@socketsecurity/lib 3.0.2 → 3.0.4

package/dist/stdio/divider.js

@@ -1,5 +1,91 @@
 /* Socket Lib - Built with esbuild */
-var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var u=(i,t)=>{for(var n in t)c(i,n,{get:t[n],enumerable:!0})},f=(i,t,n,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of h(t))!v.call(i,o)&&o!==n&&c(i,o,{get:()=>t[o],enumerable:!(e=p(t,o))||e.enumerable});return i};var D=i=>f(c({},"__esModule",{value:!0}),i);var m={};u(m,{divider:()=>r,dividers:()=>x,printDivider:()=>d,printDottedDivider:()=>O,printSectionBreak:()=>k,printThickDivider:()=>g,printThinDivider:()=>l,sectionBreak:()=>s});module.exports=D(m);var a=require("../strings");function r(i){const t={__proto__:null,...i},{char:n="\u2550",width:e=55}=t;return(0,a.repeatString)(n,e)}function d(i){console.log(r(i))}const x={thick:()=>r({char:"\u2550"}),thin:()=>r({char:"\u2500"}),double:()=>r({char:"\u2550"}),single:()=>r({char:"-"}),dotted:()=>r({char:"\xB7"}),dashed:()=>r({char:"\u254C"}),wave:()=>r({char:"~"}),star:()=>r({char:"*"}),diamond:()=>r({char:"\u25C6"}),arrow:()=>r({char:"\u2192"})};function g(){d({char:"\u2550"})}function l(){d({char:"\u2500"})}function O(){d({char:"\xB7"})}function s(i){return`
-${r(i)}
-`}function k(i){console.log(s(i))}0&&(module.exports={divider,dividers,printDivider,printDottedDivider,printSectionBreak,printThickDivider,printThinDivider,sectionBreak});
+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 divider_exports = {};
+__export(divider_exports, {
+  divider: () => divider,
+  dividers: () => dividers,
+  printDivider: () => printDivider,
+  printDottedDivider: () => printDottedDivider,
+  printSectionBreak: () => printSectionBreak,
+  printThickDivider: () => printThickDivider,
+  printThinDivider: () => printThinDivider,
+  sectionBreak: () => sectionBreak
+});
+module.exports = __toCommonJS(divider_exports);
+var import_strings = require("../strings");
+function divider(options) {
+  const opts = { __proto__: null, ...options };
+  const { char = "\u2550", width = 55 } = opts;
+  return (0, import_strings.repeatString)(char, width);
+}
+function printDivider(options) {
+  console.log(divider(options));
+}
+const dividers = {
+  /** Thick double-line divider using `═` */
+  thick: () => divider({ char: "\u2550" }),
+  /** Thin single-line divider using `─` */
+  thin: () => divider({ char: "\u2500" }),
+  /** Double-line divider (alias for thick) */
+  double: () => divider({ char: "\u2550" }),
+  /** Simple single dash divider using `-` */
+  single: () => divider({ char: "-" }),
+  /** Dotted divider using `·` */
+  dotted: () => divider({ char: "\xB7" }),
+  /** Dashed divider using `╌` */
+  dashed: () => divider({ char: "\u254C" }),
+  /** Wave divider using `~` */
+  wave: () => divider({ char: "~" }),
+  /** Star divider using `*` */
+  star: () => divider({ char: "*" }),
+  /** Diamond divider using `◆` */
+  diamond: () => divider({ char: "\u25C6" }),
+  /** Arrow divider using `→` */
+  arrow: () => divider({ char: "\u2192" })
+};
+function printThickDivider() {
+  printDivider({ char: "\u2550" });
+}
+function printThinDivider() {
+  printDivider({ char: "\u2500" });
+}
+function printDottedDivider() {
+  printDivider({ char: "\xB7" });
+}
+function sectionBreak(options) {
+  const div = divider(options);
+  return `
+${div}
+`;
+}
+function printSectionBreak(options) {
+  console.log(sectionBreak(options));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  divider,
+  dividers,
+  printDivider,
+  printDottedDivider,
+  printSectionBreak,
+  printThickDivider,
+  printThinDivider,
+  sectionBreak
+});
 //# sourceMappingURL=divider.js.map

package/dist/stdio/divider.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/divider.ts"],
   "sourcesContent": ["/**\n * @fileoverview Console divider and separator utilities.\n * Provides various line styles for visual separation in CLI output.\n */\n\nimport { repeatString } from '../strings'\n\nexport interface DividerOptions {\n  /**\n   * Width of the divider line in characters.\n   * @default 55\n   */\n  width?: number | undefined\n  /**\n   * Character to repeat for the divider line.\n   * @default '\u2550'\n   */\n  char?: string | undefined\n  /**\n   * Optional color function to apply to the divider.\n   * Accepts a function from `yoctocolors` or similar.\n   */\n  color?: ((text: string) => string) | undefined\n}\n\n/**\n * Create a divider line with custom character and width.\n * Returns a string of repeated characters for visual separation.\n *\n * @param options - Divider formatting options\n * @returns Divider string\n *\n * @example\n * ```ts\n * console.log(divider()) // Default: 55 '\u2550' characters\n * console.log(divider({ char: '-', width: 40 }))\n * console.log(divider({ char: '\u00B7', width: 30 }))\n * ```\n */\nexport function divider(options?: DividerOptions): string {\n  const opts = { __proto__: null, ...options } as DividerOptions\n  const { char = '\u2550', width = 55 } = opts\n  return repeatString(char, width)\n}\n\n/**\n * Print a divider line directly to console.\n *\n * @param options - Divider formatting options\n *\n * @example\n * ```ts\n * printDivider() // Prints default divider\n * printDivider({ char: '\u2500', width: 60 })\n * ```\n */\nexport function printDivider(options?: DividerOptions): void {\n  console.log(divider(options))\n}\n\n/**\n * Common divider style presets.\n * Provides quick access to popular divider styles.\n *\n * @example\n * ```ts\n * console.log(dividers.thick()) // \u2550\u2550\u2550\u2550\u2550\u2550\u2550...\n * console.log(dividers.thin())  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500...\n * console.log(dividers.dotted()) // \u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7...\n * ```\n */\nexport const dividers = {\n  /** Thick double-line divider using `\u2550` */\n  thick: () => divider({ char: '\u2550' }),\n  /** Thin single-line divider using `\u2500` */\n  thin: () => divider({ char: '\u2500' }),\n  /** Double-line divider (alias for thick) */\n  double: () => divider({ char: '\u2550' }),\n  /** Simple single dash divider using `-` */\n  single: () => divider({ char: '-' }),\n  /** Dotted divider using `\u00B7` */\n  dotted: () => divider({ char: '\u00B7' }),\n  /** Dashed divider using `\u254C` */\n  dashed: () => divider({ char: '\u254C' }),\n  /** Wave divider using `~` */\n  wave: () => divider({ char: '~' }),\n  /** Star divider using `*` */\n  star: () => divider({ char: '*' }),\n  /** Diamond divider using `\u25C6` */\n  diamond: () => divider({ char: '\u25C6' }),\n  /** Arrow divider using `\u2192` */\n  arrow: () => divider({ char: '\u2192' }),\n} as const\n\n/**\n * Print a thick divider line (default style).\n * Convenience function using `\u2550` character.\n *\n * @example\n * ```ts\n * printThickDivider()\n * // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * ```\n */\nexport function printThickDivider(): void {\n  printDivider({ char: '\u2550' })\n}\n\n/**\n * Print a thin divider line.\n * Convenience function using `\u2500` character.\n *\n * @example\n * ```ts\n * printThinDivider()\n * // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * ```\n */\nexport function printThinDivider(): void {\n  printDivider({ char: '\u2500' })\n}\n\n/**\n * Print a dotted divider line.\n * Convenience function using `\u00B7` character.\n *\n * @example\n * ```ts\n * printDottedDivider()\n * // \u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\u00B7\n * ```\n */\nexport function printDottedDivider(): void {\n  printDivider({ char: '\u00B7' })\n}\n\n/**\n * Create a section break with blank lines before and after the divider.\n * Useful for creating visual separation between major sections.\n *\n * @param options - Divider formatting options\n * @returns Section break string with newlines\n *\n * @example\n * ```ts\n * console.log('Previous section')\n * console.log(sectionBreak())\n * console.log('Next section')\n * // Output:\n * // Previous section\n * //\n * // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * //\n * // Next section\n * ```\n */\nexport function sectionBreak(options?: DividerOptions): string {\n  const div = divider(options)\n  return `\\n${div}\\n`\n}\n\n/**\n * Print a section break with spacing directly to console.\n *\n * @param options - Divider formatting options\n *\n * @example\n * ```ts\n * console.log('Previous section')\n * printSectionBreak()\n * console.log('Next section')\n * ```\n */\nexport function printSectionBreak(options?: DividerOptions): void {\n  console.log(sectionBreak(options))\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,aAAAC,EAAA,iBAAAC,EAAA,uBAAAC,EAAA,sBAAAC,EAAA,sBAAAC,EAAA,qBAAAC,EAAA,iBAAAC,IAAA,eAAAC,EAAAV,GAKA,IAAAW,EAA6B,sBAkCtB,SAAST,EAAQU,EAAkC,CACxD,MAAMC,EAAO,CAAE,UAAW,KAAM,GAAGD,CAAQ,EACrC,CAAE,KAAAE,EAAO,SAAK,MAAAC,EAAQ,EAAG,EAAIF,EACnC,SAAO,gBAAaC,EAAMC,CAAK,CACjC,CAaO,SAASX,EAAaQ,EAAgC,CAC3D,QAAQ,IAAIV,EAAQU,CAAO,CAAC,CAC9B,CAaO,MAAMT,EAAW,CAEtB,MAAO,IAAMD,EAAQ,CAAE,KAAM,QAAI,CAAC,EAElC,KAAM,IAAMA,EAAQ,CAAE,KAAM,QAAI,CAAC,EAEjC,OAAQ,IAAMA,EAAQ,CAAE,KAAM,QAAI,CAAC,EAEnC,OAAQ,IAAMA,EAAQ,CAAE,KAAM,GAAI,CAAC,EAEnC,OAAQ,IAAMA,EAAQ,CAAE,KAAM,MAAI,CAAC,EAEnC,OAAQ,IAAMA,EAAQ,CAAE,KAAM,QAAI,CAAC,EAEnC,KAAM,IAAMA,EAAQ,CAAE,KAAM,GAAI,CAAC,EAEjC,KAAM,IAAMA,EAAQ,CAAE,KAAM,GAAI,CAAC,EAEjC,QAAS,IAAMA,EAAQ,CAAE,KAAM,QAAI,CAAC,EAEpC,MAAO,IAAMA,EAAQ,CAAE,KAAM,QAAI,CAAC,CACpC,EAYO,SAASK,GAA0B,CACxCH,EAAa,CAAE,KAAM,QAAI,CAAC,CAC5B,CAYO,SAASI,GAAyB,CACvCJ,EAAa,CAAE,KAAM,QAAI,CAAC,CAC5B,CAYO,SAASC,GAA2B,CACzCD,EAAa,CAAE,KAAM,MAAI,CAAC,CAC5B,CAsBO,SAASK,EAAaG,EAAkC,CAE7D,MAAO;AAAA,EADKV,EAAQU,CAAO,CACZ;AAAA,CACjB,CAcO,SAASN,EAAkBM,EAAgC,CAChE,QAAQ,IAAIH,EAAaG,CAAO,CAAC,CACnC",
-  "names": ["divider_exports", "__export", "divider", "dividers", "printDivider", "printDottedDivider", "printSectionBreak", "printThickDivider", "printThinDivider", "sectionBreak", "__toCommonJS", "import_strings", "options", "opts", "char", "width"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA6B;AAkCtB,SAAS,QAAQ,SAAkC;AACxD,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,EAAE,OAAO,UAAK,QAAQ,GAAG,IAAI;AACnC,aAAO,6BAAa,MAAM,KAAK;AACjC;AAaO,SAAS,aAAa,SAAgC;AAC3D,UAAQ,IAAI,QAAQ,OAAO,CAAC;AAC9B;AAaO,MAAM,WAAW;AAAA;AAAA,EAEtB,OAAO,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA;AAAA,EAElC,MAAM,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA;AAAA,EAEjC,QAAQ,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA;AAAA,EAEnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA;AAAA,EAEnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,OAAI,CAAC;AAAA;AAAA,EAEnC,QAAQ,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA;AAAA,EAEnC,MAAM,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA;AAAA,EAEjC,MAAM,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA;AAAA,EAEjC,SAAS,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AAAA;AAAA,EAEpC,OAAO,MAAM,QAAQ,EAAE,MAAM,SAAI,CAAC;AACpC;AAYO,SAAS,oBAA0B;AACxC,eAAa,EAAE,MAAM,SAAI,CAAC;AAC5B;AAYO,SAAS,mBAAyB;AACvC,eAAa,EAAE,MAAM,SAAI,CAAC;AAC5B;AAYO,SAAS,qBAA2B;AACzC,eAAa,EAAE,MAAM,OAAI,CAAC;AAC5B;AAsBO,SAAS,aAAa,SAAkC;AAC7D,QAAM,MAAM,QAAQ,OAAO;AAC3B,SAAO;AAAA,EAAK,GAAG;AAAA;AACjB;AAcO,SAAS,kBAAkB,SAAgC;AAChE,UAAQ,IAAI,aAAa,OAAO,CAAC;AACnC;",
+  "names": []
 }

package/dist/stdio/footer.js

@@ -1,4 +1,96 @@
 /* Socket Lib - Built with esbuild */
-var w=Object.create;var f=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var F=Object.getPrototypeOf,S=Object.prototype.hasOwnProperty;var $=(e,r)=>{for(var n in r)f(e,n,{get:r[n],enumerable:!0})},p=(e,r,n,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let d of y(r))!S.call(e,d)&&d!==n&&f(e,d,{get:()=>r[d],enumerable:!(o=b(r,d))||o.enumerable});return e};var D=(e,r,n)=>(n=e!=null?w(F(e)):{},p(r||!e||!e.__esModule?f(n,"default",{value:e,enumerable:!0}):n,e)),T=e=>p(f({},"__esModule",{value:!0}),e);var x={};$(x,{createFooter:()=>l,createSummaryFooter:()=>k});module.exports=T(x);var i=D(require("../external/yoctocolors-cjs")),m=require("../strings");function l(e,r){const{borderChar:n="=",color:o="gray",showDuration:d=!1,showTimestamp:c=!1,startTime:a,width:g=80}={__proto__:null,...r},h=(0,m.repeatString)(n,g),u=[];if(e){const t=o&&i.default[o]?i.default[o]:s=>s;u.push(t(e))}if(c){const t=new Date().toISOString();u.push(i.default.gray(`Completed at: ${t}`))}if(d&&a){const s=((Date.now()-a)/1e3).toFixed(2);u.push(i.default.gray(`Duration: ${s}s`))}return u.push(h),u.join(`
-`)}function k(e,r){const n=[];e.total!==void 0&&n.push(`Total: ${e.total}`),e.success!==void 0&&n.push(i.default.green(`\u2713 ${e.success} passed`)),e.failed!==void 0&&e.failed>0&&n.push(i.default.red(`\u2717 ${e.failed} failed`)),e.skipped!==void 0&&e.skipped>0&&n.push(i.default.yellow(`\u25CB ${e.skipped} skipped`)),e.warnings!==void 0&&e.warnings>0&&n.push(i.default.yellow(`\u26A0 ${e.warnings} warnings`)),e.errors!==void 0&&e.errors>0&&n.push(i.default.red(`\u2717 ${e.errors} errors`));const o=n.join(" | ");return l(o,{...r,showDuration:e.duration!==void 0,...e.duration!==void 0&&{startTime:e.duration}})}0&&(module.exports={createFooter,createSummaryFooter});
+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 footer_exports = {};
+__export(footer_exports, {
+  createFooter: () => createFooter,
+  createSummaryFooter: () => createSummaryFooter
+});
+module.exports = __toCommonJS(footer_exports);
+var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
+var import_strings = require("../strings");
+function createFooter(message, options) {
+  const {
+    borderChar = "=",
+    color = "gray",
+    showDuration = false,
+    showTimestamp = false,
+    startTime,
+    width = 80
+  } = { __proto__: null, ...options };
+  const border = (0, import_strings.repeatString)(borderChar, width);
+  const lines = [];
+  if (message) {
+    const colorFn = color && import_yoctocolors_cjs.default[color] ? import_yoctocolors_cjs.default[color] : (s) => s;
+    lines.push(colorFn(message));
+  }
+  if (showTimestamp) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    lines.push(import_yoctocolors_cjs.default.gray(`Completed at: ${timestamp}`));
+  }
+  if (showDuration && startTime) {
+    const duration = Date.now() - startTime;
+    const seconds = (duration / 1e3).toFixed(2);
+    lines.push(import_yoctocolors_cjs.default.gray(`Duration: ${seconds}s`));
+  }
+  lines.push(border);
+  return lines.join("\n");
+}
+function createSummaryFooter(stats, options) {
+  const parts = [];
+  if (stats.total !== void 0) {
+    parts.push(`Total: ${stats.total}`);
+  }
+  if (stats.success !== void 0) {
+    parts.push(import_yoctocolors_cjs.default.green(`\u2713 ${stats.success} passed`));
+  }
+  if (stats.failed !== void 0 && stats.failed > 0) {
+    parts.push(import_yoctocolors_cjs.default.red(`\u2717 ${stats.failed} failed`));
+  }
+  if (stats.skipped !== void 0 && stats.skipped > 0) {
+    parts.push(import_yoctocolors_cjs.default.yellow(`\u25CB ${stats.skipped} skipped`));
+  }
+  if (stats.warnings !== void 0 && stats.warnings > 0) {
+    parts.push(import_yoctocolors_cjs.default.yellow(`\u26A0 ${stats.warnings} warnings`));
+  }
+  if (stats.errors !== void 0 && stats.errors > 0) {
+    parts.push(import_yoctocolors_cjs.default.red(`\u2717 ${stats.errors} errors`));
+  }
+  const message = parts.join(" | ");
+  return createFooter(message, {
+    ...options,
+    showDuration: stats.duration !== void 0,
+    ...stats.duration !== void 0 && { startTime: stats.duration }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFooter,
+  createSummaryFooter
+});
 //# sourceMappingURL=footer.js.map

package/dist/stdio/footer.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/footer.ts"],
   "sourcesContent": ["/**\n * @fileoverview Console footer/summary formatting utilities.\n * Provides consistent footer and summary formatting for CLI applications.\n */\n\nimport colors from '../external/yoctocolors-cjs'\nimport { repeatString } from '../strings'\n\nexport interface FooterOptions {\n  /**\n   * Width of the footer border in characters.\n   * @default 80\n   */\n  width?: number | undefined\n  /**\n   * Character to use for the border line.\n   * @default '='\n   */\n  borderChar?: string | undefined\n  /**\n   * Include ISO timestamp in footer.\n   * @default false\n   */\n  showTimestamp?: boolean | undefined\n  /**\n   * Show duration since start time.\n   * @default false\n   */\n  showDuration?: boolean | undefined\n  /**\n   * Start time in milliseconds (from Date.now()).\n   * Required when `showDuration` is true.\n   */\n  startTime?: number | undefined\n  /**\n   * Color to apply to the footer message.\n   * @default 'gray'\n   */\n  color?:\n    | 'cyan'\n    | 'green'\n    | 'yellow'\n    | 'blue'\n    | 'magenta'\n    | 'red'\n    | 'gray'\n    | undefined\n}\n\nexport interface SummaryStats {\n  /** Total number of items processed */\n  total?: number | undefined\n  /** Number of successful items */\n  success?: number | undefined\n  /** Number of failed items */\n  failed?: number | undefined\n  /** Number of skipped items */\n  skipped?: number | undefined\n  /** Number of warnings */\n  warnings?: number | undefined\n  /** Number of errors */\n  errors?: number | undefined\n  /** Duration in milliseconds (timestamp value, not elapsed time) */\n  duration?: number | undefined\n}\n\n/**\n * Create a formatted footer with optional message, timestamp, and duration.\n * Useful for marking the end of CLI output or showing completion status.\n *\n * @param message - Optional message to display in footer\n * @param options - Footer formatting options\n * @returns Formatted footer string with border and optional info\n *\n * @example\n * ```ts\n * const startTime = Date.now()\n * // ... do work\n * console.log(createFooter('Build complete', {\n *   width: 60,\n *   color: 'green',\n *   showDuration: true,\n *   startTime\n * }))\n * ```\n */\nexport function createFooter(\n  message?: string | undefined,\n  options?: FooterOptions,\n): string {\n  const {\n    borderChar = '=',\n    color = 'gray',\n    showDuration = false,\n    showTimestamp = false,\n    startTime,\n    width = 80,\n  } = { __proto__: null, ...options } as FooterOptions\n\n  const border = repeatString(borderChar, width)\n  const lines: string[] = []\n\n  if (message) {\n    const colorFn = color && colors[color] ? colors[color] : (s: string) => s\n    lines.push(colorFn(message))\n  }\n\n  if (showTimestamp) {\n    const timestamp = new Date().toISOString()\n    lines.push(colors.gray(`Completed at: ${timestamp}`))\n  }\n\n  if (showDuration && startTime) {\n    const duration = Date.now() - startTime\n    const seconds = (duration / 1000).toFixed(2)\n    lines.push(colors.gray(`Duration: ${seconds}s`))\n  }\n\n  lines.push(border)\n  return lines.join('\\n')\n}\n\n/**\n * Create a summary footer with statistics and colored status indicators.\n * Automatically formats success/failure/warning counts with appropriate colors.\n * Useful for test results, build summaries, or batch operation reports.\n *\n * @param stats - Statistics to display in the summary\n * @param options - Footer formatting options\n * @returns Formatted summary footer string with colored indicators\n *\n * @example\n * ```ts\n * console.log(createSummaryFooter({\n *   total: 150,\n *   success: 145,\n *   failed: 3,\n *   skipped: 2,\n *   warnings: 5\n * }))\n * // Output: Total: 150 | \u2713 145 passed | \u2717 3 failed | \u25CB 2 skipped | \u26A0 5 warnings\n * // ========================================\n * ```\n */\nexport function createSummaryFooter(\n  stats: SummaryStats,\n  options?: FooterOptions,\n): string {\n  const parts: string[] = []\n\n  if (stats.total !== undefined) {\n    parts.push(`Total: ${stats.total}`)\n  }\n\n  if (stats.success !== undefined) {\n    parts.push(colors.green(`\u2713 ${stats.success} passed`))\n  }\n\n  if (stats.failed !== undefined && stats.failed > 0) {\n    parts.push(colors.red(`\u2717 ${stats.failed} failed`))\n  }\n\n  if (stats.skipped !== undefined && stats.skipped > 0) {\n    parts.push(colors.yellow(`\u25CB ${stats.skipped} skipped`))\n  }\n\n  if (stats.warnings !== undefined && stats.warnings > 0) {\n    parts.push(colors.yellow(`\u26A0 ${stats.warnings} warnings`))\n  }\n\n  if (stats.errors !== undefined && stats.errors > 0) {\n    parts.push(colors.red(`\u2717 ${stats.errors} errors`))\n  }\n\n  const message = parts.join(' | ')\n  return createFooter(message, {\n    ...options,\n    showDuration: stats.duration !== undefined,\n    ...(stats.duration !== undefined && { startTime: stats.duration }),\n  })\n}\n"],
-  "mappings": ";6iBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,wBAAAC,IAAA,eAAAC,EAAAJ,GAKA,IAAAK,EAAmB,0CACnBC,EAA6B,sBAgFtB,SAASJ,EACdK,EACAC,EACQ,CACR,KAAM,CACJ,WAAAC,EAAa,IACb,MAAAC,EAAQ,OACR,aAAAC,EAAe,GACf,cAAAC,EAAgB,GAChB,UAAAC,EACA,MAAAC,EAAQ,EACV,EAAI,CAAE,UAAW,KAAM,GAAGN,CAAQ,EAE5BO,KAAS,gBAAaN,EAAYK,CAAK,EACvCE,EAAkB,CAAC,EAEzB,GAAIT,EAAS,CACX,MAAMU,EAAUP,GAAS,EAAAQ,QAAOR,CAAK,EAAI,EAAAQ,QAAOR,CAAK,EAAK,GAAc,EACxEM,EAAM,KAAKC,EAAQV,CAAO,CAAC,CAC7B,CAEA,GAAIK,EAAe,CACjB,MAAMO,EAAY,IAAI,KAAK,EAAE,YAAY,EACzCH,EAAM,KAAK,EAAAE,QAAO,KAAK,iBAAiBC,CAAS,EAAE,CAAC,CACtD,CAEA,GAAIR,GAAgBE,EAAW,CAE7B,MAAMO,IADW,KAAK,IAAI,EAAIP,GACF,KAAM,QAAQ,CAAC,EAC3CG,EAAM,KAAK,EAAAE,QAAO,KAAK,aAAaE,CAAO,GAAG,CAAC,CACjD,CAEA,OAAAJ,EAAM,KAAKD,CAAM,EACVC,EAAM,KAAK;AAAA,CAAI,CACxB,CAwBO,SAASb,EACdkB,EACAb,EACQ,CACR,MAAMc,EAAkB,CAAC,EAErBD,EAAM,QAAU,QAClBC,EAAM,KAAK,UAAUD,EAAM,KAAK,EAAE,EAGhCA,EAAM,UAAY,QACpBC,EAAM,KAAK,EAAAJ,QAAO,MAAM,UAAKG,EAAM,OAAO,SAAS,CAAC,EAGlDA,EAAM,SAAW,QAAaA,EAAM,OAAS,GAC/CC,EAAM,KAAK,EAAAJ,QAAO,IAAI,UAAKG,EAAM,MAAM,SAAS,CAAC,EAG/CA,EAAM,UAAY,QAAaA,EAAM,QAAU,GACjDC,EAAM,KAAK,EAAAJ,QAAO,OAAO,UAAKG,EAAM,OAAO,UAAU,CAAC,EAGpDA,EAAM,WAAa,QAAaA,EAAM,SAAW,GACnDC,EAAM,KAAK,EAAAJ,QAAO,OAAO,UAAKG,EAAM,QAAQ,WAAW,CAAC,EAGtDA,EAAM,SAAW,QAAaA,EAAM,OAAS,GAC/CC,EAAM,KAAK,EAAAJ,QAAO,IAAI,UAAKG,EAAM,MAAM,SAAS,CAAC,EAGnD,MAAMd,EAAUe,EAAM,KAAK,KAAK,EAChC,OAAOpB,EAAaK,EAAS,CAC3B,GAAGC,EACH,aAAca,EAAM,WAAa,OACjC,GAAIA,EAAM,WAAa,QAAa,CAAE,UAAWA,EAAM,QAAS,CAClE,CAAC,CACH",
-  "names": ["footer_exports", "__export", "createFooter", "createSummaryFooter", "__toCommonJS", "import_yoctocolors_cjs", "import_strings", "message", "options", "borderChar", "color", "showDuration", "showTimestamp", "startTime", "width", "border", "lines", "colorFn", "colors", "timestamp", "seconds", "stats", "parts"]
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,6BAAmB;AACnB,qBAA6B;AAgFtB,SAAS,aACd,SACA,SACQ;AACR,QAAM;AAAA,IACJ,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,eAAe;AAAA,IACf,gBAAgB;AAAA,IAChB;AAAA,IACA,QAAQ;AAAA,EACV,IAAI,EAAE,WAAW,MAAM,GAAG,QAAQ;AAElC,QAAM,aAAS,6BAAa,YAAY,KAAK;AAC7C,QAAM,QAAkB,CAAC;AAEzB,MAAI,SAAS;AACX,UAAM,UAAU,SAAS,uBAAAA,QAAO,KAAK,IAAI,uBAAAA,QAAO,KAAK,IAAI,CAAC,MAAc;AACxE,UAAM,KAAK,QAAQ,OAAO,CAAC;AAAA,EAC7B;AAEA,MAAI,eAAe;AACjB,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,UAAM,KAAK,uBAAAA,QAAO,KAAK,iBAAiB,SAAS,EAAE,CAAC;AAAA,EACtD;AAEA,MAAI,gBAAgB,WAAW;AAC7B,UAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,UAAM,WAAW,WAAW,KAAM,QAAQ,CAAC;AAC3C,UAAM,KAAK,uBAAAA,QAAO,KAAK,aAAa,OAAO,GAAG,CAAC;AAAA,EACjD;AAEA,QAAM,KAAK,MAAM;AACjB,SAAO,MAAM,KAAK,IAAI;AACxB;AAwBO,SAAS,oBACd,OACA,SACQ;AACR,QAAM,QAAkB,CAAC;AAEzB,MAAI,MAAM,UAAU,QAAW;AAC7B,UAAM,KAAK,UAAU,MAAM,KAAK,EAAE;AAAA,EACpC;AAEA,MAAI,MAAM,YAAY,QAAW;AAC/B,UAAM,KAAK,uBAAAA,QAAO,MAAM,UAAK,MAAM,OAAO,SAAS,CAAC;AAAA,EACtD;AAEA,MAAI,MAAM,WAAW,UAAa,MAAM,SAAS,GAAG;AAClD,UAAM,KAAK,uBAAAA,QAAO,IAAI,UAAK,MAAM,MAAM,SAAS,CAAC;AAAA,EACnD;AAEA,MAAI,MAAM,YAAY,UAAa,MAAM,UAAU,GAAG;AACpD,UAAM,KAAK,uBAAAA,QAAO,OAAO,UAAK,MAAM,OAAO,UAAU,CAAC;AAAA,EACxD;AAEA,MAAI,MAAM,aAAa,UAAa,MAAM,WAAW,GAAG;AACtD,UAAM,KAAK,uBAAAA,QAAO,OAAO,UAAK,MAAM,QAAQ,WAAW,CAAC;AAAA,EAC1D;AAEA,MAAI,MAAM,WAAW,UAAa,MAAM,SAAS,GAAG;AAClD,UAAM,KAAK,uBAAAA,QAAO,IAAI,UAAK,MAAM,MAAM,SAAS,CAAC;AAAA,EACnD;AAEA,QAAM,UAAU,MAAM,KAAK,KAAK;AAChC,SAAO,aAAa,SAAS;AAAA,IAC3B,GAAG;AAAA,IACH,cAAc,MAAM,aAAa;AAAA,IACjC,GAAI,MAAM,aAAa,UAAa,EAAE,WAAW,MAAM,SAAS;AAAA,EAClE,CAAC;AACH;",
+  "names": ["colors"]
 }

package/dist/stdio/header.js

@@ -1,4 +1,102 @@
 /* Socket Lib - Built with esbuild */
-var _=Object.create;var a=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var O=Object.getPrototypeOf,w=Object.prototype.hasOwnProperty;var y=(e,o)=>{for(var n in o)a(e,n,{get:o[n],enumerable:!0})},b=(e,o,n,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of x(o))!w.call(e,r)&&r!==n&&a(e,r,{get:()=>o[r],enumerable:!(i=m(o,r))||i.enumerable});return e};var C=(e,o,n)=>(n=e!=null?_(O(e)):{},b(o||!e||!e.__esModule?a(n,"default",{value:e,enumerable:!0}):n,e)),T=e=>b(a({},"__esModule",{value:!0}),e);var F={};y(F,{createHeader:()=>h,createSectionHeader:()=>v,printFooter:()=>j,printHeader:()=>S});module.exports=T(F);var d=C(require("../external/yoctocolors-cjs")),t=require("../strings");function h(e,o){const{bold:n=!0,borderChar:i="=",color:r="cyan",padding:u=1,width:p=80}={__proto__:null,...o},g=(0,t.repeatString)(i,p);let l=e;r&&d.default[r]&&(l=d.default[r](l)),n&&d.default.bold&&(l=d.default.bold(l));const H=(0,t.centerText)(l,p),f=(0,t.repeatString)(" ",p),s=[g];for(let c=0;c<u;c++)s.push(f);s.push(H);for(let c=0;c<u;c++)s.push(f);return s.push(g),s.join(`
-`)}function v(e,o){const{borderChar:n="-",color:i="blue",width:r=60}={__proto__:null,...o};return h(e,{width:r,borderChar:n,padding:0,color:i,bold:!1})}function S(e){const o=(0,t.repeatString)("\u2550",55);console.log(o),console.log(`  ${e}`),console.log(o)}function j(e){const o=(0,t.repeatString)("\u2500",55);console.log(o),e&&console.log(d.default.green(e))}0&&(module.exports={createHeader,createSectionHeader,printFooter,printHeader});
+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 header_exports = {};
+__export(header_exports, {
+  createHeader: () => createHeader,
+  createSectionHeader: () => createSectionHeader,
+  printFooter: () => printFooter,
+  printHeader: () => printHeader
+});
+module.exports = __toCommonJS(header_exports);
+var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
+var import_strings = require("../strings");
+function createHeader(title, options) {
+  const {
+    bold = true,
+    borderChar = "=",
+    color = "cyan",
+    padding = 1,
+    width = 80
+  } = { __proto__: null, ...options };
+  const border = (0, import_strings.repeatString)(borderChar, width);
+  let formattedTitle = title;
+  if (color && import_yoctocolors_cjs.default[color]) {
+    formattedTitle = import_yoctocolors_cjs.default[color](formattedTitle);
+  }
+  if (bold && import_yoctocolors_cjs.default.bold) {
+    formattedTitle = import_yoctocolors_cjs.default.bold(formattedTitle);
+  }
+  const centeredTitle = (0, import_strings.centerText)(formattedTitle, width);
+  const paddingLine = (0, import_strings.repeatString)(" ", width);
+  const lines = [border];
+  for (let i = 0; i < padding; i++) {
+    lines.push(paddingLine);
+  }
+  lines.push(centeredTitle);
+  for (let i = 0; i < padding; i++) {
+    lines.push(paddingLine);
+  }
+  lines.push(border);
+  return lines.join("\n");
+}
+function createSectionHeader(title, options) {
+  const {
+    borderChar = "-",
+    color = "blue",
+    width = 60
+  } = { __proto__: null, ...options };
+  return createHeader(title, {
+    width,
+    borderChar,
+    padding: 0,
+    color,
+    bold: false
+  });
+}
+function printHeader(title) {
+  const border = (0, import_strings.repeatString)("\u2550", 55);
+  console.log(border);
+  console.log(`  ${title}`);
+  console.log(border);
+}
+function printFooter(message) {
+  const border = (0, import_strings.repeatString)("\u2500", 55);
+  console.log(border);
+  if (message) {
+    console.log(import_yoctocolors_cjs.default.green(message));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createHeader,
+  createSectionHeader,
+  printFooter,
+  printHeader
+});
 //# sourceMappingURL=header.js.map

package/dist/stdio/header.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/stdio/header.ts"],
   "sourcesContent": ["/**\n * @fileoverview Console header/banner formatting utilities.\n * Provides consistent header formatting for CLI applications.\n */\n\nimport colors from '../external/yoctocolors-cjs'\nimport { centerText, repeatString } from '../strings'\n\nexport interface HeaderOptions {\n  /**\n   * Width of the header in characters.\n   * @default 80\n   */\n  width?: number | undefined\n  /**\n   * Character to use for border lines.\n   * @default '='\n   */\n  borderChar?: string | undefined\n  /**\n   * Number of blank lines above and below title.\n   * @default 1\n   */\n  padding?: number | undefined\n  /**\n   * Color to apply to the title text.\n   * @default 'cyan'\n   */\n  color?:\n    | 'cyan'\n    | 'green'\n    | 'yellow'\n    | 'blue'\n    | 'magenta'\n    | 'red'\n    | 'gray'\n    | undefined\n  /**\n   * Apply bold styling to title.\n   * @default true\n   */\n  bold?: boolean | undefined\n}\n\n/**\n * Create a formatted header/banner with borders and centered title.\n * Useful for marking the start of CLI output or creating visual sections.\n *\n * @param title - Title text to display in header\n * @param options - Header formatting options\n * @returns Formatted header string with borders and centered title\n *\n * @example\n * ```ts\n * console.log(createHeader('Socket Security Analysis', {\n *   width: 70,\n *   color: 'cyan',\n *   bold: true,\n *   padding: 2\n * }))\n * // Output:\n * // ======================================================================\n * //\n * //                    Socket Security Analysis\n * //\n * // ======================================================================\n * ```\n */\nexport function createHeader(title: string, options?: HeaderOptions): string {\n  const {\n    bold = true,\n    borderChar = '=',\n    color = 'cyan',\n    padding = 1,\n    width = 80,\n  } = { __proto__: null, ...options } as HeaderOptions\n\n  const border = repeatString(borderChar, width)\n\n  // Apply color and bold\n  let formattedTitle = title\n  if (color && colors[color]) {\n    formattedTitle = colors[color](formattedTitle)\n  }\n  if (bold && colors.bold) {\n    formattedTitle = colors.bold(formattedTitle)\n  }\n\n  const centeredTitle = centerText(formattedTitle, width)\n  const paddingLine = repeatString(' ', width)\n\n  const lines: string[] = [border]\n\n  for (let i = 0; i < padding; i++) {\n    lines.push(paddingLine)\n  }\n\n  lines.push(centeredTitle)\n\n  for (let i = 0; i < padding; i++) {\n    lines.push(paddingLine)\n  }\n\n  lines.push(border)\n\n  return lines.join('\\n')\n}\n\n/**\n * Create a simple section header without padding.\n * A lighter-weight alternative to `createHeader()` for subsections.\n *\n * @param title - Title text to display in header\n * @param options - Header formatting options\n * @returns Formatted section header string\n *\n * @example\n * ```ts\n * console.log(createSectionHeader('Dependencies', {\n *   width: 50,\n *   color: 'blue'\n * }))\n * // Output:\n * // --------------------------------------------------\n * //                   Dependencies\n * // --------------------------------------------------\n * ```\n */\nexport function createSectionHeader(\n  title: string,\n  options?: HeaderOptions,\n): string {\n  const {\n    borderChar = '-',\n    color = 'blue',\n    width = 60,\n  } = { __proto__: null, ...options } as HeaderOptions\n\n  return createHeader(title, {\n    width,\n    borderChar,\n    padding: 0,\n    color,\n    bold: false,\n  })\n}\n\n/**\n * Print a header directly to stdout with standard formatting.\n * Uses fixed width of 55 characters with `\u2550` borders.\n * Simpler alternative to `createHeader()` for quick headers.\n *\n * @param title - Title text to display\n *\n * @example\n * ```ts\n * printHeader('Package Analysis')\n * // Output:\n * // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * //   Package Analysis\n * // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * ```\n */\nexport function printHeader(title: string): void {\n  const border = repeatString('\u2550', 55)\n  console.log(border)\n  console.log(`  ${title}`)\n  console.log(border)\n}\n\n/**\n * Print a footer with optional success message.\n * Uses `\u2500` border character for a lighter appearance.\n * Fixed width of 55 characters to match `printHeader()`.\n *\n * @param message - Optional message to display (shown in green)\n *\n * @example\n * ```ts\n * printFooter('Analysis complete')\n * // Output:\n * // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * // Analysis complete (in green)\n * ```\n */\nexport function printFooter(message?: string | undefined): void {\n  const border = repeatString('\u2500', 55)\n  console.log(border)\n  if (message) {\n    console.log(colors.green(message))\n  }\n}\n"],
-  "mappings": ";6iBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,wBAAAC,EAAA,gBAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAN,GAKA,IAAAO,EAAmB,0CACnBC,EAAyC,sBA8DlC,SAASN,EAAaO,EAAeC,EAAiC,CAC3E,KAAM,CACJ,KAAAC,EAAO,GACP,WAAAC,EAAa,IACb,MAAAC,EAAQ,OACR,QAAAC,EAAU,EACV,MAAAC,EAAQ,EACV,EAAI,CAAE,UAAW,KAAM,GAAGL,CAAQ,EAE5BM,KAAS,gBAAaJ,EAAYG,CAAK,EAG7C,IAAIE,EAAiBR,EACjBI,GAAS,EAAAK,QAAOL,CAAK,IACvBI,EAAiB,EAAAC,QAAOL,CAAK,EAAEI,CAAc,GAE3CN,GAAQ,EAAAO,QAAO,OACjBD,EAAiB,EAAAC,QAAO,KAAKD,CAAc,GAG7C,MAAME,KAAgB,cAAWF,EAAgBF,CAAK,EAChDK,KAAc,gBAAa,IAAKL,CAAK,EAErCM,EAAkB,CAACL,CAAM,EAE/B,QAASM,EAAI,EAAGA,EAAIR,EAASQ,IAC3BD,EAAM,KAAKD,CAAW,EAGxBC,EAAM,KAAKF,CAAa,EAExB,QAASG,EAAI,EAAGA,EAAIR,EAASQ,IAC3BD,EAAM,KAAKD,CAAW,EAGxB,OAAAC,EAAM,KAAKL,CAAM,EAEVK,EAAM,KAAK;AAAA,CAAI,CACxB,CAsBO,SAASlB,EACdM,EACAC,EACQ,CACR,KAAM,CACJ,WAAAE,EAAa,IACb,MAAAC,EAAQ,OACR,MAAAE,EAAQ,EACV,EAAI,CAAE,UAAW,KAAM,GAAGL,CAAQ,EAElC,OAAOR,EAAaO,EAAO,CACzB,MAAAM,EACA,WAAAH,EACA,QAAS,EACT,MAAAC,EACA,KAAM,EACR,CAAC,CACH,CAkBO,SAASR,EAAYI,EAAqB,CAC/C,MAAMO,KAAS,gBAAa,SAAK,EAAE,EACnC,QAAQ,IAAIA,CAAM,EAClB,QAAQ,IAAI,KAAKP,CAAK,EAAE,EACxB,QAAQ,IAAIO,CAAM,CACpB,CAiBO,SAASZ,EAAYmB,EAAoC,CAC9D,MAAMP,KAAS,gBAAa,SAAK,EAAE,EACnC,QAAQ,IAAIA,CAAM,EACdO,GACF,QAAQ,IAAI,EAAAL,QAAO,MAAMK,CAAO,CAAC,CAErC",
-  "names": ["header_exports", "__export", "createHeader", "createSectionHeader", "printFooter", "printHeader", "__toCommonJS", "import_yoctocolors_cjs", "import_strings", "title", "options", "bold", "borderChar", "color", "padding", "width", "border", "formattedTitle", "colors", "centeredTitle", "paddingLine", "lines", "i", "message"]
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,6BAAmB;AACnB,qBAAyC;AA8DlC,SAAS,aAAa,OAAe,SAAiC;AAC3E,QAAM;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,QAAQ;AAAA,EACV,IAAI,EAAE,WAAW,MAAM,GAAG,QAAQ;AAElC,QAAM,aAAS,6BAAa,YAAY,KAAK;AAG7C,MAAI,iBAAiB;AACrB,MAAI,SAAS,uBAAAA,QAAO,KAAK,GAAG;AAC1B,qBAAiB,uBAAAA,QAAO,KAAK,EAAE,cAAc;AAAA,EAC/C;AACA,MAAI,QAAQ,uBAAAA,QAAO,MAAM;AACvB,qBAAiB,uBAAAA,QAAO,KAAK,cAAc;AAAA,EAC7C;AAEA,QAAM,oBAAgB,2BAAW,gBAAgB,KAAK;AACtD,QAAM,kBAAc,6BAAa,KAAK,KAAK;AAE3C,QAAM,QAAkB,CAAC,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,SAAS,KAAK;AAChC,UAAM,KAAK,WAAW;AAAA,EACxB;AAEA,QAAM,KAAK,aAAa;AAExB,WAAS,IAAI,GAAG,IAAI,SAAS,KAAK;AAChC,UAAM,KAAK,WAAW;AAAA,EACxB;AAEA,QAAM,KAAK,MAAM;AAEjB,SAAO,MAAM,KAAK,IAAI;AACxB;AAsBO,SAAS,oBACd,OACA,SACQ;AACR,QAAM;AAAA,IACJ,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,IAAI,EAAE,WAAW,MAAM,GAAG,QAAQ;AAElC,SAAO,aAAa,OAAO;AAAA,IACzB;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA,MAAM;AAAA,EACR,CAAC;AACH;AAkBO,SAAS,YAAY,OAAqB;AAC/C,QAAM,aAAS,6BAAa,UAAK,EAAE;AACnC,UAAQ,IAAI,MAAM;AAClB,UAAQ,IAAI,KAAK,KAAK,EAAE;AACxB,UAAQ,IAAI,MAAM;AACpB;AAiBO,SAAS,YAAY,SAAoC;AAC9D,QAAM,aAAS,6BAAa,UAAK,EAAE;AACnC,UAAQ,IAAI,MAAM;AAClB,MAAI,SAAS;AACX,YAAQ,IAAI,uBAAAA,QAAO,MAAM,OAAO,CAAC;AAAA,EACnC;AACF;",
+  "names": ["colors"]
 }

package/dist/stdio/mask.js

@@ -1,7 +1,209 @@
 /* Socket Lib - Built with esbuild */
-var S=Object.create;var d=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,C=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var i in t)d(e,i,{get:t[i],enumerable:!0})},c=(e,t,i,p)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of M(t))!C.call(e,o)&&o!==i&&d(e,o,{get:()=>t[o],enumerable:!(p=v(t,o))||p.enumerable});return e};var B=(e,t,i)=>(i=e!=null?S(T(e)):{},c(t||!e||!e.__esModule?d(i,"default",{value:e,enumerable:!0}):i,e)),E=e=>c(d({},"__esModule",{value:!0}),e);var P={};h(P,{attachOutputMask:()=>x,createKeyboardHandler:()=>w,createOutputMask:()=>b,runWithMask:()=>R});module.exports=E(P);var g=require("child_process"),O=B(require("readline")),f=require("../spinner.js"),l=require("./clear.js"),a=require("./stdout.js");function b(e={}){const{showOutput:t=!1}=e;return{isSpinning:!t,outputBuffer:[],stderrCapture:"",stdoutCapture:"",verbose:t}}function w(e,t,i={}){const{message:p="Running\u2026",toggleText:o="to see full output"}=i;return(s,n)=>{if(n?.ctrl&&n.name==="o")if(e.verbose=!e.verbose,e.verbose)e.isSpinning&&((0,f.getDefaultSpinner)().stop(),e.isSpinning=!1),(0,l.clearLine)(),e.outputBuffer.length>0&&(console.log("--- Output (ctrl+o to hide) ---"),e.outputBuffer.forEach(r=>{(0,a.write)(r)}));else{if(e.outputBuffer.length>0){const r=e.outputBuffer.join("").split(`
-`).length+1;for(let u=0;u<r;u+=1)process.stdout.write("\x1B[1A\x1B[2K")}(0,l.clearLine)(),e.outputBuffer=[],e.isSpinning||((0,f.getDefaultSpinner)().start(`${p} (ctrl+o ${o})`),e.isSpinning=!0)}else if(n?.ctrl&&n.name==="c")throw t.kill("SIGTERM"),process.stdin.isTTY&&process.stdin.setRawMode(!1),new Error("Process cancelled by user")}}function x(e,t={}){return new Promise((i,p)=>{const{message:o="Running\u2026"}=t,s=b(t);if(s.isSpinning&&process.stdout.isTTY&&(0,f.getDefaultSpinner)().start(`${o} (ctrl+o ${t.toggleText||"to see full output"})`),process.stdin.isTTY){O.default.emitKeypressEvents(process.stdin),process.stdin.setRawMode(!0);const n=w(s,e,t);process.stdin.on("keypress",n),e.on("exit",()=>{process.stdin.isTTY&&(process.stdin.setRawMode(!1),process.stdin.removeListener("keypress",n))})}e.stdout&&e.stdout.on("data",n=>{const r=n.toString();if(s.stdoutCapture+=r,!(t.filterOutput&&!t.filterOutput(r,"stdout")))if(s.verbose)(0,a.write)(r);else{s.outputBuffer.push(r);const u=s.outputBuffer.join("").split(`
-`);u.length>1e3&&(s.outputBuffer=[u.slice(-1e3).join(`
-`)])}}),e.stderr&&e.stderr.on("data",n=>{const r=n.toString();s.stderrCapture+=r,!(t.filterOutput&&!t.filterOutput(r,"stderr"))&&(s.verbose?process.stderr.write(r):s.outputBuffer.push(r))}),e.on("exit",n=>{process.stdin.isTTY&&process.stdin.setRawMode(!1);let r=n||0;if(t.overrideExitCode){const u=t.overrideExitCode(r,s.stdoutCapture,s.stderrCapture);u!==void 0&&(r=u)}if(s.isSpinning){const u=(0,f.getDefaultSpinner)();r===0?u.successAndStop(`${o} completed`):(u.failAndStop(`${o} failed`),s.outputBuffer.length>0&&!s.verbose&&(console.log(`
---- Output ---`),s.outputBuffer.forEach(m=>{(0,a.write)(m)})))}i(r)}),e.on("error",n=>{process.stdin.isTTY&&process.stdin.setRawMode(!1),s.isSpinning&&(0,f.getDefaultSpinner)().failAndStop(`${o} error`),p(n)})})}async function R(e,t=[],i={}){const{message:p="Running\u2026",showOutput:o=!1,toggleText:s="to see output",...n}=i,r=(0,g.spawn)(e,t,{stdio:["inherit","pipe","pipe"],...n});return await x(r,{message:p,showOutput:o,toggleText:s})}0&&(module.exports={attachOutputMask,createKeyboardHandler,createOutputMask,runWithMask});
+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 mask_exports = {};
+__export(mask_exports, {
+  attachOutputMask: () => attachOutputMask,
+  createKeyboardHandler: () => createKeyboardHandler,
+  createOutputMask: () => createOutputMask,
+  runWithMask: () => runWithMask
+});
+module.exports = __toCommonJS(mask_exports);
+var import_child_process = require("child_process");
+var import_readline = __toESM(require("readline"));
+var import_spinner = require("../spinner.js");
+var import_clear = require("./clear.js");
+var import_stdout = require("./stdout.js");
+function createOutputMask(options = {}) {
+  const { showOutput = false } = options;
+  return {
+    isSpinning: !showOutput,
+    outputBuffer: [],
+    stderrCapture: "",
+    stdoutCapture: "",
+    verbose: showOutput
+  };
+}
+function createKeyboardHandler(mask, child, options = {}) {
+  const { message = "Running\u2026", toggleText = "to see full output" } = options;
+  return (_str, key) => {
+    if (key?.ctrl && key.name === "o") {
+      mask.verbose = !mask.verbose;
+      if (mask.verbose) {
+        if (mask.isSpinning) {
+          (0, import_spinner.getDefaultSpinner)().stop();
+          mask.isSpinning = false;
+        }
+        (0, import_clear.clearLine)();
+        if (mask.outputBuffer.length > 0) {
+          console.log("--- Output (ctrl+o to hide) ---");
+          mask.outputBuffer.forEach((line) => {
+            (0, import_stdout.write)(line);
+          });
+        }
+      } else {
+        if (mask.outputBuffer.length > 0) {
+          const lineCount = mask.outputBuffer.join("").split("\n").length + 1;
+          for (let i = 0; i < lineCount; i += 1) {
+            process.stdout.write("\x1B[1A\x1B[2K");
+          }
+        }
+        (0, import_clear.clearLine)();
+        mask.outputBuffer = [];
+        if (!mask.isSpinning) {
+          (0, import_spinner.getDefaultSpinner)().start(`${message} (ctrl+o ${toggleText})`);
+          mask.isSpinning = true;
+        }
+      }
+    } else if (key?.ctrl && key.name === "c") {
+      child.kill("SIGTERM");
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      throw new Error("Process cancelled by user");
+    }
+  };
+}
+function attachOutputMask(child, options = {}) {
+  return new Promise((resolve, reject) => {
+    const { message = "Running\u2026" } = options;
+    const mask = createOutputMask(options);
+    if (mask.isSpinning && process.stdout.isTTY) {
+      (0, import_spinner.getDefaultSpinner)().start(
+        `${message} (ctrl+o ${options.toggleText || "to see full output"})`
+      );
+    }
+    if (process.stdin.isTTY) {
+      import_readline.default.emitKeypressEvents(process.stdin);
+      process.stdin.setRawMode(true);
+      const keypressHandler = createKeyboardHandler(mask, child, options);
+      process.stdin.on("keypress", keypressHandler);
+      child.on("exit", () => {
+        if (process.stdin.isTTY) {
+          process.stdin.setRawMode(false);
+          process.stdin.removeListener("keypress", keypressHandler);
+        }
+      });
+    }
+    if (child.stdout) {
+      child.stdout.on("data", (data) => {
+        const text = data.toString();
+        mask.stdoutCapture += text;
+        if (options.filterOutput && !options.filterOutput(text, "stdout")) {
+          return void 0;
+        }
+        if (mask.verbose) {
+          (0, import_stdout.write)(text);
+        } else {
+          mask.outputBuffer.push(text);
+          const lines = mask.outputBuffer.join("").split("\n");
+          if (lines.length > 1e3) {
+            mask.outputBuffer = [lines.slice(-1e3).join("\n")];
+          }
+        }
+        return void 0;
+      });
+    }
+    if (child.stderr) {
+      child.stderr.on("data", (data) => {
+        const text = data.toString();
+        mask.stderrCapture += text;
+        if (options.filterOutput && !options.filterOutput(text, "stderr")) {
+          return void 0;
+        }
+        if (mask.verbose) {
+          process.stderr.write(text);
+        } else {
+          mask.outputBuffer.push(text);
+        }
+        return void 0;
+      });
+    }
+    child.on("exit", (code) => {
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      let finalCode = code || 0;
+      if (options.overrideExitCode) {
+        const overridden = options.overrideExitCode(
+          finalCode,
+          mask.stdoutCapture,
+          mask.stderrCapture
+        );
+        if (overridden !== void 0) {
+          finalCode = overridden;
+        }
+      }
+      if (mask.isSpinning) {
+        const spinner = (0, import_spinner.getDefaultSpinner)();
+        if (finalCode === 0) {
+          spinner.successAndStop(`${message} completed`);
+        } else {
+          spinner.failAndStop(`${message} failed`);
+          if (mask.outputBuffer.length > 0 && !mask.verbose) {
+            console.log("\n--- Output ---");
+            mask.outputBuffer.forEach((line) => {
+              (0, import_stdout.write)(line);
+            });
+          }
+        }
+      }
+      resolve(finalCode);
+    });
+    child.on("error", (error) => {
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      if (mask.isSpinning) {
+        (0, import_spinner.getDefaultSpinner)().failAndStop(`${message} error`);
+      }
+      reject(error);
+    });
+  });
+}
+async function runWithMask(command, args = [], options = {}) {
+  const {
+    message = "Running\u2026",
+    showOutput = false,
+    toggleText = "to see output",
+    ...spawnOptions
+  } = options;
+  const child = (0, import_child_process.spawn)(command, args, {
+    stdio: ["inherit", "pipe", "pipe"],
+    ...spawnOptions
+  });
+  return await attachOutputMask(child, { message, showOutput, toggleText });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  attachOutputMask,
+  createKeyboardHandler,
+  createOutputMask,
+  runWithMask
+});
 //# sourceMappingURL=mask.js.map