@socketsecurity/lib 3.2.8 → 3.3.0

package/dist/spinner.js

@@ -33,13 +33,13 @@ __export(spinner_exports, {
   ciSpinner: () => ciSpinner,
   getCliSpinners: () => getCliSpinners,
   getDefaultSpinner: () => getDefaultSpinner,
-  toRgb: () => toRgb,
   withSpinner: () => withSpinner,
   withSpinnerRestore: () => withSpinnerRestore,
   withSpinnerSync: () => withSpinnerSync
 });
 module.exports = __toCommonJS(spinner_exports);
-var import_ci = require("./env/ci");
+var import_colors = require("./colors");
+var import_ci = require("#env/ci");
 var import_debug = require("./debug");
 var import_pulse_frames = require("./effects/pulse-frames");
 var import_text_shimmer = require("./effects/text-shimmer");
@@ -50,34 +50,6 @@ var import_strings = require("./strings");
 var import_context = require("./themes/context");
 var import_themes = require("./themes/themes");
 var import_utils = require("./themes/utils");
-const colorToRgb = {
-  __proto__: null,
-  black: [0, 0, 0],
-  blue: [0, 0, 255],
-  blueBright: [100, 149, 237],
-  cyan: [0, 255, 255],
-  cyanBright: [0, 255, 255],
-  gray: [128, 128, 128],
-  green: [0, 128, 0],
-  greenBright: [0, 255, 0],
-  magenta: [255, 0, 255],
-  magentaBright: [255, 105, 180],
-  red: [255, 0, 0],
-  redBright: [255, 69, 0],
-  white: [255, 255, 255],
-  whiteBright: [255, 255, 255],
-  yellow: [255, 255, 0],
-  yellowBright: [255, 255, 153]
-};
-function isRgbTuple(value) {
-  return Array.isArray(value);
-}
-function toRgb(color) {
-  if (isRgbTuple(color)) {
-    return color;
-  }
-  return colorToRgb[color];
-}
 const ciSpinner = {
   frames: [""],
   interval: 2147483647
@@ -163,14 +135,14 @@ function Spinner(options) {
           }
         }
         const spinnerColor = opts.color ?? defaultColor;
-        if (isRgbTuple(spinnerColor) && (spinnerColor.length !== 3 || !spinnerColor.every(
+        if ((0, import_colors.isRgbTuple)(spinnerColor) && (spinnerColor.length !== 3 || !spinnerColor.every(
           (n) => typeof n === "number" && n >= 0 && n <= 255
         ))) {
           throw new TypeError(
             "RGB color must be an array of 3 numbers between 0 and 255"
           );
         }
-        const spinnerColorRgb = toRgb(spinnerColor);
+        const spinnerColorRgb = (0, import_colors.toRgb)(spinnerColor);
         let shimmerInfo;
         if (opts.shimmer) {
           let shimmerDir;
@@ -197,7 +169,7 @@ function Spinner(options) {
           };
         }
         super({
-          signal: require("./constants/process").getAbortSignal(),
+          signal: require("#constants/process").getAbortSignal(),
           ...opts,
           // Pass RGB color directly to yocto-spinner (it now supports RGB).
           color: spinnerColorRgb,
@@ -222,11 +194,11 @@ function Spinner(options) {
       // Override color getter to ensure it's always RGB.
       get color() {
         const value = super.color;
-        return isRgbTuple(value) ? value : toRgb(value);
+        return (0, import_colors.isRgbTuple)(value) ? value : (0, import_colors.toRgb)(value);
       }
       // Override color setter to always convert to RGB before passing to yocto-spinner.
       set color(value) {
-        super.color = isRgbTuple(value) ? value : toRgb(value);
+        super.color = (0, import_colors.isRgbTuple)(value) ? value : (0, import_colors.toRgb)(value);
       }
       // Getter to expose current shimmer state.
       get shimmerState() {
@@ -295,7 +267,7 @@ function Spinner(options) {
           } else if (Array.isArray(this.#shimmer.color[0])) {
             shimmerColor = this.#shimmer.color;
           } else {
-            shimmerColor = toRgb(this.#shimmer.color);
+            shimmerColor = (0, import_colors.toRgb)(this.#shimmer.color);
           }
           displayText = (0, import_text_shimmer.applyShimmer)(displayText, this.#shimmer, {
             color: shimmerColor,
@@ -310,6 +282,7 @@ function Spinner(options) {
       /**
        * Show a status message without stopping the spinner.
        * Outputs the symbol and message to stderr, then continues spinning.
+       * @private
        */
       #showStatusAndKeepSpinning(symbolType, args) {
         let text = args.at(0);
@@ -387,6 +360,20 @@ function Spinner(options) {
         this.#updateSpinnerText();
         return this;
       }
+      /**
+       * Disable shimmer effect.
+       * Preserves config for later re-enable via enableShimmer().
+       *
+       * @returns This spinner for chaining
+       *
+       * @example
+       * spinner.disableShimmer()
+       */
+      disableShimmer() {
+        this.#shimmer = void 0;
+        this.#updateSpinnerText();
+        return this;
+      }
       /**
        * Show a done/success message (✓) without stopping the spinner.
        * Alias for `success()` with a shorter name.
@@ -412,6 +399,31 @@ function Spinner(options) {
       doneAndStop(text, ...extras) {
         return this.#apply("success", [text, ...extras]);
       }
+      /**
+       * Enable shimmer effect.
+       * Restores saved config or uses defaults if no saved config exists.
+       *
+       * @returns This spinner for chaining
+       *
+       * @example
+       * spinner.enableShimmer()
+       */
+      enableShimmer() {
+        if (this.#shimmerSavedConfig) {
+          this.#shimmer = { ...this.#shimmerSavedConfig };
+        } else {
+          this.#shimmer = {
+            color: import_text_shimmer.COLOR_INHERIT,
+            currentDir: import_text_shimmer.DIR_LTR,
+            mode: import_text_shimmer.DIR_LTR,
+            speed: 1 / 3,
+            step: 0
+          };
+          this.#shimmerSavedConfig = this.#shimmer;
+        }
+        this.#updateSpinnerText();
+        return this;
+      }
       /**
        * Show a failure message (✗) without stopping the spinner.
        * DESIGN DECISION: Unlike yocto-spinner, our `fail()` does NOT stop the spinner.
@@ -559,6 +571,67 @@ function Spinner(options) {
         }
         return this;
       }
+      /**
+       * Show a reasoning/working message (∴) without stopping the spinner.
+       * Outputs to stderr and continues spinning.
+       *
+       * @param text - Reasoning message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      reason(text, ...extras) {
+        return this.#showStatusAndKeepSpinning("reason", [text, ...extras]);
+      }
+      /**
+       * Show a reasoning/working message (∴) and stop the spinner.
+       * Auto-clears the spinner line before displaying the message.
+       *
+       * Implementation note: Unlike other *AndStop methods (successAndStop, failAndStop, etc.),
+       * this method cannot use #apply() with a 'reason' method name because yocto-spinner
+       * doesn't have a built-in 'reason' method. Instead, we manually stop the spinner then
+       * log the message with the reason symbol. This matches the pattern used by methods
+       * like debugAndStop() and maintains consistency with normalizeText() usage and empty
+       * string handling (see #apply's stop method handling for the pattern).
+       *
+       * @param text - Reasoning message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      reasonAndStop(text, ...extras) {
+        this.#apply("stop", []);
+        const normalized = normalizeText(text);
+        if (normalized) {
+          logger.error(`${import_logger.LOG_SYMBOLS.reason} ${normalized}`, ...extras);
+        }
+        return this;
+      }
+      /**
+       * Set complete shimmer configuration.
+       * Replaces any existing shimmer config with the provided values.
+       * Undefined properties will use default values.
+       *
+       * @param config - Complete shimmer configuration
+       * @returns This spinner for chaining
+       *
+       * @example
+       * spinner.setShimmer({
+       *   color: [255, 0, 0],
+       *   dir: 'rtl',
+       *   speed: 0.5
+       * })
+       */
+      setShimmer(config) {
+        this.#shimmer = {
+          color: config.color ?? import_text_shimmer.COLOR_INHERIT,
+          currentDir: import_text_shimmer.DIR_LTR,
+          mode: config.dir ?? import_text_shimmer.DIR_LTR,
+          speed: config.speed ?? 1 / 3,
+          step: 0
+        };
+        this.#shimmerSavedConfig = this.#shimmer;
+        this.#updateSpinnerText();
+        return this;
+      }
       /**
        * Start the spinner animation with optional text.
        * Begins displaying the animated spinner on stderr.
@@ -610,28 +683,6 @@ function Spinner(options) {
         }
         return this;
       }
-      /**
-       * Log an indented substep message to stderr without stopping the spinner.
-       * Adds 2-space indentation to the message.
-       * Aligns with `logger.substep()` to use stderr for status messages.
-       *
-       * @param text - Substep message to display
-       * @param extras - Additional values to log
-       * @returns This spinner for chaining
-       *
-       * @example
-       * ```ts
-       * spinner.step('Building application')
-       * spinner.substep('Compiling TypeScript')
-       * spinner.substep('Bundling assets')
-       * ```
-       */
-      substep(text, ...extras) {
-        if (typeof text === "string") {
-          logger.error(`  ${text}`, ...extras);
-        }
-        return this;
-      }
       /**
        * Stop the spinner animation and clear internal state.
        * Auto-clears the spinner line via yocto-spinner.stop().
@@ -663,6 +714,28 @@ function Spinner(options) {
         super.text = "";
         return result;
       }
+      /**
+       * Log an indented substep message to stderr without stopping the spinner.
+       * Adds 2-space indentation to the message.
+       * Aligns with `logger.substep()` to use stderr for status messages.
+       *
+       * @param text - Substep message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       *
+       * @example
+       * ```ts
+       * spinner.step('Building application')
+       * spinner.substep('Compiling TypeScript')
+       * spinner.substep('Bundling assets')
+       * ```
+       */
+      substep(text, ...extras) {
+        if (typeof text === "string") {
+          logger.error(`  ${text}`, ...extras);
+        }
+        return this;
+      }
       /**
        * Show a success message (✓) without stopping the spinner.
        * DESIGN DECISION: Unlike yocto-spinner, our `success()` does NOT stop the spinner.
@@ -695,94 +768,6 @@ function Spinner(options) {
         this.#updateSpinnerText();
         return this;
       }
-      /**
-       * Show a warning message (⚠) without stopping the spinner.
-       * Outputs to stderr and continues spinning.
-       *
-       * @param text - Warning message to display
-       * @param extras - Additional values to log
-       * @returns This spinner for chaining
-       */
-      warn(text, ...extras) {
-        return this.#showStatusAndKeepSpinning("warn", [text, ...extras]);
-      }
-      /**
-       * Show a warning message (⚠) and stop the spinner.
-       * Auto-clears the spinner line before displaying the warning message.
-       *
-       * @param text - Warning message to display
-       * @param extras - Additional values to log
-       * @returns This spinner for chaining
-       */
-      warnAndStop(text, ...extras) {
-        return this.#apply("warning", [text, ...extras]);
-      }
-      /**
-       * Enable shimmer effect.
-       * Restores saved config or uses defaults if no saved config exists.
-       *
-       * @returns This spinner for chaining
-       *
-       * @example
-       * spinner.enableShimmer()
-       */
-      enableShimmer() {
-        if (this.#shimmerSavedConfig) {
-          this.#shimmer = { ...this.#shimmerSavedConfig };
-        } else {
-          this.#shimmer = {
-            color: import_text_shimmer.COLOR_INHERIT,
-            currentDir: import_text_shimmer.DIR_LTR,
-            mode: import_text_shimmer.DIR_LTR,
-            speed: 1 / 3,
-            step: 0
-          };
-          this.#shimmerSavedConfig = this.#shimmer;
-        }
-        this.#updateSpinnerText();
-        return this;
-      }
-      /**
-       * Disable shimmer effect.
-       * Preserves config for later re-enable via enableShimmer().
-       *
-       * @returns This spinner for chaining
-       *
-       * @example
-       * spinner.disableShimmer()
-       */
-      disableShimmer() {
-        this.#shimmer = void 0;
-        this.#updateSpinnerText();
-        return this;
-      }
-      /**
-       * Set complete shimmer configuration.
-       * Replaces any existing shimmer config with the provided values.
-       * Undefined properties will use default values.
-       *
-       * @param config - Complete shimmer configuration
-       * @returns This spinner for chaining
-       *
-       * @example
-       * spinner.setShimmer({
-       *   color: [255, 0, 0],
-       *   dir: 'rtl',
-       *   speed: 0.5
-       * })
-       */
-      setShimmer(config) {
-        this.#shimmer = {
-          color: config.color ?? import_text_shimmer.COLOR_INHERIT,
-          currentDir: import_text_shimmer.DIR_LTR,
-          mode: config.dir ?? import_text_shimmer.DIR_LTR,
-          speed: config.speed ?? 1 / 3,
-          step: 0
-        };
-        this.#shimmerSavedConfig = this.#shimmer;
-        this.#updateSpinnerText();
-        return this;
-      }
       /**
        * Update partial shimmer configuration.
        * Merges with existing config, enabling shimmer if currently disabled.
@@ -834,6 +819,28 @@ function Spinner(options) {
         this.#updateSpinnerText();
         return this;
       }
+      /**
+       * Show a warning message (⚠) without stopping the spinner.
+       * Outputs to stderr and continues spinning.
+       *
+       * @param text - Warning message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      warn(text, ...extras) {
+        return this.#showStatusAndKeepSpinning("warn", [text, ...extras]);
+      }
+      /**
+       * Show a warning message (⚠) and stop the spinner.
+       * Auto-clears the spinner line before displaying the warning message.
+       *
+       * @param text - Warning message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      warnAndStop(text, ...extras) {
+        return this.#apply("warning", [text, ...extras]);
+      }
     };
     Object.defineProperties(_Spinner.prototype, {
       error: desc(_Spinner.prototype.fail),
@@ -866,7 +873,7 @@ async function withSpinner(options) {
   const savedColor = withOptions?.color !== void 0 ? spinner.color : void 0;
   const savedShimmerState = withOptions?.shimmer !== void 0 ? spinner.shimmerState : void 0;
   if (withOptions?.color !== void 0) {
-    spinner.color = toRgb(withOptions.color);
+    spinner.color = (0, import_colors.toRgb)(withOptions.color);
   }
   if (withOptions?.shimmer !== void 0) {
     if (typeof withOptions.shimmer === "string") {
@@ -920,7 +927,7 @@ function withSpinnerSync(options) {
   const savedColor = withOptions?.color !== void 0 ? spinner.color : void 0;
   const savedShimmerState = withOptions?.shimmer !== void 0 ? spinner.shimmerState : void 0;
   if (withOptions?.color !== void 0) {
-    spinner.color = toRgb(withOptions.color);
+    spinner.color = (0, import_colors.toRgb)(withOptions.color);
   }
   if (withOptions?.shimmer !== void 0) {
     if (typeof withOptions.shimmer === "string") {
@@ -956,7 +963,6 @@ function withSpinnerSync(options) {
   ciSpinner,
   getCliSpinners,
   getDefaultSpinner,
-  toRgb,
   withSpinner,
   withSpinnerRestore,
   withSpinnerSync

package/dist/stdio/prompts.js

@@ -40,7 +40,7 @@ __export(prompts_exports, {
   wrapPrompt: () => wrapPrompt
 });
 module.exports = __toCommonJS(prompts_exports);
-var import_process = require("../constants/process");
+var import_process = require("#constants/process");
 var import_context = require("../themes/context");
 var import_themes = require("../themes/themes");
 var import_utils = require("../themes/utils");

package/dist/temporary-executor.js

@@ -22,7 +22,7 @@ __export(temporary_executor_exports, {
   isRunningInTemporaryExecutor: () => isRunningInTemporaryExecutor
 });
 module.exports = __toCommonJS(temporary_executor_exports);
-var import_platform = require("./constants/platform");
+var import_platform = require("#constants/platform");
 var import_path = require("./path");
 function isRunningInTemporaryExecutor(cwd = process.cwd()) {
   const userAgent = process.env["npm_config_user_agent"];

package/dist/themes/types.d.ts

@@ -2,7 +2,8 @@
  * @fileoverview Elegant theme type system.
  * Type-safe theming for spinners, loggers, prompts, and links.
  */
-import type { ColorValue, SpinnerStyle } from '../spinner';
+import type { ColorValue } from '../colors';
+import type { SpinnerStyle } from '../spinner';
 import type { ShimmerDirection } from '../effects/text-shimmer';
 /**
  * Color reference — direct value or semantic keyword.

package/dist/themes/utils.d.ts

@@ -1,4 +1,4 @@
-import type { ColorValue } from '../spinner';
+import type { ColorValue } from '../colors';
 import type { ShimmerColorGradient } from '../effects/text-shimmer';
 import type { Theme, ThemeColors, ColorReference } from './types';
 /**

package/dist/utils/get-ipc.d.ts

@@ -13,4 +13,3 @@ export interface IpcObject {
 }
 export declare function getIpc(): Promise<IpcObject>;
 export declare function getIpc<K extends keyof IpcObject>(key: K): Promise<IpcObject[K]>;
-export default getIpc;

package/dist/utils/get-ipc.js

@@ -18,7 +18,10 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var get_ipc_exports = {};
-/* module.exports will be set at end of file */
+__export(get_ipc_exports, {
+  getIpc: () => getIpc
+});
+module.exports = __toCommonJS(get_ipc_exports);
 let _ipcObject;
 async function getIpc(key) {
   if (_ipcObject === void 0) {
@@ -49,10 +52,7 @@ async function getIpc(key) {
   }
   return key ? _ipcObject[key] : _ipcObject;
 }
-var get_ipc_default = getIpc;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getIpc
 });
-
-module.exports = get_ipc_default;

package/dist/versions.d.ts

@@ -84,4 +84,4 @@ export declare function sortVersionsDesc(versions: string[]): string[];
 /**
  * Get the difference between two versions.
  */
-export declare function versionDiff(version1: string, version2: string): 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | undefined;
+export declare function versionDiff(version1: string, version2: string): 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | 'release' | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.2.8",
+  "version": "3.3.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -56,6 +56,10 @@
       "types": "./dist/cache-with-ttl.d.ts",
       "default": "./dist/cache-with-ttl.js"
     },
+    "./colors": {
+      "types": "./dist/colors.d.ts",
+      "default": "./dist/colors.js"
+    },
     "./constants/agents": {
       "types": "./dist/constants/agents.d.ts",
       "default": "./dist/constants/agents.js"
@@ -578,19 +582,16 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "node scripts/build.mjs",
-    "build:watch": "node scripts/build-js.mjs --watch",
+    "build": "node scripts/build/main.mjs",
     "check": "node scripts/check.mjs",
-    "claude": "node scripts/claude.mjs",
-    "clean": "node scripts/clean.mjs",
-    "cover": "node scripts/cover.mjs",
-    "dev": "pnpm run build:watch",
+    "clean": "node scripts/build/clean.mjs",
+    "cover": "node scripts/test/cover.mjs",
+    "dev": "node scripts/build/main.mjs --watch",
     "fix": "node scripts/lint.mjs --fix",
-    "fix:build": "node scripts/fix-build.mjs",
     "lint": "node scripts/lint.mjs",
     "prepare": "husky",
     "prepublishOnly": "pnpm run build",
-    "test": "node scripts/test.mjs",
+    "test": "node scripts/test/main.mjs",
     "update": "node scripts/update.mjs"
   },
   "devDependencies": {