@socketsecurity/lib 6.0.3 → 6.0.5

package/dist/stdio/prompts.js

@@ -1,185 +1,261 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 prompts_exports = {};
-__export(prompts_exports, {
-  Separator: () => ActualSeparator,
-  applyColor: () => applyColor,
-  checkbox: () => checkbox,
-  confirm: () => confirm,
-  createInquirerTheme: () => createInquirerTheme,
-  createSeparator: () => createSeparator,
-  input: () => input,
-  isSocketTheme: () => isSocketTheme,
-  password: () => password,
-  resolveTheme: () => resolveTheme,
-  search: () => search,
-  select: () => select,
-  wrapPrompt: () => wrapPrompt
-});
-module.exports = __toCommonJS(prompts_exports);
-var import_abort = require("../process/abort");
-var import_checkbox = __toESM(require("../external/@inquirer/checkbox"));
-var import_confirm = __toESM(require("../external/@inquirer/confirm"));
-var import_input = __toESM(require("../external/@inquirer/input"));
-var import_password = __toESM(require("../external/@inquirer/password"));
-var searchModule = __toESM(require("../external/@inquirer/search"));
-var selectModuleImport = __toESM(require("../external/@inquirer/select"));
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_default = require("../spinner/default");
-var import_context = require("../themes/context");
-var import_themes = require("../themes/themes");
-var import_resolve = require("../themes/resolve");
-const abortSignal = (0, import_abort.getAbortSignal)();
-const spinner = (0, import_default.getDefaultSpinner)();
-const searchRaw = searchModule.default;
-const selectModule = selectModuleImport;
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_themes_themes = require('../themes/themes.js');
+const require_themes_context = require('../themes/context.js');
+const require_process_abort = require('../process/abort.js');
+const require_themes_resolve = require('../themes/resolve.js');
+const require_spinner_default = require('../spinner/default.js');
+let src_external_yoctocolors_cjs = require("../external/yoctocolors-cjs");
+src_external_yoctocolors_cjs = require_runtime.__toESM(src_external_yoctocolors_cjs);
+let src_external__inquirer_checkbox = require("../external/@inquirer/checkbox");
+src_external__inquirer_checkbox = require_runtime.__toESM(src_external__inquirer_checkbox);
+let src_external__inquirer_confirm = require("../external/@inquirer/confirm");
+src_external__inquirer_confirm = require_runtime.__toESM(src_external__inquirer_confirm);
+let src_external__inquirer_input = require("../external/@inquirer/input");
+src_external__inquirer_input = require_runtime.__toESM(src_external__inquirer_input);
+let src_external__inquirer_password = require("../external/@inquirer/password");
+src_external__inquirer_password = require_runtime.__toESM(src_external__inquirer_password);
+let src_external__inquirer_search = require("../external/@inquirer/search");
+src_external__inquirer_search = require_runtime.__toESM(src_external__inquirer_search);
+let src_external__inquirer_select = require("../external/@inquirer/select");
+src_external__inquirer_select = require_runtime.__toESM(src_external__inquirer_select);
+
+//#region src/stdio/prompts.ts
+/**
+* @file User prompt utilities for interactive scripts. Provides inquirer.js
+*   integration with spinner support, context handling, and theming.
+*/
+const abortSignal = require_process_abort.getAbortSignal();
+const spinner = require_spinner_default.getDefaultSpinner();
+const searchRaw = src_external__inquirer_search.default;
+const selectModule = src_external__inquirer_select;
 const selectRaw = selectModule.default;
 const ActualSeparator = selectModule.Separator;
+/**
+* Apply a color to text using yoctocolors. Handles both named colors and RGB
+* tuples.
+*
+* @private
+*/
 function applyColor(text, color) {
-  if (typeof color === "string") {
-    return import_yoctocolors_cjs.default[color](text);
-  }
-  const { 0: r, 1: g, 2: b } = color;
-  return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+	if (typeof color === "string") return src_external_yoctocolors_cjs.default[color](text);
+	const { 0: r, 1: g, 2: b } = color;
+	return `\u001B[38;2;${r};${g};${b}m${text}\u001B[39m`;
 }
+/**
+* Convert Socket theme to @inquirer theme format. Maps our theme colors to
+* inquirer's style functions. Handles theme names, Theme objects, and passes
+* through @inquirer themes.
+*
+* @example
+*   ;```ts
+*   // Socket theme name
+*   createInquirerTheme('sunset')
+*
+*   // Socket Theme object
+*   createInquirerTheme(SUNSET_THEME)
+*
+*   // @inquirer theme (passes through)
+*   createInquirerTheme({ style: {...}, icon: {...} })
+*   ```
+*
+* @param theme - Socket theme name, Theme object, or @inquirer theme.
+*
+* @returns @inquirer theme object
+*/
 function createInquirerTheme(theme) {
-  if (typeof theme === "string" || isSocketTheme(theme)) {
-    const socketTheme = resolveTheme(theme);
-    const promptColor = (0, import_resolve.resolveColor)(
-      socketTheme.colors.prompt,
-      socketTheme.colors
-    );
-    const textDimColor = (0, import_resolve.resolveColor)(
-      socketTheme.colors.textDim,
-      socketTheme.colors
-    );
-    const errorColor = socketTheme.colors.error;
-    const successColor = socketTheme.colors.success;
-    const primaryColor = socketTheme.colors.primary;
-    return {
-      style: {
-        // Message text (uses colors.prompt)
-        message: (text) => applyColor(text, promptColor),
-        // Answer text (uses primary color)
-        answer: (text) => applyColor(text, primaryColor),
-        // Help text / descriptions (uses textDim)
-        help: (text) => applyColor(text, textDimColor),
-        description: (text) => applyColor(text, textDimColor),
-        // Disabled items (uses textDim)
-        disabled: (text) => applyColor(text, textDimColor),
-        // Error messages (uses error color)
-        error: (text) => applyColor(text, errorColor),
-        // Highlight/active (uses primary color)
-        highlight: (text) => applyColor(text, primaryColor)
-      },
-      icon: {
-        // oxlint-disable-next-line socket/no-status-emoji -- Inquirer theme icon; consumed by the prompt library, not log output.
-        checked: applyColor("\u2713", successColor),
-        unchecked: " ",
-        cursor: applyColor("\u276F", primaryColor)
-      }
-    };
-  }
-  if (theme === void 0 || theme === null) {
-    return {};
-  }
-  return theme;
+	if (typeof theme === "string" || isSocketTheme(theme)) {
+		const socketTheme = resolveTheme(theme);
+		const promptColor = require_themes_resolve.resolveColor(socketTheme.colors.prompt, socketTheme.colors);
+		const textDimColor = require_themes_resolve.resolveColor(socketTheme.colors.textDim, socketTheme.colors);
+		const errorColor = socketTheme.colors.error;
+		const successColor = socketTheme.colors.success;
+		const primaryColor = socketTheme.colors.primary;
+		return {
+			style: {
+				message: (text) => applyColor(text, promptColor),
+				answer: (text) => applyColor(text, primaryColor),
+				help: (text) => applyColor(text, textDimColor),
+				description: (text) => applyColor(text, textDimColor),
+				disabled: (text) => applyColor(text, textDimColor),
+				error: (text) => applyColor(text, errorColor),
+				highlight: (text) => applyColor(text, primaryColor)
+			},
+			icon: {
+				checked: applyColor("✓", successColor),
+				unchecked: " ",
+				cursor: applyColor("❯", primaryColor)
+			}
+		};
+	}
+	if (theme === void 0 || theme === null) return {};
+	return theme;
 }
+/**
+* Create a separator for select prompts. Creates a visual separator line in
+* choice lists.
+*
+* @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 },
+*     ],
+*   })
+*
+* @param text - Optional separator text (defaults to '───────')
+*
+* @returns Separator instance
+*/
 function createSeparator(text) {
-  return new ActualSeparator(text);
+	return new ActualSeparator(text);
 }
+/**
+* Check if value is a Socket Theme object.
+*
+* @param value - Value to check.
+*
+* @returns True if value is a Socket Theme
+*/
 function isSocketTheme(value) {
-  return typeof value === "object" && value !== null && "name" in value && "colors" in value;
+	return typeof value === "object" && value !== null && "name" in value && "colors" in value;
 }
+/**
+* Resolve theme name or object to Theme.
+*
+* @param theme - Theme name or object.
+*
+* @returns Resolved Theme
+*/
 function resolveTheme(theme) {
-  return typeof theme === "string" ? import_themes.THEMES[theme] ?? import_themes.THEMES.socket : theme;
+	return typeof theme === "string" ? require_themes_themes.THEMES[theme] ?? require_themes_themes.THEMES.socket : theme;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Wrap an inquirer prompt with spinner handling, theme injection, and signal
+* injection. Automatically stops/starts spinners during prompt display, injects
+* the current theme, and injects abort signals. Trims string results and
+* handles cancellation gracefully.
+*
+* @example
+*   const myPrompt = wrapPrompt(rawInquirerPrompt)
+*   const result = await myPrompt({ message: 'Enter name:' })
+*
+* @template T - Type of the prompt result.
+*
+* @param inquirerPrompt - The inquirer prompt function to wrap.
+*
+* @returns Wrapped prompt function with spinner, theme, and signal handling
+*/
+/* @__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;
-    const config = args[0];
-    if (config && typeof config === "object") {
-      if (!config["theme"]) {
-        config["theme"] = createInquirerTheme((0, import_context.getTheme)());
-      } else {
-        config["theme"] = createInquirerTheme(config["theme"]);
-      }
-    }
-    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;
-  };
+	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;
+		const config = args[0];
+		if (config && typeof config === "object") if (!config["theme"]) config["theme"] = createInquirerTheme(require_themes_context.getTheme());
+		else config["theme"] = createInquirerTheme(config["theme"]);
+		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 checkbox = /* @__PURE__ */ wrapPrompt(import_checkbox.default);
-const confirm = /* @__PURE__ */ wrapPrompt(import_confirm.default);
-const input = /* @__PURE__ */ wrapPrompt(import_input.default);
-const password = /* @__PURE__ */ wrapPrompt(import_password.default);
+/**
+* Prompt to select multiple items from a list of choices. Wrapped with spinner
+* handling and abort signal support.
+*
+* @example
+*   const choices = await checkbox({
+*     message: 'Select options:',
+*     choices: [
+*       { name: 'Option 1', value: 'opt1' },
+*       { name: 'Option 2', value: 'opt2' },
+*       { name: 'Option 3', value: 'opt3' },
+*     ],
+*   })
+*/
+const checkbox = /* @__PURE__ */ wrapPrompt(src_external__inquirer_checkbox.default);
+/**
+* Prompt for a yes/no confirmation. Wrapped with spinner handling and abort
+* signal support.
+*
+* @example
+*   const answer = await confirm({ message: 'Continue?' })
+*   if (answer) { // user confirmed }
+*/
+const confirm = /* @__PURE__ */ wrapPrompt(src_external__inquirer_confirm.default);
+/**
+* Prompt for text input. Wrapped with spinner handling and abort signal
+* support. Result is automatically trimmed.
+*
+* @example
+*   const name = await input({ message: 'Enter your name:' })
+*/
+const input = /* @__PURE__ */ wrapPrompt(src_external__inquirer_input.default);
+/**
+* Prompt for password input (hidden characters). Wrapped with spinner handling
+* and abort signal support.
+*
+* @example
+*   const token = await password({ message: 'Enter API token:' })
+*/
+const password = /* @__PURE__ */ wrapPrompt(src_external__inquirer_password.default);
+/**
+* Prompt with searchable/filterable choices. Wrapped with spinner handling and
+* abort signal support.
+*
+* @example
+*   const result = await search({
+*     message: 'Select a package:',
+*     source: async input => fetchPackages(input),
+*   })
+*/
 const search = /* @__PURE__ */ wrapPrompt(searchRaw);
+/**
+* Prompt to select from a list of choices. Wrapped with spinner handling and
+* abort signal support.
+*
+* @example
+*   const choice = await select({
+*     message: 'Choose an option:',
+*     choices: [
+*       { name: 'Option 1', value: 'opt1' },
+*       { name: 'Option 2', value: 'opt2' },
+*     ],
+*   })
+*/
 const select = /* @__PURE__ */ wrapPrompt(selectRaw);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Separator,
-  applyColor,
-  checkbox,
-  confirm,
-  createInquirerTheme,
-  createSeparator,
-  input,
-  isSocketTheme,
-  password,
-  resolveTheme,
-  search,
-  select,
-  wrapPrompt
-});
+
+//#endregion
+exports.Separator = ActualSeparator;
+exports.applyColor = applyColor;
+exports.checkbox = checkbox;
+exports.confirm = confirm;
+exports.createInquirerTheme = createInquirerTheme;
+exports.createSeparator = createSeparator;
+exports.input = input;
+exports.isSocketTheme = isSocketTheme;
+exports.password = password;
+exports.resolveTheme = resolveTheme;
+exports.search = search;
+exports.select = select;
+exports.wrapPrompt = wrapPrompt;