@socketsecurity/lib 3.0.1 → 3.0.3

package/dist/suppress-warnings.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/suppress-warnings.ts"],
   "sourcesContent": ["/**\n * @fileoverview Utilities to suppress specific process warnings.\n */\n\nconst { apply: ReflectApply } = Reflect\n\n// Store the original emitWarning function to avoid repeat wrapping.\nlet originalEmitWarning: typeof process.emitWarning | undefined\n\n// Track which warning types are currently suppressed.\nconst suppressedWarnings = new Set<string>()\n\n/**\n * Internal function to set up warning suppression.\n * Only wraps process.emitWarning once, regardless of how many times it's called.\n */\nfunction setupSuppression(): void {\n  // Only wrap once - store the original on first call.\n  if (!originalEmitWarning) {\n    originalEmitWarning = process.emitWarning\n    process.emitWarning = (warning: string | Error, ...args: any[]) => {\n      // Check both string warnings and warning objects.\n      if (typeof warning === 'string') {\n        // Check if any suppressed warning type matches.\n        for (const suppressedType of suppressedWarnings) {\n          if (warning.includes(suppressedType)) {\n            return\n          }\n        }\n      } else if (warning && typeof warning === 'object') {\n        const warningObj = warning as { name?: string }\n        if (warningObj.name && suppressedWarnings.has(warningObj.name)) {\n          return\n        }\n      }\n      // Not suppressed - call the original function.\n      return ReflectApply(\n        originalEmitWarning as typeof process.emitWarning,\n        process,\n        [warning, ...args],\n      )\n    }\n  }\n}\n\n/**\n * Suppress MaxListenersExceededWarning messages.\n * This is useful in tests or scripts where multiple listeners are expected.\n *\n * @example\n * import { suppressMaxListenersWarning } from '@socketsecurity/lib/suppress-warnings'\n *\n * suppressMaxListenersWarning()\n */\nexport function suppressMaxListenersWarning(): void {\n  suppressedWarnings.add('MaxListenersExceededWarning')\n  setupSuppression()\n}\n\n/**\n * Suppress all process warnings of a specific type.\n *\n * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')\n *\n * @example\n * import { suppressWarningType } from '@socketsecurity/lib/suppress-warnings'\n *\n * suppressWarningType('ExperimentalWarning')\n */\nexport function suppressWarningType(warningType: string): void {\n  suppressedWarnings.add(warningType)\n  setupSuppression()\n}\n\n/**\n * Set max listeners on an EventTarget (like AbortSignal) to avoid TypeError.\n *\n * By manually setting `kMaxEventTargetListeners` on the target we avoid:\n *   TypeError [ERR_INVALID_ARG_TYPE]: The \"emitter\" argument must be an\n *   instance of EventEmitter or EventTarget. Received an instance of\n *   AbortSignal\n *\n * in some patch releases of Node 18-23 when calling events.getMaxListeners().\n * See https://github.com/nodejs/node/pull/56807.\n *\n * Instead of calling events.setMaxListeners(n, target) we set the symbol\n * property directly to avoid depending on 'node:events' module.\n *\n * @param target - The EventTarget or AbortSignal to configure\n * @param maxListeners - Maximum number of listeners (defaults to 10, the Node.js default)\n *\n * @example\n * import { setMaxEventTargetListeners } from '@socketsecurity/lib/suppress-warnings'\n *\n * const controller = new AbortController()\n * setMaxEventTargetListeners(controller.signal)\n */\nexport function setMaxEventTargetListeners(\n  target: EventTarget | AbortSignal | undefined,\n  maxListeners: number = 10,\n): void {\n  if (!target) {\n    return\n  }\n  const symbols = Object.getOwnPropertySymbols(target)\n  const kMaxEventTargetListeners = symbols.find(\n    s => s.description === 'events.maxEventTargetListeners',\n  )\n  if (kMaxEventTargetListeners) {\n    // The default events.defaultMaxListeners value is 10.\n    // https://nodejs.org/api/events.html#eventsdefaultmaxlisteners\n    ;(target as any)[kMaxEventTargetListeners] = maxListeners\n  }\n}\n\n/**\n * Restore the original process.emitWarning function.\n * Call this to re-enable all warnings after suppressing them.\n */\nexport function restoreWarnings(): void {\n  if (originalEmitWarning) {\n    process.emitWarning = originalEmitWarning\n    originalEmitWarning = undefined\n    suppressedWarnings.clear()\n  }\n}\n\n/**\n * Suppress warnings temporarily within a callback.\n *\n * @param warningType - The warning type to suppress\n * @param callback - Function to execute with warnings suppressed\n * @returns The result of the callback\n *\n * @example\n * import { withSuppressedWarnings } from '@socketsecurity/lib/suppress-warnings'\n *\n * const result = await withSuppressedWarnings('ExperimentalWarning', async () => {\n *   // Code that triggers experimental warnings\n *   return someValue\n * })\n */\nexport async function withSuppressedWarnings<T>(\n  warningType: string,\n  callback: () => T | Promise<T>,\n): Promise<T> {\n  const original = process.emitWarning\n  suppressWarningType(warningType)\n  try {\n    return await callback()\n  } finally {\n    process.emitWarning = original\n  }\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,+BAAAC,EAAA,gCAAAC,EAAA,wBAAAC,EAAA,2BAAAC,IAAA,eAAAC,EAAAP,GAIA,KAAM,CAAE,MAAOQ,CAAa,EAAI,QAGhC,IAAIC,EAGJ,MAAMC,EAAqB,IAAI,IAM/B,SAASC,GAAyB,CAE3BF,IACHA,EAAsB,QAAQ,YAC9B,QAAQ,YAAc,CAACG,KAA4BC,IAAgB,CAEjE,GAAI,OAAOD,GAAY,UAErB,UAAWE,KAAkBJ,EAC3B,GAAIE,EAAQ,SAASE,CAAc,EACjC,eAGKF,GAAW,OAAOA,GAAY,SAAU,CACjD,MAAMG,EAAaH,EACnB,GAAIG,EAAW,MAAQL,EAAmB,IAAIK,EAAW,IAAI,EAC3D,MAEJ,CAEA,OAAOP,EACLC,EACA,QACA,CAACG,EAAS,GAAGC,CAAI,CACnB,CACF,EAEJ,CAWO,SAAST,GAAoC,CAClDM,EAAmB,IAAI,6BAA6B,EACpDC,EAAiB,CACnB,CAYO,SAASN,EAAoBW,EAA2B,CAC7DN,EAAmB,IAAIM,CAAW,EAClCL,EAAiB,CACnB,CAyBO,SAASR,EACdc,EACAC,EAAuB,GACjB,CACN,GAAI,CAACD,EACH,OAGF,MAAME,EADU,OAAO,sBAAsBF,CAAM,EACV,KACvCG,GAAKA,EAAE,cAAgB,gCACzB,EACID,IAGAF,EAAeE,CAAwB,EAAID,EAEjD,CAMO,SAAShB,GAAwB,CAClCO,IACF,QAAQ,YAAcA,EACtBA,EAAsB,OACtBC,EAAmB,MAAM,EAE7B,CAiBA,eAAsBJ,EACpBU,EACAK,EACY,CACZ,MAAMC,EAAW,QAAQ,YACzBjB,EAAoBW,CAAW,EAC/B,GAAI,CACF,OAAO,MAAMK,EAAS,CACxB,QAAE,CACA,QAAQ,YAAcC,CACxB,CACF",
-  "names": ["suppress_warnings_exports", "__export", "restoreWarnings", "setMaxEventTargetListeners", "suppressMaxListenersWarning", "suppressWarningType", "withSuppressedWarnings", "__toCommonJS", "ReflectApply", "originalEmitWarning", "suppressedWarnings", "setupSuppression", "warning", "args", "suppressedType", "warningObj", "warningType", "target", "maxListeners", "kMaxEventTargetListeners", "s", "callback", "original"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,MAAM,EAAE,OAAO,aAAa,IAAI;AAGhC,IAAI;AAGJ,MAAM,qBAAqB,oBAAI,IAAY;AAM3C,SAAS,mBAAyB;AAEhC,MAAI,CAAC,qBAAqB;AACxB,0BAAsB,QAAQ;AAC9B,YAAQ,cAAc,CAAC,YAA4B,SAAgB;AAEjE,UAAI,OAAO,YAAY,UAAU;AAE/B,mBAAW,kBAAkB,oBAAoB;AAC/C,cAAI,QAAQ,SAAS,cAAc,GAAG;AACpC;AAAA,UACF;AAAA,QACF;AAAA,MACF,WAAW,WAAW,OAAO,YAAY,UAAU;AACjD,cAAM,aAAa;AACnB,YAAI,WAAW,QAAQ,mBAAmB,IAAI,WAAW,IAAI,GAAG;AAC9D;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,CAAC,SAAS,GAAG,IAAI;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;AAWO,SAAS,8BAAoC;AAClD,qBAAmB,IAAI,6BAA6B;AACpD,mBAAiB;AACnB;AAYO,SAAS,oBAAoB,aAA2B;AAC7D,qBAAmB,IAAI,WAAW;AAClC,mBAAiB;AACnB;AAyBO,SAAS,2BACd,QACA,eAAuB,IACjB;AACN,MAAI,CAAC,QAAQ;AACX;AAAA,EACF;AACA,QAAM,UAAU,OAAO,sBAAsB,MAAM;AACnD,QAAM,2BAA2B,QAAQ;AAAA,IACvC,OAAK,EAAE,gBAAgB;AAAA,EACzB;AACA,MAAI,0BAA0B;AAG5B;AAAC,IAAC,OAAe,wBAAwB,IAAI;AAAA,EAC/C;AACF;AAMO,SAAS,kBAAwB;AACtC,MAAI,qBAAqB;AACvB,YAAQ,cAAc;AACtB,0BAAsB;AACtB,uBAAmB,MAAM;AAAA,EAC3B;AACF;AAiBA,eAAsB,uBACpB,aACA,UACY;AACZ,QAAM,WAAW,QAAQ;AACzB,sBAAoB,WAAW;AAC/B,MAAI;AACF,WAAO,MAAM,SAAS;AAAA,EACxB,UAAE;AACA,YAAQ,cAAc;AAAA,EACxB;AACF;",
+  "names": []
 }

package/dist/tables.js

@@ -1,5 +1,130 @@
 /* Socket Lib - Built with esbuild */
-var j=Object.create;var u=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var C=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var A=(n,t)=>{for(var r in t)u(n,r,{get:t[r],enumerable:!0})},x=(n,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let d of y(t))!k.call(n,d)&&d!==r&&u(n,d,{get:()=>t[d],enumerable:!(i=w(t,d))||i.enumerable});return n};var M=(n,t,r)=>(r=n!=null?j(C(n)):{},x(t||!n||!n.__esModule?u(r,"default",{value:n,enumerable:!0}):r,n)),S=n=>x(u({},"__esModule",{value:!0}),n);var v={};A(v,{formatSimpleTable:()=>W,formatTable:()=>T});module.exports=S(v);var o=M(require("./external/yoctocolors-cjs")),b=require("./strings");function l(n){return(0,b.stripAnsi)(n).length}function g(n,t,r="left"){const d=(0,b.stripAnsi)(n).length,h=Math.max(0,t-d);switch(r){case"right":return" ".repeat(h)+n;case"center":{const a=Math.floor(h/2),m=h-a;return" ".repeat(a)+n+" ".repeat(m)}default:return n+" ".repeat(h)}}function T(n,t){if(n.length===0)return"(no data)";const r=t.map(e=>{const p=l(e.header),s=Math.max(...n.map(c=>l(String(c[e.key]??""))));return e.width??Math.max(p,s)}),i=[],d=`\u250C\u2500${r.map(e=>"\u2500".repeat(e)).join("\u2500\u252C\u2500")}\u2500\u2510`;i.push(o.default.dim(d));const h=t.map((e,p)=>{const s=o.default.bold(e.header);return g(s,r[p],e.align)});i.push(o.default.dim("\u2502 ")+h.join(o.default.dim(" \u2502 "))+o.default.dim(" \u2502"));const a=`\u251C\u2500${r.map(e=>"\u2500".repeat(e)).join("\u2500\u253C\u2500")}\u2500\u2524`;i.push(o.default.dim(a));for(const e of n){const p=t.map((s,c)=>{let f=String(e[s.key]??"");return s.color&&(f=s.color(f)),g(f,r[c],s.align)});i.push(o.default.dim("\u2502 ")+p.join(o.default.dim(" \u2502 "))+o.default.dim(" \u2502"))}const m=`\u2514\u2500${r.map(e=>"\u2500".repeat(e)).join("\u2500\u2534\u2500")}\u2500\u2518`;return i.push(o.default.dim(m)),i.join(`
-`)}function W(n,t){if(n.length===0)return"(no data)";const r=t.map(a=>{const m=l(a.header),e=Math.max(...n.map(p=>l(String(p[a.key]??""))));return a.width??Math.max(m,e)}),i=[],d=t.map((a,m)=>g(o.default.bold(a.header),r[m],a.align));i.push(d.join("  "));const h=r.map(a=>o.default.dim("\u2500".repeat(a)));i.push(h.join("  "));for(const a of n){const m=t.map((e,p)=>{let s=String(a[e.key]??"");return e.color&&(s=e.color(s)),g(s,r[p],e.align)});i.push(m.join("  "))}return i.join(`
-`)}0&&(module.exports={formatSimpleTable,formatTable});
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var tables_exports = {};
+__export(tables_exports, {
+  formatSimpleTable: () => formatSimpleTable,
+  formatTable: () => formatTable
+});
+module.exports = __toCommonJS(tables_exports);
+var import_yoctocolors_cjs = __toESM(require("./external/yoctocolors-cjs"));
+var import_strings = require("./strings");
+function displayWidth(text) {
+  return (0, import_strings.stripAnsi)(text).length;
+}
+function padText(text, width, align = "left") {
+  const stripped = (0, import_strings.stripAnsi)(text);
+  const textWidth = stripped.length;
+  const padding = Math.max(0, width - textWidth);
+  switch (align) {
+    case "right":
+      return " ".repeat(padding) + text;
+    case "center": {
+      const leftPad = Math.floor(padding / 2);
+      const rightPad = padding - leftPad;
+      return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+    }
+    default:
+      return text + " ".repeat(padding);
+  }
+}
+function formatTable(data, columns) {
+  if (data.length === 0) {
+    return "(no data)";
+  }
+  const widths = columns.map((col) => {
+    const headerWidth = displayWidth(col.header);
+    const maxDataWidth = Math.max(
+      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
+    );
+    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 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] ?? "");
+      if (col.color) {
+        value = col.color(value);
+      }
+      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")
+    );
+  }
+  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) {
+  if (data.length === 0) {
+    return "(no data)";
+  }
+  const widths = columns.map((col) => {
+    const headerWidth = displayWidth(col.header);
+    const maxDataWidth = Math.max(
+      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
+    );
+    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)
+  );
+  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] ?? "");
+      if (col.color) {
+        value = col.color(value);
+      }
+      return padText(value, widths[i], col.align);
+    });
+    lines.push(cells.join("  "));
+  }
+  return lines.join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatSimpleTable,
+  formatTable
+});
 //# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/tables.ts"],
   "sourcesContent": ["/**\n * @fileoverview Table formatting utilities for CLI applications.\n * Provides ASCII table rendering with borders, alignment, and colors.\n */\n\nimport colors from './external/yoctocolors-cjs'\nimport { stripAnsi } from './strings'\n\nexport type ColumnAlignment = 'left' | 'right' | 'center'\n\n/**\n * Table column configuration.\n */\nexport type TableColumn = {\n  key: string\n  header: string\n  align?: ColumnAlignment | undefined\n  width?: number | undefined\n  color?: ((value: string) => string) | undefined\n}\n\n/**\n * Calculate display width accounting for ANSI codes.\n */\nfunction displayWidth(text: string): number {\n  return stripAnsi(text).length\n}\n\n/**\n * Pad text to specified width with alignment.\n */\nfunction padText(\n  text: string,\n  width: number,\n  align: ColumnAlignment = 'left',\n): string {\n  const stripped = stripAnsi(text)\n  const textWidth = stripped.length\n  const padding = Math.max(0, width - textWidth)\n\n  switch (align) {\n    case 'right':\n      return ' '.repeat(padding) + text\n    case 'center': {\n      const leftPad = Math.floor(padding / 2)\n      const rightPad = padding - leftPad\n      return ' '.repeat(leftPad) + text + ' '.repeat(rightPad)\n    }\n    default:\n      return text + ' '.repeat(padding)\n  }\n}\n\n/**\n * Format data as an ASCII table with borders.\n *\n * @param data - Array of data objects\n * @param columns - Column configuration\n * @returns Formatted table string\n *\n * @example\n * import { formatTable } from '@socketsecurity/lib/tables'\n * import colors from 'yoctocolors-cjs'\n *\n * const data = [\n *   { name: 'lodash', version: '4.17.21', issues: 0 },\n *   { name: 'react', version: '18.2.0', issues: 2 },\n * ]\n * const columns = [\n *   { key: 'name', header: 'Package' },\n *   { key: 'version', header: 'Version', align: 'center' },\n *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },\n * ]\n * console.log(formatTable(data, columns))\n * // Output:\n * // \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n * // \u2502 Package \u2502 Version \u2502 Issues \u2502\n * // \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n * // \u2502 lodash  \u2502 4.17.21 \u2502      0 \u2502\n * // \u2502 react   \u2502 18.2.0  \u2502      2 \u2502\n * // \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n */\nexport function formatTable(\n  data: Array<Record<string, unknown>>,\n  columns: TableColumn[],\n): string {\n  if (data.length === 0) {\n    return '(no data)'\n  }\n\n  // Calculate column widths\n  const widths = columns.map(col => {\n    const headerWidth = displayWidth(col.header)\n    const maxDataWidth = Math.max(\n      ...data.map(row => displayWidth(String(row[col.key] ?? ''))),\n    )\n    return col.width ?? Math.max(headerWidth, maxDataWidth)\n  })\n\n  const lines: string[] = []\n\n  // Top border\n  const topBorder = `\u250C\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u252C\u2500')}\u2500\u2510`\n  lines.push(colors.dim(topBorder))\n\n  // Header row\n  const headerCells = columns.map((col, i) => {\n    const text = colors.bold(col.header)\n    return padText(text, widths[i] as number, col.align)\n  })\n  lines.push(\n    colors.dim('\u2502 ') + headerCells.join(colors.dim(' \u2502 ')) + colors.dim(' \u2502'),\n  )\n\n  // Header separator\n  const headerSep = `\u251C\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u253C\u2500')}\u2500\u2524`\n  lines.push(colors.dim(headerSep))\n\n  // Data rows\n  for (const row of data) {\n    const cells = columns.map((col, i) => {\n      let value = String(row[col.key] ?? '')\n      if (col.color) {\n        value = col.color(value)\n      }\n      return padText(value, widths[i] as number, col.align)\n    })\n    lines.push(\n      colors.dim('\u2502 ') + cells.join(colors.dim(' \u2502 ')) + colors.dim(' \u2502'),\n    )\n  }\n\n  // Bottom border\n  const bottomBorder = `\u2514\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u2534\u2500')}\u2500\u2518`\n  lines.push(colors.dim(bottomBorder))\n\n  return lines.join('\\n')\n}\n\n/**\n * Format data as a simple table without borders.\n * Lighter weight alternative to formatTable().\n *\n * @param data - Array of data objects\n * @param columns - Column configuration\n * @returns Formatted table string\n *\n * @example\n * import { formatSimpleTable } from '@socketsecurity/lib/tables'\n * import colors from 'yoctocolors-cjs'\n *\n * const data = [\n *   { name: 'lodash', version: '4.17.21' },\n *   { name: 'react', version: '18.2.0' },\n * ]\n * const columns = [\n *   { key: 'name', header: 'Package' },\n *   { key: 'version', header: 'Version' },\n * ]\n * console.log(formatSimpleTable(data, columns))\n * // Output:\n * // Package  Version\n * // \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * // lodash   4.17.21\n * // react    18.2.0\n */\nexport function formatSimpleTable(\n  data: Array<Record<string, unknown>>,\n  columns: TableColumn[],\n): string {\n  if (data.length === 0) {\n    return '(no data)'\n  }\n\n  // Calculate column widths\n  const widths = columns.map(col => {\n    const headerWidth = displayWidth(col.header)\n    const maxDataWidth = Math.max(\n      ...data.map(row => displayWidth(String(row[col.key] ?? ''))),\n    )\n    return col.width ?? Math.max(headerWidth, maxDataWidth)\n  })\n\n  const lines: string[] = []\n\n  // Header row\n  const headerCells = columns.map((col, i) =>\n    padText(colors.bold(col.header), widths[i] as number, col.align),\n  )\n  lines.push(headerCells.join('  '))\n\n  // Header separator\n  const separators = widths.map(w => colors.dim('\u2500'.repeat(w)))\n  lines.push(separators.join('  '))\n\n  // Data rows\n  for (const row of data) {\n    const cells = columns.map((col, i) => {\n      let value = String(row[col.key] ?? '')\n      if (col.color) {\n        value = col.color(value)\n      }\n      return padText(value, widths[i] as number, col.align)\n    })\n    lines.push(cells.join('  '))\n  }\n\n  return lines.join('\\n')\n}\n"],
-  "mappings": "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",
-  "names": ["tables_exports", "__export", "formatSimpleTable", "formatTable", "__toCommonJS", "import_yoctocolors_cjs", "import_strings", "displayWidth", "text", "padText", "width", "align", "textWidth", "padding", "leftPad", "rightPad", "data", "columns", "widths", "col", "headerWidth", "maxDataWidth", "row", "lines", "topBorder", "w", "colors", "headerCells", "i", "headerSep", "cells", "value", "bottomBorder", "separators"]
+  "mappings": "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",
+  "names": ["colors"]
 }

package/dist/temporary-executor.js

@@ -1,3 +1,55 @@
 /* Socket Lib - Built with esbuild */
-var c=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var l=(e,n)=>{for(var o in n)c(e,o,{get:n[o],enumerable:!0})},d=(e,n,o,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of m(n))!a.call(e,r)&&r!==o&&c(e,r,{get:()=>n[r],enumerable:!(s=u(n,r))||s.enumerable});return e};var f=e=>d(c({},"__esModule",{value:!0}),e);var _={};l(_,{isRunningInTemporaryExecutor:()=>x});module.exports=f(_);var p=require("#constants/platform"),t=require("./path");function x(e=process.cwd()){const n=process.env.npm_config_user_agent;if(n?.includes("exec")||n?.includes("npx")||n?.includes("dlx"))return!0;const o=(0,t.normalizePath)(e),s=process.env.npm_config_cache;if(s&&o.includes((0,t.normalizePath)(s)))return!0;const r=["_npx",".pnpm-store","dlx-",".yarn/$$"];return p.WIN32&&r.push("AppData/Local/Temp/xfs-"),r.some(i=>o.includes(i))}0&&(module.exports={isRunningInTemporaryExecutor});
+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 temporary_executor_exports = {};
+__export(temporary_executor_exports, {
+  isRunningInTemporaryExecutor: () => isRunningInTemporaryExecutor
+});
+module.exports = __toCommonJS(temporary_executor_exports);
+var import_platform = require("#constants/platform");
+var import_path = require("./path");
+function isRunningInTemporaryExecutor(cwd = process.cwd()) {
+  const userAgent = process.env["npm_config_user_agent"];
+  if (userAgent?.includes("exec") || userAgent?.includes("npx") || userAgent?.includes("dlx")) {
+    return true;
+  }
+  const normalizedCwd = (0, import_path.normalizePath)(cwd);
+  const npmCache = process.env["npm_config_cache"];
+  if (npmCache && normalizedCwd.includes((0, import_path.normalizePath)(npmCache))) {
+    return true;
+  }
+  const tempPatterns = [
+    // npm's npx cache directory
+    "_npx",
+    // pnpm dlx temporary store
+    ".pnpm-store",
+    // Common dlx directory prefix
+    "dlx-",
+    // Yarn Berry PnP virtual packages.
+    ".yarn/$$"
+  ];
+  if (import_platform.WIN32) {
+    tempPatterns.push("AppData/Local/Temp/xfs-");
+  }
+  return tempPatterns.some((pattern) => normalizedCwd.includes(pattern));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isRunningInTemporaryExecutor
+});
 //# sourceMappingURL=temporary-executor.js.map

package/dist/temporary-executor.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/temporary-executor.ts"],
   "sourcesContent": ["/**\n * @fileoverview Temporary package executor detection utilities for Socket ecosystem.\n * Identifies and handles temporary execution contexts such as npx, pnpm dlx, and yarn dlx.\n */\n\nimport { WIN32 } from '#constants/platform'\nimport { normalizePath } from './path'\n\n/**\n * Detects if the current process is running in a temporary package execution context\n * such as npm exec, npx, pnpm dlx, or yarn dlx.\n *\n * When package managers run commands via exec/npx/dlx, they execute in temporary directories\n * that are cleaned up after execution. Creating persistent shadows or modifying PATH\n * in these contexts can break subsequent package manager commands.\n */\nexport function isRunningInTemporaryExecutor(cwd = process.cwd()): boolean {\n  // Check environment variable for exec/npx/dlx indicators.\n  const userAgent = process.env['npm_config_user_agent']\n  if (\n    userAgent?.includes('exec') ||\n    userAgent?.includes('npx') ||\n    userAgent?.includes('dlx')\n  ) {\n    return true\n  }\n\n  // Normalize the cwd path for consistent checking across platforms.\n  const normalizedCwd = normalizePath(cwd)\n\n  // Check if running from npm's npx cache.\n  const npmCache = process.env['npm_config_cache']\n  if (npmCache && normalizedCwd.includes(normalizePath(npmCache))) {\n    return true\n  }\n\n  // Check common temporary execution path patterns.\n  const tempPatterns = [\n    // npm's npx cache directory\n    '_npx',\n    // pnpm dlx temporary store\n    '.pnpm-store',\n    // Common dlx directory prefix\n    'dlx-',\n    // Yarn Berry PnP virtual packages.\n    '.yarn/$$',\n  ]\n\n  // Yarn on Windows uses AppData/Local/Temp/xfs- pattern.\n  if (WIN32) {\n    tempPatterns.push('AppData/Local/Temp/xfs-')\n  }\n\n  return tempPatterns.some(pattern => normalizedCwd.includes(pattern))\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kCAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAsB,+BACtBC,EAA8B,kBAUvB,SAASH,EAA6BI,EAAM,QAAQ,IAAI,EAAY,CAEzE,MAAMC,EAAY,QAAQ,IAAI,sBAC9B,GACEA,GAAW,SAAS,MAAM,GAC1BA,GAAW,SAAS,KAAK,GACzBA,GAAW,SAAS,KAAK,EAEzB,MAAO,GAIT,MAAMC,KAAgB,iBAAcF,CAAG,EAGjCG,EAAW,QAAQ,IAAI,iBAC7B,GAAIA,GAAYD,EAAc,YAAS,iBAAcC,CAAQ,CAAC,EAC5D,MAAO,GAIT,MAAMC,EAAe,CAEnB,OAEA,cAEA,OAEA,UACF,EAGA,OAAI,SACFA,EAAa,KAAK,yBAAyB,EAGtCA,EAAa,KAAKC,GAAWH,EAAc,SAASG,CAAO,CAAC,CACrE",
-  "names": ["temporary_executor_exports", "__export", "isRunningInTemporaryExecutor", "__toCommonJS", "import_platform", "import_path", "cwd", "userAgent", "normalizedCwd", "npmCache", "tempPatterns", "pattern"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,sBAAsB;AACtB,kBAA8B;AAUvB,SAAS,6BAA6B,MAAM,QAAQ,IAAI,GAAY;AAEzE,QAAM,YAAY,QAAQ,IAAI,uBAAuB;AACrD,MACE,WAAW,SAAS,MAAM,KAC1B,WAAW,SAAS,KAAK,KACzB,WAAW,SAAS,KAAK,GACzB;AACA,WAAO;AAAA,EACT;AAGA,QAAM,oBAAgB,2BAAc,GAAG;AAGvC,QAAM,WAAW,QAAQ,IAAI,kBAAkB;AAC/C,MAAI,YAAY,cAAc,aAAS,2BAAc,QAAQ,CAAC,GAAG;AAC/D,WAAO;AAAA,EACT;AAGA,QAAM,eAAe;AAAA;AAAA,IAEnB;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA,EACF;AAGA,MAAI,uBAAO;AACT,iBAAa,KAAK,yBAAyB;AAAA,EAC7C;AAEA,SAAO,aAAa,KAAK,aAAW,cAAc,SAAS,OAAO,CAAC;AACrE;",
+  "names": []
 }

package/dist/themes/context.js

@@ -1,3 +1,73 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var g=(e,t)=>{for(var n in t)m(e,n,{get:t[n],enumerable:!0})},y=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of f(t))!u.call(e,r)&&r!==n&&m(e,r,{get:()=>t[r],enumerable:!(a=p(t,r))||a.enumerable});return e};var d=e=>y(m({},"__esModule",{value:!0}),e);var C={};g(C,{getTheme:()=>S,onThemeChange:()=>x,setTheme:()=>l,withTheme:()=>v,withThemeSync:()=>w});module.exports=d(C);var c=require("node:async_hooks"),o=require("./themes");const i=new c.AsyncLocalStorage;let T=o.SOCKET_THEME;const h=new Set;function l(e){T=typeof e=="string"?o.THEMES[e]:e,s(T)}function S(){return i.getStore()??T}async function v(e,t){const n=typeof e=="string"?o.THEMES[e]:e;return await i.run(n,async()=>(s(n),await t()))}function w(e,t){const n=typeof e=="string"?o.THEMES[e]:e;return i.run(n,()=>(s(n),t()))}function x(e){return h.add(e),()=>{h.delete(e)}}function s(e){for(const t of h)t(e)}0&&(module.exports={getTheme,onThemeChange,setTheme,withTheme,withThemeSync});
+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 context_exports = {};
+__export(context_exports, {
+  getTheme: () => getTheme,
+  onThemeChange: () => onThemeChange,
+  setTheme: () => setTheme,
+  withTheme: () => withTheme,
+  withThemeSync: () => withThemeSync
+});
+module.exports = __toCommonJS(context_exports);
+var import_node_async_hooks = require("node:async_hooks");
+var import_themes = require("./themes");
+const themeStorage = new import_node_async_hooks.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;
+}
+async function withTheme(theme, fn) {
+  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] : 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;
+  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,
+  onThemeChange,
+  setTheme,
+  withTheme,
+  withThemeSync
+});
 //# sourceMappingURL=context.js.map

package/dist/themes/context.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/themes/context.ts"],
   "sourcesContent": ["/**\n * @fileoverview Elegant theme context management.\n * Async-aware theming with automatic context isolation via AsyncLocalStorage.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks'\n\nimport type { Theme } from './types'\nimport { SOCKET_THEME, THEMES, type ThemeName } from './themes'\n\n/**\n * Theme change event listener signature.\n */\nexport type ThemeChangeListener = (theme: Theme) => void\n\n/**\n * AsyncLocalStorage for theme context isolation.\n */\nconst themeStorage = new AsyncLocalStorage<Theme>()\n\n/**\n * Fallback theme for global context.\n */\nlet fallbackTheme: Theme = SOCKET_THEME\n\n/**\n * Registered theme change listeners.\n */\nconst listeners: Set<ThemeChangeListener> = new Set()\n\n/**\n * Set the global fallback theme.\n *\n * @param theme - Theme name or object\n *\n * @example\n * ```ts\n * setTheme('socket-firewall')\n * ```\n */\nexport function setTheme(theme: Theme | ThemeName): void {\n  fallbackTheme = typeof theme === 'string' ? THEMES[theme] : theme\n  emitThemeChange(fallbackTheme)\n}\n\n/**\n * Get the active theme from context.\n *\n * @returns Current theme\n *\n * @example\n * ```ts\n * const theme = getTheme()\n * console.log(theme.displayName)\n * ```\n */\nexport function getTheme(): Theme {\n  return themeStorage.getStore() ?? fallbackTheme\n}\n\n/**\n * Execute async operation with scoped theme.\n * Theme automatically restored on completion.\n *\n * @template T - Return type\n * @param theme - Scoped theme\n * @param fn - Async operation\n * @returns Operation result\n *\n * @example\n * ```ts\n * await withTheme('ultra', async () => {\n *   // Operations use Ultra theme\n * })\n * ```\n */\nexport async function withTheme<T>(\n  theme: Theme | ThemeName,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const resolvedTheme = typeof theme === 'string' ? THEMES[theme] : theme\n  return await themeStorage.run(resolvedTheme, async () => {\n    emitThemeChange(resolvedTheme)\n    return await fn()\n  })\n}\n\n/**\n * Execute sync operation with scoped theme.\n * Theme automatically restored on completion.\n *\n * @template T - Return type\n * @param theme - Scoped theme\n * @param fn - Sync operation\n * @returns Operation result\n *\n * @example\n * ```ts\n * const result = withThemeSync('coana', () => {\n *   return processData()\n * })\n * ```\n */\nexport function withThemeSync<T>(theme: Theme | ThemeName, fn: () => T): T {\n  const resolvedTheme = typeof theme === 'string' ? THEMES[theme] : theme\n  return themeStorage.run(resolvedTheme, () => {\n    emitThemeChange(resolvedTheme)\n    return fn()\n  })\n}\n\n/**\n * Subscribe to theme change events.\n *\n * @param listener - Change handler\n * @returns Unsubscribe function\n *\n * @example\n * ```ts\n * const unsubscribe = onThemeChange((theme) => {\n *   console.log('Theme:', theme.displayName)\n * })\n *\n * // Cleanup\n * unsubscribe()\n * ```\n */\nexport function onThemeChange(listener: ThemeChangeListener): () => void {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/**\n * Emit theme change event to listeners.\n * @private\n */\nfunction emitThemeChange(theme: Theme): void {\n  for (const listener of listeners) {\n    listener(theme)\n  }\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,EAAA,kBAAAC,EAAA,aAAAC,EAAA,cAAAC,EAAA,kBAAAC,IAAA,eAAAC,EAAAP,GAKA,IAAAQ,EAAkC,4BAGlCC,EAAqD,oBAUrD,MAAMC,EAAe,IAAI,oBAKzB,IAAIC,EAAuB,eAK3B,MAAMC,EAAsC,IAAI,IAYzC,SAASR,EAASS,EAAgC,CACvDF,EAAgB,OAAOE,GAAU,SAAW,SAAOA,CAAK,EAAIA,EAC5DC,EAAgBH,CAAa,CAC/B,CAaO,SAAST,GAAkB,CAChC,OAAOQ,EAAa,SAAS,GAAKC,CACpC,CAkBA,eAAsBN,EACpBQ,EACAE,EACY,CACZ,MAAMC,EAAgB,OAAOH,GAAU,SAAW,SAAOA,CAAK,EAAIA,EAClE,OAAO,MAAMH,EAAa,IAAIM,EAAe,UAC3CF,EAAgBE,CAAa,EACtB,MAAMD,EAAG,EACjB,CACH,CAkBO,SAAST,EAAiBO,EAA0BE,EAAgB,CACzE,MAAMC,EAAgB,OAAOH,GAAU,SAAW,SAAOA,CAAK,EAAIA,EAClE,OAAOH,EAAa,IAAIM,EAAe,KACrCF,EAAgBE,CAAa,EACtBD,EAAG,EACX,CACH,CAkBO,SAASZ,EAAcc,EAA2C,CACvE,OAAAL,EAAU,IAAIK,CAAQ,EACf,IAAM,CACXL,EAAU,OAAOK,CAAQ,CAC3B,CACF,CAMA,SAASH,EAAgBD,EAAoB,CAC3C,UAAWI,KAAYL,EACrBK,EAASJ,CAAK,CAElB",
-  "names": ["context_exports", "__export", "getTheme", "onThemeChange", "setTheme", "withTheme", "withThemeSync", "__toCommonJS", "import_node_async_hooks", "import_themes", "themeStorage", "fallbackTheme", "listeners", "theme", "emitThemeChange", "fn", "resolvedTheme", "listener"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,8BAAkC;AAGlC,oBAAqD;AAUrD,MAAM,eAAe,IAAI,0CAAyB;AAKlD,IAAI,gBAAuB;AAK3B,MAAM,YAAsC,oBAAI,IAAI;AAY7C,SAAS,SAAS,OAAgC;AACvD,kBAAgB,OAAO,UAAU,WAAW,qBAAO,KAAK,IAAI;AAC5D,kBAAgB,aAAa;AAC/B;AAaO,SAAS,WAAkB;AAChC,SAAO,aAAa,SAAS,KAAK;AACpC;AAkBA,eAAsB,UACpB,OACA,IACY;AACZ,QAAM,gBAAgB,OAAO,UAAU,WAAW,qBAAO,KAAK,IAAI;AAClE,SAAO,MAAM,aAAa,IAAI,eAAe,YAAY;AACvD,oBAAgB,aAAa;AAC7B,WAAO,MAAM,GAAG;AAAA,EAClB,CAAC;AACH;AAkBO,SAAS,cAAiB,OAA0B,IAAgB;AACzE,QAAM,gBAAgB,OAAO,UAAU,WAAW,qBAAO,KAAK,IAAI;AAClE,SAAO,aAAa,IAAI,eAAe,MAAM;AAC3C,oBAAgB,aAAa;AAC7B,WAAO,GAAG;AAAA,EACZ,CAAC;AACH;AAkBO,SAAS,cAAc,UAA2C;AACvE,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAAA,EAC3B;AACF;AAMA,SAAS,gBAAgB,OAAoB;AAC3C,aAAW,YAAY,WAAW;AAChC,aAAS,KAAK;AAAA,EAChB;AACF;",
+  "names": []
 }

package/dist/themes/index.js

@@ -1,3 +1,59 @@
 /* Socket Lib - Built with esbuild */
-var E=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var n=Object.prototype.hasOwnProperty;var s=(h,m)=>{for(var t in m)E(h,t,{get:m[t],enumerable:!0})},H=(h,m,t,p)=>{if(m&&typeof m=="object"||typeof m=="function")for(let r of f(m))!n.call(h,r)&&r!==t&&E(h,r,{get:()=>m[r],enumerable:!(p=C(m,r))||p.enumerable});return h};var M=h=>H(E({},"__esModule",{value:!0}),h);var S={};s(S,{BRICK_THEME:()=>e.BRICK_THEME,LUSH_THEME:()=>e.LUSH_THEME,SOCKET_THEME:()=>e.SOCKET_THEME,SUNSET_THEME:()=>e.SUNSET_THEME,THEMES:()=>e.THEMES,ULTRA_THEME:()=>e.ULTRA_THEME,createTheme:()=>o.createTheme,extendTheme:()=>o.extendTheme,getTheme:()=>T.getTheme,onThemeChange:()=>T.onThemeChange,resolveColor:()=>o.resolveColor,resolveShimmerColor:()=>o.resolveShimmerColor,setTheme:()=>T.setTheme,withTheme:()=>T.withTheme,withThemeSync:()=>T.withThemeSync});module.exports=M(S);var e=require("./themes"),T=require("./context"),o=require("./utils");0&&(module.exports={BRICK_THEME,LUSH_THEME,SOCKET_THEME,SUNSET_THEME,THEMES,ULTRA_THEME,createTheme,extendTheme,getTheme,onThemeChange,resolveColor,resolveShimmerColor,setTheme,withTheme,withThemeSync});
+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 themes_exports = {};
+__export(themes_exports, {
+  BRICK_THEME: () => import_themes.BRICK_THEME,
+  LUSH_THEME: () => import_themes.LUSH_THEME,
+  SOCKET_THEME: () => import_themes.SOCKET_THEME,
+  SUNSET_THEME: () => import_themes.SUNSET_THEME,
+  THEMES: () => import_themes.THEMES,
+  ULTRA_THEME: () => import_themes.ULTRA_THEME,
+  createTheme: () => import_utils.createTheme,
+  extendTheme: () => import_utils.extendTheme,
+  getTheme: () => import_context.getTheme,
+  onThemeChange: () => import_context.onThemeChange,
+  resolveColor: () => import_utils.resolveColor,
+  resolveShimmerColor: () => import_utils.resolveShimmerColor,
+  setTheme: () => import_context.setTheme,
+  withTheme: () => import_context.withTheme,
+  withThemeSync: () => import_context.withThemeSync
+});
+module.exports = __toCommonJS(themes_exports);
+var import_themes = require("./themes");
+var import_context = require("./context");
+var import_utils = require("./utils");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BRICK_THEME,
+  LUSH_THEME,
+  SOCKET_THEME,
+  SUNSET_THEME,
+  THEMES,
+  ULTRA_THEME,
+  createTheme,
+  extendTheme,
+  getTheme,
+  onThemeChange,
+  resolveColor,
+  resolveShimmerColor,
+  setTheme,
+  withTheme,
+  withThemeSync
+});
 //# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/themes/index.ts"],
   "sourcesContent": ["/**\n * @fileoverview Elegant theming system for Socket libraries.\n * Unified visual language across spinners, loggers, prompts, and links.\n *\n * @example\n * ```ts\n * import { setTheme, THEMES } from '@socketsecurity/lib/themes'\n *\n * // Set global theme\n * setTheme('brick')\n * ```\n *\n * @example\n * ```ts\n * import { withTheme } from '@socketsecurity/lib/themes'\n *\n * // Scoped theme context\n * await withTheme('ultra', async () => {\n *   // All operations inherit Ultra theme\n * })\n * ```\n *\n * @example\n * ```ts\n * import { createTheme } from '@socketsecurity/lib/themes'\n *\n * // Custom theme creation\n * const myTheme = createTheme({\n *   name: 'custom',\n *   displayName: 'Custom Theme',\n *   colors: {\n *     primary: [255, 100, 200],\n *     success: 'greenBright',\n *     error: 'redBright',\n *     warning: 'yellowBright',\n *     info: 'blueBright',\n *     step: 'cyanBright',\n *     text: 'white',\n *     textDim: 'gray',\n *     link: 'cyanBright',\n *     prompt: 'primary'\n *   }\n * })\n * ```\n */\n\n// Type system\nexport type {\n  ColorReference,\n  Theme,\n  ThemeColors,\n  ThemeEffects,\n  ThemeMeta,\n} from './types'\n\n// Curated themes\nexport {\n  BRICK_THEME,\n  LUSH_THEME,\n  SOCKET_THEME,\n  SUNSET_THEME,\n  THEMES,\n  ULTRA_THEME,\n  type ThemeName,\n} from './themes'\n\n// Context management\nexport {\n  getTheme,\n  onThemeChange,\n  setTheme,\n  withTheme,\n  withThemeSync,\n  type ThemeChangeListener,\n} from './context'\n\n// Composition utilities\nexport {\n  createTheme,\n  extendTheme,\n  resolveColor,\n  resolveShimmerColor,\n} from './utils'\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sdAAAE,EAAAF,GAwDA,IAAAG,EAQO,oBAGPC,EAOO,qBAGPC,EAKO",
-  "names": ["themes_exports", "__export", "__toCommonJS", "import_themes", "import_context", "import_utils"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwDA,oBAQO;AAGP,qBAOO;AAGP,mBAKO;",
+  "names": []
 }