@empline/preflight 1.0.20

package/dist/utils/console-chars.d.ts

@@ -0,0 +1,388 @@
+#!/usr/bin/env tsx
+/**
+ * Console Characters Utility
+ *
+ * Provides cross-platform console output characters that work on:
+ * - Windows CMD (ASCII fallback)
+ * - Windows Terminal (Unicode)
+ * - VS Code integrated terminal (Unicode)
+ * - macOS/Linux terminals (Unicode)
+ *
+ * USAGE:
+ *   import { chars, createProgressBar, box } from '@/scripts/active/utils/console-chars';
+ *
+ *   // Progress bars
+ *   console.log(createProgressBar(50, 100));  // [##########----------] 50%
+ *
+ *   // Box drawing
+ *   console.log(box.horizontal.repeat(40));   // ════════════════════════════════════════
+ *
+ *   // Individual characters
+ *   console.log(`${chars.check} Done!`);      // ✓ Done! (or [OK] on CMD)
+ *
+ * WHY THIS EXISTS:
+ *   Windows CMD doesn't handle UTF-8 properly by default, causing Unicode
+ *   characters like █, ░, ━ to render as garbage (ΓÅ│, Γûê, etc.)
+ *
+ *   This utility detects the terminal type and provides appropriate characters:
+ *   - Windows CMD: ASCII-safe characters
+ *   - Everything else: Beautiful Unicode characters
+ */
+/**
+ * Progress bar characters
+ */
+export declare const progress: {
+    readonly filled: "#" | "█";
+    readonly empty: "-" | "░";
+    readonly filledLight: "=" | "▓";
+    readonly emptyLight: "." | "▒";
+};
+/**
+ * Box drawing characters
+ */
+export declare const box: {
+    readonly horizontal: "-" | "─";
+    readonly vertical: "|" | "│";
+    readonly topLeft: "+" | "┌";
+    readonly topRight: "+" | "┐";
+    readonly bottomLeft: "+" | "└";
+    readonly bottomRight: "+" | "┘";
+    readonly teeLeft: "+" | "├";
+    readonly teeRight: "+" | "┤";
+    readonly teeTop: "+" | "┬";
+    readonly teeBottom: "+" | "┴";
+    readonly cross: "+" | "┼";
+    readonly heavyHorizontal: "=" | "━";
+    readonly heavyVertical: "|" | "┃";
+    readonly doubleHorizontal: "=" | "═";
+    readonly doubleVertical: "|" | "║";
+    readonly doubleTopLeft: "+" | "╔";
+    readonly doubleTopRight: "+" | "╗";
+    readonly doubleBottomLeft: "+" | "╚";
+    readonly doubleBottomRight: "+" | "╝";
+    readonly doubleTeeLeft: "+" | "╠";
+    readonly doubleTeeRight: "+" | "╣";
+    readonly doubleTeeTop: "+" | "╦";
+    readonly doubleTeeBottom: "+" | "╩";
+    readonly doubleCross: "+" | "╬";
+};
+/**
+ * Status/indicator characters
+ */
+export declare const chars: {
+    readonly check: "[OK]" | "✓";
+    readonly cross: "[X]" | "✗";
+    readonly warning: "[!]" | "⚠";
+    readonly info: "[i]" | "ℹ";
+    readonly bullet: "*" | "•";
+    readonly arrow: "->" | "→";
+    readonly arrowRight: "->" | "→";
+    readonly arrowLeft: "<-" | "←";
+    readonly arrowUp: "^" | "↑";
+    readonly arrowDown: "v" | "↓";
+    readonly spinner: string[];
+    readonly treeBranch: "|--" | "├──";
+    readonly treeCorner: "`--" | "└──";
+    readonly treeLine: "|  " | "│  ";
+    readonly ellipsis: "..." | "…";
+    readonly middot: "." | "·";
+};
+/**
+ * Emoji characters with ASCII fallbacks for Windows CMD
+ * Use these instead of raw emojis in console output
+ */
+export declare const emoji: {
+    readonly success: "[OK]" | "✅";
+    readonly error: "[ERR]" | "❌";
+    readonly warning: "[WARN]" | "⚠️";
+    readonly info: "[i]" | "ℹ️";
+    readonly hint: "[TIP]" | "💡";
+    readonly check: "[OK]" | "✅";
+    readonly skip: "[SKIP]" | "⏭️";
+    readonly hourglass: "[...]" | "⏳";
+    readonly clock: "[TIME]" | "⏱️";
+    readonly rocket: "[GO]" | "🚀";
+    readonly gear: "[CFG]" | "⚙️";
+    readonly wrench: "[FIX]" | "🔧";
+    readonly hammer: "[BUILD]" | "🔨";
+    readonly refresh: "[SYNC]" | "🔄";
+    readonly file: "[FILE]" | "📄";
+    readonly folder: "[DIR]" | "📁";
+    readonly clipboard: "📋" | "[LIST]";
+    readonly chart: "[STATS]" | "📊";
+    readonly graph: "[PERF]" | "📈";
+    readonly search: "[SCAN]" | "🔍";
+    readonly magnifier: "[FIND]" | "🔎";
+    readonly robot: "[AI]" | "🤖";
+    readonly lock: "[SEC]" | "🔒";
+    readonly unlock: "[OPEN]" | "🔓";
+    readonly globe: "[NET]" | "🌐";
+    readonly database: "[DB]" | "🗄️";
+    readonly palette: "[UI]" | "🎨";
+    readonly testTube: "[TEST]" | "🧪";
+    readonly lightning: "⚡" | "[FAST]";
+    readonly fire: "[HOT]" | "🔥";
+    readonly bug: "[BUG]" | "🐛";
+    readonly package: "[PKG]" | "📦";
+    readonly link: "[LINK]" | "🔗";
+    readonly key: "[KEY]" | "🔑";
+    readonly shield: "[SAFE]" | "🛡️";
+    readonly target: "[AIM]" | "🎯";
+    readonly trophy: "[WIN]" | "🏆";
+    readonly party: "[DONE]" | "🎉";
+    readonly thumbsUp: "[+1]" | "👍";
+    readonly thumbsDown: "[-1]" | "👎";
+    readonly eyes: "[LOOK]" | "👀";
+    readonly brain: "[THINK]" | "🧠";
+    readonly memo: "[NOTE]" | "📝";
+    readonly bell: "[ALERT]" | "🔔";
+    readonly stop: "[STOP]" | "🛑";
+    readonly construction: "[WIP]" | "🚧";
+    readonly users: "[TEAM]" | "👥";
+    readonly mobile: "[MOBILE]" | "📱";
+    readonly undo: "[UNDO]" | "↩️";
+    readonly docs: "[DOCS]" | "📚";
+    readonly flag: "[FLAG]" | "🚩";
+    readonly calendar: "[DATE]" | "📅";
+    readonly flask: "[TEST]" | "🧪";
+    readonly accessibility: "[A11Y]" | "♿";
+    readonly store: "[STORE]" | "🏪";
+    readonly test: "[TEST]" | "🧪";
+    readonly components: "[COMP]" | "🧩";
+    readonly tree: "[TREE]" | "🌳";
+    readonly arrow: "->" | "→";
+    readonly lightbulb: "[TIP]" | "💡";
+    readonly bullet: "*" | "•";
+    readonly stats: "[STATS]" | "📊";
+    readonly book: "[BOOK]" | "📖";
+    readonly api: "[API]" | "🔌";
+    readonly tag: "[TAG]" | "🏷️";
+    readonly card: "[CARD]" | "🃏";
+    readonly rotate: "🔄" | "[ROTATE]";
+    readonly image: "[IMG]" | "🖼️";
+    readonly archive: "📦" | "[ARCHIVE]";
+    readonly cloud: "[CLOUD]" | "☁️";
+    readonly list: "📋" | "[LIST]";
+    readonly plus: "[+]" | "➕";
+    readonly minus: "[-]" | "➖";
+    readonly edit: "[MOD]" | "✏️";
+    readonly watch: "[WATCH]" | "👁️";
+    readonly config: "[CFG]" | "⚙️";
+    readonly category: "[CAT]" | "📂";
+};
+/**
+ * Create a progress bar string
+ *
+ * @param current - Current progress value
+ * @param total - Total value (100%)
+ * @param width - Width of the bar in characters (default: 20)
+ * @param showPercent - Whether to append percentage (default: true)
+ * @returns Formatted progress bar string
+ *
+ * @example
+ * createProgressBar(50, 100)     // "[##########----------] 50%"
+ * createProgressBar(3, 10, 10)   // "[###-------] 30%"
+ * createProgressBar(100, 100)    // "[####################] 100%"
+ */
+export declare function createProgressBar(current: number, total: number, width?: number, showPercent?: boolean): string;
+/**
+ * Create a horizontal divider line
+ *
+ * @param width - Width of the divider (default: 60)
+ * @param style - 'light', 'heavy', or 'double' (default: 'light')
+ * @returns Divider string
+ *
+ * @example
+ * createDivider(40)           // "────────────────────────────────────────"
+ * createDivider(40, 'heavy')  // "════════════════════════════════════════"
+ */
+export declare function createDivider(width?: number, style?: "light" | "heavy" | "double"): string;
+/**
+ * Create a boxed header
+ *
+ * @param text - Header text
+ * @param width - Total width (default: 60)
+ * @returns Multi-line boxed header string
+ *
+ * @example
+ * createHeader("MY HEADER")
+ * // ════════════════════════════════════════════════════════════
+ * //   MY HEADER
+ * // ════════════════════════════════════════════════════════════
+ */
+export declare function createHeader(text: string, width?: number): string;
+/**
+ * Format a tree structure
+ *
+ * @param items - Array of items with optional children
+ * @returns Formatted tree string
+ *
+ * @example
+ * formatTree([
+ *   { label: 'Root', children: [
+ *     { label: 'Child 1' },
+ *     { label: 'Child 2' }
+ *   ]}
+ * ])
+ * // Root
+ * // ├── Child 1
+ * // └── Child 2
+ */
+export declare function formatTree(items: Array<{
+    label: string;
+    children?: Array<{
+        label: string;
+    }>;
+}>, prefix?: string): string;
+/**
+ * Check if Unicode is supported in current terminal
+ */
+export declare const supportsUnicode: boolean;
+/**
+ * Get the current terminal type for debugging
+ */
+export declare function getTerminalInfo(): {
+    platform: string;
+    isWindowsCmd: boolean;
+    supportsUnicode: boolean;
+    env: Record<string, string | undefined>;
+};
+declare const _default: {
+    progress: {
+        readonly filled: "#" | "█";
+        readonly empty: "-" | "░";
+        readonly filledLight: "=" | "▓";
+        readonly emptyLight: "." | "▒";
+    };
+    box: {
+        readonly horizontal: "-" | "─";
+        readonly vertical: "|" | "│";
+        readonly topLeft: "+" | "┌";
+        readonly topRight: "+" | "┐";
+        readonly bottomLeft: "+" | "└";
+        readonly bottomRight: "+" | "┘";
+        readonly teeLeft: "+" | "├";
+        readonly teeRight: "+" | "┤";
+        readonly teeTop: "+" | "┬";
+        readonly teeBottom: "+" | "┴";
+        readonly cross: "+" | "┼";
+        readonly heavyHorizontal: "=" | "━";
+        readonly heavyVertical: "|" | "┃";
+        readonly doubleHorizontal: "=" | "═";
+        readonly doubleVertical: "|" | "║";
+        readonly doubleTopLeft: "+" | "╔";
+        readonly doubleTopRight: "+" | "╗";
+        readonly doubleBottomLeft: "+" | "╚";
+        readonly doubleBottomRight: "+" | "╝";
+        readonly doubleTeeLeft: "+" | "╠";
+        readonly doubleTeeRight: "+" | "╣";
+        readonly doubleTeeTop: "+" | "╦";
+        readonly doubleTeeBottom: "+" | "╩";
+        readonly doubleCross: "+" | "╬";
+    };
+    chars: {
+        readonly check: "[OK]" | "✓";
+        readonly cross: "[X]" | "✗";
+        readonly warning: "[!]" | "⚠";
+        readonly info: "[i]" | "ℹ";
+        readonly bullet: "*" | "•";
+        readonly arrow: "->" | "→";
+        readonly arrowRight: "->" | "→";
+        readonly arrowLeft: "<-" | "←";
+        readonly arrowUp: "^" | "↑";
+        readonly arrowDown: "v" | "↓";
+        readonly spinner: string[];
+        readonly treeBranch: "|--" | "├──";
+        readonly treeCorner: "`--" | "└──";
+        readonly treeLine: "|  " | "│  ";
+        readonly ellipsis: "..." | "…";
+        readonly middot: "." | "·";
+    };
+    emoji: {
+        readonly success: "[OK]" | "✅";
+        readonly error: "[ERR]" | "❌";
+        readonly warning: "[WARN]" | "⚠️";
+        readonly info: "[i]" | "ℹ️";
+        readonly hint: "[TIP]" | "💡";
+        readonly check: "[OK]" | "✅";
+        readonly skip: "[SKIP]" | "⏭️";
+        readonly hourglass: "[...]" | "⏳";
+        readonly clock: "[TIME]" | "⏱️";
+        readonly rocket: "[GO]" | "🚀";
+        readonly gear: "[CFG]" | "⚙️";
+        readonly wrench: "[FIX]" | "🔧";
+        readonly hammer: "[BUILD]" | "🔨";
+        readonly refresh: "[SYNC]" | "🔄";
+        readonly file: "[FILE]" | "📄";
+        readonly folder: "[DIR]" | "📁";
+        readonly clipboard: "📋" | "[LIST]";
+        readonly chart: "[STATS]" | "📊";
+        readonly graph: "[PERF]" | "📈";
+        readonly search: "[SCAN]" | "🔍";
+        readonly magnifier: "[FIND]" | "🔎";
+        readonly robot: "[AI]" | "🤖";
+        readonly lock: "[SEC]" | "🔒";
+        readonly unlock: "[OPEN]" | "🔓";
+        readonly globe: "[NET]" | "🌐";
+        readonly database: "[DB]" | "🗄️";
+        readonly palette: "[UI]" | "🎨";
+        readonly testTube: "[TEST]" | "🧪";
+        readonly lightning: "⚡" | "[FAST]";
+        readonly fire: "[HOT]" | "🔥";
+        readonly bug: "[BUG]" | "🐛";
+        readonly package: "[PKG]" | "📦";
+        readonly link: "[LINK]" | "🔗";
+        readonly key: "[KEY]" | "🔑";
+        readonly shield: "[SAFE]" | "🛡️";
+        readonly target: "[AIM]" | "🎯";
+        readonly trophy: "[WIN]" | "🏆";
+        readonly party: "[DONE]" | "🎉";
+        readonly thumbsUp: "[+1]" | "👍";
+        readonly thumbsDown: "[-1]" | "👎";
+        readonly eyes: "[LOOK]" | "👀";
+        readonly brain: "[THINK]" | "🧠";
+        readonly memo: "[NOTE]" | "📝";
+        readonly bell: "[ALERT]" | "🔔";
+        readonly stop: "[STOP]" | "🛑";
+        readonly construction: "[WIP]" | "🚧";
+        readonly users: "[TEAM]" | "👥";
+        readonly mobile: "[MOBILE]" | "📱";
+        readonly undo: "[UNDO]" | "↩️";
+        readonly docs: "[DOCS]" | "📚";
+        readonly flag: "[FLAG]" | "🚩";
+        readonly calendar: "[DATE]" | "📅";
+        readonly flask: "[TEST]" | "🧪";
+        readonly accessibility: "[A11Y]" | "♿";
+        readonly store: "[STORE]" | "🏪";
+        readonly test: "[TEST]" | "🧪";
+        readonly components: "[COMP]" | "🧩";
+        readonly tree: "[TREE]" | "🌳";
+        readonly arrow: "->" | "→";
+        readonly lightbulb: "[TIP]" | "💡";
+        readonly bullet: "*" | "•";
+        readonly stats: "[STATS]" | "📊";
+        readonly book: "[BOOK]" | "📖";
+        readonly api: "[API]" | "🔌";
+        readonly tag: "[TAG]" | "🏷️";
+        readonly card: "[CARD]" | "🃏";
+        readonly rotate: "🔄" | "[ROTATE]";
+        readonly image: "[IMG]" | "🖼️";
+        readonly archive: "📦" | "[ARCHIVE]";
+        readonly cloud: "[CLOUD]" | "☁️";
+        readonly list: "📋" | "[LIST]";
+        readonly plus: "[+]" | "➕";
+        readonly minus: "[-]" | "➖";
+        readonly edit: "[MOD]" | "✏️";
+        readonly watch: "[WATCH]" | "👁️";
+        readonly config: "[CFG]" | "⚙️";
+        readonly category: "[CAT]" | "📂";
+    };
+    createProgressBar: typeof createProgressBar;
+    createDivider: typeof createDivider;
+    createHeader: typeof createHeader;
+    formatTree: typeof formatTree;
+    supportsUnicode: boolean;
+    getTerminalInfo: typeof getTerminalInfo;
+};
+export default _default;
+//# sourceMappingURL=console-chars.d.ts.map

package/dist/utils/console-chars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-chars.d.ts","sourceRoot":"","sources":["../../src/utils/console-chars.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA8DH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CA8BN,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;CAwBR,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmGR,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,WAAW,GAAE,OAAc,GAC1B,MAAM,CAQR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAE,MAAW,EAClB,KAAK,GAAE,OAAO,GAAG,OAAO,GAAG,QAAkB,GAC5C,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAMrE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,EACpE,MAAM,GAAE,MAAW,GAClB,MAAM,CAoBR;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAa,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC,CAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGD,wBAWE"}