@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/spinner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/spinner.ts"],
+  "sourcesContent": ["/**\n * @fileoverview CLI spinner utilities for long-running operations.\n * Provides animated progress indicators with CI environment detection.\n */\n\nimport type { Writable } from 'node:stream'\n\n// Note: getAbortSignal is imported lazily to avoid circular dependencies.\nimport { CI } from '#env/ci'\nimport { generateSocketSpinnerFrames } from './effects/pulse-frames'\nimport type {\n  ShimmerColorGradient,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './effects/text-shimmer'\nimport { applyShimmer, COLOR_INHERIT, DIR_LTR } from './effects/text-shimmer'\nimport yoctoSpinner from './external/@socketregistry/yocto-spinner'\nimport { hasOwn } from './objects'\nimport { isBlankString, stringWidth } from './strings'\n\nexport type ColorName =\n  | 'black'\n  | 'blue'\n  | 'blueBright'\n  | 'cyan'\n  | 'cyanBright'\n  | 'gray'\n  | 'green'\n  | 'greenBright'\n  | 'magenta'\n  | 'magentaBright'\n  | 'red'\n  | 'redBright'\n  | 'white'\n  | 'whiteBright'\n  | 'yellow'\n  | 'yellowBright'\n\nexport type ColorInherit = 'inherit'\n\nexport type ColorRgb = readonly [number, number, number]\n\nexport type ColorValue = ColorName | ColorRgb\n\nexport type SymbolType = 'fail' | 'info' | 'success' | 'warn'\n\n// Map color names to RGB values.\nconst colorToRgb: Record<ColorName, ColorRgb> = {\n  __proto__: null,\n  black: [0, 0, 0],\n  blue: [0, 0, 255],\n  blueBright: [100, 149, 237],\n  cyan: [0, 255, 255],\n  cyanBright: [0, 255, 255],\n  gray: [128, 128, 128],\n  green: [0, 128, 0],\n  greenBright: [0, 255, 0],\n  magenta: [255, 0, 255],\n  magentaBright: [255, 105, 180],\n  red: [255, 0, 0],\n  redBright: [255, 69, 0],\n  white: [255, 255, 255],\n  whiteBright: [255, 255, 255],\n  yellow: [255, 255, 0],\n  yellowBright: [255, 255, 153],\n} as Record<ColorName, ColorRgb>\n\n/**\n * Check if value is RGB tuple.\n */\nfunction isRgbTuple(value: ColorValue): value is ColorRgb {\n  return Array.isArray(value)\n}\n\n/**\n * Convert ColorValue to RGB tuple.\n */\nfunction toRgb(color: ColorValue): ColorRgb {\n  if (isRgbTuple(color)) {\n    return color\n  }\n  return colorToRgb[color]\n}\n\nexport type ProgressInfo = {\n  current: number\n  total: number\n  unit?: string | undefined\n}\n\nexport type ShimmerInfo = ShimmerState & {\n  color: ColorInherit | ColorValue | ShimmerColorGradient\n}\n\nexport type Spinner = {\n  color: ColorRgb\n  spinner: SpinnerStyle\n\n  get isSpinning(): boolean\n\n  clear(): Spinner\n  debug(text?: string | undefined, ...extras: unknown[]): Spinner\n  debugAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  error(text?: string | undefined, ...extras: unknown[]): Spinner\n  errorAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  fail(text?: string | undefined, ...extras: unknown[]): Spinner\n  failAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  // text property returns a method via _textMethod override\n  text(value: string): Spinner\n  text(): string\n\n  indent(spaces?: number | undefined): Spinner\n  dedent(spaces?: number | undefined): Spinner\n\n  info(text?: string | undefined, ...extras: unknown[]): Spinner\n  infoAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  log(text?: string | undefined, ...extras: unknown[]): Spinner\n  logAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  start(text?: string | undefined): Spinner\n  stop(text?: string | undefined): Spinner\n  stopAndPersist(text?: string | undefined): Spinner\n\n  step(text?: string | undefined, ...extras: unknown[]): Spinner\n  substep(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  success(text?: string | undefined, ...extras: unknown[]): Spinner\n  successAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  done(text?: string | undefined, ...extras: unknown[]): Spinner\n  doneAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  progress(current: number, total: number, unit?: string | undefined): Spinner\n  progressStep(amount?: number): Spinner\n\n  shimmer(enabled: boolean): Spinner\n  shimmer(config: Partial<ShimmerConfig> | ShimmerDirection): Spinner\n\n  warn(text?: string | undefined, ...extras: unknown[]): Spinner\n  warnAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n}\n\nexport type SpinnerOptions = {\n  readonly color?: ColorValue | undefined\n  readonly shimmer?: ShimmerConfig | ShimmerDirection | undefined\n  readonly spinner?: SpinnerStyle | undefined\n  readonly signal?: AbortSignal | undefined\n  readonly stream?: Writable | undefined\n  readonly text?: string | undefined\n}\n\nexport type SpinnerStyle = {\n  readonly frames: string[]\n  readonly interval?: number | undefined\n}\n\nexport const ciSpinner: SpinnerStyle = {\n  frames: [''],\n  interval: 2_147_483_647,\n}\n\nfunction desc(value: unknown) {\n  return {\n    __proto__: null,\n    configurable: true,\n    value,\n    writable: true,\n  }\n}\n\nfunction normalizeText(value: unknown) {\n  return typeof value === 'string' ? value.trimStart() : ''\n}\n\nfunction formatProgress(progress: ProgressInfo): string {\n  const { current, total, unit } = progress\n  const percentage = Math.round((current / total) * 100)\n  const bar = renderProgressBar(percentage)\n  const count = unit ? `${current}/${total} ${unit}` : `${current}/${total}`\n  return `${bar} ${percentage}% (${count})`\n}\n\nfunction renderProgressBar(percentage: number, width: number = 20): string {\n  const filled = Math.round((percentage / 100) * width)\n  const empty = width - filled\n  const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(empty)\n  // Use cyan color for the progress bar\n  const colors = /*@__PURE__*/ require('../external/yoctocolors-cjs')\n  return colors.cyan(bar)\n}\n\nlet _cliSpinners: Record<string, SpinnerStyle> | undefined\n\n/**\n * Get available CLI spinner styles or a specific style by name.\n * Extends the standard cli-spinners collection with Socket custom spinners.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n *\n * Custom spinners:\n * - `socket` (default): Socket pulse animation with sparkles and lightning\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getCliSpinners(\n  styleName?: string | undefined,\n): SpinnerStyle | Record<string, SpinnerStyle> | undefined {\n  if (_cliSpinners === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the YoctoSpinner class to access static properties.\n    const tempInstance = YoctoCtor({})\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner class.\n    const YoctoSpinnerClass = tempInstance.constructor as any\n    // Extend the standard cli-spinners collection with Socket custom spinners.\n    _cliSpinners = {\n      __proto__: null,\n      ...YoctoSpinnerClass.spinners,\n      socket: generateSocketSpinnerFrames(),\n    }\n  }\n  if (typeof styleName === 'string' && _cliSpinners) {\n    return hasOwn(_cliSpinners, styleName) ? _cliSpinners[styleName] : undefined\n  }\n  return _cliSpinners\n}\n\nlet _Spinner: {\n  new (options?: SpinnerOptions | undefined): Spinner\n}\nlet _defaultSpinner: SpinnerStyle | undefined\n\n/**\n * Create a spinner instance for displaying loading indicators.\n *\n * AUTO-CLEAR BEHAVIOR:\n * - All *AndStop() methods AUTO-CLEAR the spinner line via yocto-spinner.stop()\n *   Examples: doneAndStop(), successAndStop(), failAndStop(), etc.\n *\n * - Methods WITHOUT \"AndStop\" do NOT clear (spinner keeps spinning)\n *   Examples: done(), success(), fail(), etc.\n *\n * STREAM USAGE:\n * - Spinner animation: stderr (yocto-spinner default)\n * - Status methods (done, success, fail, info, warn, step, substep): stderr\n * - Data methods (log): stdout\n *\n * COMPARISON WITH LOGGER:\n * - logger.done() does NOT auto-clear (requires manual logger.clearLine())\n * - spinner.doneAndStop() DOES auto-clear (built into yocto-spinner.stop())\n * - Pattern: logger.clearLine().done() vs spinner.doneAndStop()\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function Spinner(options?: SpinnerOptions | undefined): Spinner {\n  if (_Spinner === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the actual YoctoSpinner class from an instance\n    const tempInstance = YoctoCtor({})\n    const YoctoSpinnerClass = tempInstance.constructor\n\n    /*@__PURE__*/\n    // biome-ignore lint/suspicious/noExplicitAny: Extending yocto-spinner class.\n    _Spinner = class SpinnerClass extends (YoctoSpinnerClass as any) {\n      declare isSpinning: boolean\n      #baseText: string = ''\n      #indentation: string = ''\n      #progress?: ProgressInfo | undefined\n      #shimmer?: ShimmerInfo | undefined\n      #shimmerSavedConfig?: ShimmerInfo | undefined\n\n      constructor(options?: SpinnerOptions | undefined) {\n        const opts = { __proto__: null, ...options } as SpinnerOptions\n\n        // Convert color option to RGB (default to Socket purple).\n        const spinnerColor = opts.color ?? ([140, 82, 255] as const)\n\n        // Validate RGB tuple if provided.\n        if (\n          isRgbTuple(spinnerColor) &&\n          (spinnerColor.length !== 3 ||\n            !spinnerColor.every(\n              n => typeof n === 'number' && n >= 0 && n <= 255,\n            ))\n        ) {\n          throw new TypeError(\n            'RGB color must be an array of 3 numbers between 0 and 255',\n          )\n        }\n\n        const spinnerColorRgb = toRgb(spinnerColor)\n\n        // Parse shimmer config - can be object or direction string.\n        let shimmerInfo: ShimmerInfo | undefined\n        if (opts.shimmer) {\n          let shimmerDir: ShimmerDirection\n          let shimmerColor:\n            | ColorInherit\n            | ColorValue\n            | ShimmerColorGradient\n            | undefined\n          // Default: 0.33 steps per frame (~150ms per step).\n          let shimmerSpeed: number = 1 / 3\n\n          if (typeof opts.shimmer === 'string') {\n            shimmerDir = opts.shimmer\n          } else {\n            const shimmerConfig = {\n              __proto__: null,\n              ...opts.shimmer,\n            } as ShimmerConfig\n            shimmerDir = shimmerConfig.dir ?? DIR_LTR\n            shimmerColor = shimmerConfig.color ?? COLOR_INHERIT\n            shimmerSpeed = shimmerConfig.speed ?? 1 / 3\n          }\n\n          // Create shimmer info with initial animation state:\n          // - COLOR_INHERIT means use spinner color dynamically\n          // - ColorValue (name or RGB tuple) is an explicit override color\n          // - undefined color defaults to COLOR_INHERIT\n          // - speed controls steps per frame (lower = slower, e.g., 0.33 = ~150ms per step)\n          shimmerInfo = {\n            __proto__: null,\n            color: shimmerColor === undefined ? COLOR_INHERIT : shimmerColor,\n            currentDir: DIR_LTR,\n            mode: shimmerDir,\n            speed: shimmerSpeed,\n            step: 0,\n          } as ShimmerInfo\n        }\n\n        // eslint-disable-next-line constructor-super\n        super({\n          signal: require('#constants/process').getAbortSignal(),\n          ...opts,\n          // Pass RGB color directly to yocto-spinner (it now supports RGB).\n          color: spinnerColorRgb,\n          // onRenderFrame callback provides full control over frame + text layout.\n          // Calculates spacing based on frame width to prevent text jumping.\n          onRenderFrame: (\n            frame: string,\n            text: string,\n            applyColor: (text: string) => string,\n          ) => {\n            const width = stringWidth(frame)\n            // Narrow frames (width 1) get 2 spaces, wide frames (width 2) get 1 space.\n            // Total width is consistent: 3 characters (frame + spacing) before text.\n            const spacing = width === 1 ? '  ' : ' '\n            return frame ? `${applyColor(frame)}${spacing}${text}` : text\n          },\n          // onFrameUpdate callback is called by yocto-spinner whenever a frame advances.\n          // This ensures shimmer updates are perfectly synchronized with animation beats.\n          onFrameUpdate: shimmerInfo\n            ? () => {\n                // Update parent's text without triggering render.\n                // Parent's #skipRender flag prevents nested render calls.\n                // Only update if we have base text to avoid blank frames.\n                if (this.#baseText) {\n                  super.text = this.#buildDisplayText()\n                }\n              }\n            : undefined,\n        })\n\n        this.#shimmer = shimmerInfo\n        this.#shimmerSavedConfig = shimmerInfo\n      }\n\n      // Override color getter to ensure it's always RGB.\n      get color(): ColorRgb {\n        const value = super.color\n        return isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      // Override color setter to always convert to RGB before passing to yocto-spinner.\n      set color(value: ColorValue | ColorRgb) {\n        super.color = isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      /**\n       * Apply a yocto-spinner method and update logger state.\n       * Handles text normalization, extra arguments, and logger tracking.\n       * @private\n       */\n      #apply(methodName: string, args: unknown[]) {\n        let extras: unknown[]\n        let text = args.at(0)\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n        const wasSpinning = this.isSpinning\n        const normalized = normalizeText(text)\n        super[methodName](normalized)\n        const {\n          incLogCallCountSymbol,\n          lastWasBlankSymbol,\n          logger,\n        } = /*@__PURE__*/ require('./logger.js')\n        if (methodName === 'stop') {\n          if (wasSpinning && normalized) {\n            logger[lastWasBlankSymbol](isBlankString(normalized))\n            logger[incLogCallCountSymbol]()\n          }\n        } else {\n          logger[lastWasBlankSymbol](false)\n          logger[incLogCallCountSymbol]()\n        }\n        if (extras.length) {\n          logger.log(...extras)\n          logger[lastWasBlankSymbol](false)\n        }\n        return this\n      }\n\n      /**\n       * Build the complete display text with progress, shimmer, and indentation.\n       * Combines base text, progress bar, shimmer effects, and indentation.\n       * @private\n       */\n      #buildDisplayText() {\n        let displayText = this.#baseText\n\n        if (this.#progress) {\n          const progressText = formatProgress(this.#progress)\n          displayText = displayText\n            ? `${displayText} ${progressText}`\n            : progressText\n        }\n\n        // Apply shimmer effect if enabled.\n        if (displayText && this.#shimmer) {\n          // If shimmer color is 'inherit', use current spinner color (getter ensures RGB).\n          // Otherwise, check if it's a gradient (array of arrays) or single color.\n          let shimmerColor: ColorRgb | ShimmerColorGradient\n          if (this.#shimmer.color === COLOR_INHERIT) {\n            shimmerColor = this.color\n          } else if (Array.isArray(this.#shimmer.color[0])) {\n            // It's a gradient - use as is.\n            shimmerColor = this.#shimmer.color as ShimmerColorGradient\n          } else {\n            // It's a single color - convert to RGB.\n            shimmerColor = toRgb(this.#shimmer.color as ColorValue)\n          }\n\n          displayText = applyShimmer(displayText, this.#shimmer, {\n            color: shimmerColor,\n            direction: this.#shimmer.mode,\n          })\n        }\n\n        // Apply indentation\n        if (this.#indentation && displayText) {\n          displayText = this.#indentation + displayText\n        }\n\n        return displayText\n      }\n\n      /**\n       * Show a status message without stopping the spinner.\n       * Outputs the symbol and message to stderr, then continues spinning.\n       */\n      #showStatusAndKeepSpinning(symbolType: SymbolType, args: unknown[]) {\n        let text = args.at(0)\n        let extras: unknown[]\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n\n        const { LOG_SYMBOLS, logger } = /*@__PURE__*/ require('./logger.js')\n        // Note: Status messages always go to stderr.\n        logger.error(`${LOG_SYMBOLS[symbolType]} ${text}`, ...extras)\n        return this\n      }\n\n      /**\n       * Update the spinner's displayed text.\n       * Rebuilds display text and triggers render.\n       * @private\n       */\n      #updateSpinnerText() {\n        // Call the parent class's text setter, which triggers render.\n        super.text = this.#buildDisplayText()\n      }\n\n      /**\n       * Show a debug message without stopping the spinner (only if debug mode enabled).\n       * Outputs to stderr and continues spinning.\n       */\n      debug(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#showStatusAndKeepSpinning('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Show a debug message and stop the spinner (only if debug mode enabled).\n       * Auto-clears the spinner line before displaying the message.\n       */\n      debugAndStop(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#apply('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Decrease indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to remove (default: 2)\n       */\n      dedent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          const newLength = Math.max(0, this.#indentation.length - amount)\n          this.#indentation = this.#indentation.slice(0, newLength)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Alias for success() (shorter name).\n       * DESIGN DECISION: Unlike yocto-spinner, our done() does NOT stop the spinner.\n       * Use doneAndStop() if you want to stop the spinner.\n       */\n      done(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a done message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      doneAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Show a failure message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our fail() does NOT stop the spinner.\n       * This allows displaying errors while continuing to spin.\n       * Use failAndStop() if you want to stop the spinner.\n       */\n      fail(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('fail', args)\n      }\n\n      /**\n       * Show a failure message and stop the spinner.\n       * Auto-clears the spinner line before displaying the error message.\n       */\n      failAndStop(...args: unknown[]) {\n        return this.#apply('error', args)\n      }\n\n      /**\n       * Increase indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to add (default: 2)\n       */\n      indent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          this.#indentation += ' '.repeat(amount)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Show an info message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      info(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('info', args)\n      }\n\n      /**\n       * Show an info message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      infoAndStop(...args: unknown[]) {\n        return this.#apply('info', args)\n      }\n\n      /**\n       * Log a message to stdout without stopping the spinner.\n       * Unlike other methods, this outputs to stdout for data logging.\n       */\n      log(...args: unknown[]) {\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        logger.log(...args)\n        return this\n      }\n\n      /**\n       * Log a message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      logAndStop(...args: unknown[]) {\n        return this.#apply('stop', args)\n      }\n\n      /**\n       * Update progress information displayed with the spinner.\n       * Shows a progress bar with percentage and optional unit label.\n       * @param current - Current progress value\n       * @param total - Total progress value\n       * @param unit - Optional unit label (e.g., 'files', 'items')\n       */\n      progress = (\n        current: number,\n        total: number,\n        unit?: string | undefined,\n      ) => {\n        this.#progress = {\n          __proto__: null,\n          current,\n          total,\n          ...(unit ? { unit } : {}),\n        } as ProgressInfo\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Increment progress by a specified amount.\n       * Updates the progress bar displayed with the spinner.\n       * @param amount - Amount to increment (default: 1)\n       */\n      progressStep(amount: number = 1) {\n        if (this.#progress) {\n          const newCurrent = this.#progress.current + amount\n          this.#progress = {\n            __proto__: null,\n            current: Math.max(0, Math.min(newCurrent, this.#progress.total)),\n            total: this.#progress.total,\n            ...(this.#progress.unit ? { unit: this.#progress.unit } : {}),\n          } as ProgressInfo\n          this.#updateSpinnerText()\n        }\n        return this\n      }\n\n      /**\n       * Start the spinner animation with optional text.\n       * Begins displaying the animated spinner.\n       * @param text - Optional text to display with the spinner\n       */\n      start(...args: unknown[]) {\n        if (args.length) {\n          const text = args.at(0)\n          const normalized = normalizeText(text)\n          // We clear this.text on start when `text` is falsy because yocto-spinner\n          // will not clear it otherwise.\n          if (!normalized) {\n            this.#baseText = ''\n            super.text = ''\n          } else {\n            this.#baseText = normalized\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this.#apply('start', args)\n      }\n\n      /**\n       * Log a main step message to stderr without stopping the spinner.\n       * Adds a blank line before the message for visual separation.\n       * Aligns with logger.step() to use stderr for status messages.\n       */\n      step(...args: unknown[]) {\n        const text = args[0]\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        if (typeof text === 'string') {\n          // Add blank line before step for visual separation.\n          logger.error('')\n          // Use error (stderr) to align with logger.step() default stream.\n          logger.error(text, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Log an indented substep message to stderr without stopping the spinner.\n       * Adds 2-space indentation to the message.\n       * Aligns with logger.substep() to use stderr for status messages.\n       */\n      substep(...args: unknown[]) {\n        const text = args[0]\n        if (typeof text === 'string') {\n          // Add 2-space indent for substep.\n          const { logger } = /*@__PURE__*/ require('./logger.js')\n          // Use error (stderr) to align with logger.substep() default stream.\n          logger.error(`  ${text}`, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Stop the spinner animation and clear internal state.\n       * Auto-clears the spinner line via yocto-spinner.stop().\n       * Resets progress, shimmer, and text state.\n       * @param text - Optional final text to display after stopping\n       */\n      stop(...args: unknown[]) {\n        // Clear internal state.\n        this.#baseText = ''\n        this.#progress = undefined\n        // Reset shimmer animation state if shimmer is enabled.\n        if (this.#shimmer) {\n          this.#shimmer.currentDir = DIR_LTR\n          this.#shimmer.step = 0\n        }\n        // Call parent stop first (clears screen, sets isSpinning = false).\n        const result = this.#apply('stop', args)\n        // Then clear text to avoid blank frame render.\n        // This is safe now because isSpinning is false.\n        super.text = ''\n        return result\n      }\n\n      /**\n       * Show a success message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our success() does NOT stop the spinner.\n       * This allows displaying success messages while continuing to spin for multi-step operations.\n       * Use successAndStop() if you want to stop the spinner.\n       */\n      success(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a success message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      successAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Get or set the spinner text.\n       * When called with no arguments, returns the current text.\n       * When called with text, updates the display and returns the spinner.\n       * @param value - Text to display (omit to get current text)\n       * @returns Current text (getter) or this spinner (setter)\n       */\n      text(): string\n      text(value: string): Spinner\n      text(value?: string): string | Spinner {\n        // biome-ignore lint/complexity/noArguments: Function overload for getter/setter pattern.\n        if (arguments.length === 0) {\n          // Getter: return current base text\n          return this.#baseText\n        }\n        // Setter: update base text and refresh display\n        this.#baseText = value ?? ''\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n\n      /**\n       * Show a warning message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      warn(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('warn', args)\n      }\n\n      /**\n       * Show a warning message and stop the spinner.\n       * Auto-clears the spinner line before displaying the warning message.\n       */\n      warnAndStop(...args: unknown[]) {\n        return this.#apply('warning', args)\n      }\n\n      /**\n       * Toggle shimmer effect or update shimmer configuration.\n       * Preserves shimmer config when toggling off, allowing easy re-enable.\n       * Supports partial config updates to tweak specific properties.\n       *\n       * @param enabledOrConfig - Boolean to toggle, partial config to update, or direction string\n       * @returns This spinner for chaining\n       *\n       * @example\n       * // Toggle off (preserves config for later re-enable)\n       * spinner.shimmer(false)\n       *\n       * // Toggle on (restores saved config or uses defaults)\n       * spinner.shimmer(true)\n       *\n       * // Update specific properties\n       * spinner.shimmer({ speed: 0.5 })\n       * spinner.shimmer({ color: [255, 0, 0] })\n       *\n       * // Set direction\n       * spinner.shimmer('rtl')\n       */\n      shimmer(\n        enabledOrConfig:\n          | boolean\n          | Partial<ShimmerConfig>\n          | ShimmerDirection\n          | undefined,\n      ): Spinner {\n        if (enabledOrConfig === false) {\n          // Disable shimmer but preserve config.\n          this.#shimmer = undefined\n        } else if (enabledOrConfig === true) {\n          // Re-enable with saved config or defaults.\n          if (this.#shimmerSavedConfig) {\n            // Restore saved config.\n            this.#shimmer = { ...this.#shimmerSavedConfig }\n          } else {\n            // Create default config.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: DIR_LTR,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (typeof enabledOrConfig === 'string') {\n          // Direction string - update existing or create new.\n          if (this.#shimmer) {\n            // Update existing shimmer direction.\n            this.#shimmer = {\n              ...this.#shimmer,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with direction.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: enabledOrConfig,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (enabledOrConfig && typeof enabledOrConfig === 'object') {\n          // Partial config update - merge with existing or saved config.\n          const partialConfig = {\n            __proto__: null,\n            ...enabledOrConfig,\n          } as Partial<ShimmerConfig>\n\n          if (this.#shimmer) {\n            // Update existing shimmer.\n            this.#shimmer = {\n              ...this.#shimmer,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with partial config.\n            this.#shimmer = {\n              color: partialConfig.color ?? COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: partialConfig.dir ?? DIR_LTR,\n              speed: partialConfig.speed ?? 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n    } as unknown as {\n      new (options?: SpinnerOptions | undefined): Spinner\n    }\n    // Add aliases.\n    Object.defineProperties(_Spinner.prototype, {\n      error: desc(_Spinner.prototype.fail),\n      errorAndStop: desc(_Spinner.prototype.failAndStop),\n      warning: desc(_Spinner.prototype.warn),\n      warningAndStop: desc(_Spinner.prototype.warnAndStop),\n    })\n    _defaultSpinner = CI\n      ? ciSpinner\n      : (getCliSpinners('socket') as SpinnerStyle)\n  }\n  return new _Spinner({\n    spinner: _defaultSpinner,\n    ...options,\n  })\n}\n\nlet _spinner: ReturnType<typeof Spinner> | undefined\n/**\n * Get the default spinner instance.\n * Lazily creates the spinner to avoid circular dependencies during module initialization.\n */\nexport function getDefaultSpinner(): ReturnType<typeof Spinner> {\n  if (_spinner === undefined) {\n    _spinner = Spinner()\n  }\n  return _spinner\n}\n\n/**\n * @deprecated Use `getDefaultSpinner()` function instead for better tree-shaking and to avoid circular dependencies.\n */\nexport const spinner = /* @__PURE__ */ (() => {\n  // Lazy initialization to prevent circular dependency issues during module loading.\n  let _lazySpinner: ReturnType<typeof Spinner> | undefined\n  return new Proxy({} as ReturnType<typeof Spinner>, {\n    get(_target, prop) {\n      if (_lazySpinner === undefined) {\n        _lazySpinner = Spinner()\n      }\n      const value = _lazySpinner[prop as keyof ReturnType<typeof Spinner>]\n      return typeof value === 'function' ? value.bind(_lazySpinner) : value\n    },\n  })\n})()\n\nexport type WithSpinnerOptions<T> = {\n  message: string\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute an async operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinner } from '@socketsecurity/registry/lib/spinner'\n *\n * // With spinner instance\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   },\n *   spinner\n * })\n *\n * // Without spinner instance (no-op)\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   }\n * })\n */\nexport async function withSpinner<T>(\n  options: WithSpinnerOptions<T>,\n): Promise<T> {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerOptions<T>\n\n  if (!spinner) {\n    return await operation()\n  }\n\n  spinner.start(message)\n  try {\n    return await operation()\n  } finally {\n    spinner.stop()\n  }\n}\n\nexport type WithSpinnerRestoreOptions<T> = {\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n  wasSpinning: boolean\n}\n\n/**\n * Execute an async operation with conditional spinner restart.\n * Useful when you need to temporarily stop a spinner for an operation,\n * then restore it to its previous state.\n *\n * @param options - Configuration object\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance to manage\n * @param options.wasSpinning - Whether spinner was spinning before\n * @returns Result of the operation\n * @throws Re-throws any error from operation after restoring spinner state\n *\n * @example\n * import { spinner, withSpinnerRestore } from '@socketsecurity/registry/lib/spinner'\n *\n * const wasSpinning = spinner.isSpinning\n * spinner.stop()\n *\n * const result = await withSpinnerRestore({\n *   operation: async () => {\n *     // Do work without spinner\n *     return await someOperation()\n *   },\n *   spinner,\n *   wasSpinning\n * })\n */\nexport async function withSpinnerRestore<T>(\n  options: WithSpinnerRestoreOptions<T>,\n): Promise<T> {\n  const { operation, spinner, wasSpinning } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerRestoreOptions<T>\n\n  try {\n    return await operation()\n  } finally {\n    if (spinner && wasSpinning) {\n      spinner.start()\n    }\n  }\n}\n\nexport type WithSpinnerSyncOptions<T> = {\n  message: string\n  operation: () => T\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute a synchronous operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinnerSync} from '@socketsecurity/registry/lib/spinner'\n *\n * const result = withSpinnerSync({\n *   message: 'Processing\u2026',\n *   operation: () => {\n *     return processDataSync()\n *   },\n *   spinner\n * })\n */\nexport function withSpinnerSync<T>(options: WithSpinnerSyncOptions<T>): T {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerSyncOptions<T>\n\n  if (!spinner) {\n    return operation()\n  }\n\n  spinner.start(message)\n  try {\n    return operation()\n  } finally {\n    spinner.stop()\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["yoctoSpinner", "options", "spinner"]
+}

package/dist/ssri.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview SSRI (Subresource Integrity) hash format utilities.
+ * Provides conversion and validation for SSRI and hex hash formats.
+ */
+/**
+ * Convert SSRI format hash to hex format.
+ *
+ * Takes a hash in SSRI format (e.g., "sha256-base64hash") and converts it to
+ * standard hex format (e.g., "hexstring").
+ *
+ * @param ssri - Hash in SSRI format (algorithm-base64)
+ * @returns Hex string representation of the hash
+ * @throws Error if SSRI format is invalid
+ *
+ * @example
+ * ```typescript
+ * const hex = ssriToHex('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=')
+ * // Returns: '76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856'
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function ssriToHex(ssri: string): string;
+/**
+ * Convert hex format hash to SSRI format.
+ *
+ * Takes a hash in hex format and converts it to SSRI format with the specified
+ * algorithm prefix (defaults to sha256).
+ *
+ * @param hex - Hash in hex format
+ * @param algorithm - Hash algorithm (default: 'sha256')
+ * @returns SSRI format hash (algorithm-base64)
+ * @throws Error if hex format is invalid
+ *
+ * @example
+ * ```typescript
+ * const ssri = hexToSsri('76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856')
+ * // Returns: 'sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY='
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function hexToSsri(hex: string, algorithm?: string): string;
+/**
+ * Check if a string is valid SSRI format.
+ *
+ * Validates that a string matches the SSRI format pattern (algorithm-base64).
+ * Does not verify that the base64 encoding is valid.
+ *
+ * @param value - String to validate
+ * @returns True if string matches SSRI format
+ *
+ * @example
+ * ```typescript
+ * isValidSsri('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // true
+ * isValidSsri('76682a9f...') // false
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function isValidSsri(value: string): boolean;
+/**
+ * Check if a string is valid hex format.
+ *
+ * Validates that a string contains only hexadecimal characters (0-9, a-f).
+ * Does not verify hash length or algorithm.
+ *
+ * @param value - String to validate
+ * @returns True if string is valid hex format
+ *
+ * @example
+ * ```typescript
+ * isValidHex('76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856') // true
+ * isValidHex('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // false
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function isValidHex(value: string): boolean;
+/**
+ * Parse SSRI format into components.
+ *
+ * Extracts the algorithm and base64 hash from an SSRI string.
+ *
+ * @param ssri - Hash in SSRI format
+ * @returns Object with algorithm and base64Hash properties
+ * @throws Error if SSRI format is invalid
+ *
+ * @example
+ * ```typescript
+ * const { algorithm, base64Hash } = parseSsri('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=')
+ * // Returns: { algorithm: 'sha256', base64Hash: 'dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=' }
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function parseSsri(ssri: string): {
+    algorithm: string;
+    base64Hash: string;
+};

package/dist/ssri.js

@@ -0,0 +1,73 @@
+/* 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 ssri_exports = {};
+__export(ssri_exports, {
+  hexToSsri: () => hexToSsri,
+  isValidHex: () => isValidHex,
+  isValidSsri: () => isValidSsri,
+  parseSsri: () => parseSsri,
+  ssriToHex: () => ssriToHex
+});
+module.exports = __toCommonJS(ssri_exports);
+// @__NO_SIDE_EFFECTS__
+function ssriToHex(ssri) {
+  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri);
+  if (!match || !match[2] || match[2].length < 2) {
+    throw new Error(`Invalid SSRI format: ${ssri}`);
+  }
+  const base64Hash = match[2];
+  const buffer = Buffer.from(base64Hash, "base64");
+  return buffer.toString("hex");
+}
+// @__NO_SIDE_EFFECTS__
+function hexToSsri(hex, algorithm = "sha256") {
+  if (!/^[a-f0-9]+$/i.test(hex)) {
+    throw new Error(`Invalid hex format: ${hex}`);
+  }
+  const buffer = Buffer.from(hex, "hex");
+  const base64Hash = buffer.toString("base64");
+  return `${algorithm}-${base64Hash}`;
+}
+// @__NO_SIDE_EFFECTS__
+function isValidSsri(value) {
+  return /^[a-z0-9]+-[A-Za-z0-9+/]{2,}=*$/i.test(value);
+}
+// @__NO_SIDE_EFFECTS__
+function isValidHex(value) {
+  return /^[a-f0-9]+$/i.test(value);
+}
+// @__NO_SIDE_EFFECTS__
+function parseSsri(ssri) {
+  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri);
+  if (!match || !match[1] || !match[2] || match[2].length < 2) {
+    throw new Error(`Invalid SSRI format: ${ssri}`);
+  }
+  const algorithm = match[1];
+  const base64Hash = match[2];
+  return { algorithm, base64Hash };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hexToSsri,
+  isValidHex,
+  isValidSsri,
+  parseSsri,
+  ssriToHex
+});
+//# sourceMappingURL=ssri.js.map

package/dist/ssri.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ssri.ts"],
+  "sourcesContent": ["/**\n * @fileoverview SSRI (Subresource Integrity) hash format utilities.\n * Provides conversion and validation for SSRI and hex hash formats.\n */\n\n/**\n * Convert SSRI format hash to hex format.\n *\n * Takes a hash in SSRI format (e.g., \"sha256-base64hash\") and converts it to\n * standard hex format (e.g., \"hexstring\").\n *\n * @param ssri - Hash in SSRI format (algorithm-base64)\n * @returns Hex string representation of the hash\n * @throws Error if SSRI format is invalid\n *\n * @example\n * ```typescript\n * const hex = ssriToHex('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=')\n * // Returns: '76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856'\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function ssriToHex(ssri: string): string {\n  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri)\n  if (!match || !match[2] || match[2].length < 2) {\n    throw new Error(`Invalid SSRI format: ${ssri}`)\n  }\n  const base64Hash = match[2]\n  // Convert base64 to hex.\n  const buffer = Buffer.from(base64Hash, 'base64')\n  return buffer.toString('hex')\n}\n\n/**\n * Convert hex format hash to SSRI format.\n *\n * Takes a hash in hex format and converts it to SSRI format with the specified\n * algorithm prefix (defaults to sha256).\n *\n * @param hex - Hash in hex format\n * @param algorithm - Hash algorithm (default: 'sha256')\n * @returns SSRI format hash (algorithm-base64)\n * @throws Error if hex format is invalid\n *\n * @example\n * ```typescript\n * const ssri = hexToSsri('76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856')\n * // Returns: 'sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY='\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function hexToSsri(hex: string, algorithm = 'sha256'): string {\n  if (!/^[a-f0-9]+$/i.test(hex)) {\n    throw new Error(`Invalid hex format: ${hex}`)\n  }\n  // Convert hex to base64.\n  const buffer = Buffer.from(hex, 'hex')\n  const base64Hash = buffer.toString('base64')\n  return `${algorithm}-${base64Hash}`\n}\n\n/**\n * Check if a string is valid SSRI format.\n *\n * Validates that a string matches the SSRI format pattern (algorithm-base64).\n * Does not verify that the base64 encoding is valid.\n *\n * @param value - String to validate\n * @returns True if string matches SSRI format\n *\n * @example\n * ```typescript\n * isValidSsri('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // true\n * isValidSsri('76682a9f...') // false\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isValidSsri(value: string): boolean {\n  return /^[a-z0-9]+-[A-Za-z0-9+/]{2,}=*$/i.test(value)\n}\n\n/**\n * Check if a string is valid hex format.\n *\n * Validates that a string contains only hexadecimal characters (0-9, a-f).\n * Does not verify hash length or algorithm.\n *\n * @param value - String to validate\n * @returns True if string is valid hex format\n *\n * @example\n * ```typescript\n * isValidHex('76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856') // true\n * isValidHex('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // false\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isValidHex(value: string): boolean {\n  return /^[a-f0-9]+$/i.test(value)\n}\n\n/**\n * Parse SSRI format into components.\n *\n * Extracts the algorithm and base64 hash from an SSRI string.\n *\n * @param ssri - Hash in SSRI format\n * @returns Object with algorithm and base64Hash properties\n * @throws Error if SSRI format is invalid\n *\n * @example\n * ```typescript\n * const { algorithm, base64Hash } = parseSsri('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=')\n * // Returns: { algorithm: 'sha256', base64Hash: 'dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=' }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function parseSsri(ssri: string): {\n  algorithm: string\n  base64Hash: string\n} {\n  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri)\n  if (!match || !match[1] || !match[2] || match[2].length < 2) {\n    throw new Error(`Invalid SSRI format: ${ssri}`)\n  }\n  const algorithm = match[1]\n  const base64Hash = match[2]\n  return { algorithm, base64Hash }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,SAAS,UAAU,MAAsB;AAC9C,QAAM,QAAQ,oCAAoC,KAAK,IAAI;AAC3D,MAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,EAAE,SAAS,GAAG;AAC9C,UAAM,IAAI,MAAM,wBAAwB,IAAI,EAAE;AAAA,EAChD;AACA,QAAM,aAAa,MAAM,CAAC;AAE1B,QAAM,SAAS,OAAO,KAAK,YAAY,QAAQ;AAC/C,SAAO,OAAO,SAAS,KAAK;AAC9B;AAAA;AAoBO,SAAS,UAAU,KAAa,YAAY,UAAkB;AACnE,MAAI,CAAC,eAAe,KAAK,GAAG,GAAG;AAC7B,UAAM,IAAI,MAAM,uBAAuB,GAAG,EAAE;AAAA,EAC9C;AAEA,QAAM,SAAS,OAAO,KAAK,KAAK,KAAK;AACrC,QAAM,aAAa,OAAO,SAAS,QAAQ;AAC3C,SAAO,GAAG,SAAS,IAAI,UAAU;AACnC;AAAA;AAkBO,SAAS,YAAY,OAAwB;AAClD,SAAO,mCAAmC,KAAK,KAAK;AACtD;AAAA;AAkBO,SAAS,WAAW,OAAwB;AACjD,SAAO,eAAe,KAAK,KAAK;AAClC;AAAA;AAkBO,SAAS,UAAU,MAGxB;AACA,QAAM,QAAQ,oCAAoC,KAAK,IAAI;AAC3D,MAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,EAAE,SAAS,GAAG;AAC3D,UAAM,IAAI,MAAM,wBAAwB,IAAI,EAAE;AAAA,EAChD;AACA,QAAM,YAAY,MAAM,CAAC;AACzB,QAAM,aAAa,MAAM,CAAC;AAC1B,SAAO,EAAE,WAAW,WAAW;AACjC;",
+  "names": []
+}

package/dist/stdio/clear.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Terminal clearing and cursor utilities.
+ * Provides functions for clearing lines, screens, and managing cursor position.
+ */
+/**
+ * Clear the current line.
+ */
+export declare function clearLine(stream?: NodeJS.WriteStream): void;
+/**
+ * Clear lines above the current position.
+ */
+export declare function clearLines(count: number, stream?: NodeJS.WriteStream): void;
+/**
+ * Clear the entire screen.
+ */
+export declare function clearScreen(stream?: NodeJS.WriteStream): void;
+/**
+ * Clear the visible terminal screen (alias for clearScreen).
+ */
+export declare function clearVisible(stream?: NodeJS.WriteStream): void;
+/**
+ * Move cursor to beginning of line.
+ */
+export declare function cursorToStart(stream?: NodeJS.WriteStream): void;
+/**
+ * Hide the cursor.
+ */
+export declare function hideCursor(stream?: NodeJS.WriteStream): void;
+/**
+ * Show the cursor.
+ */
+export declare function showCursor(stream?: NodeJS.WriteStream): void;
+/**
+ * Save cursor position.
+ */
+export declare function saveCursor(stream?: NodeJS.WriteStream): void;
+/**
+ * Restore cursor position.
+ */
+export declare function restoreCursor(stream?: NodeJS.WriteStream): void;

package/dist/stdio/clear.js

@@ -0,0 +1,84 @@
+/* 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 clear_exports = {};
+__export(clear_exports, {
+  clearLine: () => clearLine,
+  clearLines: () => clearLines,
+  clearScreen: () => clearScreen,
+  clearVisible: () => clearVisible,
+  cursorToStart: () => cursorToStart,
+  hideCursor: () => hideCursor,
+  restoreCursor: () => restoreCursor,
+  saveCursor: () => saveCursor,
+  showCursor: () => showCursor
+});
+module.exports = __toCommonJS(clear_exports);
+function clearLine(stream = process.stdout) {
+  if (stream.isTTY) {
+    stream.cursorTo(0);
+    stream.clearLine(0);
+  } else {
+    stream.write("\r\x1B[K");
+  }
+}
+function clearLines(count, stream = process.stdout) {
+  for (let i = 0; i < count; i++) {
+    stream.write("\x1B[1A\x1B[2K");
+  }
+}
+function clearScreen(stream = process.stdout) {
+  if (stream.isTTY) {
+    stream.write("\x1Bc");
+  }
+}
+function clearVisible(stream = process.stdout) {
+  clearScreen(stream);
+}
+function cursorToStart(stream = process.stdout) {
+  if (stream.isTTY) {
+    stream.cursorTo(0);
+  } else {
+    stream.write("\r");
+  }
+}
+function hideCursor(stream = process.stdout) {
+  stream.write("\x1B[?25l");
+}
+function showCursor(stream = process.stdout) {
+  stream.write("\x1B[?25h");
+}
+function saveCursor(stream = process.stdout) {
+  stream.write("\x1B7");
+}
+function restoreCursor(stream = process.stdout) {
+  stream.write("\x1B8");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearLine,
+  clearLines,
+  clearScreen,
+  clearVisible,
+  cursorToStart,
+  hideCursor,
+  restoreCursor,
+  saveCursor,
+  showCursor
+});
+//# sourceMappingURL=clear.js.map

package/dist/stdio/clear.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/stdio/clear.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Terminal clearing and cursor utilities.\n * Provides functions for clearing lines, screens, and managing cursor position.\n */\n\n/**\n * Clear the current line.\n */\nexport function clearLine(stream: NodeJS.WriteStream = process.stdout): void {\n  if (stream.isTTY) {\n    // TTY: Use cursor control\n    stream.cursorTo(0)\n    stream.clearLine(0)\n  } else {\n    // Non-TTY: Use ANSI escape codes\n    stream.write('\\r\\x1b[K')\n  }\n}\n\n/**\n * Clear lines above the current position.\n */\nexport function clearLines(\n  count: number,\n  stream: NodeJS.WriteStream = process.stdout,\n): void {\n  for (let i = 0; i < count; i++) {\n    // Move up and clear line\n    stream.write('\\x1b[1A\\x1b[2K')\n  }\n}\n\n/**\n * Clear the entire screen.\n */\nexport function clearScreen(stream: NodeJS.WriteStream = process.stdout): void {\n  if (stream.isTTY) {\n    // Clear screen and move cursor to top-left\n    stream.write('\\x1bc')\n  }\n}\n\n/**\n * Clear the visible terminal screen (alias for clearScreen).\n */\nexport function clearVisible(\n  stream: NodeJS.WriteStream = process.stdout,\n): void {\n  clearScreen(stream)\n}\n\n/**\n * Move cursor to beginning of line.\n */\nexport function cursorToStart(\n  stream: NodeJS.WriteStream = process.stdout,\n): void {\n  if (stream.isTTY) {\n    stream.cursorTo(0)\n  } else {\n    stream.write('\\r')\n  }\n}\n\n/**\n * Hide the cursor.\n */\nexport function hideCursor(stream: NodeJS.WriteStream = process.stdout): void {\n  stream.write('\\x1b[?25l')\n}\n\n/**\n * Show the cursor.\n */\nexport function showCursor(stream: NodeJS.WriteStream = process.stdout): void {\n  stream.write('\\x1b[?25h')\n}\n\n/**\n * Save cursor position.\n */\nexport function saveCursor(stream: NodeJS.WriteStream = process.stdout): void {\n  stream.write('\\x1b7')\n}\n\n/**\n * Restore cursor position.\n */\nexport function restoreCursor(\n  stream: NodeJS.WriteStream = process.stdout,\n): void {\n  stream.write('\\x1b8')\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,UAAU,SAA6B,QAAQ,QAAc;AAC3E,MAAI,OAAO,OAAO;AAEhB,WAAO,SAAS,CAAC;AACjB,WAAO,UAAU,CAAC;AAAA,EACpB,OAAO;AAEL,WAAO,MAAM,UAAU;AAAA,EACzB;AACF;AAKO,SAAS,WACd,OACA,SAA6B,QAAQ,QAC/B;AACN,WAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAE9B,WAAO,MAAM,gBAAgB;AAAA,EAC/B;AACF;AAKO,SAAS,YAAY,SAA6B,QAAQ,QAAc;AAC7E,MAAI,OAAO,OAAO;AAEhB,WAAO,MAAM,OAAO;AAAA,EACtB;AACF;AAKO,SAAS,aACd,SAA6B,QAAQ,QAC/B;AACN,cAAY,MAAM;AACpB;AAKO,SAAS,cACd,SAA6B,QAAQ,QAC/B;AACN,MAAI,OAAO,OAAO;AAChB,WAAO,SAAS,CAAC;AAAA,EACnB,OAAO;AACL,WAAO,MAAM,IAAI;AAAA,EACnB;AACF;AAKO,SAAS,WAAW,SAA6B,QAAQ,QAAc;AAC5E,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,WAAW,SAA6B,QAAQ,QAAc;AAC5E,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,WAAW,SAA6B,QAAQ,QAAc;AAC5E,SAAO,MAAM,OAAO;AACtB;AAKO,SAAS,cACd,SAA6B,QAAQ,QAC/B;AACN,SAAO,MAAM,OAAO;AACtB;",
+  "names": []
+}

package/dist/stdio/divider.d.ts

@@ -0,0 +1,48 @@
+export interface DividerOptions {
+    width?: number;
+    char?: string;
+    color?: (text: string) => string;
+}
+/**
+ * Create a divider line with custom character and width.
+ */
+export declare function divider(options?: DividerOptions): string;
+/**
+ * Print a divider line to console.
+ */
+export declare function printDivider(options?: DividerOptions): void;
+/**
+ * Common divider presets.
+ */
+export declare const dividers: {
+    readonly thick: () => string;
+    readonly thin: () => string;
+    readonly double: () => string;
+    readonly single: () => string;
+    readonly dotted: () => string;
+    readonly dashed: () => string;
+    readonly wave: () => string;
+    readonly star: () => string;
+    readonly diamond: () => string;
+    readonly arrow: () => string;
+};
+/**
+ * Print a thick divider (default).
+ */
+export declare function printThickDivider(): void;
+/**
+ * Print a thin divider.
+ */
+export declare function printThinDivider(): void;
+/**
+ * Print a dotted line divider.
+ */
+export declare function printDottedDivider(): void;
+/**
+ * Create a section break with spacing.
+ */
+export declare function sectionBreak(options?: DividerOptions): string;
+/**
+ * Print a section break with spacing.
+ */
+export declare function printSectionBreak(options?: DividerOptions): void;

package/dist/stdio/divider.js

@@ -0,0 +1,81 @@
+/* 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 divider_exports = {};
+__export(divider_exports, {
+  divider: () => divider,
+  dividers: () => dividers,
+  printDivider: () => printDivider,
+  printDottedDivider: () => printDottedDivider,
+  printSectionBreak: () => printSectionBreak,
+  printThickDivider: () => printThickDivider,
+  printThinDivider: () => printThinDivider,
+  sectionBreak: () => sectionBreak
+});
+module.exports = __toCommonJS(divider_exports);
+var import_strings = require("../strings");
+function divider(options) {
+  const opts = { __proto__: null, ...options };
+  const { char = "\u2550", width = 55 } = opts;
+  return (0, import_strings.repeatString)(char, width);
+}
+function printDivider(options) {
+  console.log(divider(options));
+}
+const dividers = {
+  thick: () => divider({ char: "\u2550" }),
+  thin: () => divider({ char: "\u2500" }),
+  double: () => divider({ char: "\u2550" }),
+  single: () => divider({ char: "-" }),
+  dotted: () => divider({ char: "\xB7" }),
+  dashed: () => divider({ char: "\u254C" }),
+  wave: () => divider({ char: "~" }),
+  star: () => divider({ char: "*" }),
+  diamond: () => divider({ char: "\u25C6" }),
+  arrow: () => divider({ char: "\u2192" })
+};
+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,
+  dividers,
+  printDivider,
+  printDottedDivider,
+  printSectionBreak,
+  printThickDivider,
+  printThinDivider,
+  sectionBreak
+});
+//# sourceMappingURL=divider.js.map

package/dist/stdio/divider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/stdio/divider.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Console divider and separator utilities.\n * Provides various line styles for visual separation in CLI output.\n */\n\nimport { repeatString } from '../strings'\n\nexport interface DividerOptions {\n  width?: number\n  char?: string\n  color?: (text: string) => string\n}\n\n/**\n * Create a divider line with custom character and width.\n */\nexport function divider(options?: DividerOptions): string {\n  const opts = { __proto__: null, ...options } as DividerOptions\n  const { char = '\u2550', width = 55 } = opts\n  return repeatString(char, width)\n}\n\n/**\n * Print a divider line to console.\n */\nexport function printDivider(options?: DividerOptions): void {\n  console.log(divider(options))\n}\n\n/**\n * Common divider presets.\n */\nexport const dividers = {\n  thick: () => divider({ char: '\u2550' }),\n  thin: () => divider({ char: '\u2500' }),\n  double: () => divider({ char: '\u2550' }),\n  single: () => divider({ char: '-' }),\n  dotted: () => divider({ char: '\u00B7' }),\n  dashed: () => divider({ char: '\u254C' }),\n  wave: () => divider({ char: '~' }),\n  star: () => divider({ char: '*' }),\n  diamond: () => divider({ char: '\u25C6' }),\n  arrow: () => divider({ char: '\u2192' }),\n} as const\n\n/**\n * Print a thick divider (default).\n */\nexport function printThickDivider(): void {\n  printDivider({ char: '\u2550' })\n}\n\n/**\n * Print a thin divider.\n */\nexport function printThinDivider(): void {\n  printDivider({ char: '\u2500' })\n}\n\n/**\n * Print a dotted line divider.\n */\nexport function printDottedDivider(): void {\n  printDivider({ char: '\u00B7' })\n}\n\n/**\n * Create a section break with spacing.\n */\nexport function sectionBreak(options?: DividerOptions): string {\n  const div = divider(options)\n  return `\\n${div}\\n`\n}\n\n/**\n * Print a section break with spacing.\n */\nexport function printSectionBreak(options?: DividerOptions): void {\n  console.log(sectionBreak(options))\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA6B;AAWtB,SAAS,QAAQ,SAAkC;AACxD,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,EAAE,OAAO,UAAK,QAAQ,GAAG,IAAI;AACnC,aAAO,6BAAa,MAAM,KAAK;AACjC;AAKO,SAAS,aAAa,SAAgC;AAC3D,UAAQ,IAAI,QAAQ,OAAO,CAAC;AAC9B;AAKO,MAAM,WAAW;AAAA,EACtB,OAAO,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA,EAClC,MAAM,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA,EACjC,QAAQ,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA,EACnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,EACnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,OAAI,CAAC;AAAA,EACnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA,EACnC,MAAM,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,EACjC,MAAM,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,EACjC,SAAS,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA,EACpC,OAAO,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AACpC;AAKO,SAAS,oBAA0B;AACxC,eAAa,EAAE,MAAM,SAAI,CAAC;AAC5B;AAKO,SAAS,mBAAyB;AACvC,eAAa,EAAE,MAAM,SAAI,CAAC;AAC5B;AAKO,SAAS,qBAA2B;AACzC,eAAa,EAAE,MAAM,OAAI,CAAC;AAC5B;AAKO,SAAS,aAAa,SAAkC;AAC7D,QAAM,MAAM,QAAQ,OAAO;AAC3B,SAAO;AAAA,EAAK,GAAG;AAAA;AACjB;AAKO,SAAS,kBAAkB,SAAgC;AAChE,UAAQ,IAAI,aAAa,OAAO,CAAC;AACnC;",
+  "names": []
+}

package/dist/stdio/footer.d.ts

@@ -0,0 +1,25 @@
+export interface FooterOptions {
+    width?: number | undefined;
+    borderChar?: string | undefined;
+    showTimestamp?: boolean | undefined;
+    showDuration?: boolean | undefined;
+    startTime?: number | undefined;
+    color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | 'red' | 'gray' | undefined;
+}
+export interface SummaryStats {
+    total?: number | undefined;
+    success?: number | undefined;
+    failed?: number | undefined;
+    skipped?: number | undefined;
+    warnings?: number | undefined;
+    errors?: number | undefined;
+    duration?: number | undefined;
+}
+/**
+ * Create a formatted footer.
+ */
+export declare function createFooter(message?: string, options?: FooterOptions): string;
+/**
+ * Create a summary footer with statistics.
+ */
+export declare function createSummaryFooter(stats: SummaryStats, options?: FooterOptions): string;