@socketsecurity/lib 5.18.2 → 5.19.1

package/dist/suppress-warnings.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -64,13 +65,12 @@ function setupSuppression() {
     };
   }
 }
-function suppressMaxListenersWarning() {
-  suppressedWarnings.add("MaxListenersExceededWarning");
-  setupSuppression();
-}
-function suppressWarningType(warningType) {
-  suppressedWarnings.add(warningType);
-  setupSuppression();
+function restoreWarnings() {
+  if (originalEmitWarning) {
+    import_node_process.default.emitWarning = originalEmitWarning;
+    originalEmitWarning = void 0;
+    suppressedWarnings.clear();
+  }
 }
 function setMaxEventTargetListeners(target, maxListeners = 10) {
   if (!target) {
@@ -85,12 +85,13 @@ function setMaxEventTargetListeners(target, maxListeners = 10) {
     target[kMaxEventTargetListeners] = maxListeners;
   }
 }
-function restoreWarnings() {
-  if (originalEmitWarning) {
-    import_node_process.default.emitWarning = originalEmitWarning;
-    originalEmitWarning = void 0;
-    suppressedWarnings.clear();
-  }
+function suppressMaxListenersWarning() {
+  suppressedWarnings.add("MaxListenersExceededWarning");
+  setupSuppression();
+}
+function suppressWarningType(warningType) {
+  suppressedWarnings.add(warningType);
+  setupSuppression();
 }
 async function withSuppressedWarnings(warningType, callback) {
   const wasAlreadySuppressed = suppressedWarnings.has(warningType);

package/dist/tables.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Table formatting utilities for CLI applications.
+ * Provides ASCII table rendering with borders, alignment, and colors.
+ */
 export type ColumnAlignment = 'left' | 'right' | 'center';
 /**
  * Table column configuration.
@@ -10,60 +14,60 @@ export type TableColumn = {
     color?: ((value: string) => string) | undefined;
 };
 /**
- * Format data as an ASCII table with borders.
+ * Format data as a simple table without borders.
+ * Lighter weight alternative to formatTable().
  *
  * @param data - Array of data objects
  * @param columns - Column configuration
  * @returns Formatted table string
  *
  * @example
- * import { formatTable } from '@socketsecurity/lib/tables'
+ * import { formatSimpleTable } from '@socketsecurity/lib/tables'
  * import colors from 'yoctocolors-cjs'
  *
  * const data = [
- *   { name: 'lodash', version: '4.17.21', issues: 0 },
- *   { name: 'react', version: '18.2.0', issues: 2 },
+ *   { name: 'lodash', version: '4.17.21' },
+ *   { name: 'react', version: '18.2.0' },
  * ]
  * const columns = [
  *   { key: 'name', header: 'Package' },
- *   { key: 'version', header: 'Version', align: 'center' },
- *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },
+ *   { key: 'version', header: 'Version' },
  * ]
- * console.log(formatTable(data, columns))
+ * console.log(formatSimpleTable(data, columns))
  * // Output:
- * // ┌─────────┬─────────┬────────┐
- * // │ Package │ Version │ Issues │
- * // ├─────────┼─────────┼────────┤
- * // │ lodash  │ 4.17.21 │      0 │
- * // │ react   │ 18.2.0  │      2 │
- * // └─────────┴─────────┴────────┘
+ * // Package  Version
+ * // ───────  ───────
+ * // lodash   4.17.21
+ * // react    18.2.0
  */
-export declare function formatTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;
+export declare function formatSimpleTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;
 /**
- * Format data as a simple table without borders.
- * Lighter weight alternative to formatTable().
+ * Format data as an ASCII table with borders.
  *
  * @param data - Array of data objects
  * @param columns - Column configuration
  * @returns Formatted table string
  *
  * @example
- * import { formatSimpleTable } from '@socketsecurity/lib/tables'
+ * import { formatTable } from '@socketsecurity/lib/tables'
  * import colors from 'yoctocolors-cjs'
  *
  * const data = [
- *   { name: 'lodash', version: '4.17.21' },
- *   { name: 'react', version: '18.2.0' },
+ *   { name: 'lodash', version: '4.17.21', issues: 0 },
+ *   { name: 'react', version: '18.2.0', issues: 2 },
  * ]
  * const columns = [
  *   { key: 'name', header: 'Package' },
- *   { key: 'version', header: 'Version' },
+ *   { key: 'version', header: 'Version', align: 'center' },
+ *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },
  * ]
- * console.log(formatSimpleTable(data, columns))
+ * console.log(formatTable(data, columns))
  * // Output:
- * // Package  Version
- * // ───────  ───────
- * // lodash   4.17.21
- * // react    18.2.0
+ * // ┌─────────┬─────────┬────────┐
+ * // │ Package │ Version │ Issues │
+ * // ├─────────┼─────────┼────────┤
+ * // │ lodash  │ 4.17.21 │      0 │
+ * // │ react   │ 18.2.0  │      2 │
+ * // └─────────┴─────────┴────────┘
  */
-export declare function formatSimpleTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;
+export declare function formatTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;

package/dist/tables.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -54,7 +55,7 @@ function padText(text, width, align = "left") {
       return text + " ".repeat(padding);
   }
 }
-function formatTable(data, columns) {
+function formatSimpleTable(data, columns) {
   if (data.length === 0) {
     return "(no data)";
   }
@@ -66,17 +67,12 @@ function formatTable(data, columns) {
     return col.width ?? Math.max(headerWidth, maxDataWidth);
   });
   const lines = [];
-  const topBorder = `\u250C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u252C\u2500")}\u2500\u2510`;
-  lines.push(import_yoctocolors_cjs.default.dim(topBorder));
-  const headerCells = columns.map((col, i) => {
-    const text = import_yoctocolors_cjs.default.bold(col.header);
-    return padText(text, widths[i], col.align);
-  });
-  lines.push(
-    import_yoctocolors_cjs.default.dim("\u2502 ") + headerCells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
+  const headerCells = columns.map(
+    (col, i) => padText(import_yoctocolors_cjs.default.bold(col.header), widths[i], col.align)
   );
-  const headerSep = `\u251C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u253C\u2500")}\u2500\u2524`;
-  lines.push(import_yoctocolors_cjs.default.dim(headerSep));
+  lines.push(headerCells.join("  "));
+  const separators = widths.map((w) => import_yoctocolors_cjs.default.dim("\u2500".repeat(w)));
+  lines.push(separators.join("  "));
   for (const row of data) {
     const cells = columns.map((col, i) => {
       let value = String(row[col.key] ?? "");
@@ -85,15 +81,11 @@ function formatTable(data, columns) {
       }
       return padText(value, widths[i], col.align);
     });
-    lines.push(
-      import_yoctocolors_cjs.default.dim("\u2502 ") + cells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
-    );
+    lines.push(cells.join("  "));
   }
-  const bottomBorder = `\u2514\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2534\u2500")}\u2500\u2518`;
-  lines.push(import_yoctocolors_cjs.default.dim(bottomBorder));
   return lines.join("\n");
 }
-function formatSimpleTable(data, columns) {
+function formatTable(data, columns) {
   if (data.length === 0) {
     return "(no data)";
   }
@@ -105,12 +97,17 @@ function formatSimpleTable(data, columns) {
     return col.width ?? Math.max(headerWidth, maxDataWidth);
   });
   const lines = [];
-  const headerCells = columns.map(
-    (col, i) => padText(import_yoctocolors_cjs.default.bold(col.header), widths[i], col.align)
+  const topBorder = `\u250C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u252C\u2500")}\u2500\u2510`;
+  lines.push(import_yoctocolors_cjs.default.dim(topBorder));
+  const headerCells = columns.map((col, i) => {
+    const text = import_yoctocolors_cjs.default.bold(col.header);
+    return padText(text, widths[i], col.align);
+  });
+  lines.push(
+    import_yoctocolors_cjs.default.dim("\u2502 ") + headerCells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
   );
-  lines.push(headerCells.join("  "));
-  const separators = widths.map((w) => import_yoctocolors_cjs.default.dim("\u2500".repeat(w)));
-  lines.push(separators.join("  "));
+  const headerSep = `\u251C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u253C\u2500")}\u2500\u2524`;
+  lines.push(import_yoctocolors_cjs.default.dim(headerSep));
   for (const row of data) {
     const cells = columns.map((col, i) => {
       let value = String(row[col.key] ?? "");
@@ -119,8 +116,12 @@ function formatSimpleTable(data, columns) {
       }
       return padText(value, widths[i], col.align);
     });
-    lines.push(cells.join("  "));
+    lines.push(
+      import_yoctocolors_cjs.default.dim("\u2502 ") + cells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
+    );
   }
+  const bottomBorder = `\u2514\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2534\u2500")}\u2500\u2518`;
+  lines.push(import_yoctocolors_cjs.default.dim(bottomBorder));
   return lines.join("\n");
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/temporary-executor.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Temporary package executor detection utilities for Socket ecosystem.
+ * Identifies and handles temporary execution contexts such as npx, pnpm dlx, and yarn dlx.
+ */
 /**
  * Detects if the current process is running in a temporary package execution context
  * such as npm exec, npx, pnpm dlx, or yarn dlx.

package/dist/temporary-executor.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/themes/context.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Elegant theme context management.
+ * Async-aware theming with automatic context isolation via AsyncLocalStorage.
+ */
 import type { Theme } from './types';
 import { type ThemeName } from './themes';
 /**
@@ -5,28 +9,45 @@ import { type ThemeName } from './themes';
  */
 export type ThemeChangeListener = (theme: Theme) => void;
 /**
- * Set the global fallback theme.
+ * Get the active theme from context.
  *
- * @param theme - Theme name or object
+ * @returns Current theme
  *
  * @example
  * ```ts
- * setTheme('socket-firewall')
+ * const theme = getTheme()
+ * console.log(theme.displayName)
  * ```
  */
-export declare function setTheme(theme: Theme | ThemeName): void;
+export declare function getTheme(): Theme;
 /**
- * Get the active theme from context.
+ * Subscribe to theme change events.
  *
- * @returns Current theme
+ * @param listener - Change handler
+ * @returns Unsubscribe function
  *
  * @example
  * ```ts
- * const theme = getTheme()
- * console.log(theme.displayName)
+ * const unsubscribe = onThemeChange((theme) => {
+ *   console.log('Theme:', theme.displayName)
+ * })
+ *
+ * // Cleanup
+ * unsubscribe()
  * ```
  */
-export declare function getTheme(): Theme;
+export declare function onThemeChange(listener: ThemeChangeListener): () => void;
+/**
+ * Set the global fallback theme.
+ *
+ * @param theme - Theme name or object
+ *
+ * @example
+ * ```ts
+ * setTheme('socket-firewall')
+ * ```
+ */
+export declare function setTheme(theme: Theme | ThemeName): void;
 /**
  * Execute async operation with scoped theme.
  * Theme automatically restored on completion.
@@ -61,20 +82,3 @@ export declare function withTheme<T>(theme: Theme | ThemeName, fn: () => Promise
  * ```
  */
 export declare function withThemeSync<T>(theme: Theme | ThemeName, fn: () => T): T;
-/**
- * Subscribe to theme change events.
- *
- * @param listener - Change handler
- * @returns Unsubscribe function
- *
- * @example
- * ```ts
- * const unsubscribe = onThemeChange((theme) => {
- *   console.log('Theme:', theme.displayName)
- * })
- *
- * // Cleanup
- * unsubscribe()
- * ```
- */
-export declare function onThemeChange(listener: ThemeChangeListener): () => void;

package/dist/themes/context.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -28,10 +29,15 @@ __export(context_exports, {
 module.exports = __toCommonJS(context_exports);
 var import_themes = require("./themes");
 let _async_hooks;
+function emitThemeChange(theme) {
+  for (const listener of listeners) {
+    listener(theme);
+  }
+}
 // @__NO_SIDE_EFFECTS__
 function getAsyncHooks() {
   if (_async_hooks === void 0) {
-    _async_hooks = require("async_hooks");
+    _async_hooks = require("node:async_hooks");
   }
   return _async_hooks;
 }
@@ -39,38 +45,33 @@ const { AsyncLocalStorage } = /* @__PURE__ */ getAsyncHooks();
 const themeStorage = new AsyncLocalStorage();
 let fallbackTheme = import_themes.SOCKET_THEME;
 const listeners = /* @__PURE__ */ new Set();
-function setTheme(theme) {
-  fallbackTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
-  emitThemeChange(fallbackTheme);
-}
 function getTheme() {
   return themeStorage.getStore() ?? fallbackTheme;
 }
+function onThemeChange(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function setTheme(theme) {
+  fallbackTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
+  emitThemeChange(fallbackTheme);
+}
 async function withTheme(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
+  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
   return await themeStorage.run(resolvedTheme, async () => {
     emitThemeChange(resolvedTheme);
     return await fn();
   });
 }
 function withThemeSync(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
+  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
   return themeStorage.run(resolvedTheme, () => {
     emitThemeChange(resolvedTheme);
     return fn();
   });
 }
-function onThemeChange(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-function emitThemeChange(theme) {
-  for (const listener of listeners) {
-    listener(theme);
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getTheme,

package/dist/themes/index.d.ts

@@ -43,11 +43,7 @@
  * })
  * ```
  */
-// Type system
 export type { ColorReference, Theme, ThemeColors, ThemeEffects, ThemeMeta, } from './types';
-// Curated themes
 export { LUSH_THEME, SOCKET_THEME, SUNSET_THEME, TERRACOTTA_THEME, THEMES, ULTRA_THEME, type ThemeName, } from './themes';
-// Context management
 export { getTheme, onThemeChange, setTheme, withTheme, withThemeSync, type ThemeChangeListener, } from './context';
-// Composition utilities
 export { createTheme, extendTheme, resolveColor, resolveShimmerColor, } from './utils';

package/dist/themes/index.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/themes.d.ts

@@ -36,7 +36,7 @@ export declare const ULTRA_THEME: Theme;
  * Theme registry — Curated palette collection.
  */
 export declare const THEMES: {
-    readonly __proto__: any;
+    readonly __proto__: null;
     readonly socket: Theme;
     readonly sunset: Theme;
     readonly terracotta: Theme;

package/dist/themes/themes.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/types.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/utils.d.ts

@@ -1,35 +1,36 @@
-import type { ColorValue } from '../colors';
-import type { ShimmerColorGradient } from '../effects/text-shimmer';
-import type { Theme, ThemeColors, ColorReference } from './types';
 /**
- * Resolve color reference to concrete value.
- * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'
- *
- * @param value - Color reference
- * @param colors - Theme palette
- * @returns Resolved color
- *
- * @example
- * ```ts
- * resolveColor('primary', theme.colors)
- * resolveColor([255, 0, 0], theme.colors)
- * ```
+ * @fileoverview Theme utilities — color resolution and composition.
  */
-export declare function resolveColor(value: ColorReference | ColorValue, colors: ThemeColors): ColorValue | 'inherit' | ShimmerColorGradient;
+import type { ColorValue } from '../colors';
+import type { ShimmerColorGradient } from '../effects/text-shimmer';
+import type { ColorReference, Theme, ThemeColors } from './types';
 /**
- * Resolve shimmer color with gradient support.
+ * Create new theme from complete specification.
  *
- * @param value - Shimmer color
- * @param theme - Theme context
- * @returns Resolved color
+ * @param config - Theme configuration
+ * @returns Theme object
  *
  * @example
  * ```ts
- * resolveShimmerColor('rainbow', theme)
- * resolveShimmerColor('primary', theme)
+ * const theme = createTheme({
+ *   name: 'custom',
+ *   displayName: 'Custom',
+ *   colors: {
+ *     primary: [255, 100, 200],
+ *     success: 'greenBright',
+ *     error: 'redBright',
+ *     warning: 'yellowBright',
+ *     info: 'blueBright',
+ *     step: 'cyanBright',
+ *     text: 'white',
+ *     textDim: 'gray',
+ *     link: 'cyanBright',
+ *     prompt: 'primary'
+ *   }
+ * })
  * ```
  */
-export declare function resolveShimmerColor(value: ColorReference | ColorValue[] | undefined, theme: Theme): ColorValue | ShimmerColorGradient | 'inherit';
+export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;
 /**
  * Extend existing theme with custom overrides.
  * Deep merge of colors and effects.
@@ -50,29 +51,31 @@ export declare function extendTheme(base: Theme, overrides: Partial<Omit<Theme,
     colors?: Partial<ThemeColors> | undefined;
 }): Theme;
 /**
- * Create new theme from complete specification.
+ * Resolve color reference to concrete value.
+ * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'
  *
- * @param config - Theme configuration
- * @returns Theme object
+ * @param value - Color reference
+ * @param colors - Theme palette
+ * @returns Resolved color
  *
  * @example
  * ```ts
- * const theme = createTheme({
- *   name: 'custom',
- *   displayName: 'Custom',
- *   colors: {
- *     primary: [255, 100, 200],
- *     success: 'greenBright',
- *     error: 'redBright',
- *     warning: 'yellowBright',
- *     info: 'blueBright',
- *     step: 'cyanBright',
- *     text: 'white',
- *     textDim: 'gray',
- *     link: 'cyanBright',
- *     prompt: 'primary'
- *   }
- * })
+ * resolveColor('primary', theme.colors)
+ * resolveColor([255, 0, 0], theme.colors)
  * ```
  */
-export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;
+export declare function resolveColor(value: ColorReference | ColorValue, colors: ThemeColors): ColorValue | 'inherit' | ShimmerColorGradient;
+/**
+ * Resolve shimmer color with gradient support.
+ *
+ * @param value - Shimmer color
+ * @param theme - Theme context
+ * @returns Resolved color
+ *
+ * @example
+ * ```ts
+ * resolveShimmerColor('rainbow', theme)
+ * resolveShimmerColor('primary', theme)
+ * ```
+ */
+export declare function resolveShimmerColor(value: ColorReference | ColorValue[] | undefined, theme: Theme): ColorValue | ShimmerColorGradient | 'inherit';