@socketsecurity/lib 1.3.5 → 2.1.0

package/dist/effects/text-shimmer.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var y=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var A=(e,r)=>{for(var t in r)y(e,t,{get:r[t],enumerable:!0})},E=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of G(r))!M.call(e,o)&&o!==t&&y(e,o,{get:()=>r[o],enumerable:!(n=O(r,o))||n.enumerable});return e};var N=e=>E(y({},"__esModule",{value:!0}),e);var H={};A(H,{COLOR_INHERIT:()=>j,DIR_LTR:()=>p,DIR_NONE:()=>x,DIR_RANDOM:()=>a,DIR_RTL:()=>u,MODE_BI:()=>_,applyShimmer:()=>B});module.exports=N(H);var l=require("../ansi"),$=require("../arrays"),C=require("#env/ci");function k(e){return{__proto__:null,bold:/\x1b\[1m/.test(e),dim:/\x1b\[2m/.test(e),italic:/\x1b\[3m/.test(e),strikethrough:/\x1b\[9m/.test(e),underline:/\x1b\[4m/.test(e)}}function D(e){let r="";return e.bold&&(r+="\x1B[1m"),e.dim&&(r+="\x1B[2m"),e.italic&&(r+="\x1B[3m"),e.underline&&(r+="\x1B[4m"),e.strikethrough&&(r+="\x1B[9m"),r}const j="inherit",p="ltr",x="none",a="random",u="rtl",_="bi";function w(e,r=2.5){return e>r?0:(1-e/r)**2.5}function z(e,r,t){const n=Math.round(e[0]+(r[0]-e[0])*t),o=Math.round(e[1]+(r[1]-e[1])*t),s=Math.round(e[2]+(r[2]-e[2])*t);return[n,o,s]}function L(e,r,t,n,o){const s=Math.abs(r-t),m=w(s),b=D(o),i=(0,$.isArray)(n[0])?n[r%n.length]??[140,82,255]:n;if(m===0){const h=`\x1B[38;2;${i[0]};${i[1]};${i[2]}m`;return`${b}${h}${e}${l.ANSI_RESET}`}const d=z(i,[255,255,255],m),c=`\x1B[38;2;${d[0]};${d[1]};${d[2]}m`;return`${b}${c}${e}${l.ANSI_RESET}`}function P(e,r,t,n=2.5){const o=e+n+2;return t===u?e-r%o:r%o}function W(e){return e===a?Math.random()<.5?p:u:e===u?u:p}function B(e,r,t){const n={__proto__:null,...t},o=n.direction??x,s=n.shimmerWidth??2.5,m=n.color??[140,82,255],b=n.styles??k(e),i=(0,l.stripAnsi)(e);if(C.CI||!i||o===x){const h=D(b),S=(0,$.isArray)(m[0]);return i.split("").map((R,T)=>{const f=S?m[T%m.length]??[140,82,255]:m,I=`\x1B[38;2;${f[0]};${f[1]};${f[2]}m`;return`${h}${I}${R}${l.ANSI_RESET}`}).join("")}const g=P(i.length,r.step,r.currentDir,s),d=i.split("").map((h,S)=>L(h,S,g,m,b)).join("");r.step+=r.speed;const c=i.length+s+2;return r.mode===_?r.step>=c&&(r.step=0,r.currentDir=r.currentDir===p?u:p):r.mode===a?r.step>=c&&(r.step=0,r.currentDir=W(a)):r.step>=c&&(r.step=0),d}0&&(module.exports={COLOR_INHERIT,DIR_LTR,DIR_NONE,DIR_RANDOM,DIR_RTL,MODE_BI,applyShimmer});
+var y=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var A=(e,r)=>{for(var t in r)y(e,t,{get:r[t],enumerable:!0})},E=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of G(r))!M.call(e,o)&&o!==t&&y(e,o,{get:()=>r[o],enumerable:!(n=O(r,o))||n.enumerable});return e};var N=e=>E(y({},"__esModule",{value:!0}),e);var H={};A(H,{COLOR_INHERIT:()=>j,DIR_LTR:()=>p,DIR_NONE:()=>x,DIR_RANDOM:()=>a,DIR_RTL:()=>u,MODE_BI:()=>_,applyShimmer:()=>B});module.exports=N(H);var l=require("../ansi"),$=require("../arrays"),C=require("#env/ci");function k(e){return{__proto__:null,bold:/\x1b\[1m/.test(e),dim:/\x1b\[2m/.test(e),italic:/\x1b\[3m/.test(e),strikethrough:/\x1b\[9m/.test(e),underline:/\x1b\[4m/.test(e)}}function D(e){let r="";return e.bold&&(r+="\x1B[1m"),e.dim&&(r+="\x1B[2m"),e.italic&&(r+="\x1B[3m"),e.underline&&(r+="\x1B[4m"),e.strikethrough&&(r+="\x1B[9m"),r}const j="inherit",p="ltr",x="none",a="random",u="rtl",_="bi";function w(e,r=2.5){return e>r?0:(1-e/r)**2.5}function z(e,r,t){const n=Math.round(e[0]+(r[0]-e[0])*t),o=Math.round(e[1]+(r[1]-e[1])*t),s=Math.round(e[2]+(r[2]-e[2])*t);return[n,o,s]}function L(e,r,t,n,o){const s=Math.abs(r-t),m=w(s),b=D(o),i=(0,$.isArray)(n[0])?n[r%n.length]??[140,82,255]:n;if(m===0){const h=`\x1B[38;2;${i[0]};${i[1]};${i[2]}m`;return`${b}${h}${e}${l.ANSI_RESET}`}const d=z(i,[255,255,255],m),c=`\x1B[38;2;${d[0]};${d[1]};${d[2]}m`;return`${b}${c}${e}${l.ANSI_RESET}`}function P(e,r,t,n=2.5){const o=e+n+2;return t===u?e-r%o:r%o}function W(e){return e===a?Math.random()<.5?p:u:e===u?u:p}function B(e,r,t){const n={__proto__:null,...t},o=n.direction??x,s=n.shimmerWidth??2.5,m=n.color??[140,82,255],b=n.styles??k(e),i=(0,l.stripAnsi)(e);if((0,C.getCI)()||!i||o===x){const h=D(b),S=(0,$.isArray)(m[0]);return i.split("").map((R,T)=>{const f=S?m[T%m.length]??[140,82,255]:m,I=`\x1B[38;2;${f[0]};${f[1]};${f[2]}m`;return`${h}${I}${R}${l.ANSI_RESET}`}).join("")}const g=P(i.length,r.step,r.currentDir,s),d=i.split("").map((h,S)=>L(h,S,g,m,b)).join("");r.step+=r.speed;const c=i.length+s+2;return r.mode===_?r.step>=c&&(r.step=0,r.currentDir=r.currentDir===p?u:p):r.mode===a?r.step>=c&&(r.step=0,r.currentDir=W(a)):r.step>=c&&(r.step=0),d}0&&(module.exports={COLOR_INHERIT,DIR_LTR,DIR_NONE,DIR_RANDOM,DIR_RTL,MODE_BI,applyShimmer});
 //# sourceMappingURL=text-shimmer.js.map

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 { CI } 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 (CI || !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'\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": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mBAAAE,EAAA,YAAAC,EAAA,aAAAC,EAAA,eAAAC,EAAA,YAAAC,EAAA,YAAAC,EAAA,iBAAAC,IAAA,eAAAC,EAAAT,GAcA,IAAAU,EAAsC,mBACtCC,EAAwB,qBACxBC,EAAsB,mBAmCtB,SAASC,EAAaC,EAA0B,CAC9C,MAAO,CACL,UAAW,KAEX,KAAM,WAAW,KAAKA,CAAI,EAE1B,IAAK,WAAW,KAAKA,CAAI,EAEzB,OAAQ,WAAW,KAAKA,CAAI,EAE5B,cAAe,WAAW,KAAKA,CAAI,EAEnC,UAAW,WAAW,KAAKA,CAAI,CACjC,CACF,CAMA,SAASC,EAAaC,EAA4B,CAChD,IAAIC,EAAQ,GACZ,OAAID,EAAO,OACTC,GAAS,WAEPD,EAAO,MACTC,GAAS,WAEPD,EAAO,SACTC,GAAS,WAEPD,EAAO,YACTC,GAAS,WAEPD,EAAO,gBACTC,GAAS,WAEJA,CACT,CAUO,MAAMf,EAAgB,UAEhBC,EAAU,MAEVC,EAAW,OAEXC,EAAa,SAEbC,EAAU,MAEVC,EAAU,KAOvB,SAASW,EACPC,EACAC,EAAuB,IACf,CAER,OAAID,EAAWC,EACN,GAID,EADWD,EAAWC,IACH,GAC7B,CAMA,SAASC,EACPC,EACAC,EACAC,EACmC,CACnC,MAAMC,EAAI,KAAK,MAAMH,EAAO,CAAC,GAAKC,EAAO,CAAC,EAAID,EAAO,CAAC,GAAKE,CAAM,EAC3DE,EAAI,KAAK,MAAMJ,EAAO,CAAC,GAAKC,EAAO,CAAC,EAAID,EAAO,CAAC,GAAKE,CAAM,EAC3DG,EAAI,KAAK,MAAML,EAAO,CAAC,GAAKC,EAAO,CAAC,EAAID,EAAO,CAAC,GAAKE,CAAM,EACjE,MAAO,CAACC,EAAGC,EAAGC,CAAC,CACjB,CASA,SAASC,EACPC,EACAC,EACAC,EACAC,EACAhB,EACQ,CAER,MAAMG,EAAW,KAAK,IAAIW,EAAQC,CAAU,EACtCE,EAAYf,EAAiBC,CAAQ,EAErCe,EAAYnB,EAAaC,CAAM,EAG/BmB,KAA+C,WAAQH,EAAU,CAAC,CAAC,EACnEA,EAAmCF,EAAQE,EAAU,MAAM,GAAK,CAChE,IAAK,GAAI,GACX,EACCA,EAGL,GAAIC,IAAc,EAAG,CACnB,MAAMG,EAAO,aAAaD,EAAU,CAAC,CAAC,IAAIA,EAAU,CAAC,CAAC,IAAIA,EAAU,CAAC,CAAC,IACtE,MAAO,GAAGD,CAAS,GAAGE,CAAI,GAAGP,CAAI,GAAG,YAAU,EAChD,CAKA,MAAMQ,EAAUhB,EAAYc,EADqB,CAAC,IAAK,IAAK,GAAG,EACjBF,CAAS,EAEjDK,EAAQ,aAAaD,EAAQ,CAAC,CAAC,IAAIA,EAAQ,CAAC,CAAC,IAAIA,EAAQ,CAAC,CAAC,IACjE,MAAO,GAAGH,CAAS,GAAGI,CAAK,GAAGT,CAAI,GAAG,YAAU,EACjD,CAOA,SAASU,EACPC,EACAC,EACAC,EACAtB,EAAuB,IACf,CAER,MAAMuB,EAAaH,EAAapB,EAAe,EAG/C,OAAIsB,IAAepC,EACVkC,EAAcC,EAAOE,EAIvBF,EAAOE,CAChB,CAMA,SAASC,EAAcC,EAA4C,CAEjE,OAAIA,IAAcxC,EACT,KAAK,OAAO,EAAI,GAAMF,EAAUG,EAGrCuC,IAAcvC,EACTA,EAGFH,CACT,CAYO,SAASK,EACdM,EACAgC,EACAC,EACQ,CACR,MAAMC,EAAO,CAAE,UAAW,KAAM,GAAGD,CAAQ,EACrCF,EAAYG,EAAK,WAAa5C,EAC9BgB,EAAe4B,EAAK,cAAgB,IAEpCV,EAAQU,EAAK,OAAU,CAAC,IAAK,GAAI,GAAG,EAGpChC,EAASgC,EAAK,QAAUnC,EAAaC,CAAI,EAGzCmC,KAAY,aAAUnC,CAAI,EAGhC,MAAI,SAAM,GAAK,CAACmC,GAAaJ,IAAczC,EAAU,CACnD,MAAM8B,EAAYnB,EAAaC,CAAM,EAG/BkC,KAAa,WAAQZ,EAAM,CAAC,CAAC,EAEnC,OAAOW,EACJ,MAAM,EAAE,EACR,IAAI,CAACpB,EAAMsB,IAAM,CAChB,MAAMhB,EAA+Ce,EAC/CZ,EAA+Ba,EAAIb,EAAM,MAAM,GAAK,CACpD,IAAK,GAAI,GACX,EACCA,EACCF,EAAO,aAAaD,EAAU,CAAC,CAAC,IAAIA,EAAU,CAAC,CAAC,IAAIA,EAAU,CAAC,CAAC,IACtE,MAAO,GAAGD,CAAS,GAAGE,CAAI,GAAGP,CAAI,GAAG,YAAU,EAChD,CAAC,EACA,KAAK,EAAE,CACZ,CAGA,MAAME,EAAaQ,EACjBU,EAAU,OACVH,EAAM,KACNA,EAAM,WACN1B,CACF,EAGMgC,EAASH,EACZ,MAAM,EAAE,EACR,IAAI,CAACpB,EAAMsB,IAAMvB,EAAWC,EAAMsB,EAAGpB,EAAYO,EAAOtB,CAAM,CAAC,EAC/D,KAAK,EAAE,EAMV8B,EAAM,MAAQA,EAAM,MAGpB,MAAMH,EAAaM,EAAU,OAAS7B,EAAe,EACrD,OAAI0B,EAAM,OAASvC,EACbuC,EAAM,MAAQH,IAChBG,EAAM,KAAO,EAEbA,EAAM,WAAaA,EAAM,aAAe3C,EAAUG,EAAUH,GAErD2C,EAAM,OAASzC,EAEpByC,EAAM,MAAQH,IAChBG,EAAM,KAAO,EACbA,EAAM,WAAaF,EAAcvC,CAAU,GAIzCyC,EAAM,MAAQH,IAChBG,EAAM,KAAO,GAIVM,CACT",
   "names": ["text_shimmer_exports", "__export", "COLOR_INHERIT", "DIR_LTR", "DIR_NONE", "DIR_RANDOM", "DIR_RTL", "MODE_BI", "applyShimmer", "__toCommonJS", "import_ansi", "import_arrays", "import_ci", "detectStyles", "text", "stylesToAnsi", "styles", "codes", "shimmerIntensity", "distance", "shimmerWidth", "blendColors", "color1", "color2", "factor", "r", "g", "b", "renderChar", "char", "index", "shimmerPos", "baseColor", "intensity", "styleCode", "charColor", "base", "blended", "color", "getShimmerPos", "textLength", "step", "currentDir", "totalSteps", "pickDirection", "direction", "state", "options", "opts", "plainText", "isGradient", "i", "result"]
 }

package/dist/env/ci.d.ts

@@ -1 +1 @@
-export declare const CI: boolean;
+export declare function getCI(): boolean;

package/dist/env/ci.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var n=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var C=(r,o)=>{for(var m in o)n(r,m,{get:o[m],enumerable:!0})},I=(r,o,m,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of s(o))!v.call(r,e)&&e!==m&&n(r,e,{get:()=>o[e],enumerable:!(t=i(o,e))||t.enumerable});return r};var a=r=>I(n({},"__esModule",{value:!0}),r);var l={};C(l,{CI:()=>c});module.exports=a(l);var p=require("node:process"),f=require("#env/helpers");const c=(0,f.envAsBoolean)(p.env.CI);0&&(module.exports={CI});
+var t=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var u=(e,o)=>{for(var r in o)t(e,r,{get:o[r],enumerable:!0})},g=(e,o,r,m)=>{if(o&&typeof o=="object"||typeof o=="function")for(let n of l(o))!p.call(e,n)&&n!==r&&t(e,n,{get:()=>o[n],enumerable:!(m=i(o,n))||m.enumerable});return e};var v=e=>g(t({},"__esModule",{value:!0}),e);var I={};u(I,{getCI:()=>C});module.exports=v(I);var a=require("#env/helpers"),f=require("#env/rewire");function C(){return(0,a.envAsBoolean)((0,f.getEnvValue)("CI"))}0&&(module.exports={getCI});
 //# sourceMappingURL=ci.js.map

package/dist/env/ci.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/ci.ts"],
-  "sourcesContent": ["/**\n * CI environment variable snapshot.\n * Determines if code is running in a Continuous Integration environment.\n */\n\nimport { env } from 'node:process'\n\nimport { envAsBoolean } from '#env/helpers'\n\nexport const CI = envAsBoolean(env['CI'])\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,QAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEpBC,EAA6B,wBAEtB,MAAMH,KAAK,gBAAa,MAAI,EAAK",
-  "names": ["ci_exports", "__export", "CI", "__toCommonJS", "import_node_process", "import_helpers"]
+  "sourcesContent": ["/**\n * CI environment variable getter.\n * Determines if code is running in a Continuous Integration environment.\n */\n\nimport { envAsBoolean } from '#env/helpers'\nimport { getEnvValue } from '#env/rewire'\n\nexport function getCI(): boolean {\n  return envAsBoolean(getEnvValue('CI'))\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,WAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA6B,wBAC7BC,EAA4B,uBAErB,SAASH,GAAiB,CAC/B,SAAO,mBAAa,eAAY,IAAI,CAAC,CACvC",
+  "names": ["ci_exports", "__export", "getCI", "__toCommonJS", "import_helpers", "import_rewire"]
 }

package/dist/env/debug.d.ts

@@ -1 +1 @@
-export declare const DEBUG: string;
+export declare function getDebug(): string | undefined;

package/dist/env/debug.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var G=(r,o)=>{for(var e in o)m(r,e,{get:o[e],enumerable:!0})},U=(r,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of D(o))!E.call(r,t)&&t!==e&&m(r,t,{get:()=>o[t],enumerable:!(n=B(o,t))||n.enumerable});return r};var c=r=>U(m({},"__esModule",{value:!0}),r);var i={};G(i,{DEBUG:()=>f});module.exports=c(i);var p=require("node:process");const f=p.env.DEBUG;0&&(module.exports={DEBUG});
+var u=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var m=(n,e)=>{for(var r in e)u(n,r,{get:e[r],enumerable:!0})},p=(n,e,r,g)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of f(e))!d.call(n,t)&&t!==r&&u(n,t,{get:()=>e[t],enumerable:!(g=o(e,t))||g.enumerable});return n};var D=n=>p(u({},"__esModule",{value:!0}),n);var a={};m(a,{getDebug:()=>E});module.exports=D(a);var i=require("#env/rewire");function E(){return(0,i.getEnvValue)("DEBUG")}0&&(module.exports={getDebug});
 //# sourceMappingURL=debug.js.map

package/dist/env/debug.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/debug.ts"],
-  "sourcesContent": ["/**\n * DEBUG environment variable snapshot.\n * Controls debug output for the debug package.\n */\n\nimport { env } from 'node:process'\n\nexport const DEBUG = env['DEBUG']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,WAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAQ,MAAI",
-  "names": ["debug_exports", "__export", "DEBUG", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * DEBUG environment variable getter.\n * Controls debug output for the debug package.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getDebug(): string | undefined {\n  return getEnvValue('DEBUG')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAA+B,CAC7C,SAAO,eAAY,OAAO,CAC5B",
+  "names": ["debug_exports", "__export", "getDebug", "__toCommonJS", "import_rewire"]
 }

package/dist/env/github.d.ts

@@ -0,0 +1,40 @@
+/**
+ * GITHUB_API_URL environment variable.
+ * GitHub API URL (e.g., https://api.github.com).
+ */
+export declare function getGithubApiUrl(): string | undefined;
+/**
+ * GITHUB_BASE_REF environment variable.
+ * GitHub pull request base branch.
+ */
+export declare function getGithubBaseRef(): string | undefined;
+/**
+ * GITHUB_REF_NAME environment variable.
+ * GitHub branch or tag name.
+ */
+export declare function getGithubRefName(): string | undefined;
+/**
+ * GITHUB_REF_TYPE environment variable.
+ * GitHub ref type (branch or tag).
+ */
+export declare function getGithubRefType(): string | undefined;
+/**
+ * GITHUB_REPOSITORY environment variable.
+ * GitHub repository name in owner/repo format.
+ */
+export declare function getGithubRepository(): string | undefined;
+/**
+ * GITHUB_SERVER_URL environment variable.
+ * GitHub server URL (e.g., https://github.com).
+ */
+export declare function getGithubServerUrl(): string | undefined;
+/**
+ * GITHUB_TOKEN environment variable.
+ * GitHub authentication token for API access.
+ */
+export declare function getGithubToken(): string | undefined;
+/**
+ * GH_TOKEN environment variable.
+ * Alternative GitHub authentication token for API access (used by GitHub CLI).
+ */
+export declare function getGhToken(): string | undefined;

package/dist/env/github.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var u=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var G=(t,e)=>{for(var i in e)u(t,i,{get:e[i],enumerable:!0})},T=(t,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of g(e))!d.call(t,r)&&r!==i&&u(t,r,{get:()=>e[r],enumerable:!(o=f(e,r))||o.enumerable});return t};var R=t=>T(u({},"__esModule",{value:!0}),t);var h={};G(h,{getGhToken:()=>c,getGithubApiUrl:()=>_,getGithubBaseRef:()=>p,getGithubRefName:()=>E,getGithubRefType:()=>U,getGithubRepository:()=>s,getGithubServerUrl:()=>B,getGithubToken:()=>I});module.exports=R(h);var n=require("#env/rewire");function _(){return(0,n.getEnvValue)("GITHUB_API_URL")}function p(){return(0,n.getEnvValue)("GITHUB_BASE_REF")}function E(){return(0,n.getEnvValue)("GITHUB_REF_NAME")}function U(){return(0,n.getEnvValue)("GITHUB_REF_TYPE")}function s(){return(0,n.getEnvValue)("GITHUB_REPOSITORY")}function B(){return(0,n.getEnvValue)("GITHUB_SERVER_URL")}function I(){return(0,n.getEnvValue)("GITHUB_TOKEN")}function c(){return(0,n.getEnvValue)("GH_TOKEN")}0&&(module.exports={getGhToken,getGithubApiUrl,getGithubBaseRef,getGithubRefName,getGithubRefType,getGithubRepository,getGithubServerUrl,getGithubToken});
+//# sourceMappingURL=github.js.map

package/dist/env/github.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/github.ts"],
+  "sourcesContent": ["/**\n * @fileoverview GitHub Actions environment variable getters.\n * Provides access to GitHub Actions CI/CD environment variables.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * GITHUB_API_URL environment variable.\n * GitHub API URL (e.g., https://api.github.com).\n */\nexport function getGithubApiUrl(): string | undefined {\n  return getEnvValue('GITHUB_API_URL')\n}\n\n/**\n * GITHUB_BASE_REF environment variable.\n * GitHub pull request base branch.\n */\nexport function getGithubBaseRef(): string | undefined {\n  return getEnvValue('GITHUB_BASE_REF')\n}\n\n/**\n * GITHUB_REF_NAME environment variable.\n * GitHub branch or tag name.\n */\nexport function getGithubRefName(): string | undefined {\n  return getEnvValue('GITHUB_REF_NAME')\n}\n\n/**\n * GITHUB_REF_TYPE environment variable.\n * GitHub ref type (branch or tag).\n */\nexport function getGithubRefType(): string | undefined {\n  return getEnvValue('GITHUB_REF_TYPE')\n}\n\n/**\n * GITHUB_REPOSITORY environment variable.\n * GitHub repository name in owner/repo format.\n */\nexport function getGithubRepository(): string | undefined {\n  return getEnvValue('GITHUB_REPOSITORY')\n}\n\n/**\n * GITHUB_SERVER_URL environment variable.\n * GitHub server URL (e.g., https://github.com).\n */\nexport function getGithubServerUrl(): string | undefined {\n  return getEnvValue('GITHUB_SERVER_URL')\n}\n\n/**\n * GITHUB_TOKEN environment variable.\n * GitHub authentication token for API access.\n */\nexport function getGithubToken(): string | undefined {\n  return getEnvValue('GITHUB_TOKEN')\n}\n\n/**\n * GH_TOKEN environment variable.\n * Alternative GitHub authentication token for API access (used by GitHub CLI).\n */\nexport function getGhToken(): string | undefined {\n  return getEnvValue('GH_TOKEN')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,EAAA,oBAAAC,EAAA,qBAAAC,EAAA,qBAAAC,EAAA,qBAAAC,EAAA,wBAAAC,EAAA,uBAAAC,EAAA,mBAAAC,IAAA,eAAAC,EAAAV,GAKA,IAAAW,EAA4B,uBAMrB,SAASR,GAAsC,CACpD,SAAO,eAAY,gBAAgB,CACrC,CAMO,SAASC,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC,CAMO,SAASC,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC,CAMO,SAASC,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC,CAMO,SAASC,GAA0C,CACxD,SAAO,eAAY,mBAAmB,CACxC,CAMO,SAASC,GAAyC,CACvD,SAAO,eAAY,mBAAmB,CACxC,CAMO,SAASC,GAAqC,CACnD,SAAO,eAAY,cAAc,CACnC,CAMO,SAASP,GAAiC,CAC/C,SAAO,eAAY,UAAU,CAC/B",
+  "names": ["github_exports", "__export", "getGhToken", "getGithubApiUrl", "getGithubBaseRef", "getGithubRefName", "getGithubRefType", "getGithubRepository", "getGithubServerUrl", "getGithubToken", "__toCommonJS", "import_rewire"]
+}

package/dist/env/home.d.ts

@@ -1 +1 @@
-export declare const HOME: string;
+export declare function getHome(): string | undefined;

package/dist/env/home.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var O=(r,o)=>{for(var e in o)m(r,e,{get:o[e],enumerable:!0})},c=(r,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of H(o))!M.call(r,t)&&t!==e&&m(r,t,{get:()=>o[t],enumerable:!(n=E(o,t))||n.enumerable});return r};var f=r=>c(m({},"__esModule",{value:!0}),r);var s={};O(s,{HOME:()=>i});module.exports=f(s);var p=require("node:process");const i=p.env.HOME;0&&(module.exports={HOME});
+var o=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,e)=>{for(var r in e)o(n,r,{get:e[r],enumerable:!0})},p=(n,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of g(e))!m.call(n,t)&&t!==r&&o(n,t,{get:()=>e[t],enumerable:!(i=f(e,t))||i.enumerable});return n};var E=n=>p(o({},"__esModule",{value:!0}),n);var a={};d(a,{getHome:()=>H});module.exports=E(a);var u=require("#env/rewire");function H(){return(0,u.getEnvValue)("HOME")}0&&(module.exports={getHome});
 //# sourceMappingURL=home.js.map

package/dist/env/home.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/home.ts"],
-  "sourcesContent": ["/**\n * HOME environment variable snapshot.\n * Points to the user's home directory.\n */\n\nimport { env } from 'node:process'\n\nexport const HOME = env['HOME']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAO,MAAI",
-  "names": ["home_exports", "__export", "HOME", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * HOME environment variable getter.\n * Points to the user's home directory.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getHome(): string | undefined {\n  return getEnvValue('HOME')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAA8B,CAC5C,SAAO,eAAY,MAAM,CAC3B",
+  "names": ["home_exports", "__export", "getHome", "__toCommonJS", "import_rewire"]
 }

package/dist/env/locale.d.ts

@@ -0,0 +1,15 @@
+/**
+ * LANG environment variable.
+ * System locale and language settings.
+ */
+export declare function getLang(): string | undefined;
+/**
+ * LC_ALL environment variable.
+ * Override for all locale settings.
+ */
+export declare function getLcAll(): string | undefined;
+/**
+ * LC_MESSAGES environment variable.
+ * Locale setting for message translations.
+ */
+export declare function getLcMessages(): string | undefined;

package/dist/env/locale.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var u=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var d=(e,n)=>{for(var r in n)u(e,r,{get:n[r],enumerable:!0})},s=(e,n,r,g)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of L(n))!f.call(e,t)&&t!==r&&u(e,t,{get:()=>n[t],enumerable:!(g=o(n,t))||g.enumerable});return e};var c=e=>s(u({},"__esModule",{value:!0}),e);var l={};d(l,{getLang:()=>p,getLcAll:()=>A,getLcMessages:()=>a});module.exports=c(l);var i=require("#env/rewire");function p(){return(0,i.getEnvValue)("LANG")}function A(){return(0,i.getEnvValue)("LC_ALL")}function a(){return(0,i.getEnvValue)("LC_MESSAGES")}0&&(module.exports={getLang,getLcAll,getLcMessages});
+//# sourceMappingURL=locale.js.map

package/dist/env/locale.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/locale.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Locale and language environment variable getters.\n * Provides access to system locale settings.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * LANG environment variable.\n * System locale and language settings.\n */\nexport function getLang(): string | undefined {\n  return getEnvValue('LANG')\n}\n\n/**\n * LC_ALL environment variable.\n * Override for all locale settings.\n */\nexport function getLcAll(): string | undefined {\n  return getEnvValue('LC_ALL')\n}\n\n/**\n * LC_MESSAGES environment variable.\n * Locale setting for message translations.\n */\nexport function getLcMessages(): string | undefined {\n  return getEnvValue('LC_MESSAGES')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,aAAAC,EAAA,kBAAAC,IAAA,eAAAC,EAAAL,GAKA,IAAAM,EAA4B,uBAMrB,SAASJ,GAA8B,CAC5C,SAAO,eAAY,MAAM,CAC3B,CAMO,SAASC,GAA+B,CAC7C,SAAO,eAAY,QAAQ,CAC7B,CAMO,SAASC,GAAoC,CAClD,SAAO,eAAY,aAAa,CAClC",
+  "names": ["locale_exports", "__export", "getLang", "getLcAll", "getLcMessages", "__toCommonJS", "import_rewire"]
+}

package/dist/env/node-auth-token.d.ts

@@ -1 +1 @@
-export declare const NODE_AUTH_TOKEN: string;
+export declare function getNodeAuthToken(): string | undefined;

package/dist/env/node-auth-token.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var T=Object.defineProperty;var t=Object.getOwnPropertyDescriptor;var e=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var n=(E,o)=>{for(var O in o)T(E,O,{get:o[O],enumerable:!0})},p=(E,o,O,_)=>{if(o&&typeof o=="object"||typeof o=="function")for(let N of e(o))!m.call(E,N)&&N!==O&&T(E,N,{get:()=>o[N],enumerable:!(_=t(o,N))||_.enumerable});return E};var A=E=>p(T({},"__esModule",{value:!0}),E);var H={};n(H,{NODE_AUTH_TOKEN:()=>D});module.exports=A(H);var r=require("node:process");const D=r.env.NODE_AUTH_TOKEN;0&&(module.exports={NODE_AUTH_TOKEN});
+var r=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var E=(n,e)=>{for(var o in e)r(n,o,{get:e[o],enumerable:!0})},N=(n,e,o,u)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of f(e))!g.call(n,t)&&t!==o&&r(n,t,{get:()=>e[t],enumerable:!(u=d(e,t))||u.enumerable});return n};var T=n=>N(r({},"__esModule",{value:!0}),n);var p={};E(p,{getNodeAuthToken:()=>m});module.exports=T(p);var i=require("#env/rewire");function m(){return(0,i.getEnvValue)("NODE_AUTH_TOKEN")}0&&(module.exports={getNodeAuthToken});
 //# sourceMappingURL=node-auth-token.js.map

package/dist/env/node-auth-token.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/node-auth-token.ts"],
-  "sourcesContent": ["/**\n * NODE_AUTH_TOKEN environment variable snapshot.\n * Authentication token for Node.js package registry access.\n */\n\nimport { env } from 'node:process'\n\nexport const NODE_AUTH_TOKEN = env['NODE_AUTH_TOKEN']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAkB,MAAI",
-  "names": ["node_auth_token_exports", "__export", "NODE_AUTH_TOKEN", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * NODE_AUTH_TOKEN environment variable getter.\n * Authentication token for Node.js package registry access.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getNodeAuthToken(): string | undefined {\n  return getEnvValue('NODE_AUTH_TOKEN')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC",
+  "names": ["node_auth_token_exports", "__export", "getNodeAuthToken", "__toCommonJS", "import_rewire"]
 }

package/dist/env/node-env.d.ts

@@ -1 +1 @@
-export declare const NODE_ENV: string;
+export declare function getNodeEnv(): string | undefined;

package/dist/env/node-env.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var t=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var O=(E,o)=>{for(var r in o)t(E,r,{get:o[r],enumerable:!0})},V=(E,o,r,e)=>{if(o&&typeof o=="object"||typeof o=="function")for(let N of p(o))!D.call(E,N)&&N!==r&&t(E,N,{get:()=>o[N],enumerable:!(e=n(o,N))||e.enumerable});return E};var _=E=>V(t({},"__esModule",{value:!0}),E);var f={};O(f,{NODE_ENV:()=>c});module.exports=_(f);var m=require("node:process");const c=m.env.NODE_ENV;0&&(module.exports={NODE_ENV});
+var o=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var g=(n,e)=>{for(var r in e)o(n,r,{get:e[r],enumerable:!0})},N=(n,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of d(e))!f.call(n,t)&&t!==r&&o(n,t,{get:()=>e[t],enumerable:!(i=E(e,t))||i.enumerable});return n};var m=n=>N(o({},"__esModule",{value:!0}),n);var v={};g(v,{getNodeEnv:()=>p});module.exports=m(v);var u=require("#env/rewire");function p(){return(0,u.getEnvValue)("NODE_ENV")}0&&(module.exports={getNodeEnv});
 //# sourceMappingURL=node-env.js.map

package/dist/env/node-env.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/node-env.ts"],
-  "sourcesContent": ["/**\n * NODE_ENV environment variable snapshot.\n * Indicates the Node.js environment mode (production, development, test).\n */\n\nimport { env } from 'node:process'\n\nexport const NODE_ENV = env['NODE_ENV']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAW,MAAI",
-  "names": ["node_env_exports", "__export", "NODE_ENV", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * NODE_ENV environment variable getter.\n * Indicates the Node.js environment mode (production, development, test).\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getNodeEnv(): string | undefined {\n  return getEnvValue('NODE_ENV')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAAiC,CAC/C,SAAO,eAAY,UAAU,CAC/B",
+  "names": ["node_env_exports", "__export", "getNodeEnv", "__toCommonJS", "import_rewire"]
 }

package/dist/env/npm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * npm_config_registry environment variable.
+ * NPM registry URL configured by package managers.
+ */
+export declare function getNpmConfigRegistry(): string | undefined;
+/**
+ * npm_config_user_agent environment variable.
+ * User agent string set by npm/pnpm/yarn package managers.
+ */
+export declare function getNpmConfigUserAgent(): string | undefined;
+/**
+ * npm_lifecycle_event environment variable.
+ * The name of the npm lifecycle event that's currently running.
+ */
+export declare function getNpmLifecycleEvent(): string | undefined;
+/**
+ * NPM_REGISTRY environment variable.
+ * NPM registry URL override.
+ */
+export declare function getNpmRegistry(): string | undefined;
+/**
+ * NPM_TOKEN environment variable.
+ * Authentication token for NPM registry access.
+ */
+export declare function getNpmToken(): string | undefined;

package/dist/env/npm.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var g=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var c=(e,n)=>{for(var i in n)g(e,i,{get:n[i],enumerable:!0})},d=(e,n,i,f)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of u(n))!p.call(e,r)&&r!==i&&g(e,r,{get:()=>n[r],enumerable:!(f=o(n,r))||f.enumerable});return e};var m=e=>d(g({},"__esModule",{value:!0}),e);var l={};c(l,{getNpmConfigRegistry:()=>s,getNpmConfigUserAgent:()=>_,getNpmLifecycleEvent:()=>N,getNpmRegistry:()=>x,getNpmToken:()=>y});module.exports=m(l);var t=require("#env/rewire");function s(){return(0,t.getEnvValue)("npm_config_registry")}function _(){return(0,t.getEnvValue)("npm_config_user_agent")}function N(){return(0,t.getEnvValue)("npm_lifecycle_event")}function x(){return(0,t.getEnvValue)("NPM_REGISTRY")}function y(){return(0,t.getEnvValue)("NPM_TOKEN")}0&&(module.exports={getNpmConfigRegistry,getNpmConfigUserAgent,getNpmLifecycleEvent,getNpmRegistry,getNpmToken});
+//# sourceMappingURL=npm.js.map

package/dist/env/npm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/npm.ts"],
+  "sourcesContent": ["/**\n * @fileoverview NPM environment variable getters.\n * Provides access to NPM and package manager environment variables.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * npm_config_registry environment variable.\n * NPM registry URL configured by package managers.\n */\nexport function getNpmConfigRegistry(): string | undefined {\n  return getEnvValue('npm_config_registry')\n}\n\n/**\n * npm_config_user_agent environment variable.\n * User agent string set by npm/pnpm/yarn package managers.\n */\nexport function getNpmConfigUserAgent(): string | undefined {\n  return getEnvValue('npm_config_user_agent')\n}\n\n/**\n * npm_lifecycle_event environment variable.\n * The name of the npm lifecycle event that's currently running.\n */\nexport function getNpmLifecycleEvent(): string | undefined {\n  return getEnvValue('npm_lifecycle_event')\n}\n\n/**\n * NPM_REGISTRY environment variable.\n * NPM registry URL override.\n */\nexport function getNpmRegistry(): string | undefined {\n  return getEnvValue('NPM_REGISTRY')\n}\n\n/**\n * NPM_TOKEN environment variable.\n * Authentication token for NPM registry access.\n */\nexport function getNpmToken(): string | undefined {\n  return getEnvValue('NPM_TOKEN')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,EAAA,0BAAAC,EAAA,yBAAAC,EAAA,mBAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAP,GAKA,IAAAQ,EAA4B,uBAMrB,SAASN,GAA2C,CACzD,SAAO,eAAY,qBAAqB,CAC1C,CAMO,SAASC,GAA4C,CAC1D,SAAO,eAAY,uBAAuB,CAC5C,CAMO,SAASC,GAA2C,CACzD,SAAO,eAAY,qBAAqB,CAC1C,CAMO,SAASC,GAAqC,CACnD,SAAO,eAAY,cAAc,CACnC,CAMO,SAASC,GAAkC,CAChD,SAAO,eAAY,WAAW,CAChC",
+  "names": ["npm_exports", "__export", "getNpmConfigRegistry", "getNpmConfigUserAgent", "getNpmLifecycleEvent", "getNpmRegistry", "getNpmToken", "__toCommonJS", "import_rewire"]
+}

package/dist/env/package-manager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Package manager type detected from environment.
+ */
+export type PackageManagerType = 'npm' | 'pnpm' | 'yarn' | 'bun' | null;
+/**
+ * Detect which package manager is currently running based on environment variables.
+ * Checks npm_config_user_agent which all package managers set.
+ *
+ * Detection priority:
+ * 1. npm_config_user_agent (most reliable, set by all package managers)
+ * 2. Binary path analysis (fallback for non-standard environments)
+ *
+ * @returns The detected package manager or null if unable to determine
+ *
+ * @example
+ * ```typescript
+ * // During: npm install
+ * detectPackageManager() // 'npm'
+ *
+ * // During: pnpm install
+ * detectPackageManager() // 'pnpm'
+ *
+ * // During: yarn install
+ * detectPackageManager() // 'yarn'
+ *
+ * // Outside package manager context
+ * detectPackageManager() // null
+ * ```
+ */
+export declare function detectPackageManager(): PackageManagerType;
+/**
+ * Get the package manager name and version from user agent.
+ *
+ * @returns Object with name and version, or null if not available
+ * @example
+ * ```typescript
+ * getPackageManagerInfo()
+ * // { name: 'pnpm', version: '8.15.1' }
+ * ```
+ */
+export declare function getPackageManagerInfo(): {
+    name: string;
+    version: string;
+} | null;
+/**
+ * Get the package manager user agent from environment.
+ * Package managers set npm_config_user_agent with format: "npm/8.19.2 node/v18.12.0 darwin arm64"
+ *
+ * @returns The user agent string or undefined
+ * @example
+ * ```typescript
+ * getPackageManagerUserAgent()
+ * // npm: "npm/10.2.4 node/v20.11.0 darwin arm64 workspaces/false"
+ * // pnpm: "pnpm/8.15.1 npm/? node/v20.11.0 darwin arm64"
+ * // yarn: "yarn/1.22.19 npm/? node/v20.11.0 darwin arm64"
+ * ```
+ */
+export declare function getPackageManagerUserAgent(): string | undefined;

package/dist/env/package-manager.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var t=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var l=(e,n)=>{for(var r in n)t(e,r,{get:n[r],enumerable:!0})},o=(e,n,r,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let a of g(n))!p.call(e,a)&&a!==r&&t(e,a,{get:()=>n[a],enumerable:!(c=s(n,a))||c.enumerable});return e};var m=e=>o(t({},"__esModule",{value:!0}),e);var y={};l(y,{detectPackageManager:()=>d,getPackageManagerInfo:()=>f,getPackageManagerUserAgent:()=>u});module.exports=m(y);var i=require("#env/rewire");function d(){const e=u();if(e){const r=e.match(/^(npm|pnpm|yarn|bun)\//);if(r)return r[1]}const n=process.argv[0];if(n){if(n.includes("/pnpm/")||n.includes("\\pnpm\\"))return"pnpm";if(n.includes("/yarn/")||n.includes("\\yarn\\")||n.includes("/.yarn/")||n.includes("\\.yarn\\"))return"yarn";if(n.includes("/bun/")||n.includes("\\bun\\"))return"bun";if(n.includes("/node_modules/")||n.includes("\\node_modules\\"))return"npm"}return null}function f(){const e=u();if(!e)return null;const n=e.match(/^([^/]+)\/([^\s]+)/);return n?{name:n[1],version:n[2]}:null}function u(){return(0,i.getEnvValue)("npm_config_user_agent")}0&&(module.exports={detectPackageManager,getPackageManagerInfo,getPackageManagerUserAgent});
+//# sourceMappingURL=package-manager.js.map

package/dist/env/package-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/package-manager.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Package manager environment detection.\n * Provides utilities to detect which package manager (npm/pnpm/yarn/bun) is running.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * Package manager type detected from environment.\n */\nexport type PackageManagerType = 'npm' | 'pnpm' | 'yarn' | 'bun' | null\n\n/**\n * Detect which package manager is currently running based on environment variables.\n * Checks npm_config_user_agent which all package managers set.\n *\n * Detection priority:\n * 1. npm_config_user_agent (most reliable, set by all package managers)\n * 2. Binary path analysis (fallback for non-standard environments)\n *\n * @returns The detected package manager or null if unable to determine\n *\n * @example\n * ```typescript\n * // During: npm install\n * detectPackageManager() // 'npm'\n *\n * // During: pnpm install\n * detectPackageManager() // 'pnpm'\n *\n * // During: yarn install\n * detectPackageManager() // 'yarn'\n *\n * // Outside package manager context\n * detectPackageManager() // null\n * ```\n */\nexport function detectPackageManager(): PackageManagerType {\n  const userAgent = getPackageManagerUserAgent()\n\n  if (userAgent) {\n    // User agent format: \"pnpm/8.15.1 npm/? node/v20.11.0 darwin arm64\"\n    // Extract the first part before the slash.\n    const match = userAgent.match(/^(npm|pnpm|yarn|bun)\\//)\n    if (match) {\n      return match[1] as PackageManagerType\n    }\n  }\n\n  // Fallback: Check binary path patterns.\n  const argv0 = process.argv[0]\n  if (argv0) {\n    if (argv0.includes('/pnpm/') || argv0.includes('\\\\pnpm\\\\')) {\n      return 'pnpm'\n    }\n    if (\n      argv0.includes('/yarn/') ||\n      argv0.includes('\\\\yarn\\\\') ||\n      argv0.includes('/.yarn/') ||\n      argv0.includes('\\\\.yarn\\\\')\n    ) {\n      return 'yarn'\n    }\n    if (argv0.includes('/bun/') || argv0.includes('\\\\bun\\\\')) {\n      return 'bun'\n    }\n    // If in node_modules but no other match, assume npm.\n    if (\n      argv0.includes('/node_modules/') ||\n      argv0.includes('\\\\node_modules\\\\')\n    ) {\n      return 'npm'\n    }\n  }\n\n  return null\n}\n\n/**\n * Get the package manager name and version from user agent.\n *\n * @returns Object with name and version, or null if not available\n * @example\n * ```typescript\n * getPackageManagerInfo()\n * // { name: 'pnpm', version: '8.15.1' }\n * ```\n */\nexport function getPackageManagerInfo(): {\n  name: string\n  version: string\n} | null {\n  const userAgent = getPackageManagerUserAgent()\n  if (!userAgent) {\n    return null\n  }\n\n  // Parse \"pnpm/8.15.1 npm/? node/v20.11.0 darwin arm64\".\n  const match = userAgent.match(/^([^/]+)\\/([^\\s]+)/)\n  if (match) {\n    return {\n      name: match[1],\n      version: match[2],\n    }\n  }\n\n  return null\n}\n\n/**\n * Get the package manager user agent from environment.\n * Package managers set npm_config_user_agent with format: \"npm/8.19.2 node/v18.12.0 darwin arm64\"\n *\n * @returns The user agent string or undefined\n * @example\n * ```typescript\n * getPackageManagerUserAgent()\n * // npm: \"npm/10.2.4 node/v20.11.0 darwin arm64 workspaces/false\"\n * // pnpm: \"pnpm/8.15.1 npm/? node/v20.11.0 darwin arm64\"\n * // yarn: \"yarn/1.22.19 npm/? node/v20.11.0 darwin arm64\"\n * ```\n */\nexport function getPackageManagerUserAgent(): string | undefined {\n  return getEnvValue('npm_config_user_agent')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,EAAA,0BAAAC,EAAA,+BAAAC,IAAA,eAAAC,EAAAL,GAKA,IAAAM,EAA4B,uBAgCrB,SAASJ,GAA2C,CACzD,MAAMK,EAAYH,EAA2B,EAE7C,GAAIG,EAAW,CAGb,MAAMC,EAAQD,EAAU,MAAM,wBAAwB,EACtD,GAAIC,EACF,OAAOA,EAAM,CAAC,CAElB,CAGA,MAAMC,EAAQ,QAAQ,KAAK,CAAC,EAC5B,GAAIA,EAAO,CACT,GAAIA,EAAM,SAAS,QAAQ,GAAKA,EAAM,SAAS,UAAU,EACvD,MAAO,OAET,GACEA,EAAM,SAAS,QAAQ,GACvBA,EAAM,SAAS,UAAU,GACzBA,EAAM,SAAS,SAAS,GACxBA,EAAM,SAAS,WAAW,EAE1B,MAAO,OAET,GAAIA,EAAM,SAAS,OAAO,GAAKA,EAAM,SAAS,SAAS,EACrD,MAAO,MAGT,GACEA,EAAM,SAAS,gBAAgB,GAC/BA,EAAM,SAAS,kBAAkB,EAEjC,MAAO,KAEX,CAEA,OAAO,IACT,CAYO,SAASN,GAGP,CACP,MAAMI,EAAYH,EAA2B,EAC7C,GAAI,CAACG,EACH,OAAO,KAIT,MAAMC,EAAQD,EAAU,MAAM,oBAAoB,EAClD,OAAIC,EACK,CACL,KAAMA,EAAM,CAAC,EACb,QAASA,EAAM,CAAC,CAClB,EAGK,IACT,CAeO,SAASJ,GAAiD,CAC/D,SAAO,eAAY,uBAAuB,CAC5C",
+  "names": ["package_manager_exports", "__export", "detectPackageManager", "getPackageManagerInfo", "getPackageManagerUserAgent", "__toCommonJS", "import_rewire", "userAgent", "match", "argv0"]
+}

package/dist/env/path.d.ts

@@ -1 +1 @@
-export declare const PATH: string;
+export declare function getPath(): string | undefined;

package/dist/env/path.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var T=(r,o)=>{for(var e in o)m(r,e,{get:o[e],enumerable:!0})},c=(r,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of H(o))!P.call(r,t)&&t!==e&&m(r,t,{get:()=>o[t],enumerable:!(n=A(o,t))||n.enumerable});return r};var f=r=>c(m({},"__esModule",{value:!0}),r);var s={};T(s,{PATH:()=>i});module.exports=f(s);var p=require("node:process");const i=p.env.PATH;0&&(module.exports={PATH});
+var i=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var d=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},m=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of g(t))!a.call(e,n)&&n!==r&&i(e,n,{get:()=>t[n],enumerable:!(o=f(t,n))||o.enumerable});return e};var p=e=>m(i({},"__esModule",{value:!0}),e);var c={};d(c,{getPath:()=>P});module.exports=p(c);var u=require("#env/rewire");function P(){return(0,u.getEnvValue)("PATH")}0&&(module.exports={getPath});
 //# sourceMappingURL=path.js.map

package/dist/env/path.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/path.ts"],
-  "sourcesContent": ["/**\n * PATH environment variable snapshot.\n * System executable search paths.\n */\n\nimport { env } from 'node:process'\n\nexport const PATH = env['PATH']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAO,MAAI",
-  "names": ["path_exports", "__export", "PATH", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * PATH environment variable getter.\n * System executable search paths.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getPath(): string | undefined {\n  return getEnvValue('PATH')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAA8B,CAC5C,SAAO,eAAY,MAAM,CAC3B",
+  "names": ["path_exports", "__export", "getPath", "__toCommonJS", "import_rewire"]
 }

package/dist/env/pre-commit.d.ts

@@ -1 +1 @@
-export declare const PRE_COMMIT: boolean;
+export declare function getPreCommit(): boolean;

package/dist/env/pre-commit.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var n=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var v=(r,o)=>{for(var m in o)n(r,m,{get:o[m],enumerable:!0})},C=(r,o,m,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of i(o))!s.call(r,e)&&e!==m&&n(r,e,{get:()=>o[e],enumerable:!(t=f(o,e))||t.enumerable});return r};var E=r=>C(n({},"__esModule",{value:!0}),r);var O={};v(O,{PRE_COMMIT:()=>I});module.exports=E(O);var M=require("node:process"),p=require("#env/helpers");const I=(0,p.envAsBoolean)(M.env.PRE_COMMIT);0&&(module.exports={PRE_COMMIT});
+var n=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var u=(e,o)=>{for(var t in o)n(e,t,{get:o[t],enumerable:!0})},g=(e,o,t,m)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of l(o))!p.call(e,r)&&r!==t&&n(e,r,{get:()=>o[r],enumerable:!(m=f(o,r))||m.enumerable});return e};var v=e=>g(n({},"__esModule",{value:!0}),e);var E={};u(E,{getPreCommit:()=>C});module.exports=v(E);var i=require("#env/helpers"),a=require("#env/rewire");function C(){return(0,i.envAsBoolean)((0,a.getEnvValue)("PRE_COMMIT"))}0&&(module.exports={getPreCommit});
 //# sourceMappingURL=pre-commit.js.map

package/dist/env/pre-commit.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/pre-commit.ts"],
-  "sourcesContent": ["/**\n * PRE_COMMIT environment variable snapshot.\n * Whether running in a pre-commit hook context.\n */\n\nimport { env } from 'node:process'\n\nimport { envAsBoolean } from '#env/helpers'\n\nexport const PRE_COMMIT = envAsBoolean(env['PRE_COMMIT'])\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEpBC,EAA6B,wBAEtB,MAAMH,KAAa,gBAAa,MAAI,UAAa",
-  "names": ["pre_commit_exports", "__export", "PRE_COMMIT", "__toCommonJS", "import_node_process", "import_helpers"]
+  "sourcesContent": ["/**\n * PRE_COMMIT environment variable getter.\n * Whether running in a pre-commit hook context.\n */\n\nimport { envAsBoolean } from '#env/helpers'\nimport { getEnvValue } from '#env/rewire'\n\nexport function getPreCommit(): boolean {\n  return envAsBoolean(getEnvValue('PRE_COMMIT'))\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA6B,wBAC7BC,EAA4B,uBAErB,SAASH,GAAwB,CACtC,SAAO,mBAAa,eAAY,YAAY,CAAC,CAC/C",
+  "names": ["pre_commit_exports", "__export", "getPreCommit", "__toCommonJS", "import_helpers", "import_rewire"]
 }