@socketsecurity/lib 2.10.3 → 3.0.0

package/dist/themes/context.d.ts

@@ -0,0 +1,80 @@
+import type { Theme } from './types';
+import { type ThemeName } from './themes';
+/**
+ * Theme change event listener signature.
+ */
+export type ThemeChangeListener = (theme: Theme) => 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;
+/**
+ * Get the active theme from context.
+ *
+ * @returns Current theme
+ *
+ * @example
+ * ```ts
+ * const theme = getTheme()
+ * console.log(theme.displayName)
+ * ```
+ */
+export declare function getTheme(): Theme;
+/**
+ * Execute async operation with scoped theme.
+ * Theme automatically restored on completion.
+ *
+ * @template T - Return type
+ * @param theme - Scoped theme
+ * @param fn - Async operation
+ * @returns Operation result
+ *
+ * @example
+ * ```ts
+ * await withTheme('ultra', async () => {
+ *   // Operations use Ultra theme
+ * })
+ * ```
+ */
+export declare function withTheme<T>(theme: Theme | ThemeName, fn: () => Promise<T>): Promise<T>;
+/**
+ * Execute sync operation with scoped theme.
+ * Theme automatically restored on completion.
+ *
+ * @template T - Return type
+ * @param theme - Scoped theme
+ * @param fn - Sync operation
+ * @returns Operation result
+ *
+ * @example
+ * ```ts
+ * const result = withThemeSync('coana', () => {
+ *   return processData()
+ * })
+ * ```
+ */
+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

@@ -0,0 +1,3 @@
+/* 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});
+//# sourceMappingURL=context.js.map

package/dist/themes/context.js.map

@@ -0,0 +1,7 @@
+{
+  "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"]
+}

package/dist/themes/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Elegant theming system for Socket libraries.
+ * Unified visual language across spinners, loggers, prompts, and links.
+ *
+ * @example
+ * ```ts
+ * import { setTheme, THEMES } from '@socketsecurity/lib/themes'
+ *
+ * // Set global theme
+ * setTheme('brick')
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { withTheme } from '@socketsecurity/lib/themes'
+ *
+ * // Scoped theme context
+ * await withTheme('ultra', async () => {
+ *   // All operations inherit Ultra theme
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createTheme } from '@socketsecurity/lib/themes'
+ *
+ * // Custom theme creation
+ * const myTheme = createTheme({
+ *   name: 'custom',
+ *   displayName: 'Custom Theme',
+ *   colors: {
+ *     primary: [255, 100, 200],
+ *     success: 'greenBright',
+ *     error: 'redBright',
+ *     warning: 'yellowBright',
+ *     info: 'blueBright',
+ *     step: 'cyanBright',
+ *     text: 'white',
+ *     textDim: 'gray',
+ *     link: 'cyanBright',
+ *     prompt: 'primary'
+ *   }
+ * })
+ * ```
+ */
+// Type system
+export type { ColorReference, Theme, ThemeColors, ThemeEffects, ThemeMeta, } from './types';
+// Curated themes
+export { BRICK_THEME, LUSH_THEME, SOCKET_THEME, SUNSET_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

@@ -0,0 +1,3 @@
+/* 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});
+//# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -0,0 +1,7 @@
+{
+  "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"]
+}

package/dist/themes/themes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Elegant theme definitions for Socket libraries.
+ * Sophisticated color palettes crafted for clarity and visual harmony.
+ *
+ * Philosophy: Every color choice serves a purpose. Bright variants ensure
+ * terminal legibility without compromising sophistication. Minimal emoji use,
+ * refined symbols with color—elegance in restraint.
+ */
+import type { Theme } from './types';
+/**
+ * Socket Security — The signature theme.
+ * Refined violet with subtle shimmer, designed for focus and elegance.
+ */
+export declare const SOCKET_THEME: Theme;
+/**
+ * Sunset — Crisp azure.
+ * Clean analytical theme with precise blue tones.
+ */
+export declare const SUNSET_THEME: Theme;
+/**
+ * Brick — Solid warmth.
+ * Rich terracotta and ember tones for grounded confidence.
+ */
+export declare const BRICK_THEME: Theme;
+/**
+ * Lush — Steel elegance.
+ * Python-inspired steel blue with golden accents.
+ */
+export declare const LUSH_THEME: Theme;
+/**
+ * Ultra — Premium intensity.
+ * Prismatic shimmer for deep analysis, where complexity meets elegance.
+ */
+export declare const ULTRA_THEME: Theme;
+/**
+ * Theme registry — Curated palette collection.
+ */
+export declare const THEMES: {
+    readonly __proto__: any;
+    readonly socket: Theme;
+    readonly sunset: Theme;
+    readonly brick: Theme;
+    readonly lush: Theme;
+    readonly ultra: Theme;
+};
+/**
+ * Available theme identifiers.
+ */
+export type ThemeName = keyof typeof THEMES;

package/dist/themes/themes.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var o=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var g=(r,e)=>{for(var i in e)o(r,i,{get:e[i],enumerable:!0})},d=(r,e,i,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of l(e))!y.call(r,t)&&t!==i&&o(r,t,{get:()=>e[t],enumerable:!(s=p(e,t))||s.enumerable});return r};var B=r=>d(o({},"__esModule",{value:!0}),r);var f={};g(f,{BRICK_THEME:()=>c,LUSH_THEME:()=>m,SOCKET_THEME:()=>n,SUNSET_THEME:()=>a,THEMES:()=>u,ULTRA_THEME:()=>h});module.exports=B(f);const n={name:"socket",displayName:"Socket Security",colors:{primary:[140,82,255],success:"greenBright",error:"redBright",warning:"yellowBright",info:"blueBright",step:"cyanBright",text:"white",textDim:"gray",link:"cyanBright",prompt:"primary"},effects:{spinner:{color:"primary",style:"socket"},shimmer:{enabled:!0,color:"inherit",direction:"ltr",speed:.33}},meta:{description:"Signature theme with refined violet and subtle shimmer",version:"1.0.0"}},a={name:"sunset",displayName:"Sunset",colors:{primary:[100,200,255],secondary:[50,150,200],success:"greenBright",error:"redBright",warning:"yellowBright",info:"blueBright",step:"cyanBright",text:"white",textDim:"gray",link:"cyanBright",prompt:"primary"},effects:{spinner:{color:"primary",style:"dots"}},meta:{description:"Crisp azure theme for precision and clarity",version:"1.0.0"}},c={name:"brick",displayName:"Brick",colors:{primary:[255,100,50],secondary:[255,150,100],success:"greenBright",error:"redBright",warning:"yellowBright",info:"blueBright",step:"cyanBright",text:"white",textDim:"gray",link:"secondary",prompt:"primary"},effects:{spinner:{color:"primary",style:"socket"},shimmer:{enabled:!0,color:"inherit",direction:"ltr",speed:.5}},meta:{description:"Solid theme with rich terracotta and ember warmth",version:"1.0.0"}},m={name:"lush",displayName:"Lush",colors:{primary:[70,130,180],secondary:[255,215,0],success:"greenBright",error:"redBright",warning:"yellowBright",info:"blueBright",step:"cyanBright",text:"white",textDim:"gray",link:"cyanBright",prompt:"primary"},effects:{spinner:{color:"primary",style:"dots"}},meta:{description:"Elegant theme with steel blue and golden harmony",version:"1.0.0"}},h={name:"ultra",displayName:"Ultra",colors:{primary:[140,82,255],success:"greenBright",error:"redBright",warning:"yellowBright",info:"cyanBright",step:"magentaBright",text:"whiteBright",textDim:"gray",link:"cyanBright",prompt:"primary"},effects:{spinner:{color:"inherit",style:"socket"},shimmer:{enabled:!0,color:"rainbow",direction:"bi",speed:.5}},meta:{description:"Premium theme with prismatic shimmer for deep analysis",version:"1.0.0"}},u={__proto__:null,socket:n,sunset:a,brick:c,lush:m,ultra:h};0&&(module.exports={BRICK_THEME,LUSH_THEME,SOCKET_THEME,SUNSET_THEME,THEMES,ULTRA_THEME});
+//# sourceMappingURL=themes.js.map

package/dist/themes/themes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/themes/themes.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Elegant theme definitions for Socket libraries.\n * Sophisticated color palettes crafted for clarity and visual harmony.\n *\n * Philosophy: Every color choice serves a purpose. Bright variants ensure\n * terminal legibility without compromising sophistication. Minimal emoji use,\n * refined symbols with color\u2014elegance in restraint.\n */\n\nimport type { Theme } from './types'\n\n/**\n * Socket Security \u2014 The signature theme.\n * Refined violet with subtle shimmer, designed for focus and elegance.\n */\nexport const SOCKET_THEME: Theme = {\n  name: 'socket',\n  displayName: 'Socket Security',\n  colors: {\n    primary: [140, 82, 255],\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  effects: {\n    spinner: {\n      color: 'primary',\n      style: 'socket',\n    },\n    shimmer: {\n      enabled: true,\n      color: 'inherit',\n      direction: 'ltr',\n      speed: 0.33,\n    },\n  },\n  meta: {\n    description: 'Signature theme with refined violet and subtle shimmer',\n    version: '1.0.0',\n  },\n}\n\n/**\n * Sunset \u2014 Crisp azure.\n * Clean analytical theme with precise blue tones.\n */\nexport const SUNSET_THEME: Theme = {\n  name: 'sunset',\n  displayName: 'Sunset',\n  colors: {\n    primary: [100, 200, 255],\n    secondary: [50, 150, 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  effects: {\n    spinner: {\n      color: 'primary',\n      style: 'dots',\n    },\n  },\n  meta: {\n    description: 'Crisp azure theme for precision and clarity',\n    version: '1.0.0',\n  },\n}\n\n/**\n * Brick \u2014 Solid warmth.\n * Rich terracotta and ember tones for grounded confidence.\n */\nexport const BRICK_THEME: Theme = {\n  name: 'brick',\n  displayName: 'Brick',\n  colors: {\n    primary: [255, 100, 50],\n    secondary: [255, 150, 100],\n    success: 'greenBright',\n    error: 'redBright',\n    warning: 'yellowBright',\n    info: 'blueBright',\n    step: 'cyanBright',\n    text: 'white',\n    textDim: 'gray',\n    link: 'secondary',\n    prompt: 'primary',\n  },\n  effects: {\n    spinner: {\n      color: 'primary',\n      style: 'socket',\n    },\n    shimmer: {\n      enabled: true,\n      color: 'inherit',\n      direction: 'ltr',\n      speed: 0.5,\n    },\n  },\n  meta: {\n    description: 'Solid theme with rich terracotta and ember warmth',\n    version: '1.0.0',\n  },\n}\n\n/**\n * Lush \u2014 Steel elegance.\n * Python-inspired steel blue with golden accents.\n */\nexport const LUSH_THEME: Theme = {\n  name: 'lush',\n  displayName: 'Lush',\n  colors: {\n    primary: [70, 130, 180],\n    secondary: [255, 215, 0],\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  effects: {\n    spinner: {\n      color: 'primary',\n      style: 'dots',\n    },\n  },\n  meta: {\n    description: 'Elegant theme with steel blue and golden harmony',\n    version: '1.0.0',\n  },\n}\n\n/**\n * Ultra \u2014 Premium intensity.\n * Prismatic shimmer for deep analysis, where complexity meets elegance.\n */\nexport const ULTRA_THEME: Theme = {\n  name: 'ultra',\n  displayName: 'Ultra',\n  colors: {\n    primary: [140, 82, 255],\n    success: 'greenBright',\n    error: 'redBright',\n    warning: 'yellowBright',\n    info: 'cyanBright',\n    step: 'magentaBright',\n    text: 'whiteBright',\n    textDim: 'gray',\n    link: 'cyanBright',\n    prompt: 'primary',\n  },\n  effects: {\n    spinner: {\n      color: 'inherit',\n      style: 'socket',\n    },\n    shimmer: {\n      enabled: true,\n      color: 'rainbow',\n      direction: 'bi',\n      speed: 0.5,\n    },\n  },\n  meta: {\n    description: 'Premium theme with prismatic shimmer for deep analysis',\n    version: '1.0.0',\n  },\n}\n\n/**\n * Theme registry \u2014 Curated palette collection.\n */\nexport const THEMES = {\n  __proto__: null,\n  socket: SOCKET_THEME,\n  sunset: SUNSET_THEME,\n  brick: BRICK_THEME,\n  lush: LUSH_THEME,\n  ultra: ULTRA_THEME,\n} as const\n\n/**\n * Available theme identifiers.\n */\nexport type ThemeName = keyof typeof THEMES\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,EAAA,eAAAC,EAAA,iBAAAC,EAAA,iBAAAC,EAAA,WAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAR,GAeO,MAAMI,EAAsB,CACjC,KAAM,SACN,YAAa,kBACb,OAAQ,CACN,QAAS,CAAC,IAAK,GAAI,GAAG,EACtB,QAAS,cACT,MAAO,YACP,QAAS,eACT,KAAM,aACN,KAAM,aACN,KAAM,QACN,QAAS,OACT,KAAM,aACN,OAAQ,SACV,EACA,QAAS,CACP,QAAS,CACP,MAAO,UACP,MAAO,QACT,EACA,QAAS,CACP,QAAS,GACT,MAAO,UACP,UAAW,MACX,MAAO,GACT,CACF,EACA,KAAM,CACJ,YAAa,yDACb,QAAS,OACX,CACF,EAMaC,EAAsB,CACjC,KAAM,SACN,YAAa,SACb,OAAQ,CACN,QAAS,CAAC,IAAK,IAAK,GAAG,EACvB,UAAW,CAAC,GAAI,IAAK,GAAG,EACxB,QAAS,cACT,MAAO,YACP,QAAS,eACT,KAAM,aACN,KAAM,aACN,KAAM,QACN,QAAS,OACT,KAAM,aACN,OAAQ,SACV,EACA,QAAS,CACP,QAAS,CACP,MAAO,UACP,MAAO,MACT,CACF,EACA,KAAM,CACJ,YAAa,8CACb,QAAS,OACX,CACF,EAMaH,EAAqB,CAChC,KAAM,QACN,YAAa,QACb,OAAQ,CACN,QAAS,CAAC,IAAK,IAAK,EAAE,EACtB,UAAW,CAAC,IAAK,IAAK,GAAG,EACzB,QAAS,cACT,MAAO,YACP,QAAS,eACT,KAAM,aACN,KAAM,aACN,KAAM,QACN,QAAS,OACT,KAAM,YACN,OAAQ,SACV,EACA,QAAS,CACP,QAAS,CACP,MAAO,UACP,MAAO,QACT,EACA,QAAS,CACP,QAAS,GACT,MAAO,UACP,UAAW,MACX,MAAO,EACT,CACF,EACA,KAAM,CACJ,YAAa,oDACb,QAAS,OACX,CACF,EAMaC,EAAoB,CAC/B,KAAM,OACN,YAAa,OACb,OAAQ,CACN,QAAS,CAAC,GAAI,IAAK,GAAG,EACtB,UAAW,CAAC,IAAK,IAAK,CAAC,EACvB,QAAS,cACT,MAAO,YACP,QAAS,eACT,KAAM,aACN,KAAM,aACN,KAAM,QACN,QAAS,OACT,KAAM,aACN,OAAQ,SACV,EACA,QAAS,CACP,QAAS,CACP,MAAO,UACP,MAAO,MACT,CACF,EACA,KAAM,CACJ,YAAa,mDACb,QAAS,OACX,CACF,EAMaI,EAAqB,CAChC,KAAM,QACN,YAAa,QACb,OAAQ,CACN,QAAS,CAAC,IAAK,GAAI,GAAG,EACtB,QAAS,cACT,MAAO,YACP,QAAS,eACT,KAAM,aACN,KAAM,gBACN,KAAM,cACN,QAAS,OACT,KAAM,aACN,OAAQ,SACV,EACA,QAAS,CACP,QAAS,CACP,MAAO,UACP,MAAO,QACT,EACA,QAAS,CACP,QAAS,GACT,MAAO,UACP,UAAW,KACX,MAAO,EACT,CACF,EACA,KAAM,CACJ,YAAa,yDACb,QAAS,OACX,CACF,EAKaD,EAAS,CACpB,UAAW,KACX,OAAQF,EACR,OAAQC,EACR,MAAOH,EACP,KAAMC,EACN,MAAOI,CACT",
+  "names": ["themes_exports", "__export", "BRICK_THEME", "LUSH_THEME", "SOCKET_THEME", "SUNSET_THEME", "THEMES", "ULTRA_THEME", "__toCommonJS"]
+}

package/dist/themes/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Elegant theme type system.
+ * Type-safe theming for spinners, loggers, prompts, and links.
+ */
+import type { ColorValue, SpinnerStyle } from '../spinner';
+import type { ShimmerDirection } from '../effects/text-shimmer';
+/**
+ * Color reference — direct value or semantic keyword.
+ * Keywords: 'primary', 'secondary', 'inherit', 'rainbow'
+ */
+export type ColorReference = ColorValue | 'primary' | 'secondary' | 'inherit' | 'rainbow';
+/**
+ * Theme color palette — semantic colors for visual harmony.
+ */
+export type ThemeColors = {
+    /** Primary brand identity */
+    primary: ColorValue;
+    /** Secondary accent (optional) */
+    secondary?: ColorValue | undefined;
+    /** Success indicator ✓ */
+    success: ColorValue;
+    /** Error indicator ✗ */
+    error: ColorValue;
+    /** Warning indicator ⚠ */
+    warning: ColorValue;
+    /** Information indicator ℹ */
+    info: ColorValue;
+    /** Progress indicator → */
+    step: ColorValue;
+    /** Primary text */
+    text: ColorValue;
+    /** Dimmed text */
+    textDim: ColorValue;
+    /** Hyperlinks */
+    link: ColorReference;
+    /** Interactive prompts */
+    prompt: ColorReference;
+};
+/**
+ * Theme effects — animations and visual enhancements.
+ */
+export type ThemeEffects = {
+    /** Spinner configuration */
+    spinner?: {
+        /** Color (supports theme references) */
+        color?: ColorReference | undefined;
+        /** Animation style */
+        style?: SpinnerStyle | string | undefined;
+    };
+    /** Shimmer configuration */
+    shimmer?: {
+        /** Enable shimmer */
+        enabled?: boolean | undefined;
+        /** Color (single, gradient, or keyword) */
+        color?: ColorReference | ColorValue[] | undefined;
+        /** Direction */
+        direction?: ShimmerDirection | undefined;
+        /** Speed (steps per frame) */
+        speed?: number | undefined;
+    };
+    /** Pulse configuration */
+    pulse?: {
+        /** Speed (milliseconds) */
+        speed?: number | undefined;
+    };
+};
+/**
+ * Theme metadata — descriptive information.
+ */
+export type ThemeMeta = {
+    /** Description */
+    description?: string | undefined;
+    /** Author */
+    author?: string | undefined;
+    /** Version */
+    version?: string | undefined;
+};
+/**
+ * Theme definition — complete visual identity.
+ */
+export type Theme = {
+    /** Unique identifier (kebab-case) */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** Color palette */
+    colors: ThemeColors;
+    /** Visual effects (optional) */
+    effects?: ThemeEffects | undefined;
+    /** Metadata (optional) */
+    meta?: ThemeMeta | undefined;
+};

package/dist/themes/types.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var i=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var u=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of d(e))!s.call(r,o)&&o!==t&&i(r,o,{get:()=>e[o],enumerable:!(n=l(e,o))||n.enumerable});return r};var f=r=>u(i({},"__esModule",{value:!0}),r);var m={};module.exports=f(m);
+//# sourceMappingURL=types.js.map

package/dist/themes/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/themes/types.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Elegant theme type system.\n * Type-safe theming for spinners, loggers, prompts, and links.\n */\n\nimport type { ColorValue, SpinnerStyle } from '../spinner'\nimport type { ShimmerDirection } from '../effects/text-shimmer'\n\n/**\n * Color reference \u2014 direct value or semantic keyword.\n * Keywords: 'primary', 'secondary', 'inherit', 'rainbow'\n */\nexport type ColorReference =\n  | ColorValue\n  | 'primary'\n  | 'secondary'\n  | 'inherit'\n  | 'rainbow'\n\n/**\n * Theme color palette \u2014 semantic colors for visual harmony.\n */\nexport type ThemeColors = {\n  /** Primary brand identity */\n  primary: ColorValue\n  /** Secondary accent (optional) */\n  secondary?: ColorValue | undefined\n\n  /** Success indicator \u2713 */\n  success: ColorValue\n  /** Error indicator \u2717 */\n  error: ColorValue\n  /** Warning indicator \u26A0 */\n  warning: ColorValue\n  /** Information indicator \u2139 */\n  info: ColorValue\n  /** Progress indicator \u2192 */\n  step: ColorValue\n\n  /** Primary text */\n  text: ColorValue\n  /** Dimmed text */\n  textDim: ColorValue\n  /** Hyperlinks */\n  link: ColorReference\n  /** Interactive prompts */\n  prompt: ColorReference\n}\n\n/**\n * Theme effects \u2014 animations and visual enhancements.\n */\nexport type ThemeEffects = {\n  /** Spinner configuration */\n  spinner?: {\n    /** Color (supports theme references) */\n    color?: ColorReference | undefined\n    /** Animation style */\n    style?: SpinnerStyle | string | undefined\n  }\n\n  /** Shimmer configuration */\n  shimmer?: {\n    /** Enable shimmer */\n    enabled?: boolean | undefined\n    /** Color (single, gradient, or keyword) */\n    color?: ColorReference | ColorValue[] | undefined\n    /** Direction */\n    direction?: ShimmerDirection | undefined\n    /** Speed (steps per frame) */\n    speed?: number | undefined\n  }\n\n  /** Pulse configuration */\n  pulse?: {\n    /** Speed (milliseconds) */\n    speed?: number | undefined\n  }\n}\n\n/**\n * Theme metadata \u2014 descriptive information.\n */\nexport type ThemeMeta = {\n  /** Description */\n  description?: string | undefined\n  /** Author */\n  author?: string | undefined\n  /** Version */\n  version?: string | undefined\n}\n\n/**\n * Theme definition \u2014 complete visual identity.\n */\nexport type Theme = {\n  /** Unique identifier (kebab-case) */\n  name: string\n  /** Display name */\n  displayName: string\n\n  /** Color palette */\n  colors: ThemeColors\n\n  /** Visual effects (optional) */\n  effects?: ThemeEffects | undefined\n\n  /** Metadata (optional) */\n  meta?: ThemeMeta | undefined\n}\n"],
+  "mappings": ";kWAAA,IAAAA,EAAA,kBAAAC,EAAAD",
+  "names": ["types_exports", "__toCommonJS"]
+}

package/dist/themes/utils.d.ts

@@ -0,0 +1,78 @@
+import type { ColorValue } from '../spinner';
+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)
+ * ```
+ */
+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';
+/**
+ * Extend existing theme with custom overrides.
+ * Deep merge of colors and effects.
+ *
+ * @param base - Base theme
+ * @param overrides - Custom overrides
+ * @returns Extended theme
+ *
+ * @example
+ * ```ts
+ * const custom = extendTheme(SOCKET_THEME, {
+ *   name: 'custom',
+ *   colors: { primary: [255, 100, 200] }
+ * })
+ * ```
+ */
+export declare function extendTheme(base: Theme, overrides: Partial<Omit<Theme, 'colors'>> & {
+    colors?: Partial<ThemeColors> | undefined;
+}): Theme;
+/**
+ * Create new theme from complete specification.
+ *
+ * @param config - Theme configuration
+ * @returns Theme object
+ *
+ * @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'
+ *   }
+ * })
+ * ```
+ */
+export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;

package/dist/themes/utils.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var n=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var p=(e,r)=>{for(var o in r)n(e,o,{get:r[o],enumerable:!0})},h=(e,r,o,f)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of s(r))!_.call(e,t)&&t!==o&&n(e,t,{get:()=>r[t],enumerable:!(f=i(r,t))||f.enumerable});return e};var u=e=>h(n({},"__esModule",{value:!0}),e);var y={};p(y,{createTheme:()=>C,extendTheme:()=>c,resolveColor:()=>l,resolveShimmerColor:()=>a});module.exports=u(y);var m=require("../effects/ultra");function l(e,r){return typeof e=="string"?e==="primary"?r.primary:e==="secondary"?r.secondary??r.primary:e==="inherit"?"inherit":e==="rainbow"?m.RAINBOW_GRADIENT:e:e}function a(e,r){return e?e==="rainbow"?m.RAINBOW_GRADIENT:e==="inherit"?"inherit":Array.isArray(e)?(e.length>0&&Array.isArray(e[0]),e):l(e,r.colors):"inherit"}function c(e,r){return{__proto__:null,...e,...r,colors:{__proto__:null,...e.colors,...r.colors},effects:r.effects?{__proto__:null,...e.effects,...r.effects,spinner:r.effects.spinner!==void 0?{__proto__:null,...e.effects?.spinner,...r.effects.spinner}:e.effects?.spinner,shimmer:r.effects.shimmer!==void 0?{__proto__:null,...e.effects?.shimmer,...r.effects.shimmer}:e.effects?.shimmer,pulse:r.effects.pulse!==void 0?{__proto__:null,...e.effects?.pulse,...r.effects.pulse}:e.effects?.pulse}:e.effects,meta:r.meta?{__proto__:null,...e.meta,...r.meta}:e.meta}}function C(e){return{__proto__:null,name:e.name,displayName:e.displayName,colors:{__proto__:null,...e.colors},effects:e.effects?{__proto__:null,...e.effects}:void 0,meta:e.meta?{__proto__:null,...e.meta}:void 0}}0&&(module.exports={createTheme,extendTheme,resolveColor,resolveShimmerColor});
+//# sourceMappingURL=utils.js.map

package/dist/themes/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/themes/utils.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Theme utilities \u2014 color resolution and composition.\n */\n\nimport { RAINBOW_GRADIENT } from '../effects/ultra'\nimport type { ColorValue } from '../spinner'\nimport type { ShimmerColorGradient } from '../effects/text-shimmer'\nimport type { Theme, ThemeColors, ColorReference } from './types'\n\n/**\n * Resolve color reference to concrete value.\n * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'\n *\n * @param value - Color reference\n * @param colors - Theme palette\n * @returns Resolved color\n *\n * @example\n * ```ts\n * resolveColor('primary', theme.colors)\n * resolveColor([255, 0, 0], theme.colors)\n * ```\n */\nexport function resolveColor(\n  value: ColorReference | ColorValue,\n  colors: ThemeColors,\n): ColorValue | 'inherit' | ShimmerColorGradient {\n  if (typeof value === 'string') {\n    if (value === 'primary') {\n      return colors.primary\n    }\n    if (value === 'secondary') {\n      return colors.secondary ?? colors.primary\n    }\n    if (value === 'inherit') {\n      return 'inherit'\n    }\n    if (value === 'rainbow') {\n      return RAINBOW_GRADIENT\n    }\n    return value as ColorValue\n  }\n  return value as ColorValue\n}\n\n/**\n * Resolve shimmer color with gradient support.\n *\n * @param value - Shimmer color\n * @param theme - Theme context\n * @returns Resolved color\n *\n * @example\n * ```ts\n * resolveShimmerColor('rainbow', theme)\n * resolveShimmerColor('primary', theme)\n * ```\n */\nexport function resolveShimmerColor(\n  value: ColorReference | ColorValue[] | undefined,\n  theme: Theme,\n): ColorValue | ShimmerColorGradient | 'inherit' {\n  if (!value) {\n    return 'inherit'\n  }\n  if (value === 'rainbow') {\n    return RAINBOW_GRADIENT\n  }\n  if (value === 'inherit') {\n    return 'inherit'\n  }\n  if (Array.isArray(value)) {\n    if (value.length > 0 && Array.isArray(value[0])) {\n      // Gradient\n      return value as ShimmerColorGradient\n    }\n    // Single RGB\n    return value as unknown as ColorValue\n  }\n  return resolveColor(value as ColorReference, theme.colors)\n}\n\n/**\n * Extend existing theme with custom overrides.\n * Deep merge of colors and effects.\n *\n * @param base - Base theme\n * @param overrides - Custom overrides\n * @returns Extended theme\n *\n * @example\n * ```ts\n * const custom = extendTheme(SOCKET_THEME, {\n *   name: 'custom',\n *   colors: { primary: [255, 100, 200] }\n * })\n * ```\n */\nexport function extendTheme(\n  base: Theme,\n  overrides: Partial<Omit<Theme, 'colors'>> & {\n    colors?: Partial<ThemeColors> | undefined\n  },\n): Theme {\n  return {\n    __proto__: null,\n    ...base,\n    ...overrides,\n    colors: {\n      __proto__: null,\n      ...base.colors,\n      ...overrides.colors,\n    } as ThemeColors,\n    effects: overrides.effects\n      ? {\n          __proto__: null,\n          ...base.effects,\n          ...overrides.effects,\n          spinner:\n            overrides.effects.spinner !== undefined\n              ? {\n                  __proto__: null,\n                  ...base.effects?.spinner,\n                  ...overrides.effects.spinner,\n                }\n              : base.effects?.spinner,\n          shimmer:\n            overrides.effects.shimmer !== undefined\n              ? {\n                  __proto__: null,\n                  ...base.effects?.shimmer,\n                  ...overrides.effects.shimmer,\n                }\n              : base.effects?.shimmer,\n          pulse:\n            overrides.effects.pulse !== undefined\n              ? {\n                  __proto__: null,\n                  ...base.effects?.pulse,\n                  ...overrides.effects.pulse,\n                }\n              : base.effects?.pulse,\n        }\n      : base.effects,\n    meta: overrides.meta\n      ? {\n          __proto__: null,\n          ...base.meta,\n          ...overrides.meta,\n        }\n      : base.meta,\n  } as Theme\n}\n\n/**\n * Create new theme from complete specification.\n *\n * @param config - Theme configuration\n * @returns Theme object\n *\n * @example\n * ```ts\n * const theme = createTheme({\n *   name: 'custom',\n *   displayName: 'Custom',\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 */\nexport function createTheme(\n  config: Pick<Theme, 'name' | 'displayName' | 'colors'> &\n    Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>,\n): Theme {\n  return {\n    __proto__: null,\n    name: config.name,\n    displayName: config.displayName,\n    colors: { __proto__: null, ...config.colors } as ThemeColors,\n    effects: config.effects\n      ? { __proto__: null, ...config.effects }\n      : undefined,\n    meta: config.meta ? { __proto__: null, ...config.meta } : undefined,\n  } as Theme\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,EAAA,gBAAAC,EAAA,iBAAAC,EAAA,wBAAAC,IAAA,eAAAC,EAAAN,GAIA,IAAAO,EAAiC,4BAmB1B,SAASH,EACdI,EACAC,EAC+C,CAC/C,OAAI,OAAOD,GAAU,SACfA,IAAU,UACLC,EAAO,QAEZD,IAAU,YACLC,EAAO,WAAaA,EAAO,QAEhCD,IAAU,UACL,UAELA,IAAU,UACL,mBAEFA,EAEFA,CACT,CAeO,SAASH,EACdG,EACAE,EAC+C,CAC/C,OAAKF,EAGDA,IAAU,UACL,mBAELA,IAAU,UACL,UAEL,MAAM,QAAQA,CAAK,GACjBA,EAAM,OAAS,GAAK,MAAM,QAAQA,EAAM,CAAC,CAAC,EAErCA,GAKJJ,EAAaI,EAAyBE,EAAM,MAAM,EAhBhD,SAiBX,CAkBO,SAASP,EACdQ,EACAC,EAGO,CACP,MAAO,CACL,UAAW,KACX,GAAGD,EACH,GAAGC,EACH,OAAQ,CACN,UAAW,KACX,GAAGD,EAAK,OACR,GAAGC,EAAU,MACf,EACA,QAASA,EAAU,QACf,CACE,UAAW,KACX,GAAGD,EAAK,QACR,GAAGC,EAAU,QACb,QACEA,EAAU,QAAQ,UAAY,OAC1B,CACE,UAAW,KACX,GAAGD,EAAK,SAAS,QACjB,GAAGC,EAAU,QAAQ,OACvB,EACAD,EAAK,SAAS,QACpB,QACEC,EAAU,QAAQ,UAAY,OAC1B,CACE,UAAW,KACX,GAAGD,EAAK,SAAS,QACjB,GAAGC,EAAU,QAAQ,OACvB,EACAD,EAAK,SAAS,QACpB,MACEC,EAAU,QAAQ,QAAU,OACxB,CACE,UAAW,KACX,GAAGD,EAAK,SAAS,MACjB,GAAGC,EAAU,QAAQ,KACvB,EACAD,EAAK,SAAS,KACtB,EACAA,EAAK,QACT,KAAMC,EAAU,KACZ,CACE,UAAW,KACX,GAAGD,EAAK,KACR,GAAGC,EAAU,IACf,EACAD,EAAK,IACX,CACF,CA4BO,SAAST,EACdW,EAEO,CACP,MAAO,CACL,UAAW,KACX,KAAMA,EAAO,KACb,YAAaA,EAAO,YACpB,OAAQ,CAAE,UAAW,KAAM,GAAGA,EAAO,MAAO,EAC5C,QAASA,EAAO,QACZ,CAAE,UAAW,KAAM,GAAGA,EAAO,OAAQ,EACrC,OACJ,KAAMA,EAAO,KAAO,CAAE,UAAW,KAAM,GAAGA,EAAO,IAAK,EAAI,MAC5D,CACF",
+  "names": ["utils_exports", "__export", "createTheme", "extendTheme", "resolveColor", "resolveShimmerColor", "__toCommonJS", "import_ultra", "value", "colors", "theme", "base", "overrides", "config"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "2.10.3",
+  "version": "3.0.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -152,10 +152,6 @@
       "types": "./dist/dlx-package.d.ts",
       "default": "./dist/dlx-package.js"
     },
-    "./download-lock": {
-      "types": "./dist/download-lock.d.ts",
-      "default": "./dist/download-lock.js"
-    },
     "./effects/pulse-frames": {
       "types": "./dist/effects/pulse-frames.d.ts",
       "default": "./dist/effects/pulse-frames.js"
@@ -296,6 +292,14 @@
       "types": "./dist/json.d.ts",
       "default": "./dist/json.js"
     },
+    "./links": {
+      "types": "./dist/links/index.d.ts",
+      "default": "./dist/links/index.js"
+    },
+    "./links/index": {
+      "types": "./dist/links/index.d.ts",
+      "default": "./dist/links/index.js"
+    },
     "./logger": {
       "types": "./dist/logger.d.ts",
       "default": "./dist/logger.js"
@@ -397,8 +401,12 @@
       "default": "./dist/promises.js"
     },
     "./prompts": {
-      "types": "./dist/prompts.d.ts",
-      "default": "./dist/prompts.js"
+      "types": "./dist/prompts/index.d.ts",
+      "default": "./dist/prompts/index.js"
+    },
+    "./prompts/index": {
+      "types": "./dist/prompts/index.d.ts",
+      "default": "./dist/prompts/index.js"
     },
     "./regexps": {
       "types": "./dist/regexps.d.ts",
@@ -488,6 +496,30 @@
       "types": "./dist/temporary-executor.d.ts",
       "default": "./dist/temporary-executor.js"
     },
+    "./themes": {
+      "types": "./dist/themes/index.d.ts",
+      "default": "./dist/themes/index.js"
+    },
+    "./themes/context": {
+      "types": "./dist/themes/context.d.ts",
+      "default": "./dist/themes/context.js"
+    },
+    "./themes/index": {
+      "types": "./dist/themes/index.d.ts",
+      "default": "./dist/themes/index.js"
+    },
+    "./themes/themes": {
+      "types": "./dist/themes/themes.d.ts",
+      "default": "./dist/themes/themes.js"
+    },
+    "./themes/types": {
+      "types": "./dist/themes/types.d.ts",
+      "default": "./dist/themes/types.js"
+    },
+    "./themes/utils": {
+      "types": "./dist/themes/utils.d.ts",
+      "default": "./dist/themes/utils.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "default": "./dist/types.js"
@@ -579,7 +611,7 @@
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "1.3.1",
     "@socketregistry/yocto-spinner": "1.0.19",
-    "@types/node": "24.6.2",
+    "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",
     "@vitest/ui": "4.0.3",

package/dist/download-lock.d.ts

@@ -1,49 +0,0 @@
-import type { HttpDownloadOptions, HttpDownloadResult } from './http-request';
-export interface DownloadLockInfo {
-    pid: number;
-    startTime: number;
-    url: string;
-}
-export interface DownloadWithLockOptions extends HttpDownloadOptions {
-    /**
-     * Maximum time to wait for lock acquisition in milliseconds.
-     * @default 60000 (1 minute)
-     */
-    lockTimeout?: number | undefined;
-    /**
-     * Directory where lock files are stored.
-     * @default '<destPath>.locks'
-     */
-    locksDir?: string | undefined;
-    /**
-     * Interval for checking stale locks in milliseconds.
-     * @default 1000 (1 second)
-     */
-    pollInterval?: number | undefined;
-    /**
-     * Maximum age of a lock before it's considered stale in milliseconds.
-     * Aligned with npm's npx locking strategy (5-10 seconds).
-     * @default 10000 (10 seconds)
-     */
-    staleTimeout?: number | undefined;
-}
-/**
- * Download a file with locking to prevent concurrent downloads of the same resource.
- * If another process is already downloading to the same destination, this will wait
- * for the download to complete (up to lockTimeout) before proceeding.
- *
- * @throws {Error} When download fails or lock cannot be acquired.
- *
- * @example
- * ```typescript
- * const result = await downloadWithLock(
- *   'https://example.com/file.tar.gz',
- *   '/tmp/downloads/file.tar.gz',
- *   {
- *     retries: 3,
- *     lockTimeout: 60000, // Wait up to 1 minute for other downloads
- *   }
- * )
- * ```
- */
-export declare function downloadWithLock(url: string, destPath: string, options?: DownloadWithLockOptions | undefined): Promise<HttpDownloadResult>;

package/dist/download-lock.js

@@ -1,10 +0,0 @@
-/* Socket Lib - Built with esbuild */
-var D=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var y=(o,t)=>{for(var n in t)D(o,n,{get:t[n],enumerable:!0})},I=(o,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of h(t))!L.call(o,r)&&r!==n&&D(o,r,{get:()=>t[r],enumerable:!(i=T(t,r))||i.enumerable});return o};var b=o=>I(D({},"__esModule",{value:!0}),o);var z={};y(z,{downloadWithLock:()=>x});module.exports=b(z);var f=require("node:fs"),e=require("node:fs/promises"),u=require("node:path"),g=require("./http-request");function O(o,t){const n=o.replace(/[^\w.-]/g,"_"),i=t||(0,u.join)((0,u.dirname)(o),".locks",n);return(0,u.join)(i,"concurrency.lock")}function S(o,t){if(Date.now()-o.startTime>t)return!0;try{return process.kill(o.pid,0),!1}catch{return!0}}async function $(o,t,n){const{lockTimeout:i,locksDir:r,pollInterval:m,staleTimeout:p}=n,s=O(o,r),w=(0,u.dirname)(s);await(0,e.mkdir)(w,{recursive:!0});const c=Date.now();for(;;)try{if((0,f.existsSync)(s)){const d=await(0,e.readFile)(s,"utf8"),l=JSON.parse(d);if(S(l,p))await(0,e.rm)(s,{force:!0});else{if(Date.now()-c>i){const k=Date.now()-l.startTime;throw new Error(`Download lock timed out after ${i}ms
-Lock held by process ${l.pid} for ${k}ms
-Resource: ${l.url}
-Started: ${new Date(l.startTime).toISOString()}
-To resolve:
-  1. Check if process ${l.pid} is still running: ps -p ${l.pid}
-  2. If stale, remove lock file: rm "${s}"
-  3. Or increase lockTimeout option`)}await new Promise(k=>setTimeout(k,m));continue}}const a={pid:process.pid,startTime:Date.now(),url:t};return await(0,e.writeFile)(s,JSON.stringify(a,null,2),{flag:"wx"}),s}catch(a){if(a.code==="EEXIST"){if(Date.now()-c>i)throw new Error(`Lock acquisition timed out after ${i}ms`);await new Promise(d=>setTimeout(d,m));continue}throw a}}async function v(o){try{await(0,e.rm)(o,{force:!0})}catch{}}async function x(o,t,n){const{lockTimeout:i=6e4,locksDir:r,pollInterval:m=1e3,staleTimeout:p=1e4,...s}={__proto__:null,...n};if((0,f.existsSync)(t)){const c=await(0,e.stat)(t).catch(()=>null);if(c&&c.size>0)return{path:t,size:c.size}}const w=await $(t,o,{lockTimeout:i,locksDir:r,pollInterval:m,staleTimeout:p});try{if((0,f.existsSync)(t)){const a=await(0,e.stat)(t).catch(()=>null);if(a&&a.size>0)return{path:t,size:a.size}}return await(0,g.httpDownload)(o,t,s)}finally{await v(w)}}0&&(module.exports={downloadWithLock});
-//# sourceMappingURL=download-lock.js.map