@socketsecurity/lib 3.0.2 → 3.0.4

package/dist/stdio/mask.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/mask.ts"],
   "sourcesContent": ["/**\n * @fileoverview Interactive output masking utilities for CLI tools.\n * Provides output control with keyboard toggling (ctrl+o).\n *\n * ANSI Escape Sequences Used:\n * - '\\r': Carriage return - moves cursor to beginning of current line.\n * - '\\x1b[K' or '\\x1b[0K': CSI K (erase line) - clear from cursor to end of line.\n * - '\\x1b[2K': CSI 2K - erase entire line.\n * - '\\x1b[1A': CSI A - move cursor up 1 line.\n *\n * Terminal Control:\n * - Raw mode (setRawMode(true)): Captures keypresses immediately without buffering.\n * - TTY detection: Ensures terminal manipulation only occurs in interactive terminals.\n *\n * Key Features:\n * - Output buffering: Stores up to 1000 lines when masked to prevent memory issues.\n * - Graceful cleanup: Always restores terminal to normal mode on exit/error.\n * - Visual feedback: Uses spinner to indicate process is running when output is masked.\n */\n\nimport type { ChildProcess, SpawnOptions } from 'child_process'\nimport { spawn } from 'child_process'\nimport readline from 'readline'\nimport { getDefaultSpinner } from '../spinner.js'\nimport { clearLine } from './clear.js'\nimport { write } from './stdout.js'\n\nexport interface OutputMaskOptions {\n  /**\n   * Current working directory for spawned process.\n   * @default process.cwd()\n   */\n  cwd?: string | undefined\n  /**\n   * Environment variables for spawned process.\n   * @default process.env\n   */\n  env?: NodeJS.ProcessEnv | undefined\n  /**\n   * Filter output before displaying or buffering.\n   * Return `false` to skip the line, `true` to include it.\n   *\n   * Useful for filtering non-fatal warnings or noise from test runners.\n   * The filter runs on every chunk of output before display/buffering.\n   *\n   * @param text - The output text chunk (may include ANSI codes)\n   * @param stream - Whether this came from 'stdout' or 'stderr'\n   * @returns `true` to include this output, `false` to skip it\n   *\n   * @example\n   * ```ts\n   * filterOutput: (text, stream) => {\n   *   // Skip vitest worker termination errors\n   *   if (text.includes('Terminating worker thread')) return false\n   *   return true\n   * }\n   * ```\n   */\n  filterOutput?:\n    | ((text: string, stream: 'stdout' | 'stderr') => boolean)\n    | undefined\n  /**\n   * Progress message to display in spinner.\n   * @default 'Running\u2026'\n   */\n  message?: string | undefined\n  /**\n   * Override the exit code based on captured output.\n   *\n   * Useful for handling non-fatal errors that shouldn't fail the build.\n   * Called after the process exits with the original code and all captured output.\n   * Return a number to override the exit code, or `undefined` to keep original.\n   *\n   * @param code - Original exit code from the process\n   * @param stdout - All captured stdout (even filtered lines are captured)\n   * @param stderr - All captured stderr (even filtered lines are captured)\n   * @returns New exit code, or `undefined` to keep original\n   *\n   * @example\n   * ```ts\n   * overrideExitCode: (code, stdout, stderr) => {\n   *   // If only worker termination errors, treat as success\n   *   const output = stdout + stderr\n   *   const hasWorkerError = output.includes('Terminating worker thread')\n   *   const hasRealFailure = output.includes('FAIL')\n   *   if (code !== 0 && hasWorkerError && !hasRealFailure) {\n   *     return 0 // Override to success\n   *   }\n   *   return undefined // Keep original\n   * }\n   * ```\n   */\n  overrideExitCode?:\n    | ((code: number, stdout: string, stderr: string) => number | undefined)\n    | undefined\n  /**\n   * Start with output visible instead of masked.\n   * When `true`, output shows immediately without needing ctrl+o.\n   * @default false\n   */\n  showOutput?: boolean | undefined\n  /**\n   * Text to show after \"ctrl+o\" in spinner message.\n   * @default 'to see full output'\n   */\n  toggleText?: string | undefined\n}\n\nexport interface OutputMask {\n  /** Whether spinner is currently active */\n  isSpinning: boolean\n  /** Buffered output lines */\n  outputBuffer: string[]\n  /** All stderr captured (for exit code override) */\n  stderrCapture: string\n  /** All stdout captured (for exit code override) */\n  stdoutCapture: string\n  /** Whether output is currently visible */\n  verbose: boolean\n}\n\n/**\n * Create an output mask for controlling command output visibility.\n * The mask tracks whether output should be shown or hidden (buffered).\n * When hidden, output is buffered and a spinner is shown instead.\n */\nexport function createOutputMask(options: OutputMaskOptions = {}): OutputMask {\n  const { showOutput = false } = options\n\n  return {\n    isSpinning: !showOutput,\n    outputBuffer: [],\n    stderrCapture: '',\n    stdoutCapture: '',\n    verbose: showOutput,\n  }\n}\n\n/**\n * Create a keyboard handler for toggling output visibility.\n * Handles two key combinations:\n * - ctrl+o: Toggle between showing and hiding output.\n * - ctrl+c: Cancel the running process.\n * The handler manipulates terminal state using ANSI escape sequences.\n */\nexport function createKeyboardHandler(\n  mask: OutputMask,\n  child: ChildProcess,\n  options: OutputMaskOptions = {},\n): (_str: string, key: readline.Key) => void {\n  const { message = 'Running\u2026', toggleText = 'to see full output' } = options\n\n  return (_str, key) => {\n    // ctrl+o toggles verbose mode.\n    if (key?.ctrl && key.name === 'o') {\n      mask.verbose = !mask.verbose\n\n      if (mask.verbose) {\n        // Stop spinner and show buffered output.\n        if (mask.isSpinning) {\n          getDefaultSpinner().stop()\n          mask.isSpinning = false\n        }\n\n        // Clear the current line (removes spinner remnants).\n        clearLine()\n\n        // Show buffered output.\n        if (mask.outputBuffer.length > 0) {\n          console.log('--- Output (ctrl+o to hide) ---')\n          mask.outputBuffer.forEach(line => {\n            write(line)\n          })\n        }\n      } else {\n        // Hide output and show spinner.\n        // Clear all the output lines that were shown.\n        if (mask.outputBuffer.length > 0) {\n          // Calculate number of lines to clear (output + header line).\n          const lineCount = mask.outputBuffer.join('').split('\\n').length + 1\n          // Move up and clear each line using ANSI escape sequences:\n          // - '\\x1b[1A' (CSI A): Move cursor up 1 line.\n          // - '\\x1b[2K' (CSI K with param 2): Erase entire line.\n          // This combination effectively \"rewinds\" the terminal output.\n          for (let i = 0; i < lineCount; i += 1) {\n            process.stdout.write('\\x1b[1A\\x1b[2K')\n          }\n        }\n        clearLine()\n\n        // Clear the buffer and restart spinner.\n        mask.outputBuffer = []\n        if (!mask.isSpinning) {\n          getDefaultSpinner().start(`${message} (ctrl+o ${toggleText})`)\n          mask.isSpinning = true\n        }\n      }\n    }\n    // ctrl+c to cancel.\n    else if (key?.ctrl && key.name === 'c') {\n      // Gracefully terminate child process.\n      child.kill('SIGTERM')\n      // Restore terminal to normal mode before exiting.\n      if (process.stdin.isTTY) {\n        process.stdin.setRawMode(false)\n      }\n      throw new Error('Process cancelled by user')\n    }\n  }\n}\n\n/**\n * Attach output masking to a child process.\n * Returns a promise that resolves with the exit code.\n * This function:\n * - Sets up keyboard input handling in raw mode for immediate key capture.\n * - Buffers stdout/stderr when not in verbose mode.\n * - Shows a spinner when output is masked.\n * - Allows toggling between masked and unmasked output with ctrl+o.\n */\nexport function attachOutputMask(\n  child: ChildProcess,\n  options: OutputMaskOptions = {},\n): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const { message = 'Running\u2026' } = options\n    const mask = createOutputMask(options)\n\n    // Start spinner if not verbose.\n    if (mask.isSpinning && process.stdout.isTTY) {\n      getDefaultSpinner().start(\n        `${message} (ctrl+o ${options.toggleText || 'to see full output'})`,\n      )\n    }\n\n    // Setup keyboard input handling.\n    // Raw mode is required to capture ctrl+o without waiting for Enter.\n    if (process.stdin.isTTY) {\n      readline.emitKeypressEvents(process.stdin)\n      process.stdin.setRawMode(true)\n\n      const keypressHandler = createKeyboardHandler(mask, child, options)\n      process.stdin.on('keypress', keypressHandler)\n\n      // Cleanup on exit: restore terminal to normal mode.\n      child.on('exit', () => {\n        if (process.stdin.isTTY) {\n          process.stdin.setRawMode(false)\n          process.stdin.removeListener('keypress', keypressHandler)\n        }\n      })\n    }\n\n    // Handle stdout: either show immediately or buffer for later.\n    if (child.stdout) {\n      child.stdout.on('data', data => {\n        const text = data.toString()\n\n        // Always capture for exit code override.\n        mask.stdoutCapture += text\n\n        // Apply filter if provided.\n        if (options.filterOutput && !options.filterOutput(text, 'stdout')) {\n          // Skip this output.\n          return undefined\n        }\n\n        if (mask.verbose) {\n          write(text)\n        } else {\n          // Buffer the output for later.\n          mask.outputBuffer.push(text)\n\n          // Keep buffer size reasonable (last 1000 lines).\n          // This prevents unbounded memory growth for long-running processes.\n          const lines = mask.outputBuffer.join('').split('\\n')\n          if (lines.length > 1000) {\n            mask.outputBuffer = [lines.slice(-1000).join('\\n')]\n          }\n        }\n        return undefined\n      })\n    }\n\n    // Handle stderr: same as stdout, but write to stderr stream when verbose.\n    if (child.stderr) {\n      child.stderr.on('data', data => {\n        const text = data.toString()\n\n        // Always capture for exit code override.\n        mask.stderrCapture += text\n\n        // Apply filter if provided.\n        if (options.filterOutput && !options.filterOutput(text, 'stderr')) {\n          // Skip this output.\n          return undefined\n        }\n\n        if (mask.verbose) {\n          process.stderr.write(text)\n        } else {\n          mask.outputBuffer.push(text)\n        }\n        return undefined\n      })\n    }\n\n    child.on('exit', code => {\n      // Cleanup keyboard if needed.\n      if (process.stdin.isTTY) {\n        process.stdin.setRawMode(false)\n      }\n\n      // Allow caller to override exit code based on output.\n      let finalCode = code || 0\n      if (options.overrideExitCode) {\n        const overridden = options.overrideExitCode(\n          finalCode,\n          mask.stdoutCapture,\n          mask.stderrCapture,\n        )\n        if (overridden !== undefined) {\n          finalCode = overridden\n        }\n      }\n\n      if (mask.isSpinning) {\n        const spinner = getDefaultSpinner()\n        if (finalCode === 0) {\n          spinner.successAndStop(`${message} completed`)\n        } else {\n          spinner.failAndStop(`${message} failed`)\n          // Show buffered output on failure so user can see what went wrong.\n          if (mask.outputBuffer.length > 0 && !mask.verbose) {\n            console.log('\\n--- Output ---')\n            mask.outputBuffer.forEach(line => {\n              write(line)\n            })\n          }\n        }\n      }\n\n      resolve(finalCode)\n    })\n\n    child.on('error', error => {\n      // Ensure terminal is restored to normal mode on error.\n      if (process.stdin.isTTY) {\n        process.stdin.setRawMode(false)\n      }\n\n      if (mask.isSpinning) {\n        getDefaultSpinner().failAndStop(`${message} error`)\n      }\n      reject(error)\n    })\n  })\n}\n\n/**\n * Run a command with interactive output masking.\n * Convenience wrapper around spawn + attachOutputMask.\n * Spawns a child process and attaches the output masking system to it.\n * stdin is inherited, stdout and stderr are piped for masking control.\n */\nexport async function runWithMask(\n  command: string,\n  args: string[] = [],\n  options: OutputMaskOptions & SpawnOptions = {},\n): Promise<number> {\n  const {\n    message = 'Running\u2026',\n    showOutput = false,\n    toggleText = 'to see output',\n    ...spawnOptions\n  } = options\n\n  const child = spawn(command, args, {\n    stdio: ['inherit', 'pipe', 'pipe'],\n    ...spawnOptions,\n  })\n\n  return await attachOutputMask(child, { message, showOutput, toggleText })\n}\n"],
-  "mappings": "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",
-  "names": ["mask_exports", "__export", "attachOutputMask", "createKeyboardHandler", "createOutputMask", "runWithMask", "__toCommonJS", "import_child_process", "import_readline", "import_spinner", "import_clear", "import_stdout", "options", "showOutput", "mask", "child", "message", "toggleText", "_str", "key", "line", "lineCount", "i", "resolve", "reject", "readline", "keypressHandler", "data", "text", "lines", "code", "finalCode", "overridden", "spinner", "error", "command", "args", "spawnOptions"]
+  "mappings": "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",
+  "names": ["readline"]
 }

package/dist/stdio/progress.js

@@ -1,4 +1,211 @@
 /* Socket Lib - Built with esbuild */
-var w=Object.create;var c=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var $=Object.getOwnPropertyNames;var S=Object.getPrototypeOf,W=Object.prototype.hasOwnProperty;var y=(r,t)=>{for(var e in t)c(r,e,{get:t[e],enumerable:!0})},u=(r,t,e,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of $(t))!W.call(r,n)&&n!==e&&c(r,n,{get:()=>t[n],enumerable:!(s=T(t,n))||s.enumerable});return r};var D=(r,t,e)=>(e=r!=null?w(S(r)):{},u(t||!r||!r.__esModule?c(e,"default",{value:r,enumerable:!0}):e,r)),R=r=>u(c({},"__esModule",{value:!0}),r);var k={};y(k,{ProgressBar:()=>M,createProgressIndicator:()=>P});module.exports=R(k);var l=D(require("../external/yoctocolors-cjs")),o=require("../strings");class M{current=0;total;startTime;lastRender=0;stream;options;terminated=!1;lastDrawnWidth=0;constructor(t,e){this.total=t,this.startTime=Date.now(),this.stream=e?.stream||process.stderr,this.options={width:40,format:":bar :percent :current/:total",complete:"\u2588",incomplete:"\u2591",head:"",clear:!1,renderThrottle:16,stream:this.stream,color:"cyan",...e}}update(t,e){if(this.terminated)return;this.current=Math.min(t,this.total);const s=Date.now();s-this.lastRender<this.options.renderThrottle&&this.current<this.total||(this.lastRender=s,this.render(e),this.current>=this.total&&this.terminate())}tick(t=1,e){this.update(this.current+t,e)}render(t){const e=l.default[this.options.color]||(h=>h),s=Math.floor(this.current/this.total*100),n=Date.now()-this.startTime,a=this.current===0?0:n/this.current*(this.total-this.current),d=this.options.width,m=Math.floor(this.current/this.total*d),p=d-m,f=(0,o.repeatString)(this.options.complete,m),g=(0,o.repeatString)(this.options.incomplete,p),b=e(f)+g;let i=this.options.format;if(i=i.replace(":bar",b),i=i.replace(":percent",`${s}%`),i=i.replace(":current",String(this.current)),i=i.replace(":total",String(this.total)),i=i.replace(":elapsed",this.formatTime(n)),i=i.replace(":eta",this.formatTime(a)),t)for(const[h,v]of Object.entries(t))i=i.replace(`:${h}`,String(v));this.clearLine(),this.stream.write(i),this.lastDrawnWidth=(0,o.stripAnsi)(i).length}clearLine(){this.stream.isTTY?(this.stream.cursorTo(0),this.stream.clearLine(0)):this.lastDrawnWidth>0&&this.stream.write(`\r${(0,o.repeatString)(" ",this.lastDrawnWidth)}\r`)}formatTime(t){const e=Math.round(t/1e3);if(e<60)return`${e}s`;const s=Math.floor(e/60),n=e%60;return`${s}m${n}s`}terminate(){this.terminated||(this.terminated=!0,this.options.clear?this.clearLine():this.stream.write(`
-`))}}function P(r,t,e){const s=Math.floor(r/t*100),n=`${r}/${t}`;let a="";return e&&(a+=`${e}: `),a+=`${l.default.cyan(`[${s}%]`)} ${n}`,a}0&&(module.exports={ProgressBar,createProgressIndicator});
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var progress_exports = {};
+__export(progress_exports, {
+  ProgressBar: () => ProgressBar,
+  createProgressIndicator: () => createProgressIndicator
+});
+module.exports = __toCommonJS(progress_exports);
+var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
+var import_strings = require("../strings");
+class ProgressBar {
+  current = 0;
+  total;
+  startTime;
+  lastRender = 0;
+  stream;
+  options;
+  terminated = false;
+  lastDrawnWidth = 0;
+  /**
+   * Create a new progress bar instance.
+   *
+   * @param total - Total number of units for the progress bar
+   * @param options - Configuration options for the progress bar
+   *
+   * @example
+   * ```ts
+   * const bar = new ProgressBar(100, {
+   *   width: 50,
+   *   format: ':bar :percent :current/:total :eta',
+   *   color: 'green'
+   * })
+   * ```
+   */
+  constructor(total, options) {
+    this.total = total;
+    this.startTime = Date.now();
+    this.stream = options?.stream || process.stderr;
+    this.options = {
+      width: 40,
+      format: ":bar :percent :current/:total",
+      complete: "\u2588",
+      incomplete: "\u2591",
+      head: "",
+      clear: false,
+      // ~60fps.
+      renderThrottle: 16,
+      stream: this.stream,
+      color: "cyan",
+      ...options
+    };
+  }
+  /**
+   * Update progress to a specific value and redraw the bar.
+   * Updates are throttled to prevent excessive rendering (default ~60fps).
+   *
+   * @param current - Current progress value (will be clamped to total)
+   * @param tokens - Optional custom tokens to replace in format string
+   *
+   * @example
+   * ```ts
+   * bar.update(50)
+   * bar.update(75, { status: 'Processing...' })
+   * ```
+   */
+  update(current, tokens) {
+    if (this.terminated) {
+      return;
+    }
+    this.current = Math.min(current, this.total);
+    const now = Date.now();
+    if (now - this.lastRender < this.options.renderThrottle && this.current < this.total) {
+      return;
+    }
+    this.lastRender = now;
+    this.render(tokens);
+    if (this.current >= this.total) {
+      this.terminate();
+    }
+  }
+  /**
+   * Increment progress by a specified amount.
+   * Convenience method for `update(current + amount)`.
+   *
+   * @param amount - Amount to increment by
+   * @param tokens - Optional custom tokens to replace in format string
+   * @default amount 1
+   *
+   * @example
+   * ```ts
+   * bar.tick() // Increment by 1
+   * bar.tick(5) // Increment by 5
+   * bar.tick(1, { file: 'data.json' })
+   * ```
+   */
+  tick(amount = 1, tokens) {
+    this.update(this.current + amount, tokens);
+  }
+  /**
+   * Render the progress bar.
+   */
+  render(tokens) {
+    const colorFn = import_yoctocolors_cjs.default[this.options.color] || ((s) => s);
+    const percent = Math.floor(this.current / this.total * 100);
+    const elapsed = Date.now() - this.startTime;
+    const eta = this.current === 0 ? 0 : elapsed / this.current * (this.total - this.current);
+    const availableWidth = this.options.width;
+    const filledWidth = Math.floor(this.current / this.total * availableWidth);
+    const emptyWidth = availableWidth - filledWidth;
+    const filled = (0, import_strings.repeatString)(this.options.complete, filledWidth);
+    const empty = (0, import_strings.repeatString)(this.options.incomplete, emptyWidth);
+    const bar = colorFn(filled) + empty;
+    let output = this.options.format;
+    output = output.replace(":bar", bar);
+    output = output.replace(":percent", `${percent}%`);
+    output = output.replace(":current", String(this.current));
+    output = output.replace(":total", String(this.total));
+    output = output.replace(":elapsed", this.formatTime(elapsed));
+    output = output.replace(":eta", this.formatTime(eta));
+    if (tokens) {
+      for (const [key, value] of Object.entries(tokens)) {
+        output = output.replace(`:${key}`, String(value));
+      }
+    }
+    this.clearLine();
+    this.stream.write(output);
+    this.lastDrawnWidth = (0, import_strings.stripAnsi)(output).length;
+  }
+  /**
+   * Clear the current line.
+   */
+  clearLine() {
+    if (this.stream.isTTY) {
+      this.stream.cursorTo(0);
+      this.stream.clearLine(0);
+    } else if (this.lastDrawnWidth > 0) {
+      this.stream.write(`\r${(0, import_strings.repeatString)(" ", this.lastDrawnWidth)}\r`);
+    }
+  }
+  /**
+   * Format time in seconds to human readable.
+   */
+  formatTime(ms) {
+    const seconds = Math.round(ms / 1e3);
+    if (seconds < 60) {
+      return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${minutes}m${remainingSeconds}s`;
+  }
+  /**
+   * Terminate the progress bar and optionally clear it.
+   * Called automatically when progress reaches 100%.
+   * If `clear` option is true, removes the bar from terminal.
+   * Otherwise, moves to next line to preserve the final state.
+   */
+  terminate() {
+    if (this.terminated) {
+      return;
+    }
+    this.terminated = true;
+    if (this.options.clear) {
+      this.clearLine();
+    } else {
+      this.stream.write("\n");
+    }
+  }
+}
+function createProgressIndicator(current, total, label) {
+  const percent = Math.floor(current / total * 100);
+  const progress = `${current}/${total}`;
+  let output = "";
+  if (label) {
+    output += `${label}: `;
+  }
+  output += `${import_yoctocolors_cjs.default.cyan(`[${percent}%]`)} ${progress}`;
+  return output;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ProgressBar,
+  createProgressIndicator
+});
 //# sourceMappingURL=progress.js.map

package/dist/stdio/progress.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/progress.ts"],
   "sourcesContent": ["/**\n * @fileoverview Progress bar utilities for CLI applications.\n * Provides various progress indicators including bars, percentages, and spinners.\n */\n\nimport colors from '../external/yoctocolors-cjs'\nimport { repeatString, stripAnsi } from '../strings'\n\nexport interface ProgressBarOptions {\n  /**\n   * Width of the progress bar in characters.\n   * @default 40\n   */\n  width?: number | undefined\n  /**\n   * Format template for progress bar display.\n   * Available tokens: `:bar`, `:percent`, `:current`, `:total`, `:elapsed`, `:eta`.\n   * Custom tokens can be passed via the `tokens` parameter in `update()` or `tick()`.\n   * @default ':bar :percent :current/:total'\n   * @example\n   * ```ts\n   * format: ':bar :percent :current/:total :eta'\n   * ```\n   */\n  format?: string | undefined\n  /**\n   * Character(s) to use for completed portion of bar.\n   * @default '\u2588'\n   */\n  complete?: string | undefined\n  /**\n   * Character(s) to use for incomplete portion of bar.\n   * @default '\u2591'\n   */\n  incomplete?: string | undefined\n  /**\n   * Character(s) to use for the head of the progress bar.\n   * @default ''\n   */\n  head?: string | undefined\n  /**\n   * Clear the progress bar when complete.\n   * @default false\n   */\n  clear?: boolean | undefined\n  /**\n   * Minimum time between renders in milliseconds.\n   * ~60fps = 16ms throttle.\n   * @default 16\n   */\n  renderThrottle?: number | undefined\n  /**\n   * Stream to write progress bar output to.\n   * @default process.stderr\n   */\n  stream?: NodeJS.WriteStream | undefined\n  /**\n   * Color to apply to the completed portion of the bar.\n   * @default 'cyan'\n   */\n  color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | undefined\n}\n\nexport class ProgressBar {\n  private current: number = 0\n  private total: number\n  private startTime: number\n  private lastRender: number = 0\n  private stream: NodeJS.WriteStream\n  private options: Required<ProgressBarOptions>\n  private terminated: boolean = false\n  private lastDrawnWidth: number = 0\n\n  /**\n   * Create a new progress bar instance.\n   *\n   * @param total - Total number of units for the progress bar\n   * @param options - Configuration options for the progress bar\n   *\n   * @example\n   * ```ts\n   * const bar = new ProgressBar(100, {\n   *   width: 50,\n   *   format: ':bar :percent :current/:total :eta',\n   *   color: 'green'\n   * })\n   * ```\n   */\n  constructor(total: number, options?: ProgressBarOptions) {\n    this.total = total\n    this.startTime = Date.now()\n    this.stream = options?.stream || process.stderr\n    this.options = {\n      width: 40,\n      format: ':bar :percent :current/:total',\n      complete: '\u2588',\n      incomplete: '\u2591',\n      head: '',\n      clear: false,\n      // ~60fps.\n      renderThrottle: 16,\n      stream: this.stream,\n      color: 'cyan',\n      ...options,\n    }\n  }\n\n  /**\n   * Update progress to a specific value and redraw the bar.\n   * Updates are throttled to prevent excessive rendering (default ~60fps).\n   *\n   * @param current - Current progress value (will be clamped to total)\n   * @param tokens - Optional custom tokens to replace in format string\n   *\n   * @example\n   * ```ts\n   * bar.update(50)\n   * bar.update(75, { status: 'Processing...' })\n   * ```\n   */\n  update(current: number, tokens?: Record<string, unknown>): void {\n    if (this.terminated) {\n      return\n    }\n\n    this.current = Math.min(current, this.total)\n\n    // Throttle rendering\n    const now = Date.now()\n    if (\n      now - this.lastRender < this.options.renderThrottle &&\n      this.current < this.total\n    ) {\n      return\n    }\n    this.lastRender = now\n\n    this.render(tokens)\n\n    if (this.current >= this.total) {\n      this.terminate()\n    }\n  }\n\n  /**\n   * Increment progress by a specified amount.\n   * Convenience method for `update(current + amount)`.\n   *\n   * @param amount - Amount to increment by\n   * @param tokens - Optional custom tokens to replace in format string\n   * @default amount 1\n   *\n   * @example\n   * ```ts\n   * bar.tick() // Increment by 1\n   * bar.tick(5) // Increment by 5\n   * bar.tick(1, { file: 'data.json' })\n   * ```\n   */\n  tick(amount: number = 1, tokens?: Record<string, unknown>): void {\n    this.update(this.current + amount, tokens)\n  }\n\n  /**\n   * Render the progress bar.\n   */\n  private render(tokens?: Record<string, unknown>): void {\n    const colorFn = colors[this.options.color] || ((s: string) => s)\n\n    // Calculate values\n    const percent = Math.floor((this.current / this.total) * 100)\n    const elapsed = Date.now() - this.startTime\n    const eta =\n      this.current === 0\n        ? 0\n        : (elapsed / this.current) * (this.total - this.current)\n\n    // Build bar\n    const availableWidth = this.options.width\n    const filledWidth = Math.floor((this.current / this.total) * availableWidth)\n    const emptyWidth = availableWidth - filledWidth\n\n    const filled = repeatString(this.options.complete, filledWidth)\n    const empty = repeatString(this.options.incomplete, emptyWidth)\n    const bar = colorFn(filled) + empty\n\n    // Format output\n    let output = this.options.format\n    output = output.replace(':bar', bar)\n    output = output.replace(':percent', `${percent}%`)\n    output = output.replace(':current', String(this.current))\n    output = output.replace(':total', String(this.total))\n    output = output.replace(':elapsed', this.formatTime(elapsed))\n    output = output.replace(':eta', this.formatTime(eta))\n\n    // Replace custom tokens\n    if (tokens) {\n      for (const [key, value] of Object.entries(tokens)) {\n        output = output.replace(`:${key}`, String(value))\n      }\n    }\n\n    // Clear line and write\n    this.clearLine()\n    this.stream.write(output)\n    this.lastDrawnWidth = stripAnsi(output).length\n  }\n\n  /**\n   * Clear the current line.\n   */\n  private clearLine(): void {\n    if (this.stream.isTTY) {\n      this.stream.cursorTo(0)\n      this.stream.clearLine(0)\n    } else if (this.lastDrawnWidth > 0) {\n      this.stream.write(`\\r${repeatString(' ', this.lastDrawnWidth)}\\r`)\n    }\n  }\n\n  /**\n   * Format time in seconds to human readable.\n   */\n  private formatTime(ms: number): string {\n    const seconds = Math.round(ms / 1000)\n    if (seconds < 60) {\n      return `${seconds}s`\n    }\n    const minutes = Math.floor(seconds / 60)\n    const remainingSeconds = seconds % 60\n    return `${minutes}m${remainingSeconds}s`\n  }\n\n  /**\n   * Terminate the progress bar and optionally clear it.\n   * Called automatically when progress reaches 100%.\n   * If `clear` option is true, removes the bar from terminal.\n   * Otherwise, moves to next line to preserve the final state.\n   */\n  terminate(): void {\n    if (this.terminated) {\n      return\n    }\n    this.terminated = true\n\n    if (this.options.clear) {\n      this.clearLine()\n    } else {\n      this.stream.write('\\n')\n    }\n  }\n}\n\n/**\n * Create a simple progress indicator without a graphical bar.\n * Returns a formatted string showing progress as percentage and fraction.\n *\n * @param current - Current progress value\n * @param total - Total progress value\n * @param label - Optional label prefix\n * @returns Formatted progress indicator string\n *\n * @example\n * ```ts\n * createProgressIndicator(50, 100)\n * // Returns: '[50%] 50/100'\n *\n * createProgressIndicator(3, 10, 'Files')\n * // Returns: 'Files: [30%] 3/10'\n * ```\n */\nexport function createProgressIndicator(\n  current: number,\n  total: number,\n  label?: string | undefined,\n): string {\n  const percent = Math.floor((current / total) * 100)\n  const progress = `${current}/${total}`\n\n  let output = ''\n  if (label) {\n    output += `${label}: `\n  }\n\n  output += `${colors.cyan(`[${percent}%]`)} ${progress}`\n\n  return output\n}\n"],
-  "mappings": "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",
-  "names": ["progress_exports", "__export", "ProgressBar", "createProgressIndicator", "__toCommonJS", "import_yoctocolors_cjs", "import_strings", "total", "options", "current", "tokens", "now", "amount", "colorFn", "colors", "s", "percent", "elapsed", "eta", "availableWidth", "filledWidth", "emptyWidth", "filled", "empty", "bar", "output", "key", "value", "ms", "seconds", "minutes", "remainingSeconds", "label", "progress"]
+  "mappings": "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",
+  "names": ["colors"]
 }

package/dist/stdio/prompts.js

@@ -1,3 +1,90 @@
 /* Socket Lib - Built with esbuild */
-var c=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var h=(n,e)=>{for(var t in e)c(n,t,{get:e[t],enumerable:!0})},b=(n,e,t,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of y(e))!R.call(n,r)&&r!==t&&c(n,r,{get:()=>e[r],enumerable:!(a=g(e,r))||a.enumerable});return n};var q=n=>b(c({},"__esModule",{value:!0}),n);var D={};h(D,{Separator:()=>J,confirm:()=>N,input:()=>V,password:()=>W,search:()=>j,select:()=>v,wrapPrompt:()=>o});module.exports=q(D);var s=require("#constants/process");const C=(0,s.getAbortSignal)(),T=(0,s.getSpinner)();function o(n){return async(...e)=>{const t=e.length>1?e[1]:void 0,{spinner:a,...r}=t??{},p=a!==void 0?a:T,d=C;t?e[1]={signal:d,...r}:e[1]={signal:d};const m=!!p?.isSpinning;p?.stop();let i;try{i=await n(...e)}catch(f){if(f instanceof TypeError)throw f}return m&&p.start(),typeof i=="string"?i.trim():i}}const l=require("../external/@inquirer/confirm"),w=require("../external/@inquirer/input"),x=require("../external/@inquirer/password"),S=require("../external/@inquirer/search"),u=require("../external/@inquirer/select"),E=l.default??l,k=w.default??w,P=x.default??x,A=S.default??S,I=u.default??u,J=u.Separator,N=o(E),V=o(k),W=o(P),j=o(A),v=o(I);0&&(module.exports={Separator,confirm,input,password,search,select,wrapPrompt});
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prompts_exports = {};
+__export(prompts_exports, {
+  Separator: () => ActualSeparator,
+  confirm: () => confirm,
+  input: () => input,
+  password: () => password,
+  search: () => search,
+  select: () => select,
+  wrapPrompt: () => wrapPrompt
+});
+module.exports = __toCommonJS(prompts_exports);
+var import_process = require("#constants/process");
+const abortSignal = (0, import_process.getAbortSignal)();
+const spinner = (0, import_process.getSpinner)();
+// @__NO_SIDE_EFFECTS__
+function wrapPrompt(inquirerPrompt) {
+  return async (...args) => {
+    const origContext = args.length > 1 ? args[1] : void 0;
+    const { spinner: contextSpinner, ...contextWithoutSpinner } = origContext ?? {};
+    const spinnerInstance = contextSpinner !== void 0 ? contextSpinner : spinner;
+    const signal = abortSignal;
+    if (origContext) {
+      args[1] = {
+        signal,
+        ...contextWithoutSpinner
+      };
+    } else {
+      args[1] = { signal };
+    }
+    const wasSpinning = !!spinnerInstance?.isSpinning;
+    spinnerInstance?.stop();
+    let result;
+    try {
+      result = await inquirerPrompt(...args);
+    } catch (e) {
+      if (e instanceof TypeError) {
+        throw e;
+      }
+    }
+    if (wasSpinning) {
+      spinnerInstance.start();
+    }
+    return typeof result === "string" ? result.trim() : result;
+  };
+}
+const confirmExport = require("../external/@inquirer/confirm");
+const inputExport = require("../external/@inquirer/input");
+const passwordExport = require("../external/@inquirer/password");
+const searchExport = require("../external/@inquirer/search");
+const selectExport = require("../external/@inquirer/select");
+const confirmRaw = confirmExport.default ?? confirmExport;
+const inputRaw = inputExport.default ?? inputExport;
+const passwordRaw = passwordExport.default ?? passwordExport;
+const searchRaw = searchExport.default ?? searchExport;
+const selectRaw = selectExport.default ?? selectExport;
+const ActualSeparator = selectExport.Separator;
+const confirm = /* @__PURE__ */ wrapPrompt(confirmRaw);
+const input = /* @__PURE__ */ wrapPrompt(inputRaw);
+const password = /* @__PURE__ */ wrapPrompt(passwordRaw);
+const search = /* @__PURE__ */ wrapPrompt(searchRaw);
+const select = /* @__PURE__ */ wrapPrompt(selectRaw);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Separator,
+  confirm,
+  input,
+  password,
+  search,
+  select,
+  wrapPrompt
+});
 //# sourceMappingURL=prompts.js.map

package/dist/stdio/prompts.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/prompts.ts"],
   "sourcesContent": ["/**\n * @fileoverview User prompt utilities for interactive scripts.\n * Provides inquirer.js integration with spinner support and context handling.\n */\n\nimport { getAbortSignal, getSpinner } from '#constants/process'\n\nconst abortSignal = getAbortSignal()\nconst spinner = getSpinner()\n\n// Type definitions\n\n/**\n * Choice option for select and search prompts.\n *\n * @template Value - Type of the choice value\n */\nexport interface Choice<Value = unknown> {\n  /** The value returned when this choice is selected */\n  value: Value\n  /** Whether this choice is disabled, or a reason string */\n  disabled?: boolean | string | undefined\n  /** Additional description text shown below the choice */\n  description?: string | undefined\n  /** Display name for the choice (defaults to value.toString()) */\n  name?: string | undefined\n  /** Short text shown after selection (defaults to name) */\n  short?: string | undefined\n}\n\n/**\n * Context for inquirer prompts.\n * Minimal context interface used by Inquirer prompts.\n * Duplicated from `@inquirer/type` - InquirerContext.\n */\ninterface InquirerContext {\n  /** Abort signal for cancelling the prompt */\n  signal?: AbortSignal | undefined\n  /** Input stream (defaults to process.stdin) */\n  input?: NodeJS.ReadableStream | undefined\n  /** Output stream (defaults to process.stdout) */\n  output?: NodeJS.WritableStream | undefined\n  /** Clear the prompt from terminal when done */\n  clearPromptOnDone?: boolean | undefined\n}\n\n/**\n * Extended context with spinner support.\n * Allows passing a spinner instance to be managed during prompts.\n */\nexport type Context = import('../objects').Remap<\n  InquirerContext & {\n    /** Optional spinner to stop/start during prompt display */\n    spinner?: import('../spinner').Spinner | undefined\n  }\n>\n\n/**\n * Separator for visual grouping in select/checkbox prompts.\n * Creates a non-selectable visual separator line.\n * Duplicated from `@inquirer/select` - Separator.\n * This type definition ensures the Separator type is available in published packages.\n *\n * @example\n * import { Separator } from './prompts'\n *\n * const choices = [\n *   { name: 'Option 1', value: 1 },\n *   new Separator(),\n *   { name: 'Option 2', value: 2 }\n * ]\n */\ndeclare class SeparatorType {\n  readonly separator: string\n  readonly type: 'separator'\n  constructor(separator?: string)\n}\n\nexport type Separator = SeparatorType\n\n/**\n * Wrap an inquirer prompt with spinner handling and signal injection.\n * Automatically stops/starts spinners during prompt display and injects abort signals.\n * Trims string results and handles cancellation gracefully.\n *\n * @template T - Type of the prompt result\n * @param inquirerPrompt - The inquirer prompt function to wrap\n * @returns Wrapped prompt function with spinner and signal handling\n *\n * @example\n * const myPrompt = wrapPrompt(rawInquirerPrompt)\n * const result = await myPrompt({ message: 'Enter name:' })\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function wrapPrompt<T = unknown>(\n  inquirerPrompt: (...args: unknown[]) => Promise<T>,\n): (...args: unknown[]) => Promise<T | undefined> {\n  return async (...args) => {\n    const origContext = (args.length > 1 ? args[1] : undefined) as\n      | Context\n      | undefined\n    const { spinner: contextSpinner, ...contextWithoutSpinner } =\n      origContext ?? ({} as Context)\n    const spinnerInstance =\n      contextSpinner !== undefined ? contextSpinner : spinner\n    const signal = abortSignal\n    if (origContext) {\n      args[1] = {\n        signal,\n        ...contextWithoutSpinner,\n      }\n    } else {\n      args[1] = { signal }\n    }\n    const wasSpinning = !!spinnerInstance?.isSpinning\n    spinnerInstance?.stop()\n    let result: unknown\n    try {\n      result = await inquirerPrompt(...args)\n    } catch (e) {\n      if (e instanceof TypeError) {\n        throw e\n      }\n    }\n    if (wasSpinning) {\n      spinnerInstance.start()\n    }\n    return (typeof result === 'string' ? result.trim() : result) as\n      | T\n      | undefined\n  }\n}\n\n// c8 ignore start - Third-party inquirer library requires and exports not testable in isolation.\nconst confirmExport = /*@__PURE__*/ require('../external/@inquirer/confirm')\nconst inputExport = /*@__PURE__*/ require('../external/@inquirer/input')\nconst passwordExport = /*@__PURE__*/ require('../external/@inquirer/password')\nconst searchExport = /*@__PURE__*/ require('../external/@inquirer/search')\nconst selectExport = /*@__PURE__*/ require('../external/@inquirer/select')\nconst confirmRaw = confirmExport.default ?? confirmExport\nconst inputRaw = inputExport.default ?? inputExport\nconst passwordRaw = passwordExport.default ?? passwordExport\nconst searchRaw = searchExport.default ?? searchExport\nconst selectRaw = selectExport.default ?? selectExport\nconst ActualSeparator = selectExport.Separator\n// c8 ignore stop\n\n/**\n * Prompt for a yes/no confirmation.\n * Wrapped with spinner handling and abort signal support.\n *\n * @example\n * const answer = await confirm({ message: 'Continue?' })\n * if (answer) { // user confirmed }\n */\nexport const confirm: typeof confirmRaw = wrapPrompt(confirmRaw)\n\n/**\n * Prompt for text input.\n * Wrapped with spinner handling and abort signal support.\n * Result is automatically trimmed.\n *\n * @example\n * const name = await input({ message: 'Enter your name:' })\n */\nexport const input: typeof inputRaw = wrapPrompt(inputRaw)\n\n/**\n * Prompt for password input (hidden characters).\n * Wrapped with spinner handling and abort signal support.\n *\n * @example\n * const token = await password({ message: 'Enter API token:' })\n */\nexport const password: typeof passwordRaw = wrapPrompt(passwordRaw)\n\n/**\n * Prompt with searchable/filterable choices.\n * Wrapped with spinner handling and abort signal support.\n *\n * @example\n * const result = await search({\n *   message: 'Select a package:',\n *   source: async (input) => fetchPackages(input)\n * })\n */\nexport const search: typeof searchRaw = wrapPrompt(searchRaw)\n\n/**\n * Prompt to select from a list of choices.\n * Wrapped with spinner handling and abort signal support.\n *\n * @example\n * const choice = await select({\n *   message: 'Choose an option:',\n *   choices: [\n *     { name: 'Option 1', value: 'opt1' },\n *     { name: 'Option 2', value: 'opt2' }\n *   ]\n * })\n */\nexport const select: typeof selectRaw = wrapPrompt(selectRaw)\n\nexport { ActualSeparator as Separator }\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,YAAAC,EAAA,UAAAC,EAAA,aAAAC,EAAA,WAAAC,EAAA,WAAAC,EAAA,eAAAC,IAAA,eAAAC,EAAAT,GAKA,IAAAU,EAA2C,8BAE3C,MAAMC,KAAc,kBAAe,EAC7BC,KAAU,cAAW,EAsFpB,SAASJ,EACdK,EACgD,CAChD,MAAO,UAAUC,IAAS,CACxB,MAAMC,EAAeD,EAAK,OAAS,EAAIA,EAAK,CAAC,EAAI,OAG3C,CAAE,QAASE,EAAgB,GAAGC,CAAsB,EACxDF,GAAgB,CAAC,EACbG,EACJF,IAAmB,OAAYA,EAAiBJ,EAC5CO,EAASR,EACXI,EACFD,EAAK,CAAC,EAAI,CACR,OAAAK,EACA,GAAGF,CACL,EAEAH,EAAK,CAAC,EAAI,CAAE,OAAAK,CAAO,EAErB,MAAMC,EAAc,CAAC,CAACF,GAAiB,WACvCA,GAAiB,KAAK,EACtB,IAAIG,EACJ,GAAI,CACFA,EAAS,MAAMR,EAAe,GAAGC,CAAI,CACvC,OAASQ,EAAG,CACV,GAAIA,aAAa,UACf,MAAMA,CAEV,CACA,OAAIF,GACFF,EAAgB,MAAM,EAEhB,OAAOG,GAAW,SAAWA,EAAO,KAAK,EAAIA,CAGvD,CACF,CAGA,MAAME,EAA8B,QAAQ,+BAA+B,EACrEC,EAA4B,QAAQ,6BAA6B,EACjEC,EAA+B,QAAQ,gCAAgC,EACvEC,EAA6B,QAAQ,8BAA8B,EACnEC,EAA6B,QAAQ,8BAA8B,EACnEC,EAAaL,EAAc,SAAWA,EACtCM,EAAWL,EAAY,SAAWA,EAClCM,EAAcL,EAAe,SAAWA,EACxCM,EAAYL,EAAa,SAAWA,EACpCM,EAAYL,EAAa,SAAWA,EACpCzB,EAAkByB,EAAa,UAWxBxB,EAA6BK,EAAWoB,CAAU,EAUlDxB,EAAyBI,EAAWqB,CAAQ,EAS5CxB,EAA+BG,EAAWsB,CAAW,EAYrDxB,EAA2BE,EAAWuB,CAAS,EAe/CxB,EAA2BC,EAAWwB,CAAS",
-  "names": ["prompts_exports", "__export", "ActualSeparator", "confirm", "input", "password", "search", "select", "wrapPrompt", "__toCommonJS", "import_process", "abortSignal", "spinner", "inquirerPrompt", "args", "origContext", "contextSpinner", "contextWithoutSpinner", "spinnerInstance", "signal", "wasSpinning", "result", "e", "confirmExport", "inputExport", "passwordExport", "searchExport", "selectExport", "confirmRaw", "inputRaw", "passwordRaw", "searchRaw", "selectRaw"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA2C;AAE3C,MAAM,kBAAc,+BAAe;AACnC,MAAM,cAAU,2BAAW;AAAA;AAsFpB,SAAS,WACd,gBACgD;AAChD,SAAO,UAAU,SAAS;AACxB,UAAM,cAAe,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI;AAGjD,UAAM,EAAE,SAAS,gBAAgB,GAAG,sBAAsB,IACxD,eAAgB,CAAC;AACnB,UAAM,kBACJ,mBAAmB,SAAY,iBAAiB;AAClD,UAAM,SAAS;AACf,QAAI,aAAa;AACf,WAAK,CAAC,IAAI;AAAA,QACR;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF,OAAO;AACL,WAAK,CAAC,IAAI,EAAE,OAAO;AAAA,IACrB;AACA,UAAM,cAAc,CAAC,CAAC,iBAAiB;AACvC,qBAAiB,KAAK;AACtB,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,eAAe,GAAG,IAAI;AAAA,IACvC,SAAS,GAAG;AACV,UAAI,aAAa,WAAW;AAC1B,cAAM;AAAA,MACR;AAAA,IACF;AACA,QAAI,aAAa;AACf,sBAAgB,MAAM;AAAA,IACxB;AACA,WAAQ,OAAO,WAAW,WAAW,OAAO,KAAK,IAAI;AAAA,EAGvD;AACF;AAGA,MAAM,gBAA8B,QAAQ,+BAA+B;AAC3E,MAAM,cAA4B,QAAQ,6BAA6B;AACvE,MAAM,iBAA+B,QAAQ,gCAAgC;AAC7E,MAAM,eAA6B,QAAQ,8BAA8B;AACzE,MAAM,eAA6B,QAAQ,8BAA8B;AACzE,MAAM,aAAa,cAAc,WAAW;AAC5C,MAAM,WAAW,YAAY,WAAW;AACxC,MAAM,cAAc,eAAe,WAAW;AAC9C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,kBAAkB,aAAa;AAW9B,MAAM,UAA6B,2BAAW,UAAU;AAUxD,MAAM,QAAyB,2BAAW,QAAQ;AASlD,MAAM,WAA+B,2BAAW,WAAW;AAY3D,MAAM,SAA2B,2BAAW,SAAS;AAerD,MAAM,SAA2B,2BAAW,SAAS;",
+  "names": []
 }

package/dist/stdio/stderr.js

@@ -1,4 +1,91 @@
 /* Socket Lib - Built with esbuild */
-var s=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var p=(r,t)=>{for(var n in t)s(r,n,{get:t[n],enumerable:!0})},T=(r,t,n,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of a(t))!d.call(r,e)&&e!==n&&s(r,e,{get:()=>t[e],enumerable:!(c=f(t,e))||c.enumerable});return r};var g=r=>T(s({},"__esModule",{value:!0}),r);var Y={};p(Y,{clearLine:()=>x,cursorTo:()=>w,getColumns:()=>v,getRows:()=>b,isTTY:()=>l,stderr:()=>o,writeError:()=>m,writeErrorFormatted:()=>u,writeErrorLine:()=>i,writeStackTrace:()=>$,writeWarning:()=>E});module.exports=g(Y);const o=process.stderr;function i(r=""){o.write(`${r}
-`)}function m(r){o.write(r)}function x(){o.isTTY&&(o.cursorTo(0),o.clearLine(0))}function w(r,t){o.isTTY&&o.cursorTo(r,t)}function l(){return o.isTTY||!1}function v(){return o.columns||80}function b(){return o.rows||24}function E(r,t="Warning"){const n=`${t}: ${r}`;i(n)}function u(r,t="Error"){const n=`${t}: ${r}`;i(n)}function $(r){r.stack?i(r.stack):u(r.message)}0&&(module.exports={clearLine,cursorTo,getColumns,getRows,isTTY,stderr,writeError,writeErrorFormatted,writeErrorLine,writeStackTrace,writeWarning});
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var stderr_exports = {};
+__export(stderr_exports, {
+  clearLine: () => clearLine,
+  cursorTo: () => cursorTo,
+  getColumns: () => getColumns,
+  getRows: () => getRows,
+  isTTY: () => isTTY,
+  stderr: () => stderr,
+  writeError: () => writeError,
+  writeErrorFormatted: () => writeErrorFormatted,
+  writeErrorLine: () => writeErrorLine,
+  writeStackTrace: () => writeStackTrace,
+  writeWarning: () => writeWarning
+});
+module.exports = __toCommonJS(stderr_exports);
+const stderr = process.stderr;
+function writeErrorLine(text = "") {
+  stderr.write(`${text}
+`);
+}
+function writeError(text) {
+  stderr.write(text);
+}
+function clearLine() {
+  if (stderr.isTTY) {
+    stderr.cursorTo(0);
+    stderr.clearLine(0);
+  }
+}
+function cursorTo(x, y) {
+  if (stderr.isTTY) {
+    stderr.cursorTo(x, y);
+  }
+}
+function isTTY() {
+  return stderr.isTTY || false;
+}
+function getColumns() {
+  return stderr.columns || 80;
+}
+function getRows() {
+  return stderr.rows || 24;
+}
+function writeWarning(message, prefix = "Warning") {
+  const formatted = `${prefix}: ${message}`;
+  writeErrorLine(formatted);
+}
+function writeErrorFormatted(message, prefix = "Error") {
+  const formatted = `${prefix}: ${message}`;
+  writeErrorLine(formatted);
+}
+function writeStackTrace(error) {
+  if (error.stack) {
+    writeErrorLine(error.stack);
+  } else {
+    writeErrorFormatted(error.message);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearLine,
+  cursorTo,
+  getColumns,
+  getRows,
+  isTTY,
+  stderr,
+  writeError,
+  writeErrorFormatted,
+  writeErrorLine,
+  writeStackTrace,
+  writeWarning
+});
 //# sourceMappingURL=stderr.js.map

package/dist/stdio/stderr.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/stderr.ts"],
   "sourcesContent": ["/**\n * @fileoverview Standard error stream utilities.\n * Provides utilities for writing to stderr with formatting and control.\n */\n\n// Get the actual stderr stream\nconst stderr: NodeJS.WriteStream = process.stderr\n\n/**\n * Write a line to stderr with trailing newline.\n * Used for error messages, warnings, and diagnostic output.\n *\n * @param text - Text to write\n * @default text ''\n *\n * @example\n * ```ts\n * writeErrorLine('Error: File not found')\n * writeErrorLine() // Write empty line\n * ```\n */\nexport function writeErrorLine(text: string = ''): void {\n  stderr.write(`${text}\\n`)\n}\n\n/**\n * Write text to stderr without adding a newline.\n *\n * @param text - Text to write\n *\n * @example\n * ```ts\n * writeError('Downloading...')\n * // Later update progress\n * ```\n */\nexport function writeError(text: string): void {\n  stderr.write(text)\n}\n\n/**\n * Clear the current line on stderr.\n * Only works in TTY environments.\n *\n * @example\n * ```ts\n * writeError('Processing...')\n * clearLine()\n * writeError('Done!')\n * ```\n */\nexport function clearLine(): void {\n  if (stderr.isTTY) {\n    stderr.cursorTo(0)\n    stderr.clearLine(0)\n  }\n}\n\n/**\n * Move cursor to specific position on stderr.\n * Only works in TTY environments.\n *\n * @param x - Column position (0-based)\n * @param y - Row position (0-based, optional)\n *\n * @example\n * ```ts\n * cursorTo(0) // Move to start of line\n * cursorTo(10, 5) // Move to column 10, row 5\n * ```\n */\nexport function cursorTo(x: number, y?: number | undefined): void {\n  if (stderr.isTTY) {\n    stderr.cursorTo(x, y)\n  }\n}\n\n/**\n * Check if stderr is connected to a TTY (terminal).\n *\n * @returns `true` if stderr is a TTY, `false` if piped/redirected\n *\n * @example\n * ```ts\n * if (isTTY()) {\n *   // Show colored error messages\n * } else {\n *   // Use plain text\n * }\n * ```\n */\nexport function isTTY(): boolean {\n  return stderr.isTTY || false\n}\n\n/**\n * Get the number of columns (width) in the terminal.\n *\n * @returns Terminal width in characters\n * @default 80\n *\n * @example\n * ```ts\n * const width = getColumns()\n * console.error(`Terminal is ${width} characters wide`)\n * ```\n */\nexport function getColumns(): number {\n  return stderr.columns || 80\n}\n\n/**\n * Get the number of rows (height) in the terminal.\n *\n * @returns Terminal height in lines\n * @default 24\n *\n * @example\n * ```ts\n * const height = getRows()\n * console.error(`Terminal is ${height} lines tall`)\n * ```\n */\nexport function getRows(): number {\n  return stderr.rows || 24\n}\n\n/**\n * Write a formatted warning message to stderr.\n *\n * @param message - Warning message text\n * @param prefix - Prefix label for the warning\n * @default prefix 'Warning'\n *\n * @example\n * ```ts\n * writeWarning('Deprecated API usage')\n * // Output: 'Warning: Deprecated API usage'\n *\n * writeWarning('Invalid config', 'Config')\n * // Output: 'Config: Invalid config'\n * ```\n */\nexport function writeWarning(\n  message: string,\n  prefix: string = 'Warning',\n): void {\n  const formatted = `${prefix}: ${message}`\n  writeErrorLine(formatted)\n}\n\n/**\n * Write a formatted error message to stderr.\n *\n * @param message - Error message text\n * @param prefix - Prefix label for the error\n * @default prefix 'Error'\n *\n * @example\n * ```ts\n * writeErrorFormatted('File not found')\n * // Output: 'Error: File not found'\n *\n * writeErrorFormatted('Connection failed', 'Network')\n * // Output: 'Network: Connection failed'\n * ```\n */\nexport function writeErrorFormatted(\n  message: string,\n  prefix: string = 'Error',\n): void {\n  const formatted = `${prefix}: ${message}`\n  writeErrorLine(formatted)\n}\n\n/**\n * Write an error's stack trace to stderr.\n * Falls back to formatted error message if no stack is available.\n *\n * @param error - Error object to write\n *\n * @example\n * ```ts\n * try {\n *   throw new Error('Something went wrong')\n * } catch (err) {\n *   writeStackTrace(err as Error)\n * }\n * ```\n */\nexport function writeStackTrace(error: Error): void {\n  if (error.stack) {\n    writeErrorLine(error.stack)\n  } else {\n    writeErrorFormatted(error.message)\n  }\n}\n\n// Export the raw stream for advanced usage\nexport { stderr }\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,aAAAC,EAAA,eAAAC,EAAA,YAAAC,EAAA,UAAAC,EAAA,WAAAC,EAAA,eAAAC,EAAA,wBAAAC,EAAA,mBAAAC,EAAA,oBAAAC,EAAA,iBAAAC,IAAA,eAAAC,EAAAb,GAMA,MAAMO,EAA6B,QAAQ,OAepC,SAASG,EAAeI,EAAe,GAAU,CACtDP,EAAO,MAAM,GAAGO,CAAI;AAAA,CAAI,CAC1B,CAaO,SAASN,EAAWM,EAAoB,CAC7CP,EAAO,MAAMO,CAAI,CACnB,CAaO,SAASZ,GAAkB,CAC5BK,EAAO,QACTA,EAAO,SAAS,CAAC,EACjBA,EAAO,UAAU,CAAC,EAEtB,CAeO,SAASJ,EAASY,EAAWC,EAA8B,CAC5DT,EAAO,OACTA,EAAO,SAASQ,EAAGC,CAAC,CAExB,CAgBO,SAASV,GAAiB,CAC/B,OAAOC,EAAO,OAAS,EACzB,CAcO,SAASH,GAAqB,CACnC,OAAOG,EAAO,SAAW,EAC3B,CAcO,SAASF,GAAkB,CAChC,OAAOE,EAAO,MAAQ,EACxB,CAkBO,SAASK,EACdK,EACAC,EAAiB,UACX,CACN,MAAMC,EAAY,GAAGD,CAAM,KAAKD,CAAO,GACvCP,EAAeS,CAAS,CAC1B,CAkBO,SAASV,EACdQ,EACAC,EAAiB,QACX,CACN,MAAMC,EAAY,GAAGD,CAAM,KAAKD,CAAO,GACvCP,EAAeS,CAAS,CAC1B,CAiBO,SAASR,EAAgBS,EAAoB,CAC9CA,EAAM,MACRV,EAAeU,EAAM,KAAK,EAE1BX,EAAoBW,EAAM,OAAO,CAErC",
-  "names": ["stderr_exports", "__export", "clearLine", "cursorTo", "getColumns", "getRows", "isTTY", "stderr", "writeError", "writeErrorFormatted", "writeErrorLine", "writeStackTrace", "writeWarning", "__toCommonJS", "text", "x", "y", "message", "prefix", "formatted", "error"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,MAAM,SAA6B,QAAQ;AAepC,SAAS,eAAe,OAAe,IAAU;AACtD,SAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAC1B;AAaO,SAAS,WAAW,MAAoB;AAC7C,SAAO,MAAM,IAAI;AACnB;AAaO,SAAS,YAAkB;AAChC,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,CAAC;AACjB,WAAO,UAAU,CAAC;AAAA,EACpB;AACF;AAeO,SAAS,SAAS,GAAW,GAA8B;AAChE,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,GAAG,CAAC;AAAA,EACtB;AACF;AAgBO,SAAS,QAAiB;AAC/B,SAAO,OAAO,SAAS;AACzB;AAcO,SAAS,aAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAcO,SAAS,UAAkB;AAChC,SAAO,OAAO,QAAQ;AACxB;AAkBO,SAAS,aACd,SACA,SAAiB,WACX;AACN,QAAM,YAAY,GAAG,MAAM,KAAK,OAAO;AACvC,iBAAe,SAAS;AAC1B;AAkBO,SAAS,oBACd,SACA,SAAiB,SACX;AACN,QAAM,YAAY,GAAG,MAAM,KAAK,OAAO;AACvC,iBAAe,SAAS;AAC1B;AAiBO,SAAS,gBAAgB,OAAoB;AAClD,MAAI,MAAM,OAAO;AACf,mBAAe,MAAM,KAAK;AAAA,EAC5B,OAAO;AACL,wBAAoB,MAAM,OAAO;AAAA,EACnC;AACF;",
+  "names": []
 }