@socketsecurity/lib 0.0.0 → 1.0.1

package/dist/stdio/progress.js

@@ -0,0 +1,171 @@
+/* Socket Lib - Built with esbuild */
+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;
+  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 and redraw bar.
+   */
+  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 amount.
+   */
+  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.
+   */
+  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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/stdio/progress.ts"],
+  "sourcesContent": ["/**\n * 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  width?: number\n  // Template: ':bar :percent :current/:total :eta'.\n  format?: string\n  complete?: string\n  incomplete?: string\n  head?: string\n  clear?: boolean\n  renderThrottle?: number\n  stream?: NodeJS.WriteStream\n  color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta'\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  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 and redraw bar.\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 amount.\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.\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 bar.\n */\nexport function createProgressIndicator(\n  current: number,\n  total: number,\n  label?: string,\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": ["colors"]
+}

package/dist/stdio/prompts.d.ts

@@ -0,0 +1,46 @@
+// Type definitions
+export interface Choice<Value = unknown> {
+    value: Value;
+    disabled?: boolean | string | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    short?: string | undefined;
+}
+// Duplicated from @inquirer/type - InquirerContext
+// This is the minimal context interface used by Inquirer prompts
+interface InquirerContext {
+    signal?: AbortSignal | undefined;
+    input?: NodeJS.ReadableStream | undefined;
+    output?: NodeJS.WritableStream | undefined;
+    clearPromptOnDone?: boolean | undefined;
+}
+export type Context = import('../objects').Remap<InquirerContext & {
+    spinner?: import('../spinner').Spinner | undefined;
+}>;
+// Duplicated from @inquirer/select - Separator
+// A separator object used in select/checkbox prompts to create visual separators
+// This type definition ensures the Separator type is available in published packages
+declare class SeparatorType {
+    readonly separator: string;
+    readonly type: 'separator';
+    constructor(separator?: string);
+}
+export type Separator = SeparatorType;
+/**
+ * Wrap an inquirer prompt with spinner handling and signal injection.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function wrapPrompt<T = unknown>(inquirerPrompt: (...args: unknown[]) => Promise<T>): (...args: unknown[]) => Promise<T | undefined>;
+declare const confirmRaw: any;
+declare const inputRaw: any;
+declare const passwordRaw: any;
+declare const searchRaw: any;
+declare const selectRaw: any;
+declare const ActualSeparator: any;
+// c8 ignore stop
+export declare const confirm: typeof confirmRaw;
+export declare const input: typeof inputRaw;
+export declare const password: typeof passwordRaw;
+export declare const search: typeof searchRaw;
+export declare const select: typeof selectRaw;
+export { ActualSeparator as Separator };

package/dist/stdio/prompts.js

@@ -0,0 +1,90 @@
+/* Socket Lib - Built with esbuild */
+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

@@ -0,0 +1,7 @@
+{
+  "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\nexport interface Choice<Value = unknown> {\n  value: Value\n  disabled?: boolean | string | undefined\n  description?: string | undefined\n  name?: string | undefined\n  short?: string | undefined\n}\n\n// Duplicated from @inquirer/type - InquirerContext\n// This is the minimal context interface used by Inquirer prompts\ninterface InquirerContext {\n  signal?: AbortSignal | undefined\n  input?: NodeJS.ReadableStream | undefined\n  output?: NodeJS.WritableStream | undefined\n  clearPromptOnDone?: boolean | undefined\n}\n\nexport type Context = import('../objects').Remap<\n  InquirerContext & {\n    spinner?: import('../spinner').Spinner | undefined\n  }\n>\n\n// Duplicated from @inquirer/select - Separator\n// A separator object used in select/checkbox prompts to create visual separators\n// This type definition ensures the Separator type is available in published packages\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 */\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\nexport const confirm: typeof confirmRaw = wrapPrompt(confirmRaw)\nexport const input: typeof inputRaw = wrapPrompt(inputRaw)\nexport const password: typeof passwordRaw = wrapPrompt(passwordRaw)\nexport const search: typeof searchRaw = wrapPrompt(searchRaw)\nexport const select: typeof selectRaw = wrapPrompt(selectRaw)\nexport { ActualSeparator as Separator }\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA2C;AAE3C,MAAM,kBAAc,+BAAe;AACnC,MAAM,cAAU,2BAAW;AAAA;AA0CpB,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,kCAAkC;AAC9E,MAAM,cAA4B,QAAQ,gCAAgC;AAC1E,MAAM,iBAA+B,QAAQ,mCAAmC;AAChF,MAAM,eAA6B,QAAQ,iCAAiC;AAC5E,MAAM,eAA6B,QAAQ,iCAAiC;AAC5E,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;AAG9B,MAAM,UAA6B,2BAAW,UAAU;AACxD,MAAM,QAAyB,2BAAW,QAAQ;AAClD,MAAM,WAA+B,2BAAW,WAAW;AAC3D,MAAM,SAA2B,2BAAW,SAAS;AACrD,MAAM,SAA2B,2BAAW,SAAS;",
+  "names": []
+}

package/dist/stdio/stderr.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Standard error stream utilities.
+ * Provides utilities for writing to stderr with formatting and control.
+ */
+// Get the actual stderr stream
+declare const stderr: NodeJS.WriteStream;
+/**
+ * Write an error line to stderr.
+ */
+export declare function writeErrorLine(text?: string): void;
+/**
+ * Write error text to stderr without newline.
+ */
+export declare function writeError(text: string): void;
+/**
+ * Clear the current line on stderr.
+ */
+export declare function clearLine(): void;
+/**
+ * Move cursor to position on stderr.
+ */
+export declare function cursorTo(x: number, y?: number): void;
+/**
+ * Check if stderr is a TTY.
+ */
+export declare function isTTY(): boolean;
+/**
+ * Get terminal columns for stderr.
+ */
+export declare function getColumns(): number;
+/**
+ * Get terminal rows for stderr.
+ */
+export declare function getRows(): number;
+/**
+ * Write a warning to stderr with formatting.
+ */
+export declare function writeWarning(message: string, prefix?: string): void;
+/**
+ * Write an error to stderr with formatting.
+ */
+export declare function writeErrorFormatted(message: string, prefix?: string): void;
+/**
+ * Write stack trace to stderr.
+ */
+export declare function writeStackTrace(error: Error): void;
+// Export the raw stream for advanced usage
+export { stderr };

package/dist/stdio/stderr.js

@@ -0,0 +1,91 @@
+/* Socket Lib - Built with esbuild */
+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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/stdio/stderr.ts"],
+  "sourcesContent": ["/**\n * 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 an error line to stderr.\n */\nexport function writeErrorLine(text: string = ''): void {\n  stderr.write(`${text}\\n`)\n}\n\n/**\n * Write error text to stderr without newline.\n */\nexport function writeError(text: string): void {\n  stderr.write(text)\n}\n\n/**\n * Clear the current line on stderr.\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 position on stderr.\n */\nexport function cursorTo(x: number, y?: number): void {\n  if (stderr.isTTY) {\n    stderr.cursorTo(x, y)\n  }\n}\n\n/**\n * Check if stderr is a TTY.\n */\nexport function isTTY(): boolean {\n  return stderr.isTTY || false\n}\n\n/**\n * Get terminal columns for stderr.\n */\nexport function getColumns(): number {\n  return stderr.columns || 80\n}\n\n/**\n * Get terminal rows for stderr.\n */\nexport function getRows(): number {\n  return stderr.rows || 24\n}\n\n/**\n * Write a warning to stderr with formatting.\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 an error to stderr with formatting.\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 stack trace to stderr.\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": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,MAAM,SAA6B,QAAQ;AAKpC,SAAS,eAAe,OAAe,IAAU;AACtD,SAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAC1B;AAKO,SAAS,WAAW,MAAoB;AAC7C,SAAO,MAAM,IAAI;AACnB;AAKO,SAAS,YAAkB;AAChC,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,CAAC;AACjB,WAAO,UAAU,CAAC;AAAA,EACpB;AACF;AAKO,SAAS,SAAS,GAAW,GAAkB;AACpD,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,GAAG,CAAC;AAAA,EACtB;AACF;AAKO,SAAS,QAAiB;AAC/B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,aAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAKO,SAAS,UAAkB;AAChC,SAAO,OAAO,QAAQ;AACxB;AAKO,SAAS,aACd,SACA,SAAiB,WACX;AACN,QAAM,YAAY,GAAG,MAAM,KAAK,OAAO;AACvC,iBAAe,SAAS;AAC1B;AAKO,SAAS,oBACd,SACA,SAAiB,SACX;AACN,QAAM,YAAY,GAAG,MAAM,KAAK,OAAO;AACvC,iBAAe,SAAS;AAC1B;AAKO,SAAS,gBAAgB,OAAoB;AAClD,MAAI,MAAM,OAAO;AACf,mBAAe,MAAM,KAAK;AAAA,EAC5B,OAAO;AACL,wBAAoB,MAAM,OAAO;AAAA,EACnC;AACF;",
+  "names": []
+}

package/dist/stdio/stdout.d.ts

@@ -0,0 +1,48 @@
+// Get the actual stdout stream
+declare const stdout: NodeJS.WriteStream;
+/**
+ * Write a line to stdout.
+ */
+export declare function writeLine(text?: string): void;
+/**
+ * Write text to stdout without newline.
+ */
+export declare function write(text: string): void;
+/**
+ * Clear the current line on stdout.
+ */
+export declare function clearLine(): void;
+/**
+ * Move cursor to position on stdout.
+ */
+export declare function cursorTo(x: number, y?: number): void;
+/**
+ * Clear screen from cursor down.
+ */
+export declare function clearScreenDown(): void;
+/**
+ * Check if stdout is a TTY.
+ */
+export declare function isTTY(): boolean;
+/**
+ * Get terminal columns for stdout.
+ */
+export declare function getColumns(): number;
+/**
+ * Get terminal rows for stdout.
+ */
+export declare function getRows(): number;
+/**
+ * Hide cursor on stdout.
+ */
+export declare function hideCursor(): void;
+/**
+ * Show cursor on stdout.
+ */
+export declare function showCursor(): void;
+/**
+ * Ensure cursor is shown on exit.
+ */
+export declare function ensureCursorOnExit(): void;
+// Export the raw stream for advanced usage
+export { stdout };

package/dist/stdio/stdout.js

@@ -0,0 +1,105 @@
+/* Socket Lib - Built with esbuild */
+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 stdout_exports = {};
+__export(stdout_exports, {
+  clearLine: () => clearLine,
+  clearScreenDown: () => clearScreenDown,
+  cursorTo: () => cursorTo,
+  ensureCursorOnExit: () => ensureCursorOnExit,
+  getColumns: () => getColumns,
+  getRows: () => getRows,
+  hideCursor: () => hideCursor,
+  isTTY: () => isTTY,
+  showCursor: () => showCursor,
+  stdout: () => stdout,
+  write: () => write,
+  writeLine: () => writeLine
+});
+module.exports = __toCommonJS(stdout_exports);
+var import_node_tty = require("node:tty");
+const stdout = process.stdout;
+function writeLine(text = "") {
+  stdout.write(`${text}
+`);
+}
+function write(text) {
+  stdout.write(text);
+}
+function clearLine() {
+  if (stdout.isTTY) {
+    stdout.cursorTo(0);
+    stdout.clearLine(0);
+  }
+}
+function cursorTo(x, y) {
+  if (stdout.isTTY) {
+    stdout.cursorTo(x, y);
+  }
+}
+function clearScreenDown() {
+  if (stdout.isTTY) {
+    stdout.clearScreenDown();
+  }
+}
+function isTTY() {
+  return stdout.isTTY || false;
+}
+function getColumns() {
+  return stdout.columns || 80;
+}
+function getRows() {
+  return stdout.rows || 24;
+}
+function hideCursor() {
+  if (stdout.isTTY && stdout instanceof import_node_tty.WriteStream) {
+    stdout.write("\x1B[?25l");
+  }
+}
+function showCursor() {
+  if (stdout.isTTY && stdout instanceof import_node_tty.WriteStream) {
+    stdout.write("\x1B[?25h");
+  }
+}
+function ensureCursorOnExit() {
+  process.on("exit", showCursor);
+  process.on("SIGINT", () => {
+    showCursor();
+    process.exit(130);
+  });
+  process.on("SIGTERM", () => {
+    showCursor();
+    process.exit(143);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearLine,
+  clearScreenDown,
+  cursorTo,
+  ensureCursorOnExit,
+  getColumns,
+  getRows,
+  hideCursor,
+  isTTY,
+  showCursor,
+  stdout,
+  write,
+  writeLine
+});
+//# sourceMappingURL=stdout.js.map

package/dist/stdio/stdout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/stdio/stdout.ts"],
+  "sourcesContent": ["/**\n * Standard output stream utilities.\n * Provides utilities for writing to stdout with formatting and control.\n */\n\nimport { WriteStream } from 'node:tty'\n\n// Get the actual stdout stream\nconst stdout: NodeJS.WriteStream = process.stdout\n\n/**\n * Write a line to stdout.\n */\nexport function writeLine(text: string = ''): void {\n  stdout.write(`${text}\\n`)\n}\n\n/**\n * Write text to stdout without newline.\n */\nexport function write(text: string): void {\n  stdout.write(text)\n}\n\n/**\n * Clear the current line on stdout.\n */\nexport function clearLine(): void {\n  if (stdout.isTTY) {\n    stdout.cursorTo(0)\n    stdout.clearLine(0)\n  }\n}\n\n/**\n * Move cursor to position on stdout.\n */\nexport function cursorTo(x: number, y?: number): void {\n  if (stdout.isTTY) {\n    stdout.cursorTo(x, y)\n  }\n}\n\n/**\n * Clear screen from cursor down.\n */\nexport function clearScreenDown(): void {\n  if (stdout.isTTY) {\n    stdout.clearScreenDown()\n  }\n}\n\n/**\n * Check if stdout is a TTY.\n */\nexport function isTTY(): boolean {\n  return stdout.isTTY || false\n}\n\n/**\n * Get terminal columns for stdout.\n */\nexport function getColumns(): number {\n  return stdout.columns || 80\n}\n\n/**\n * Get terminal rows for stdout.\n */\nexport function getRows(): number {\n  return stdout.rows || 24\n}\n\n/**\n * Hide cursor on stdout.\n */\nexport function hideCursor(): void {\n  if (stdout.isTTY && stdout instanceof WriteStream) {\n    stdout.write('\\u001B[?25l')\n  }\n}\n\n/**\n * Show cursor on stdout.\n */\nexport function showCursor(): void {\n  if (stdout.isTTY && stdout instanceof WriteStream) {\n    stdout.write('\\u001B[?25h')\n  }\n}\n\n/**\n * Ensure cursor is shown on exit.\n */\nexport function ensureCursorOnExit(): void {\n  process.on('exit', showCursor)\n  process.on('SIGINT', () => {\n    showCursor()\n    // eslint-disable-next-line n/no-process-exit\n    process.exit(130)\n  })\n  process.on('SIGTERM', () => {\n    showCursor()\n    // eslint-disable-next-line n/no-process-exit\n    process.exit(143)\n  })\n}\n\n// Export the raw stream for advanced usage\nexport { stdout }\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,sBAA4B;AAG5B,MAAM,SAA6B,QAAQ;AAKpC,SAAS,UAAU,OAAe,IAAU;AACjD,SAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAC1B;AAKO,SAAS,MAAM,MAAoB;AACxC,SAAO,MAAM,IAAI;AACnB;AAKO,SAAS,YAAkB;AAChC,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,CAAC;AACjB,WAAO,UAAU,CAAC;AAAA,EACpB;AACF;AAKO,SAAS,SAAS,GAAW,GAAkB;AACpD,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,GAAG,CAAC;AAAA,EACtB;AACF;AAKO,SAAS,kBAAwB;AACtC,MAAI,OAAO,OAAO;AAChB,WAAO,gBAAgB;AAAA,EACzB;AACF;AAKO,SAAS,QAAiB;AAC/B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,aAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAKO,SAAS,UAAkB;AAChC,SAAO,OAAO,QAAQ;AACxB;AAKO,SAAS,aAAmB;AACjC,MAAI,OAAO,SAAS,kBAAkB,6BAAa;AACjD,WAAO,MAAM,WAAa;AAAA,EAC5B;AACF;AAKO,SAAS,aAAmB;AACjC,MAAI,OAAO,SAAS,kBAAkB,6BAAa;AACjD,WAAO,MAAM,WAAa;AAAA,EAC5B;AACF;AAKO,SAAS,qBAA2B;AACzC,UAAQ,GAAG,QAAQ,UAAU;AAC7B,UAAQ,GAAG,UAAU,MAAM;AACzB,eAAW;AAEX,YAAQ,KAAK,GAAG;AAAA,EAClB,CAAC;AACD,UAAQ,GAAG,WAAW,MAAM;AAC1B,eAAW;AAEX,YAAQ,KAAK,GAAG;AAAA,EAClB,CAAC;AACH;",
+  "names": []
+}