@socketsecurity/lib 3.0.4 → 3.0.6

package/CHANGELOG.md

@@ -5,6 +5,61 @@ 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.0.6](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.6) - 2025-11-01
+
+### Added
+
+- **Build validation**: Added guard against `link:` protocol dependencies in package.json
+  - New `validate-no-link-deps.mjs` script automatically runs during `pnpm run check`
+  - Prevents accidental publication with `link:` dependencies which can cause issues
+  - Recommends using `workspace:` for monorepos or `catalog:` for centralized version management
+  - Validates all dependency fields: dependencies, devDependencies, peerDependencies, optionalDependencies
+
+### Changed
+
+- **Dependencies**: Updated `@socketregistry/packageurl-js` to 1.3.3
+- **Git hooks**: Committed pre-commit and pre-push hook configurations for version control
+- **Scripts**: Removed shebang from `validate-no-link-deps` script (Node.js script, not shell)
+
+## [3.0.5](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.5) - 2025-11-01
+
+### Fixed
+
+- **Critical: Prompts API breaking changes**: Restored working prompts implementation that was accidentally replaced with non-functional stub in v3.0.0
+  - Consolidated all prompts functionality into `src/stdio/prompts.ts`
+  - Removed unimplemented stub from `src/prompts/` that was throwing "not yet implemented" errors
+  - Removed `./prompts` package export (use `@socketsecurity/lib/stdio/prompts` instead)
+  - Restored missing exports: `password`, `search`, `Separator`, and added `createSeparator()` helper
+  - Fixed `Choice` type to use correct `name` property (matching `@inquirer` API, not erroneous `label`)
+
+### Added
+
+- **Theme integration for prompts**: Prompts now automatically use the active theme colors
+  - Prompt messages styled with `colors.prompt`
+  - Descriptions and disabled items styled with `colors.textDim`
+  - Answers and highlights styled with `colors.primary`
+  - Error messages styled with `colors.error`
+  - Success indicators styled with `colors.success`
+  - Exported `createInquirerTheme()` function for converting Socket themes to @inquirer format
+  - Consistent visual experience with Logger and Spinner theme integration
+
+- **Theme parameter support**: Logger, Prompts, and text effects now accept optional `theme` parameter
+  - Pass theme names (`'socket'`, `'sunset'`, `'terracotta'`, `'lush'`, `'ultra'`) or Theme objects
+  - **Logger**: `new Logger({ theme: 'sunset' })` - uses theme-specific symbol colors
+  - **Prompts**: `await input({ message: 'Name:', theme: 'ultra' })` - uses theme for prompt styling
+  - **Text effects**: `applyShimmer(text, state, { theme: 'terracotta' })` - uses theme for shimmer colors
+  - Instance-specific themes override global theme context when provided
+  - Falls back to global theme context when no instance theme specified
+  - **Note**: Spinner already had theme parameter support in v3.0.0
+
+### Removed
+
+- **Unused index entrypoint**: Removed `src/index.ts` and package exports for `"."` and `"./index"`
+  - This was a leftover from socket-registry and not needed for this library
+  - Users should import specific modules directly (e.g., `@socketsecurity/lib/logger`)
+  - Breaking: `import { getDefaultLogger } from '@socketsecurity/lib'` no longer works
+  - Use: `import { getDefaultLogger } from '@socketsecurity/lib/logger'` instead
+
 ## [3.0.4](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.4) - 2025-11-01
 
 ### Changed

package/dist/effects/pulse-frames.d.ts

@@ -6,6 +6,13 @@
 export type SocketFramesOptions = {
     readonly baseColor?: readonly [number, number, number] | undefined;
     readonly interval?: number | undefined;
+    /**
+     * Theme to use for pulse colors.
+     * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.
+     * Note: Currently frames only contain brightness modifiers.
+     * Colors are applied by yocto-spinner based on spinner.color.
+     */
+    readonly theme?: import('../themes/types').Theme | import('../themes/themes').ThemeName | undefined;
 };
 /**
  * Generate Socket pulse animation frames.

package/dist/effects/pulse-frames.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/effects/pulse-frames.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Socket pulse animation frames generator.\n * Generates themeable pulsing animation frames using sparkles (\u2727 \u2726) and lightning (\u26A1).\n * Follows the cli-spinners format: https://github.com/sindresorhus/cli-spinners\n */\n\nexport type SocketFramesOptions = {\n  readonly baseColor?: readonly [number, number, number] | undefined\n  readonly interval?: number | undefined\n}\n\n/**\n * Generate Socket pulse animation frames.\n * Creates a pulsing throbber using Unicode sparkles and lightning symbols.\n * Frames use brightness modifiers (bold/dim) but no embedded colors.\n * Yocto-spinner applies the current spinner color to each frame.\n *\n * Returns a spinner definition compatible with cli-spinners format.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n */\nexport function generateSocketSpinnerFrames(\n  options?: SocketFramesOptions | undefined,\n): {\n  frames: string[]\n  interval: number\n} {\n  const opts = { __proto__: null, ...options } as SocketFramesOptions\n  const interval = opts.interval ?? 50\n\n  // ANSI codes for brightness modifiers only (no colors).\n  // Yocto-spinner will apply the spinner's current color to each frame.\n  const bold = '\\x1b[1m'\n  const dim = '\\x1b[2m'\n  const reset = '\\x1b[0m'\n\n  // Using VS15 (\\uFE0E) to force text-style rendering.\n  // Lightning bolt (\u26A1) is wider than stars. To keep consistent spacing:\n  // - All frames have NO internal padding\n  // - Yocto-spinner adds 1 space after each frame\n  // - Success/fail symbols also get 1 space (consistent)\n  const lightning = '\u26A1\\uFE0E'\n  const starFilled = '\u2726\\uFE0E'\n  const starOutline = '\u2727\\uFE0E'\n  const starTiny = '\u22C6\\uFE0E'\n\n  // Pulse frames with brightness modifiers only.\n  // Each frame gets colored by yocto-spinner based on current spinner.color.\n  // Yocto-spinner adds 1 space after the frame automatically.\n  const frames = [\n    // Build up from dim to bright\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    // Fade down\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${dim}${starOutline}${reset}`,\n  ]\n\n  return {\n    __proto__: null,\n    frames,\n    interval,\n  } as { frames: string[]; interval: number }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,4BACd,SAIA;AACA,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,WAAW,KAAK,YAAY;AAIlC,QAAM,OAAO;AACb,QAAM,MAAM;AACZ,QAAM,QAAQ;AAOd,QAAM,YAAY;AAClB,QAAM,aAAa;AACnB,QAAM,cAAc;AACpB,QAAM,WAAW;AAKjB,QAAM,SAAS;AAAA;AAAA,IAEb,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA;AAAA,IAE3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,EAC9B;AAEA,SAAO;AAAA,IACL,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;",
+  "sourcesContent": ["/**\n * @fileoverview Socket pulse animation frames generator.\n * Generates themeable pulsing animation frames using sparkles (\u2727 \u2726) and lightning (\u26A1).\n * Follows the cli-spinners format: https://github.com/sindresorhus/cli-spinners\n */\n\nexport type SocketFramesOptions = {\n  readonly baseColor?: readonly [number, number, number] | undefined\n  readonly interval?: number | undefined\n  /**\n   * Theme to use for pulse colors.\n   * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.\n   * Note: Currently frames only contain brightness modifiers.\n   * Colors are applied by yocto-spinner based on spinner.color.\n   */\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\n/**\n * Generate Socket pulse animation frames.\n * Creates a pulsing throbber using Unicode sparkles and lightning symbols.\n * Frames use brightness modifiers (bold/dim) but no embedded colors.\n * Yocto-spinner applies the current spinner color to each frame.\n *\n * Returns a spinner definition compatible with cli-spinners format.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n */\nexport function generateSocketSpinnerFrames(\n  options?: SocketFramesOptions | undefined,\n): {\n  frames: string[]\n  interval: number\n} {\n  const opts = { __proto__: null, ...options } as SocketFramesOptions\n  const interval = opts.interval ?? 50\n\n  // ANSI codes for brightness modifiers only (no colors).\n  // Yocto-spinner will apply the spinner's current color to each frame.\n  const bold = '\\x1b[1m'\n  const dim = '\\x1b[2m'\n  const reset = '\\x1b[0m'\n\n  // Using VS15 (\\uFE0E) to force text-style rendering.\n  // Lightning bolt (\u26A1) is wider than stars. To keep consistent spacing:\n  // - All frames have NO internal padding\n  // - Yocto-spinner adds 1 space after each frame\n  // - Success/fail symbols also get 1 space (consistent)\n  const lightning = '\u26A1\\uFE0E'\n  const starFilled = '\u2726\\uFE0E'\n  const starOutline = '\u2727\\uFE0E'\n  const starTiny = '\u22C6\\uFE0E'\n\n  // Pulse frames with brightness modifiers only.\n  // Each frame gets colored by yocto-spinner based on current spinner.color.\n  // Yocto-spinner adds 1 space after the frame automatically.\n  const frames = [\n    // Build up from dim to bright\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    // Fade down\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${dim}${starOutline}${reset}`,\n  ]\n\n  return {\n    __proto__: null,\n    frames,\n    interval,\n  } as { frames: string[]; interval: number }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+BO,SAAS,4BACd,SAIA;AACA,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,WAAW,KAAK,YAAY;AAIlC,QAAM,OAAO;AACb,QAAM,MAAM;AACZ,QAAM,QAAQ;AAOd,QAAM,YAAY;AAClB,QAAM,aAAa;AACnB,QAAM,cAAc;AACpB,QAAM,WAAW;AAKjB,QAAM,SAAS;AAAA;AAAA,IAEb,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA;AAAA,IAE3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,EAC9B;AAEA,SAAO;AAAA,IACL,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/effects/text-shimmer.d.ts

@@ -17,6 +17,7 @@ type ShimmerOptions = {
     readonly direction?: ShimmerDirection | undefined;
     readonly shimmerWidth?: number | undefined;
     readonly styles?: TextStyles | undefined;
+    readonly theme?: import('../themes/types').Theme | import('../themes/themes').ThemeName | undefined;
 };
 export declare const COLOR_INHERIT = "inherit";
 export declare const DIR_LTR = "ltr";

package/dist/effects/text-shimmer.js

@@ -30,6 +30,8 @@ module.exports = __toCommonJS(text_shimmer_exports);
 var import_ansi = require("../ansi");
 var import_arrays = require("../arrays");
 var import_ci = require("#env/ci");
+var import_utils = require("../themes/utils");
+var import_themes = require("../themes/themes");
 function detectStyles(text) {
   return {
     __proto__: null,
@@ -121,7 +123,17 @@ function applyShimmer(text, state, options) {
   const opts = { __proto__: null, ...options };
   const direction = opts.direction ?? DIR_NONE;
   const shimmerWidth = opts.shimmerWidth ?? 2.5;
-  const color = opts.color ?? [140, 82, 255];
+  let color;
+  if (opts.theme) {
+    const theme = typeof opts.theme === "string" ? import_themes.THEMES[opts.theme] : opts.theme;
+    const themeColor = (0, import_utils.resolveColor)(
+      theme.colors.primary,
+      theme.colors
+    );
+    color = typeof themeColor === "string" ? [140, 82, 255] : themeColor;
+  } else {
+    color = opts.color ?? [140, 82, 255];
+  }
   const styles = opts.styles ?? detectStyles(text);
   const plainText = (0, import_ansi.stripAnsi)(text);
   if ((0, import_ci.getCI)() || !plainText || direction === DIR_NONE) {

package/dist/effects/text-shimmer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/effects/text-shimmer.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Text shimmer animation utilities.\n * Provides animated highlight effects for spinner text with configurable directions:\n * - LTR (left-to-right): Shimmer wave moves from left to right\n * - RTL (right-to-left): Shimmer wave moves from right to left\n * - Bidirectional: Alternates between LTR and RTL each cycle\n * - Random: Picks a random direction each cycle\n * - None: No shimmer animation\n *\n * The shimmer effect creates a bright wave that travels across the text,\n * with characters near the wave appearing nearly white and fading to the\n * base color as they get further from the wave position.\n */\n\nimport { ANSI_RESET, stripAnsi } from '../ansi'\nimport { isArray } from '../arrays'\nimport { getCI } from '#env/ci'\n\nimport type {\n  ShimmerColorGradient,\n  ShimmerColorRgb,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n// Re-export types for backward compatibility.\nexport type {\n  ShimmerColor,\n  ShimmerColorGradient,\n  ShimmerColorInherit,\n  ShimmerColorRgb,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n/**\n * Detected text formatting styles from ANSI codes.\n */\ntype TextStyles = {\n  bold: boolean\n  dim: boolean\n  italic: boolean\n  strikethrough: boolean\n  underline: boolean\n}\n\n/**\n * Detect all text formatting styles present in ANSI-coded text.\n * Checks for bold, dim, italic, underline, and strikethrough.\n */\nfunction detectStyles(text: string): TextStyles {\n  return {\n    __proto__: null,\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    bold: /\\x1b\\[1m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    dim: /\\x1b\\[2m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    italic: /\\x1b\\[3m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    strikethrough: /\\x1b\\[9m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    underline: /\\x1b\\[4m/.test(text),\n  } as TextStyles\n}\n\n/**\n * Build ANSI code string from text styles.\n * Returns the concatenated ANSI codes needed to apply the styles.\n */\nfunction stylesToAnsi(styles: TextStyles): string {\n  let codes = ''\n  if (styles.bold) {\n    codes += '\\x1b[1m'\n  }\n  if (styles.dim) {\n    codes += '\\x1b[2m'\n  }\n  if (styles.italic) {\n    codes += '\\x1b[3m'\n  }\n  if (styles.underline) {\n    codes += '\\x1b[4m'\n  }\n  if (styles.strikethrough) {\n    codes += '\\x1b[9m'\n  }\n  return codes\n}\n\n// Internal options for applyShimmer function.\ntype ShimmerOptions = {\n  readonly color?: ShimmerColorRgb | ShimmerColorGradient | undefined\n  readonly direction?: ShimmerDirection | undefined\n  readonly shimmerWidth?: number | undefined\n  readonly styles?: TextStyles | undefined\n}\n\nexport const COLOR_INHERIT = 'inherit'\n\nexport const DIR_LTR = 'ltr'\n\nexport const DIR_NONE = 'none'\n\nexport const DIR_RANDOM = 'random'\n\nexport const DIR_RTL = 'rtl'\n\nexport const MODE_BI = 'bi'\n\n/**\n * Calculate shimmer intensity based on distance from shimmer wave position.\n * Uses a power curve for smooth falloff - characters close to the wave\n * get high intensity (bright white), while distant characters get 0.\n */\nfunction shimmerIntensity(\n  distance: number,\n  shimmerWidth: number = 2.5,\n): number {\n  // Characters beyond shimmer width get no effect.\n  if (distance > shimmerWidth) {\n    return 0\n  }\n  // Smooth falloff using power curve.\n  const normalized = distance / shimmerWidth\n  return (1 - normalized) ** 2.5\n}\n\n/**\n * Blend two RGB colors based on a blend factor (0-1).\n * factor 0 = color1, factor 1 = color2, factor 0.5 = 50/50 blend.\n */\nfunction blendColors(\n  color1: readonly [number, number, number],\n  color2: readonly [number, number, number],\n  factor: number,\n): readonly [number, number, number] {\n  const r = Math.round(color1[0] + (color2[0] - color1[0]) * factor)\n  const g = Math.round(color1[1] + (color2[1] - color1[1]) * factor)\n  const b = Math.round(color1[2] + (color2[2] - color1[2]) * factor)\n  return [r, g, b] as const\n}\n\n/**\n * Render character with shimmer effect based on distance from shimmer position.\n * Characters closer to the shimmer position get brighter (nearly white),\n * while characters further away use the base color.\n * Creates a smooth gradient by blending base color with white based on intensity.\n * Supports both single color and per-character color gradients.\n */\nfunction renderChar(\n  char: string,\n  index: number,\n  shimmerPos: number,\n  baseColor: readonly [number, number, number] | ShimmerColorGradient,\n  styles: TextStyles,\n): string {\n  // Calculate how far this character is from the shimmer wave.\n  const distance = Math.abs(index - shimmerPos)\n  const intensity = shimmerIntensity(distance)\n\n  const styleCode = stylesToAnsi(styles)\n\n  // Get base color for this character (single or per-character from gradient).\n  const charColor: readonly [number, number, number] = isArray(baseColor[0])\n    ? ((baseColor as ShimmerColorGradient)[index % baseColor.length] ?? [\n        140, 82, 255,\n      ])\n    : (baseColor as readonly [number, number, number])\n\n  // If no shimmer intensity, use base color as-is.\n  if (intensity === 0) {\n    const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n    return `${styleCode}${base}${char}${ANSI_RESET}`\n  }\n\n  // Blend base color with white based on intensity to create smooth gradient.\n  // Higher intensity = more white, creating the shimmer wave effect.\n  const white: readonly [number, number, number] = [255, 255, 255] as const\n  const blended = blendColors(charColor, white, intensity)\n\n  const color = `\\x1b[38;2;${blended[0]};${blended[1]};${blended[2]}m`\n  return `${styleCode}${color}${char}${ANSI_RESET}`\n}\n\n/**\n * Calculate shimmer wave position for current animation step.\n * The shimmer wave moves across the text length, with extra space\n * for the wave to fade in/out at the edges.\n */\nfunction getShimmerPos(\n  textLength: number,\n  step: number,\n  currentDir: 'ltr' | 'rtl',\n  shimmerWidth: number = 2.5,\n): number {\n  // Total steps for one complete cycle (text length + fade in/out space).\n  const totalSteps = textLength + shimmerWidth + 2\n\n  // RTL: Shimmer moves from right to left.\n  if (currentDir === DIR_RTL) {\n    return textLength - (step % totalSteps)\n  }\n\n  // LTR: Shimmer moves from left to right.\n  return step % totalSteps\n}\n\n/**\n * Resolve shimmer direction to a concrete 'ltr' or 'rtl' value.\n * Used for initializing shimmer state and picking random directions.\n */\nfunction pickDirection(direction: ShimmerDirection): 'ltr' | 'rtl' {\n  // Random mode: 50/50 chance of LTR or RTL.\n  if (direction === DIR_RANDOM) {\n    return Math.random() < 0.5 ? DIR_LTR : DIR_RTL\n  }\n  // RTL mode: Use RTL direction.\n  if (direction === DIR_RTL) {\n    return DIR_RTL\n  }\n  // LTR mode (or any other): Default to LTR.\n  return DIR_LTR\n}\n\n/**\n * Apply shimmer animation effect to text.\n * This is the main entry point for shimmer animations. It:\n * 1. Strips ANSI codes to get plain text for character positioning\n * 2. Detects any styling (bold, italic, underline, etc.) to preserve\n * 3. Calculates the current shimmer wave position based on animation step\n * 4. Renders each character with appropriate brightness based on distance from wave\n * 5. Updates the animation state for the next frame\n * 6. Handles direction changes for bidirectional and random modes\n */\nexport function applyShimmer(\n  text: string,\n  state: ShimmerState,\n  options?: ShimmerOptions | undefined,\n): string {\n  const opts = { __proto__: null, ...options } as ShimmerOptions\n  const direction = opts.direction ?? DIR_NONE\n  const shimmerWidth = opts.shimmerWidth ?? 2.5\n  // Socket purple.\n  const color = opts.color ?? ([140, 82, 255] as const)\n\n  // Detect text formatting styles from original text.\n  const styles = opts.styles ?? detectStyles(text)\n\n  // Strip ANSI codes to get plain text.\n  const plainText = stripAnsi(text)\n\n  // No shimmer effect in CI or when direction is 'none'.\n  if (getCI() || !plainText || direction === DIR_NONE) {\n    const styleCode = stylesToAnsi(styles)\n\n    // Support gradient colors (array of colors, one per character).\n    const isGradient = isArray(color[0])\n\n    return plainText\n      .split('')\n      .map((char, i) => {\n        const charColor: readonly [number, number, number] = isGradient\n          ? ((color as ShimmerColorGradient)[i % color.length] ?? [\n              140, 82, 255,\n            ])\n          : (color as readonly [number, number, number])\n        const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n        return `${styleCode}${base}${char}${ANSI_RESET}`\n      })\n      .join('')\n  }\n\n  // Calculate shimmer position.\n  const shimmerPos = getShimmerPos(\n    plainText.length,\n    state.step,\n    state.currentDir,\n    shimmerWidth,\n  )\n\n  // Render text with shimmer.\n  const result = plainText\n    .split('')\n    .map((char, i) => renderChar(char, i, shimmerPos, color, styles))\n    .join('')\n\n  // Advance shimmer position by speed amount each frame.\n  // Speed represents steps per frame (e.g., 0.33 = advance 0.33 steps per frame).\n  // This creates smooth animation by moving in small increments every frame\n  // instead of jumping larger distances every N frames.\n  state.step += state.speed\n\n  // Handle bidirectional direction changes.\n  const totalSteps = plainText.length + shimmerWidth + 2\n  if (state.mode === MODE_BI) {\n    if (state.step >= totalSteps) {\n      state.step = 0\n      // Toggle direction every cycle.\n      state.currentDir = state.currentDir === DIR_LTR ? DIR_RTL : DIR_LTR\n    }\n  } else if (state.mode === DIR_RANDOM) {\n    // Change direction randomly at end of each cycle.\n    if (state.step >= totalSteps) {\n      state.step = 0\n      state.currentDir = pickDirection(DIR_RANDOM)\n    }\n  } else {\n    // Reset for continuous loops.\n    if (state.step >= totalSteps) {\n      state.step = 0\n    }\n  }\n\n  return result\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @fileoverview Text shimmer animation utilities.\n * Provides animated highlight effects for spinner text with configurable directions:\n * - LTR (left-to-right): Shimmer wave moves from left to right\n * - RTL (right-to-left): Shimmer wave moves from right to left\n * - Bidirectional: Alternates between LTR and RTL each cycle\n * - Random: Picks a random direction each cycle\n * - None: No shimmer animation\n *\n * The shimmer effect creates a bright wave that travels across the text,\n * with characters near the wave appearing nearly white and fading to the\n * base color as they get further from the wave position.\n */\n\nimport { ANSI_RESET, stripAnsi } from '../ansi'\nimport { isArray } from '../arrays'\nimport { getCI } from '#env/ci'\nimport { resolveColor } from '../themes/utils'\nimport { THEMES } from '../themes/themes'\nimport type { ColorValue } from '../spinner'\n\nimport type {\n  ShimmerColorGradient,\n  ShimmerColorRgb,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n// Re-export types for backward compatibility.\nexport type {\n  ShimmerColor,\n  ShimmerColorGradient,\n  ShimmerColorInherit,\n  ShimmerColorRgb,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n/**\n * Detected text formatting styles from ANSI codes.\n */\ntype TextStyles = {\n  bold: boolean\n  dim: boolean\n  italic: boolean\n  strikethrough: boolean\n  underline: boolean\n}\n\n/**\n * Detect all text formatting styles present in ANSI-coded text.\n * Checks for bold, dim, italic, underline, and strikethrough.\n */\nfunction detectStyles(text: string): TextStyles {\n  return {\n    __proto__: null,\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    bold: /\\x1b\\[1m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    dim: /\\x1b\\[2m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    italic: /\\x1b\\[3m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    strikethrough: /\\x1b\\[9m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    underline: /\\x1b\\[4m/.test(text),\n  } as TextStyles\n}\n\n/**\n * Build ANSI code string from text styles.\n * Returns the concatenated ANSI codes needed to apply the styles.\n */\nfunction stylesToAnsi(styles: TextStyles): string {\n  let codes = ''\n  if (styles.bold) {\n    codes += '\\x1b[1m'\n  }\n  if (styles.dim) {\n    codes += '\\x1b[2m'\n  }\n  if (styles.italic) {\n    codes += '\\x1b[3m'\n  }\n  if (styles.underline) {\n    codes += '\\x1b[4m'\n  }\n  if (styles.strikethrough) {\n    codes += '\\x1b[9m'\n  }\n  return codes\n}\n\n// Internal options for applyShimmer function.\ntype ShimmerOptions = {\n  readonly color?: ShimmerColorRgb | ShimmerColorGradient | undefined\n  readonly direction?: ShimmerDirection | undefined\n  readonly shimmerWidth?: number | undefined\n  readonly styles?: TextStyles | undefined\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\nexport const COLOR_INHERIT = 'inherit'\n\nexport const DIR_LTR = 'ltr'\n\nexport const DIR_NONE = 'none'\n\nexport const DIR_RANDOM = 'random'\n\nexport const DIR_RTL = 'rtl'\n\nexport const MODE_BI = 'bi'\n\n/**\n * Calculate shimmer intensity based on distance from shimmer wave position.\n * Uses a power curve for smooth falloff - characters close to the wave\n * get high intensity (bright white), while distant characters get 0.\n */\nfunction shimmerIntensity(\n  distance: number,\n  shimmerWidth: number = 2.5,\n): number {\n  // Characters beyond shimmer width get no effect.\n  if (distance > shimmerWidth) {\n    return 0\n  }\n  // Smooth falloff using power curve.\n  const normalized = distance / shimmerWidth\n  return (1 - normalized) ** 2.5\n}\n\n/**\n * Blend two RGB colors based on a blend factor (0-1).\n * factor 0 = color1, factor 1 = color2, factor 0.5 = 50/50 blend.\n */\nfunction blendColors(\n  color1: readonly [number, number, number],\n  color2: readonly [number, number, number],\n  factor: number,\n): readonly [number, number, number] {\n  const r = Math.round(color1[0] + (color2[0] - color1[0]) * factor)\n  const g = Math.round(color1[1] + (color2[1] - color1[1]) * factor)\n  const b = Math.round(color1[2] + (color2[2] - color1[2]) * factor)\n  return [r, g, b] as const\n}\n\n/**\n * Render character with shimmer effect based on distance from shimmer position.\n * Characters closer to the shimmer position get brighter (nearly white),\n * while characters further away use the base color.\n * Creates a smooth gradient by blending base color with white based on intensity.\n * Supports both single color and per-character color gradients.\n */\nfunction renderChar(\n  char: string,\n  index: number,\n  shimmerPos: number,\n  baseColor: readonly [number, number, number] | ShimmerColorGradient,\n  styles: TextStyles,\n): string {\n  // Calculate how far this character is from the shimmer wave.\n  const distance = Math.abs(index - shimmerPos)\n  const intensity = shimmerIntensity(distance)\n\n  const styleCode = stylesToAnsi(styles)\n\n  // Get base color for this character (single or per-character from gradient).\n  const charColor: readonly [number, number, number] = isArray(baseColor[0])\n    ? ((baseColor as ShimmerColorGradient)[index % baseColor.length] ?? [\n        140, 82, 255,\n      ])\n    : (baseColor as readonly [number, number, number])\n\n  // If no shimmer intensity, use base color as-is.\n  if (intensity === 0) {\n    const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n    return `${styleCode}${base}${char}${ANSI_RESET}`\n  }\n\n  // Blend base color with white based on intensity to create smooth gradient.\n  // Higher intensity = more white, creating the shimmer wave effect.\n  const white: readonly [number, number, number] = [255, 255, 255] as const\n  const blended = blendColors(charColor, white, intensity)\n\n  const color = `\\x1b[38;2;${blended[0]};${blended[1]};${blended[2]}m`\n  return `${styleCode}${color}${char}${ANSI_RESET}`\n}\n\n/**\n * Calculate shimmer wave position for current animation step.\n * The shimmer wave moves across the text length, with extra space\n * for the wave to fade in/out at the edges.\n */\nfunction getShimmerPos(\n  textLength: number,\n  step: number,\n  currentDir: 'ltr' | 'rtl',\n  shimmerWidth: number = 2.5,\n): number {\n  // Total steps for one complete cycle (text length + fade in/out space).\n  const totalSteps = textLength + shimmerWidth + 2\n\n  // RTL: Shimmer moves from right to left.\n  if (currentDir === DIR_RTL) {\n    return textLength - (step % totalSteps)\n  }\n\n  // LTR: Shimmer moves from left to right.\n  return step % totalSteps\n}\n\n/**\n * Resolve shimmer direction to a concrete 'ltr' or 'rtl' value.\n * Used for initializing shimmer state and picking random directions.\n */\nfunction pickDirection(direction: ShimmerDirection): 'ltr' | 'rtl' {\n  // Random mode: 50/50 chance of LTR or RTL.\n  if (direction === DIR_RANDOM) {\n    return Math.random() < 0.5 ? DIR_LTR : DIR_RTL\n  }\n  // RTL mode: Use RTL direction.\n  if (direction === DIR_RTL) {\n    return DIR_RTL\n  }\n  // LTR mode (or any other): Default to LTR.\n  return DIR_LTR\n}\n\n/**\n * Apply shimmer animation effect to text.\n * This is the main entry point for shimmer animations. It:\n * 1. Strips ANSI codes to get plain text for character positioning\n * 2. Detects any styling (bold, italic, underline, etc.) to preserve\n * 3. Calculates the current shimmer wave position based on animation step\n * 4. Renders each character with appropriate brightness based on distance from wave\n * 5. Updates the animation state for the next frame\n * 6. Handles direction changes for bidirectional and random modes\n */\nexport function applyShimmer(\n  text: string,\n  state: ShimmerState,\n  options?: ShimmerOptions | undefined,\n): string {\n  const opts = { __proto__: null, ...options } as ShimmerOptions\n  const direction = opts.direction ?? DIR_NONE\n  const shimmerWidth = opts.shimmerWidth ?? 2.5\n\n  // Resolve color from theme or use provided color or default Socket purple.\n  let color: ShimmerColorRgb | ShimmerColorGradient\n  if (opts.theme) {\n    // Resolve theme to Theme object\n    const theme =\n      typeof opts.theme === 'string' ? THEMES[opts.theme] : opts.theme\n    // Use theme's primary color\n    const themeColor = resolveColor(\n      theme.colors.primary,\n      theme.colors,\n    ) as ColorValue\n    // Convert ColorValue to ShimmerColorRgb\n    // Fallback to Socket purple if color is a string\n    color =\n      typeof themeColor === 'string' ? ([140, 82, 255] as const) : themeColor\n  } else {\n    color = opts.color ?? ([140, 82, 255] as const)\n  }\n\n  // Detect text formatting styles from original text.\n  const styles = opts.styles ?? detectStyles(text)\n\n  // Strip ANSI codes to get plain text.\n  const plainText = stripAnsi(text)\n\n  // No shimmer effect in CI or when direction is 'none'.\n  if (getCI() || !plainText || direction === DIR_NONE) {\n    const styleCode = stylesToAnsi(styles)\n\n    // Support gradient colors (array of colors, one per character).\n    const isGradient = isArray(color[0])\n\n    return plainText\n      .split('')\n      .map((char, i) => {\n        const charColor: readonly [number, number, number] = isGradient\n          ? ((color as ShimmerColorGradient)[i % color.length] ?? [\n              140, 82, 255,\n            ])\n          : (color as readonly [number, number, number])\n        const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n        return `${styleCode}${base}${char}${ANSI_RESET}`\n      })\n      .join('')\n  }\n\n  // Calculate shimmer position.\n  const shimmerPos = getShimmerPos(\n    plainText.length,\n    state.step,\n    state.currentDir,\n    shimmerWidth,\n  )\n\n  // Render text with shimmer.\n  const result = plainText\n    .split('')\n    .map((char, i) => renderChar(char, i, shimmerPos, color, styles))\n    .join('')\n\n  // Advance shimmer position by speed amount each frame.\n  // Speed represents steps per frame (e.g., 0.33 = advance 0.33 steps per frame).\n  // This creates smooth animation by moving in small increments every frame\n  // instead of jumping larger distances every N frames.\n  state.step += state.speed\n\n  // Handle bidirectional direction changes.\n  const totalSteps = plainText.length + shimmerWidth + 2\n  if (state.mode === MODE_BI) {\n    if (state.step >= totalSteps) {\n      state.step = 0\n      // Toggle direction every cycle.\n      state.currentDir = state.currentDir === DIR_LTR ? DIR_RTL : DIR_LTR\n    }\n  } else if (state.mode === DIR_RANDOM) {\n    // Change direction randomly at end of each cycle.\n    if (state.step >= totalSteps) {\n      state.step = 0\n      state.currentDir = pickDirection(DIR_RANDOM)\n    }\n  } else {\n    // Reset for continuous loops.\n    if (state.step >= totalSteps) {\n      state.step = 0\n    }\n  }\n\n  return result\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/effects/types.d.ts

@@ -20,6 +20,12 @@ export type ShimmerConfig = {
      * Default: 1/3 (~0.33).
      */
     readonly speed?: number | undefined;
+    /**
+     * Theme to use for shimmer colors.
+     * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.
+     * If provided, overrides the color option.
+     */
+    readonly theme?: import('../themes/types').Theme | import('../themes/themes').ThemeName | undefined;
 };
 /**
  * Internal shimmer animation state.

package/dist/effects/types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/effects/types.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Shared types for effects (shimmer, pulse, ultra, etc.).\n * Common type definitions used across multiple effect modules.\n */\n\nexport type ShimmerColorInherit = 'inherit'\n\nexport type ShimmerColorRgb = readonly [number, number, number]\n\nexport type ShimmerColor = ShimmerColorInherit | ShimmerColorRgb\n\nexport type ShimmerColorGradient = readonly ShimmerColorRgb[]\n\nexport type ShimmerDirection = 'ltr' | 'rtl' | 'bi' | 'random' | 'none'\n\n/**\n * Shimmer animation configuration.\n */\nexport type ShimmerConfig = {\n  readonly color?: ShimmerColor | ShimmerColorGradient | undefined\n  readonly dir?: ShimmerDirection | undefined\n  /**\n   * Animation speed in steps per frame.\n   * Lower values = slower shimmer (e.g., 0.33 = ~150ms per step).\n   * Higher values = faster shimmer (e.g., 1.0 = 50ms per step).\n   * Default: 1/3 (~0.33).\n   */\n  readonly speed?: number | undefined\n}\n\n/**\n * Internal shimmer animation state.\n * Tracks current animation position and direction.\n */\nexport type ShimmerState = {\n  currentDir: 'ltr' | 'rtl'\n  mode: ShimmerDirection\n  /**\n   * Animation speed in steps per frame.\n   * The shimmer position advances by this amount every frame.\n   */\n  speed: number\n  /**\n   * Current shimmer position.\n   * Can be fractional for smooth sub-character movement.\n   */\n  step: number\n}\n"],
+  "sourcesContent": ["/**\n * @fileoverview Shared types for effects (shimmer, pulse, ultra, etc.).\n * Common type definitions used across multiple effect modules.\n */\n\nexport type ShimmerColorInherit = 'inherit'\n\nexport type ShimmerColorRgb = readonly [number, number, number]\n\nexport type ShimmerColor = ShimmerColorInherit | ShimmerColorRgb\n\nexport type ShimmerColorGradient = readonly ShimmerColorRgb[]\n\nexport type ShimmerDirection = 'ltr' | 'rtl' | 'bi' | 'random' | 'none'\n\n/**\n * Shimmer animation configuration.\n */\nexport type ShimmerConfig = {\n  readonly color?: ShimmerColor | ShimmerColorGradient | undefined\n  readonly dir?: ShimmerDirection | undefined\n  /**\n   * Animation speed in steps per frame.\n   * Lower values = slower shimmer (e.g., 0.33 = ~150ms per step).\n   * Higher values = faster shimmer (e.g., 1.0 = 50ms per step).\n   * Default: 1/3 (~0.33).\n   */\n  readonly speed?: number | undefined\n  /**\n   * Theme to use for shimmer colors.\n   * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.\n   * If provided, overrides the color option.\n   */\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\n/**\n * Internal shimmer animation state.\n * Tracks current animation position and direction.\n */\nexport type ShimmerState = {\n  currentDir: 'ltr' | 'rtl'\n  mode: ShimmerDirection\n  /**\n   * Animation speed in steps per frame.\n   * The shimmer position advances by this amount every frame.\n   */\n  speed: number\n  /**\n   * Current shimmer position.\n   * Can be fractional for smooth sub-character movement.\n   */\n  step: number\n}\n"],
   "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }