@socketsecurity/lib 5.18.2 → 5.19.1

package/dist/stdio/divider.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console divider and separator utilities.
+ * Provides various line styles for visual separation in CLI output.
+ */
 export interface DividerOptions {
     /**
      * Width of the divider line in characters.
@@ -30,18 +34,6 @@ export interface DividerOptions {
  * ```
  */
 export declare function divider(options?: DividerOptions): string;
-/**
- * Print a divider line directly to console.
- *
- * @param options - Divider formatting options
- *
- * @example
- * ```ts
- * printDivider() // Prints default divider
- * printDivider({ char: '─', width: 60 })
- * ```
- */
-export declare function printDivider(options?: DividerOptions): void;
 /**
  * Common divider style presets.
  * Provides quick access to popular divider styles.
@@ -75,6 +67,42 @@ export declare const dividers: {
     /** Arrow divider using `→` */
     readonly arrow: () => string;
 };
+/**
+ * Print a divider line directly to console.
+ *
+ * @param options - Divider formatting options
+ *
+ * @example
+ * ```ts
+ * printDivider() // Prints default divider
+ * printDivider({ char: '─', width: 60 })
+ * ```
+ */
+export declare function printDivider(options?: DividerOptions): void;
+/**
+ * Print a dotted divider line.
+ * Convenience function using `·` character.
+ *
+ * @example
+ * ```ts
+ * printDottedDivider()
+ * // ·······················································
+ * ```
+ */
+export declare function printDottedDivider(): void;
+/**
+ * Print a section break with spacing directly to console.
+ *
+ * @param options - Divider formatting options
+ *
+ * @example
+ * ```ts
+ * console.log('Previous section')
+ * printSectionBreak()
+ * console.log('Next section')
+ * ```
+ */
+export declare function printSectionBreak(options?: DividerOptions): void;
 /**
  * Print a thick divider line (default style).
  * Convenience function using `═` character.
@@ -97,17 +125,6 @@ export declare function printThickDivider(): void;
  * ```
  */
 export declare function printThinDivider(): void;
-/**
- * Print a dotted divider line.
- * Convenience function using `·` character.
- *
- * @example
- * ```ts
- * printDottedDivider()
- * // ·······················································
- * ```
- */
-export declare function printDottedDivider(): void;
 /**
  * Create a section break with blank lines before and after the divider.
  * Useful for creating visual separation between major sections.
@@ -129,16 +146,3 @@ export declare function printDottedDivider(): void;
  * ```
  */
 export declare function sectionBreak(options?: DividerOptions): string;
-/**
- * Print a section break with spacing directly to console.
- *
- * @param options - Divider formatting options
- *
- * @example
- * ```ts
- * console.log('Previous section')
- * printSectionBreak()
- * console.log('Next section')
- * ```
- */
-export declare function printSectionBreak(options?: DividerOptions): void;

package/dist/stdio/divider.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -35,9 +36,6 @@ function divider(options) {
   const { char = "\u2550", width = 55 } = opts;
   return (0, import_strings.repeatString)(char, width);
 }
-function printDivider(options) {
-  console.log(divider(options));
-}
 const dividers = {
   /** Thick double-line divider using `═` */
   thick: () => divider({ char: "\u2550" }),
@@ -60,24 +58,27 @@ const dividers = {
   /** Arrow divider using `→` */
   arrow: () => divider({ char: "\u2192" })
 };
+function printDivider(options) {
+  console.log(divider(options));
+}
+function printDottedDivider() {
+  printDivider({ char: "\xB7" });
+}
+function printSectionBreak(options) {
+  console.log(sectionBreak(options));
+}
 function printThickDivider() {
   printDivider({ char: "\u2550" });
 }
 function printThinDivider() {
   printDivider({ char: "\u2500" });
 }
-function printDottedDivider() {
-  printDivider({ char: "\xB7" });
-}
 function sectionBreak(options) {
   const div = divider(options);
   return `
 ${div}
 `;
 }
-function printSectionBreak(options) {
-  console.log(sectionBreak(options));
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   divider,

package/dist/stdio/footer.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console footer/summary formatting utilities.
+ * Provides consistent footer and summary formatting for CLI applications.
+ */
 export interface FooterOptions {
     /**
      * Width of the footer border in characters.
@@ -90,3 +94,19 @@ export declare function createFooter(message?: string | undefined, options?: Foo
  * ```
  */
 export declare function createSummaryFooter(stats: SummaryStats, options?: FooterOptions): string;
+/**
+ * Print a footer with optional success message.
+ * Uses `─` border character for a lighter appearance.
+ * Fixed width of 55 characters to match `printHeader()`.
+ *
+ * @param message - Optional message to display (shown in green)
+ *
+ * @example
+ * ```ts
+ * printFooter('Analysis complete')
+ * // Output:
+ * // ───────────────────────────────────────────────────
+ * // Analysis complete (in green)
+ * ```
+ */
+export declare function printFooter(message?: string | undefined): void;

package/dist/stdio/footer.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -30,7 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var footer_exports = {};
 __export(footer_exports, {
   createFooter: () => createFooter,
-  createSummaryFooter: () => createSummaryFooter
+  createSummaryFooter: () => createSummaryFooter,
+  printFooter: () => printFooter
 });
 module.exports = __toCommonJS(footer_exports);
 var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
@@ -89,8 +91,16 @@ function createSummaryFooter(stats, options) {
     ...stats.duration !== void 0 && { startTime: stats.duration }
   });
 }
+function printFooter(message) {
+  const border = (0, import_strings.repeatString)("\u2500", 55);
+  console.log(border);
+  if (message) {
+    console.log(import_yoctocolors_cjs.default.green(message));
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createFooter,
-  createSummaryFooter
+  createSummaryFooter,
+  printFooter
 });

package/dist/stdio/header.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console header/banner formatting utilities.
+ * Provides consistent header formatting for CLI applications.
+ */
 export interface HeaderOptions {
     /**
      * Width of the header in characters.
@@ -88,19 +92,3 @@ export declare function createSectionHeader(title: string, options?: HeaderOptio
  * ```
  */
 export declare function printHeader(title: string): void;
-/**
- * Print a footer with optional success message.
- * Uses `─` border character for a lighter appearance.
- * Fixed width of 55 characters to match `printHeader()`.
- *
- * @param message - Optional message to display (shown in green)
- *
- * @example
- * ```ts
- * printFooter('Analysis complete')
- * // Output:
- * // ───────────────────────────────────────────────────
- * // Analysis complete (in green)
- * ```
- */
-export declare function printFooter(message?: string | undefined): void;

package/dist/stdio/header.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -31,7 +32,6 @@ var header_exports = {};
 __export(header_exports, {
   createHeader: () => createHeader,
   createSectionHeader: () => createSectionHeader,
-  printFooter: () => printFooter,
   printHeader: () => printHeader
 });
 module.exports = __toCommonJS(header_exports);
@@ -86,17 +86,9 @@ function printHeader(title) {
   console.log(`  ${title}`);
   console.log(border);
 }
-function printFooter(message) {
-  const border = (0, import_strings.repeatString)("\u2500", 55);
-  console.log(border);
-  if (message) {
-    console.log(import_yoctocolors_cjs.default.green(message));
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createHeader,
   createSectionHeader,
-  printFooter,
   printHeader
 });

package/dist/stdio/progress.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Progress bar utilities for CLI applications.
+ * Provides various progress indicators including bars, percentages, and spinners.
+ */
 export interface ProgressBarOptions {
     /**
      * Width of the progress bar in characters.

package/dist/stdio/progress.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -97,7 +98,7 @@ class ProgressBar {
     }
     this.current = Math.min(current, this.total);
     const now = Date.now();
-    if (now - this.lastRender < this.options.renderThrottle && this.current < this.total) {
+    if (now - this.lastRender < (this.options.renderThrottle ?? 16) && this.current < this.total) {
       return;
     }
     this.lastRender = now;
@@ -128,17 +129,21 @@ class ProgressBar {
    * Render the progress bar.
    */
   render(tokens) {
-    const colorFn = import_yoctocolors_cjs.default[this.options.color] || ((s) => s);
+    const colorName = this.options.color ?? "cyan";
+    const colorFn = import_yoctocolors_cjs.default[colorName] || ((s) => s);
     const percent = this.total === 0 ? 0 : 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 = this.total === 0 ? 0 : 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 availableWidth = this.options.width ?? 40;
+    const filledWidth = this.total === 0 ? 0 : Math.min(
+      availableWidth,
+      Math.floor(this.current / this.total * availableWidth)
+    );
+    const emptyWidth = Math.max(0, availableWidth - filledWidth);
+    const filled = (0, import_strings.repeatString)(this.options.complete ?? "\u2588", filledWidth);
+    const empty = (0, import_strings.repeatString)(this.options.incomplete ?? "\u2591", emptyWidth);
     const bar = colorFn(filled) + empty;
-    let output = this.options.format;
+    let output = this.options.format ?? ":bar :percent :current/:total";
     output = output.replace(":bar", bar);
     output = output.replace(":percent", `${percent}%`);
     output = output.replace(":current", String(this.current));

package/dist/stdio/prompts.d.ts

@@ -1,14 +1,16 @@
+/**
+ * @fileoverview User prompt utilities for interactive scripts.
+ * Provides inquirer.js integration with spinner support, context handling, and theming.
+ */
 import checkboxRaw from '../external/@inquirer/checkbox';
 import confirmRaw from '../external/@inquirer/confirm';
 import inputRaw from '../external/@inquirer/input';
 import passwordRaw from '../external/@inquirer/password';
 import { type ThemeName } from '../themes/themes';
 import type { Theme } from '../themes/types';
-// Modules imported at the top - extract default and Separator
 declare const searchRaw: any;
 declare const selectRaw: any;
 declare const ActualSeparator: any;
-// Type definitions
 /**
  * Choice option for select and search prompts.
  *
@@ -91,6 +93,26 @@ export type Separator = SeparatorType;
  * ```
  */
 export declare function createInquirerTheme(theme: Theme | ThemeName | unknown): Record<string, unknown>;
+/**
+ * Create a separator for select prompts.
+ * Creates a visual separator line in choice lists.
+ *
+ * @param text - Optional separator text (defaults to '───────')
+ * @returns Separator instance
+ *
+ * @example
+ * import { select, createSeparator } from '@socketsecurity/lib/stdio/prompts'
+ *
+ * const choice = await select({
+ *   message: 'Choose an option:',
+ *   choices: [
+ *     { name: 'Option 1', value: 1 },
+ *     createSeparator(),
+ *     { name: 'Option 2', value: 2 }
+ *   ]
+ * })
+ */
+export declare function createSeparator(text?: string): InstanceType<typeof ActualSeparator>;
 /**
  * Wrap an inquirer prompt with spinner handling, theme injection, and signal injection.
  * Automatically stops/starts spinners during prompt display, injects the current theme,
@@ -104,7 +126,6 @@ export declare function createInquirerTheme(theme: Theme | ThemeName | unknown):
  * const myPrompt = wrapPrompt(rawInquirerPrompt)
  * const result = await myPrompt({ message: 'Enter name:' })
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function wrapPrompt<T = unknown>(inquirerPrompt: (...args: unknown[]) => Promise<T>): (...args: unknown[]) => Promise<T | undefined>;
 /**
  * Prompt to select multiple items from a list of choices.
@@ -173,23 +194,3 @@ export declare const search: typeof searchRaw;
  */
 export declare const select: typeof selectRaw;
 export { ActualSeparator as Separator };
-/**
- * Create a separator for select prompts.
- * Creates a visual separator line in choice lists.
- *
- * @param text - Optional separator text (defaults to '───────')
- * @returns Separator instance
- *
- * @example
- * import { select, createSeparator } from '@socketsecurity/lib/stdio/prompts'
- *
- * const choice = await select({
- *   message: 'Choose an option:',
- *   choices: [
- *     { name: 'Option 1', value: 1 },
- *     createSeparator(),
- *     { name: 'Option 2', value: 2 }
- *   ]
- * })
- */
-export declare function createSeparator(text?: string): InstanceType<typeof ActualSeparator>;

package/dist/stdio/prompts.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -66,12 +67,12 @@ function applyColor(text, color) {
   const { 0: r, 1: g, 2: b } = color;
   return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
 }
-function resolveTheme(theme) {
-  return typeof theme === "string" ? import_themes.THEMES[theme] : theme;
-}
 function isSocketTheme(value) {
   return typeof value === "object" && value !== null && "name" in value && "colors" in value;
 }
+function resolveTheme(theme) {
+  return typeof theme === "string" ? import_themes.THEMES[theme] ?? import_themes.THEMES.socket : theme;
+}
 function createInquirerTheme(theme) {
   if (typeof theme === "string" || isSocketTheme(theme)) {
     const socketTheme = resolveTheme(theme);
@@ -113,6 +114,9 @@ function createInquirerTheme(theme) {
   }
   return theme;
 }
+function createSeparator(text) {
+  return new ActualSeparator(text);
+}
 // @__NO_SIDE_EFFECTS__
 function wrapPrompt(inquirerPrompt) {
   return async (...args) => {
@@ -122,10 +126,10 @@ function wrapPrompt(inquirerPrompt) {
     const signal = abortSignal;
     const config = args[0];
     if (config && typeof config === "object") {
-      if (!config.theme) {
-        config.theme = createInquirerTheme((0, import_context.getTheme)());
+      if (!config["theme"]) {
+        config["theme"] = createInquirerTheme((0, import_context.getTheme)());
       } else {
-        config.theme = createInquirerTheme(config.theme);
+        config["theme"] = createInquirerTheme(config["theme"]);
       }
     }
     if (origContext) {
@@ -158,9 +162,6 @@ const input = /* @__PURE__ */ wrapPrompt(import_input.default);
 const password = /* @__PURE__ */ wrapPrompt(import_password.default);
 const search = /* @__PURE__ */ wrapPrompt(searchRaw);
 const select = /* @__PURE__ */ wrapPrompt(selectRaw);
-function createSeparator(text) {
-  return new ActualSeparator(text);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Separator,

package/dist/stdio/stderr.d.ts

@@ -2,21 +2,7 @@
  * @fileoverview Standard error stream utilities.
  * Provides utilities for writing to stderr with formatting and control.
  */
-// Get the actual stderr stream
 declare const stderr: NodeJS.WriteStream;
-export declare function writeErrorLine(text?: string): void;
-/**
- * Write text to stderr without adding a newline.
- *
- * @param text - Text to write
- *
- * @example
- * ```ts
- * writeError('Downloading...')
- * // Later update progress
- * ```
- */
-export declare function writeError(text: string): void;
 /**
  * Clear the current line on stderr.
  * Only works in TTY environments.
@@ -43,21 +29,6 @@ export declare function clearLine(): void;
  * ```
  */
 export declare function cursorTo(x: number, y?: number | undefined): void;
-/**
- * Check if stderr is connected to a TTY (terminal).
- *
- * @returns `true` if stderr is a TTY, `false` if piped/redirected
- *
- * @example
- * ```ts
- * if (isTTY()) {
- *   // Show colored error messages
- * } else {
- *   // Use plain text
- * }
- * ```
- */
-export declare function isTTY(): boolean;
 /**
  * Get the number of columns (width) in the terminal.
  *
@@ -85,22 +56,32 @@ export declare function getColumns(): number;
  */
 export declare function getRows(): number;
 /**
- * Write a formatted warning message to stderr.
+ * Check if stderr is connected to a TTY (terminal).
  *
- * @param message - Warning message text
- * @param prefix - Prefix label for the warning
- * @default prefix 'Warning'
+ * @returns `true` if stderr is a TTY, `false` if piped/redirected
  *
  * @example
  * ```ts
- * writeWarning('Deprecated API usage')
- * // Output: 'Warning: Deprecated API usage'
+ * if (isTTY()) {
+ *   // Show colored error messages
+ * } else {
+ *   // Use plain text
+ * }
+ * ```
+ */
+export declare function isTTY(): boolean;
+/**
+ * Write text to stderr without adding a newline.
  *
- * writeWarning('Invalid config', 'Config')
- * // Output: 'Config: Invalid config'
+ * @param text - Text to write
+ *
+ * @example
+ * ```ts
+ * writeError('Downloading...')
+ * // Later update progress
  * ```
  */
-export declare function writeWarning(message: string, prefix?: string): void;
+export declare function writeError(text: string): void;
 /**
  * Write a formatted error message to stderr.
  *
@@ -118,6 +99,21 @@ export declare function writeWarning(message: string, prefix?: string): void;
  * ```
  */
 export declare function writeErrorFormatted(message: string, prefix?: string): void;
+/**
+ * Write a line to stderr with trailing newline.
+ * Used for error messages, warnings, and diagnostic output.
+ * Passing no argument writes an empty line.
+ *
+ * @param text - Text to write (defaults to the empty string)
+ * @default text ''
+ *
+ * @example
+ * ```ts
+ * writeErrorLine('Error: File not found')
+ * writeErrorLine() // Write empty line
+ * ```
+ */
+export declare function writeErrorLine(text?: string): void;
 /**
  * Write an error's stack trace to stderr.
  * Falls back to formatted error message if no stack is available.
@@ -134,5 +130,21 @@ export declare function writeErrorFormatted(message: string, prefix?: string): v
  * ```
  */
 export declare function writeStackTrace(error: Error): void;
-// Export the raw stream for advanced usage
+/**
+ * Write a formatted warning message to stderr.
+ *
+ * @param message - Warning message text
+ * @param prefix - Prefix label for the warning
+ * @default prefix 'Warning'
+ *
+ * @example
+ * ```ts
+ * writeWarning('Deprecated API usage')
+ * // Output: 'Warning: Deprecated API usage'
+ *
+ * writeWarning('Invalid config', 'Config')
+ * // Output: 'Config: Invalid config'
+ * ```
+ */
+export declare function writeWarning(message: string, prefix?: string): void;
 export { stderr };

package/dist/stdio/stderr.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -43,42 +44,34 @@ __export(stderr_exports, {
 });
 module.exports = __toCommonJS(stderr_exports);
 var import_node_process = __toESM(require("node:process"));
+var import_stream = require("./_stream");
 const stderr = import_node_process.default.stderr;
-function writeErrorLine(text = "") {
-  stderr.write(`${text}
-`);
-}
-function writeError(text) {
-  stderr.write(text);
-}
 function clearLine() {
-  if (stderr.isTTY) {
-    stderr.cursorTo(0);
-    stderr.clearLine(0);
-  }
+  (0, import_stream.clearLineOn)(stderr);
 }
 function cursorTo(x, y) {
-  if (stderr.isTTY) {
-    stderr.cursorTo(x, y);
-  }
-}
-function isTTY() {
-  return stderr.isTTY || false;
+  (0, import_stream.cursorToOn)(stderr, x, y);
 }
 function getColumns() {
-  return stderr.columns || 80;
+  return (0, import_stream.getColumnsOf)(stderr);
 }
 function getRows() {
-  return stderr.rows || 24;
+  return (0, import_stream.getRowsOf)(stderr);
 }
-function writeWarning(message, prefix = "Warning") {
-  const formatted = `${prefix}: ${message}`;
-  writeErrorLine(formatted);
+function isTTY() {
+  return (0, import_stream.isTTYOf)(stderr);
+}
+function writeError(text) {
+  stderr.write(text);
 }
 function writeErrorFormatted(message, prefix = "Error") {
   const formatted = `${prefix}: ${message}`;
   writeErrorLine(formatted);
 }
+function writeErrorLine(text = "") {
+  stderr.write(`${text}
+`);
+}
 function writeStackTrace(error) {
   if (error.stack) {
     writeErrorLine(error.stack);
@@ -86,6 +79,10 @@ function writeStackTrace(error) {
     writeErrorFormatted(error.message);
   }
 }
+function writeWarning(message, prefix = "Warning") {
+  const formatted = `${prefix}: ${message}`;
+  writeErrorLine(formatted);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearLine,