@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/download-lock.js

@@ -0,0 +1,139 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var download_lock_exports = {};
+__export(download_lock_exports, {
+  downloadWithLock: () => downloadWithLock
+});
+module.exports = __toCommonJS(download_lock_exports);
+var import_node_fs = require("node:fs");
+var import_promises = require("node:fs/promises");
+var import_node_path = require("node:path");
+var import_http_request = require("./http-request");
+function getLockFilePath(destPath, locksDir) {
+  const dir = locksDir || `${(0, import_node_path.dirname)(destPath)}/.locks`;
+  const filename = `${destPath.replace(/[^\w.-]/g, "_")}.lock`;
+  return (0, import_node_path.join)(dir, filename);
+}
+function isLockStale(lockInfo, staleTimeout) {
+  const age = Date.now() - lockInfo.startTime;
+  if (age > staleTimeout) {
+    return true;
+  }
+  try {
+    process.kill(lockInfo.pid, 0);
+    return false;
+  } catch {
+    return true;
+  }
+}
+async function acquireLock(destPath, url, options) {
+  const { lockTimeout, locksDir, pollInterval, staleTimeout } = options;
+  const lockPath = getLockFilePath(destPath, locksDir);
+  const lockDir = (0, import_node_path.dirname)(lockPath);
+  await (0, import_promises.mkdir)(lockDir, { recursive: true });
+  const startTime = Date.now();
+  while (true) {
+    try {
+      if ((0, import_node_fs.existsSync)(lockPath)) {
+        const lockContent = await (0, import_promises.readFile)(lockPath, "utf8");
+        const lockInfo2 = JSON.parse(lockContent);
+        if (isLockStale(lockInfo2, staleTimeout)) {
+          await (0, import_promises.rm)(lockPath, { force: true });
+        } else {
+          if (Date.now() - startTime > lockTimeout) {
+            throw new Error(
+              `Lock acquisition timed out after ${lockTimeout}ms (held by PID ${lockInfo2.pid})`
+            );
+          }
+          await new Promise((resolve) => setTimeout(resolve, pollInterval));
+          continue;
+        }
+      }
+      const lockInfo = {
+        pid: process.pid,
+        startTime: Date.now(),
+        url
+      };
+      await (0, import_promises.writeFile)(lockPath, JSON.stringify(lockInfo, null, 2), {
+        // Use 'wx' flag to fail if file exists (atomic operation)
+        flag: "wx"
+      });
+      return lockPath;
+    } catch (e) {
+      if (e.code === "EEXIST") {
+        if (Date.now() - startTime > lockTimeout) {
+          throw new Error(`Lock acquisition timed out after ${lockTimeout}ms`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
+        continue;
+      }
+      throw e;
+    }
+  }
+}
+async function releaseLock(lockPath) {
+  try {
+    await (0, import_promises.rm)(lockPath, { force: true });
+  } catch {
+  }
+}
+async function downloadWithLock(url, destPath, options) {
+  const {
+    lockTimeout = 6e4,
+    locksDir,
+    pollInterval = 1e3,
+    staleTimeout = 3e5,
+    ...downloadOptions
+  } = { __proto__: null, ...options };
+  if ((0, import_node_fs.existsSync)(destPath)) {
+    const statResult = await (0, import_promises.stat)(destPath).catch(() => null);
+    if (statResult && statResult.size > 0) {
+      return {
+        path: destPath,
+        size: statResult.size
+      };
+    }
+  }
+  const lockPath = await acquireLock(destPath, url, {
+    lockTimeout,
+    locksDir,
+    pollInterval,
+    staleTimeout
+  });
+  try {
+    if ((0, import_node_fs.existsSync)(destPath)) {
+      const statResult = await (0, import_promises.stat)(destPath).catch(() => null);
+      if (statResult && statResult.size > 0) {
+        return {
+          path: destPath,
+          size: statResult.size
+        };
+      }
+    }
+    const result = await (0, import_http_request.httpDownload)(url, destPath, downloadOptions);
+    return result;
+  } finally {
+    await releaseLock(lockPath);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  downloadWithLock
+});
+//# sourceMappingURL=download-lock.js.map

package/dist/download-lock.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/download-lock.ts"],
+  "sourcesContent": ["/** @fileoverview Download locking utilities to prevent concurrent downloads of the same resource. Uses file-based locking for cross-process synchronization. */\n\nimport { existsSync } from 'node:fs'\nimport { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport type { HttpDownloadOptions, HttpDownloadResult } from './http-request'\nimport { httpDownload } from './http-request'\n\nexport interface DownloadLockInfo {\n  pid: number\n  startTime: number\n  url: string\n}\n\nexport interface DownloadWithLockOptions extends HttpDownloadOptions {\n  /**\n   * Maximum time to wait for lock acquisition in milliseconds.\n   * @default 60000 (1 minute)\n   */\n  lockTimeout?: number | undefined\n  /**\n   * Directory where lock files are stored.\n   * @default '<destPath>.locks'\n   */\n  locksDir?: string | undefined\n  /**\n   * Interval for checking stale locks in milliseconds.\n   * @default 1000 (1 second)\n   */\n  pollInterval?: number | undefined\n  /**\n   * Maximum age of a lock before it's considered stale in milliseconds.\n   * @default 300000 (5 minutes)\n   */\n  staleTimeout?: number | undefined\n}\n\n/**\n * Get the path to the lock file for a destination path.\n */\nfunction getLockFilePath(destPath: string, locksDir?: string): string {\n  const dir = locksDir || `${dirname(destPath)}/.locks`\n  const filename = `${destPath.replace(/[^\\w.-]/g, '_')}.lock`\n  return join(dir, filename)\n}\n\n/**\n * Check if a lock is stale (process no longer exists or too old).\n */\nfunction isLockStale(\n  lockInfo: DownloadLockInfo,\n  staleTimeout: number,\n): boolean {\n  // Check if lock is too old\n  const age = Date.now() - lockInfo.startTime\n  if (age > staleTimeout) {\n    return true\n  }\n\n  // Check if process still exists (Node.js specific)\n  try {\n    // process.kill(pid, 0) doesn't actually kill the process\n    // It just checks if the process exists\n    process.kill(lockInfo.pid, 0)\n    return false\n  } catch {\n    // Process doesn't exist\n    return true\n  }\n}\n\n/**\n * Acquire a lock for downloading to a destination path.\n * @throws {Error} When lock cannot be acquired within timeout.\n */\nasync function acquireLock(\n  destPath: string,\n  url: string,\n  options: {\n    lockTimeout: number\n    locksDir?: string | undefined\n    pollInterval: number\n    staleTimeout: number\n  },\n): Promise<string> {\n  const { lockTimeout, locksDir, pollInterval, staleTimeout } = options\n  const lockPath = getLockFilePath(destPath, locksDir)\n  const lockDir = dirname(lockPath)\n\n  // Ensure lock directory exists\n  await mkdir(lockDir, { recursive: true })\n\n  const startTime = Date.now()\n\n  while (true) {\n    try {\n      // Try to read existing lock\n      if (existsSync(lockPath)) {\n        // eslint-disable-next-line no-await-in-loop\n        const lockContent = await readFile(lockPath, 'utf8')\n        const lockInfo: DownloadLockInfo = JSON.parse(lockContent)\n\n        // Check if lock is stale\n        if (isLockStale(lockInfo, staleTimeout)) {\n          // Remove stale lock\n          // eslint-disable-next-line no-await-in-loop\n          await rm(lockPath, { force: true })\n        } else {\n          // Lock is valid, check timeout\n          if (Date.now() - startTime > lockTimeout) {\n            throw new Error(\n              `Lock acquisition timed out after ${lockTimeout}ms (held by PID ${lockInfo.pid})`,\n            )\n          }\n\n          // Wait and retry\n          // eslint-disable-next-line no-await-in-loop\n          await new Promise(resolve => setTimeout(resolve, pollInterval))\n          continue\n        }\n      }\n\n      // Try to create lock file\n      const lockInfo: DownloadLockInfo = {\n        pid: process.pid,\n        startTime: Date.now(),\n        url,\n      }\n\n      // eslint-disable-next-line no-await-in-loop\n      await writeFile(lockPath, JSON.stringify(lockInfo, null, 2), {\n        // Use 'wx' flag to fail if file exists (atomic operation)\n        flag: 'wx',\n      })\n\n      // Successfully acquired lock\n      return lockPath\n    } catch (e) {\n      // If file already exists, another process created it first\n      if ((e as NodeJS.ErrnoException).code === 'EEXIST') {\n        if (Date.now() - startTime > lockTimeout) {\n          throw new Error(`Lock acquisition timed out after ${lockTimeout}ms`)\n        }\n        // eslint-disable-next-line no-await-in-loop\n        await new Promise(resolve => setTimeout(resolve, pollInterval))\n        continue\n      }\n\n      // Other error\n      throw e\n    }\n  }\n}\n\n/**\n * Release a lock by removing the lock file.\n */\nasync function releaseLock(lockPath: string): Promise<void> {\n  try {\n    await rm(lockPath, { force: true })\n  } catch {\n    // Ignore errors when releasing lock\n  }\n}\n\n/**\n * Download a file with locking to prevent concurrent downloads of the same resource.\n * If another process is already downloading to the same destination, this will wait\n * for the download to complete (up to lockTimeout) before proceeding.\n *\n * @throws {Error} When download fails or lock cannot be acquired.\n *\n * @example\n * ```typescript\n * const result = await downloadWithLock(\n *   'https://example.com/file.tar.gz',\n *   '/tmp/downloads/file.tar.gz',\n *   {\n *     retries: 3,\n *     lockTimeout: 60000, // Wait up to 1 minute for other downloads\n *   }\n * )\n * ```\n */\nexport async function downloadWithLock(\n  url: string,\n  destPath: string,\n  options?: DownloadWithLockOptions | undefined,\n): Promise<HttpDownloadResult> {\n  const {\n    lockTimeout = 60_000,\n    locksDir,\n    pollInterval = 1000,\n    staleTimeout = 300_000,\n    ...downloadOptions\n  } = { __proto__: null, ...options } as DownloadWithLockOptions\n\n  // If file already exists and has content, return immediately\n  if (existsSync(destPath)) {\n    const statResult = await stat(destPath).catch(() => null)\n    if (statResult && statResult.size > 0) {\n      return {\n        path: destPath,\n        size: statResult.size,\n      }\n    }\n  }\n\n  // Acquire lock\n  const lockPath = await acquireLock(destPath, url, {\n    lockTimeout,\n    locksDir,\n    pollInterval,\n    staleTimeout,\n  })\n\n  try {\n    // Check again if file was created while we were waiting for lock\n    if (existsSync(destPath)) {\n      const statResult = await stat(destPath).catch(() => null)\n      if (statResult && statResult.size > 0) {\n        return {\n          path: destPath,\n          size: statResult.size,\n        }\n      }\n    }\n\n    // Perform download\n    const result = await httpDownload(url, destPath, downloadOptions)\n\n    return result\n  } finally {\n    // Always release lock\n    await releaseLock(lockPath)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["lockInfo"]
+}

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Socket pulse animation frames generator.
+ * Generates themeable pulsing animation frames using sparkles (✧ ✦) and lightning (⚡).
+ * Follows the cli-spinners format: https://github.com/sindresorhus/cli-spinners
+ */
+export type SocketFramesOptions = {
+    readonly baseColor?: readonly [number, number, number] | undefined;
+    readonly interval?: number | undefined;
+};
+/**
+ * Generate Socket pulse animation frames.
+ * Creates a pulsing throbber using Unicode sparkles and lightning symbols.
+ * Frames use brightness modifiers (bold/dim) but no embedded colors.
+ * Yocto-spinner applies the current spinner color to each frame.
+ *
+ * Returns a spinner definition compatible with cli-spinners format.
+ *
+ * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json
+ */
+export declare function generateSocketSpinnerFrames(options?: SocketFramesOptions | undefined): {
+    frames: string[];
+    interval: number;
+};

package/dist/effects/pulse-frames.js

@@ -0,0 +1,66 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pulse_frames_exports = {};
+__export(pulse_frames_exports, {
+  generateSocketSpinnerFrames: () => generateSocketSpinnerFrames
+});
+module.exports = __toCommonJS(pulse_frames_exports);
+function generateSocketSpinnerFrames(options) {
+  const opts = { __proto__: null, ...options };
+  const interval = opts.interval ?? 50;
+  const bold = "\x1B[1m";
+  const dim = "\x1B[2m";
+  const reset = "\x1B[0m";
+  const lightning = "\u26A1\uFE0E";
+  const starFilled = "\u2726\uFE0E";
+  const starOutline = "\u2727\uFE0E";
+  const starTiny = "\u22C6\uFE0E";
+  const frames = [
+    // Build up from dim to bright
+    `${dim}${starOutline}${reset}`,
+    `${dim}${starOutline}${reset}`,
+    `${dim}${starTiny}${reset}`,
+    `${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    // Fade down
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${dim}${starTiny}${reset}`,
+    `${dim}${starOutline}${reset}`
+  ];
+  return {
+    __proto__: null,
+    frames,
+    interval
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateSocketSpinnerFrames
+});
+//# sourceMappingURL=pulse-frames.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

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

@@ -0,0 +1,37 @@
+import type { ShimmerColorGradient, ShimmerColorRgb, ShimmerDirection, ShimmerState } from './types';
+// Re-export types for backward compatibility.
+export type { ShimmerColor, ShimmerColorGradient, ShimmerColorInherit, ShimmerColorRgb, ShimmerConfig, ShimmerDirection, ShimmerState, } from './types';
+/**
+ * Detected text formatting styles from ANSI codes.
+ */
+type TextStyles = {
+    bold: boolean;
+    dim: boolean;
+    italic: boolean;
+    strikethrough: boolean;
+    underline: boolean;
+};
+// Internal options for applyShimmer function.
+type ShimmerOptions = {
+    readonly color?: ShimmerColorRgb | ShimmerColorGradient | undefined;
+    readonly direction?: ShimmerDirection | undefined;
+    readonly shimmerWidth?: number | undefined;
+    readonly styles?: TextStyles | undefined;
+};
+export declare const COLOR_INHERIT = "inherit";
+export declare const DIR_LTR = "ltr";
+export declare const DIR_NONE = "none";
+export declare const DIR_RANDOM = "random";
+export declare const DIR_RTL = "rtl";
+export declare const MODE_BI = "bi";
+/**
+ * Apply shimmer animation effect to text.
+ * This is the main entry point for shimmer animations. It:
+ * 1. Strips ANSI codes to get plain text for character positioning
+ * 2. Detects any styling (bold, italic, underline, etc.) to preserve
+ * 3. Calculates the current shimmer wave position based on animation step
+ * 4. Renders each character with appropriate brightness based on distance from wave
+ * 5. Updates the animation state for the next frame
+ * 6. Handles direction changes for bidirectional and random modes
+ */
+export declare function applyShimmer(text: string, state: ShimmerState, options?: ShimmerOptions | undefined): string;

package/dist/effects/text-shimmer.js

@@ -0,0 +1,175 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var text_shimmer_exports = {};
+__export(text_shimmer_exports, {
+  COLOR_INHERIT: () => COLOR_INHERIT,
+  DIR_LTR: () => DIR_LTR,
+  DIR_NONE: () => DIR_NONE,
+  DIR_RANDOM: () => DIR_RANDOM,
+  DIR_RTL: () => DIR_RTL,
+  MODE_BI: () => MODE_BI,
+  applyShimmer: () => applyShimmer
+});
+module.exports = __toCommonJS(text_shimmer_exports);
+var import_ansi = require("../ansi");
+var import_arrays = require("../arrays");
+function detectStyles(text) {
+  return {
+    __proto__: null,
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    bold: /\x1b\[1m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    dim: /\x1b\[2m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    italic: /\x1b\[3m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    strikethrough: /\x1b\[9m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    underline: /\x1b\[4m/.test(text)
+  };
+}
+function stylesToAnsi(styles) {
+  let codes = "";
+  if (styles.bold) {
+    codes += "\x1B[1m";
+  }
+  if (styles.dim) {
+    codes += "\x1B[2m";
+  }
+  if (styles.italic) {
+    codes += "\x1B[3m";
+  }
+  if (styles.underline) {
+    codes += "\x1B[4m";
+  }
+  if (styles.strikethrough) {
+    codes += "\x1B[9m";
+  }
+  return codes;
+}
+const COLOR_INHERIT = "inherit";
+const DIR_LTR = "ltr";
+const DIR_NONE = "none";
+const DIR_RANDOM = "random";
+const DIR_RTL = "rtl";
+const MODE_BI = "bi";
+function shimmerIntensity(distance, shimmerWidth = 2.5) {
+  if (distance > shimmerWidth) {
+    return 0;
+  }
+  const normalized = distance / shimmerWidth;
+  return (1 - normalized) ** 2.5;
+}
+function blendColors(color1, color2, factor) {
+  const r = Math.round(color1[0] + (color2[0] - color1[0]) * factor);
+  const g = Math.round(color1[1] + (color2[1] - color1[1]) * factor);
+  const b = Math.round(color1[2] + (color2[2] - color1[2]) * factor);
+  return [r, g, b];
+}
+function renderChar(char, index, shimmerPos, baseColor, styles) {
+  const distance = Math.abs(index - shimmerPos);
+  const intensity = shimmerIntensity(distance);
+  const styleCode = stylesToAnsi(styles);
+  const charColor = (0, import_arrays.isArray)(baseColor[0]) ? baseColor[index % baseColor.length] ?? [
+    140,
+    82,
+    255
+  ] : baseColor;
+  if (intensity === 0) {
+    const base = `\x1B[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`;
+    return `${styleCode}${base}${char}${import_ansi.ANSI_RESET}`;
+  }
+  const white = [255, 255, 255];
+  const blended = blendColors(charColor, white, intensity);
+  const color = `\x1B[38;2;${blended[0]};${blended[1]};${blended[2]}m`;
+  return `${styleCode}${color}${char}${import_ansi.ANSI_RESET}`;
+}
+function getShimmerPos(textLength, step, currentDir, shimmerWidth = 2.5) {
+  const totalSteps = textLength + shimmerWidth + 2;
+  if (currentDir === DIR_RTL) {
+    return textLength - step % totalSteps;
+  }
+  return step % totalSteps;
+}
+function pickDirection(direction) {
+  if (direction === DIR_RANDOM) {
+    return Math.random() < 0.5 ? DIR_LTR : DIR_RTL;
+  }
+  if (direction === DIR_RTL) {
+    return DIR_RTL;
+  }
+  return DIR_LTR;
+}
+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];
+  const styles = opts.styles ?? detectStyles(text);
+  const plainText = (0, import_ansi.stripAnsi)(text);
+  if (!plainText || direction === DIR_NONE) {
+    const styleCode = stylesToAnsi(styles);
+    const isGradient = (0, import_arrays.isArray)(color[0]);
+    return plainText.split("").map((char, i) => {
+      const charColor = isGradient ? color[i % color.length] ?? [
+        140,
+        82,
+        255
+      ] : color;
+      const base = `\x1B[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`;
+      return `${styleCode}${base}${char}${import_ansi.ANSI_RESET}`;
+    }).join("");
+  }
+  const shimmerPos = getShimmerPos(
+    plainText.length,
+    state.step,
+    state.currentDir,
+    shimmerWidth
+  );
+  const result = plainText.split("").map((char, i) => renderChar(char, i, shimmerPos, color, styles)).join("");
+  state.step += state.speed;
+  const totalSteps = plainText.length + shimmerWidth + 2;
+  if (state.mode === MODE_BI) {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+      state.currentDir = state.currentDir === DIR_LTR ? DIR_RTL : DIR_LTR;
+    }
+  } else if (state.mode === DIR_RANDOM) {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+      state.currentDir = pickDirection(DIR_RANDOM);
+    }
+  } else {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+    }
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+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

@@ -0,0 +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'\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.\n  if (!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

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Shared types for effects (shimmer, pulse, ultra, etc.).
+ * Common type definitions used across multiple effect modules.
+ */
+export type ShimmerColorInherit = 'inherit';
+export type ShimmerColorRgb = readonly [number, number, number];
+export type ShimmerColor = ShimmerColorInherit | ShimmerColorRgb;
+export type ShimmerColorGradient = readonly ShimmerColorRgb[];
+export type ShimmerDirection = 'ltr' | 'rtl' | 'bi' | 'random' | 'none';
+/**
+ * Shimmer animation configuration.
+ */
+export type ShimmerConfig = {
+    readonly color?: ShimmerColor | ShimmerColorGradient | undefined;
+    readonly dir?: ShimmerDirection | undefined;
+    /**
+     * Animation speed in steps per frame.
+     * Lower values = slower shimmer (e.g., 0.33 = ~150ms per step).
+     * Higher values = faster shimmer (e.g., 1.0 = 50ms per step).
+     * Default: 1/3 (~0.33).
+     */
+    readonly speed?: number | undefined;
+};
+/**
+ * Internal shimmer animation state.
+ * Tracks current animation position and direction.
+ */
+export type ShimmerState = {
+    currentDir: 'ltr' | 'rtl';
+    mode: ShimmerDirection;
+    /**
+     * Animation speed in steps per frame.
+     * The shimmer position advances by this amount every frame.
+     */
+    speed: number;
+    /**
+     * Current shimmer position.
+     * Can be fractional for smooth sub-character movement.
+     */
+    step: number;
+};

package/dist/effects/types.js

@@ -0,0 +1,17 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/effects/types.js.map

@@ -0,0 +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"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/effects/ultra.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Ultrathink rainbow gradient effect.
+ * Provides rainbow gradient color generation for shimmer animations.
+ * "Ultrathink" is Claude's intensive thinking mode for deep analysis.
+ */
+import type { ShimmerColorGradient } from './types';
+/**
+ * Rainbow gradient colors used for ultrathink effect.
+ * This gradient cycles through the full color spectrum with smooth transitions.
+ */
+export declare const RAINBOW_GRADIENT: ShimmerColorGradient;
+/**
+ * Generate rainbow gradient colors for any text length.
+ * Colors are distributed evenly across the text by cycling through the gradient.
+ */
+export declare function generateRainbowGradient(textLength: number): ShimmerColorGradient;