@socketsecurity/lib 3.3.11 → 3.4.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.4.0](https://github.com/SocketDev/socket-lib/releases/tag/v3.4.0) - 2025-11-14
+
+### Added
+
+- **Spinner**: New `skip()` and `skipAndStop()` methods for displaying skipped operations
+  - `skip(text)`: Display skip message alongside spinner (e.g., "Skipping optional step...")
+  - `skipAndStop(text)`: Display skip message and stop spinner in one call
+  - Uses cyan ↻ (refresh/reload) symbol with @ ASCII fallback
+  - Normalizes text formatting consistently with other spinner methods
+  - Useful for communicating skipped steps during long-running operations
+
+- **Logger**: New `skip()` method and symbol for skipped operations
+  - `LOG_SYMBOLS.skip`: New cyan ↻ symbol for skip output (@ ASCII fallback)
+  - `skip(message)`: Display skip messages with dedicated symbol
+  - Complements existing info/step/success/error/warning/reason methods
+
 ## [3.3.11](https://github.com/SocketDev/socket-lib/releases/tag/v3.3.11) - 2025-11-14
 
 ### Fixed

package/dist/logger.d.ts

@@ -26,6 +26,8 @@ type LogSymbols = {
     progress: string;
     /** Dimmed yellow reasoning/working symbol (∴ or :. in ASCII) */
     reason: string;
+    /** Cyan colored skip symbol (↻ or @ in ASCII) */
+    skip: string;
     /** Cyan colored step symbol (→ or > in ASCII) */
     step: string;
     /** Green colored success symbol (✔ or √ in ASCII) */
@@ -741,6 +743,24 @@ export declare class Logger {
      * ```
      */
     resetIndent(): this;
+    /**
+     * Logs a skip message with a cyan colored skip symbol.
+     *
+     * Automatically prefixes the message with `LOG_SYMBOLS.skip` (cyan ↻).
+     * Always outputs to stderr. If the message starts with an existing
+     * symbol, it will be stripped and replaced.
+     *
+     * @param args - Message and additional arguments to log
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.skip('Test skipped due to environment')
+     * logger.skip('Skipping optional step')
+     * logger.skip('Feature disabled, skipping')
+     * ```
+     */
+    skip(...args: unknown[]): this;
     /**
      * Logs a main step message with a cyan arrow symbol and blank line before it.
      *

package/dist/logger.js

@@ -92,6 +92,7 @@ const LOG_SYMBOLS = /* @__PURE__ */ (() => {
     target.reason = colors.dim(
       /* @__PURE__ */ applyColor(supported ? "\u2234" : ":.", warningColor, colors)
     );
+    target.skip = /* @__PURE__ */ applyColor(supported ? "\u21BB" : "@", stepColor, colors);
     target.step = /* @__PURE__ */ applyColor(supported ? "\u2192" : ">", stepColor, colors);
     target.success = /* @__PURE__ */ applyColor(supported ? "\u2714" : "\u221A", successColor, colors);
     target.warn = /* @__PURE__ */ applyColor(supported ? "\u26A0" : "\u203C", warningColor, colors);
@@ -332,6 +333,7 @@ class Logger {
       reason: colors.dim(
         /* @__PURE__ */ applyColor(supported ? "\u2234" : ":.", theme.colors.warning, colors)
       ),
+      skip: /* @__PURE__ */ applyColor(supported ? "\u21BB" : "@", theme.colors.step, colors),
       step: /* @__PURE__ */ applyColor(supported ? "\u2192" : ">", theme.colors.step, colors),
       success: /* @__PURE__ */ applyColor(supported ? "\u2714" : "\u221A", theme.colors.success, colors),
       warn: /* @__PURE__ */ applyColor(supported ? "\u26A0" : "\u203C", theme.colors.warning, colors)
@@ -381,7 +383,7 @@ class Logger {
    * @private
    */
   #stripSymbols(text) {
-    return text.replace(/^(?:[✖✗×⚠‼✔✓√ℹ→∴]|:.)[\uFE0F\s]*/u, "");
+    return text.replace(/^(?:[✖✗×⚠‼✔✓√ℹ→∴↻]|:.)[\uFE0F\s]*/u, "");
   }
   /**
    * Apply a method with a symbol prefix.
@@ -1119,6 +1121,26 @@ class Logger {
     }
     return this;
   }
+  /**
+   * Logs a skip message with a cyan colored skip symbol.
+   *
+   * Automatically prefixes the message with `LOG_SYMBOLS.skip` (cyan ↻).
+   * Always outputs to stderr. If the message starts with an existing
+   * symbol, it will be stripped and replaced.
+   *
+   * @param args - Message and additional arguments to log
+   * @returns The logger instance for chaining
+   *
+   * @example
+   * ```typescript
+   * logger.skip('Test skipped due to environment')
+   * logger.skip('Skipping optional step')
+   * logger.skip('Feature disabled, skipping')
+   * ```
+   */
+  skip(...args) {
+    return this.#symbolApply("skip", args);
+  }
   /**
    * Logs a main step message with a cyan arrow symbol and blank line before it.
    *

package/dist/spinner.d.ts

@@ -7,9 +7,9 @@ import type { ColorInherit, ColorRgb, ColorValue } from './colors';
 import type { ShimmerColorGradient, ShimmerConfig, ShimmerDirection, ShimmerState } from './effects/text-shimmer';
 /**
  * Symbol types for status messages.
- * Maps to log symbols: fail (✗), info (ℹ), reason (∴), success (✓), warn (⚠).
+ * Maps to log symbols: fail (✗), info (ℹ), reason (∴), skip (↻), success (✓), warn (⚠).
  */
-export type SymbolType = 'fail' | 'info' | 'reason' | 'success' | 'warn';
+export type SymbolType = 'fail' | 'info' | 'reason' | 'skip' | 'success' | 'warn';
 /**
  * Progress tracking information for display in spinner.
  * Used by `progress()` and `progressStep()` methods to show animated progress bars.
@@ -107,6 +107,10 @@ export type Spinner = {
     reasonAndStop(text?: string | undefined, ...extras: unknown[]): Spinner;
     /** Set complete shimmer configuration */
     setShimmer(config: ShimmerConfig): Spinner;
+    /** Show skip (↻) message without stopping the spinner */
+    skip(text?: string | undefined, ...extras: unknown[]): Spinner;
+    /** Show skip (↻) message and stop the spinner, auto-clearing the line */
+    skipAndStop(text?: string | undefined, ...extras: unknown[]): Spinner;
     /** Start spinning with optional text */
     start(text?: string | undefined): Spinner;
     /** Show main step message to stderr without stopping */

package/dist/spinner.js

@@ -605,6 +605,37 @@ function Spinner(options) {
         }
         return this;
       }
+      /**
+       * Show a skip message (↻) without stopping the spinner.
+       * Outputs to stderr and continues spinning.
+       *
+       * @param text - Skip message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      skip(text, ...extras) {
+        return this.#showStatusAndKeepSpinning("skip", [text, ...extras]);
+      }
+      /**
+       * Show a skip message (↻) and stop the spinner.
+       * Auto-clears the spinner line before displaying the message.
+       *
+       * Implementation note: Similar to reasonAndStop(), this method cannot use #apply()
+       * with a 'skip' method name because yocto-spinner doesn't have a built-in 'skip'
+       * method. Instead, we manually stop the spinner then log the message with the skip symbol.
+       *
+       * @param text - Skip message to display
+       * @param extras - Additional values to log
+       * @returns This spinner for chaining
+       */
+      skipAndStop(text, ...extras) {
+        this.#apply("stop", []);
+        const normalized = normalizeText(text);
+        if (normalized) {
+          logger.error(`${import_logger.LOG_SYMBOLS.skip} ${normalized}`, ...extras);
+        }
+        return this;
+      }
       /**
        * Set complete shimmer configuration.
        * Replaces any existing shimmer config with the provided values.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.3.11",
+  "version": "3.4.0",
   "packageManager": "pnpm@10.22.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",