@socketsecurity/lib 5.28.0 → 6.0.1

package/dist/stdio/divider.d.ts

@@ -1,148 +1,170 @@
 /**
- * @fileoverview Console divider and separator utilities.
- * Provides various line styles for visual separation in CLI output.
+ * @file Console divider and separator utilities. Provides various line styles
+ *   for visual separation in CLI output.
  */
 export interface DividerOptions {
     /**
      * Width of the divider line in characters.
+     *
      * @default 55
      */
     width?: number | undefined;
     /**
      * Character to repeat for the divider line.
+     *
      * @default '═'
      */
     char?: string | undefined;
     /**
-     * Optional color function to apply to the divider.
-     * Accepts a function from `yoctocolors` or similar.
+     * Optional color function to apply to the divider. Accepts a function from
+     * `yoctocolors` or similar.
      */
     color?: ((text: string) => string) | undefined;
 }
 /**
- * Create a divider line with custom character and width.
- * Returns a string of repeated characters for visual separation.
- *
- * @param options - Divider formatting options
- * @returns Divider string
+ * Create a divider line with custom character and width. Returns a string of
+ * repeated characters for visual separation.
  *
  * @example
- * ```ts
- * console.log(divider()) // Default: 55 '═' characters
- * console.log(divider({ char: '-', width: 40 }))
- * console.log(divider({ char: '·', width: 30 }))
- * ```
+ *   ;```ts
+ *   console.log(divider()) // Default: 55 '═' characters
+ *   console.log(divider({ char: '-', width: 40 }))
+ *   console.log(divider({ char: '·', width: 30 }))
+ *   ```
+ *
+ * @param options - Divider formatting options.
+ *
+ * @returns Divider string
  */
 export declare function divider(options?: DividerOptions): string;
 /**
- * Common divider style presets.
- * Provides quick access to popular divider styles.
+ * Common divider style presets. Provides quick access to popular divider
+ * styles.
  *
  * @example
- * ```ts
- * console.log(dividers.thick()) // ═══════...
- * console.log(dividers.thin())  // ───────...
- * console.log(dividers.dotted()) // ·······...
- * ```
+ *   ;```ts
+ *   console.log(dividers.thick()) // ═══════...
+ *   console.log(dividers.thin()) // ───────...
+ *   console.log(dividers.dotted()) // ·······...
+ *   ```
  */
 export declare const dividers: {
-    /** Thick double-line divider using `═` */
+    /**
+     * Thick double-line divider using `═`
+     */
     readonly thick: () => string;
-    /** Thin single-line divider using `─` */
+    /**
+     * Thin single-line divider using `─`
+     */
     readonly thin: () => string;
-    /** Double-line divider (alias for thick) */
+    /**
+     * Double-line divider (alias for thick)
+     */
     readonly double: () => string;
-    /** Simple single dash divider using `-` */
+    /**
+     * Simple single dash divider using `-`
+     */
     readonly single: () => string;
-    /** Dotted divider using `·` */
+    /**
+     * Dotted divider using `·`
+     */
     readonly dotted: () => string;
-    /** Dashed divider using `╌` */
+    /**
+     * Dashed divider using `╌`
+     */
     readonly dashed: () => string;
-    /** Wave divider using `~` */
+    /**
+     * Wave divider using `~`
+     */
     readonly wave: () => string;
-    /** Star divider using `*` */
+    /**
+     * Star divider using `*`
+     */
     readonly star: () => string;
-    /** Diamond divider using `◆` */
+    /**
+     * Diamond divider using `◆`
+     */
     readonly diamond: () => string;
-    /** Arrow divider using `→` */
+    /**
+     * Arrow divider using `→`
+     */
     readonly arrow: () => string;
 };
 /**
  * Print a divider line directly to console.
  *
- * @param options - Divider formatting options
- *
  * @example
- * ```ts
- * printDivider() // Prints default divider
- * printDivider({ char: '─', width: 60 })
- * ```
+ *   ;```ts
+ *   printDivider() // Prints default divider
+ *   printDivider({ char: '─', width: 60 })
+ *   ```
+ *
+ * @param options - Divider formatting options.
  */
 export declare function printDivider(options?: DividerOptions): void;
 /**
- * Print a dotted divider line.
- * Convenience function using `·` character.
+ * Print a dotted divider line. Convenience function using `·` character.
  *
  * @example
- * ```ts
- * printDottedDivider()
- * // ·······················································
- * ```
+ *   ;```ts
+ *   printDottedDivider()
+ *   // ·······················································
+ *   ```
  */
 export declare function printDottedDivider(): void;
 /**
  * Print a section break with spacing directly to console.
  *
- * @param options - Divider formatting options
- *
  * @example
- * ```ts
- * console.log('Previous section')
- * printSectionBreak()
- * console.log('Next section')
- * ```
+ *   ;```ts
+ *   console.log('Previous section')
+ *   printSectionBreak()
+ *   console.log('Next section')
+ *   ```
+ *
+ * @param options - Divider formatting options.
  */
 export declare function printSectionBreak(options?: DividerOptions): void;
 /**
- * Print a thick divider line (default style).
- * Convenience function using `═` character.
+ * Print a thick divider line (default style). Convenience function using `═`
+ * character.
  *
  * @example
- * ```ts
- * printThickDivider()
- * // ═══════════════════════════════════════════════════
- * ```
+ *   ;```ts
+ *   printThickDivider()
+ *   // ═══════════════════════════════════════════════════
+ *   ```
  */
 export declare function printThickDivider(): void;
 /**
- * Print a thin divider line.
- * Convenience function using `─` character.
+ * Print a thin divider line. Convenience function using `─` character.
  *
  * @example
- * ```ts
- * printThinDivider()
- * // ───────────────────────────────────────────────────
- * ```
+ *   ;```ts
+ *   printThinDivider()
+ *   // ───────────────────────────────────────────────────
+ *   ```
  */
 export declare function printThinDivider(): void;
 /**
- * Create a section break with blank lines before and after the divider.
- * Useful for creating visual separation between major sections.
- *
- * @param options - Divider formatting options
- * @returns Section break string with newlines
+ * Create a section break with blank lines before and after the divider. Useful
+ * for creating visual separation between major sections.
  *
  * @example
- * ```ts
- * console.log('Previous section')
- * console.log(sectionBreak())
- * console.log('Next section')
- * // Output:
- * // Previous section
- * //
- * // ═══════════════════════════════════════════════════
- * //
- * // Next section
- * ```
+ *   ;```ts
+ *   console.log('Previous section')
+ *   console.log(sectionBreak())
+ *   console.log('Next section')
+ *   // Output:
+ *   // Previous section
+ *   //
+ *   // ═══════════════════════════════════════════════════
+ *   //
+ *   // Next section
+ *   ```
+ *
+ * @param options - Divider formatting options.
+ *
+ * @returns Section break string with newlines
  */
 export declare function sectionBreak(options?: DividerOptions): string;

package/dist/stdio/divider.js

@@ -30,42 +30,64 @@ __export(divider_exports, {
   sectionBreak: () => sectionBreak
 });
 module.exports = __toCommonJS(divider_exports);
-var import_strings = require("../strings");
+var import_default = require("../logger/default");
+var import_format = require("../strings/format");
+const logger = (0, import_default.getDefaultLogger)();
 function divider(options) {
   const opts = { __proto__: null, ...options };
   const { char = "\u2550", width = 55 } = opts;
-  return (0, import_strings.repeatString)(char, width);
+  return (0, import_format.repeatString)(char, width);
 }
 const dividers = {
-  /** Thick double-line divider using `═` */
+  /**
+   * Thick double-line divider using `═`
+   */
   thick: () => divider({ char: "\u2550" }),
-  /** Thin single-line divider using `─` */
+  /**
+   * Thin single-line divider using `─`
+   */
   thin: () => divider({ char: "\u2500" }),
-  /** Double-line divider (alias for thick) */
+  /**
+   * Double-line divider (alias for thick)
+   */
   double: () => divider({ char: "\u2550" }),
-  /** Simple single dash divider using `-` */
+  /**
+   * Simple single dash divider using `-`
+   */
   single: () => divider({ char: "-" }),
-  /** Dotted divider using `·` */
+  /**
+   * Dotted divider using `·`
+   */
   dotted: () => divider({ char: "\xB7" }),
-  /** Dashed divider using `╌` */
+  /**
+   * Dashed divider using `╌`
+   */
   dashed: () => divider({ char: "\u254C" }),
-  /** Wave divider using `~` */
+  /**
+   * Wave divider using `~`
+   */
   wave: () => divider({ char: "~" }),
-  /** Star divider using `*` */
+  /**
+   * Star divider using `*`
+   */
   star: () => divider({ char: "*" }),
-  /** Diamond divider using `◆` */
+  /**
+   * Diamond divider using `◆`
+   */
   diamond: () => divider({ char: "\u25C6" }),
-  /** Arrow divider using `→` */
+  /**
+   * Arrow divider using `→`
+   */
   arrow: () => divider({ char: "\u2192" })
 };
 function printDivider(options) {
-  console.log(divider(options));
+  logger.log(divider(options));
 }
 function printDottedDivider() {
   printDivider({ char: "\xB7" });
 }
 function printSectionBreak(options) {
-  console.log(sectionBreak(options));
+  logger.log(sectionBreak(options));
 }
 function printThickDivider() {
   printDivider({ char: "\u2550" });

package/dist/stdio/footer.d.ts

@@ -1,74 +1,96 @@
 /**
- * @fileoverview Console footer/summary formatting utilities.
- * Provides consistent footer and summary formatting for CLI applications.
+ * @file Console footer/summary formatting utilities. Provides consistent footer
+ *   and summary formatting for CLI applications.
  */
 export interface FooterOptions {
     /**
      * Width of the footer border in characters.
+     *
      * @default 80
      */
     width?: number | undefined;
     /**
      * Character to use for the border line.
+     *
      * @default '='
      */
     borderChar?: string | undefined;
     /**
      * Include ISO timestamp in footer.
+     *
      * @default false
      */
     showTimestamp?: boolean | undefined;
     /**
      * Show duration since start time.
+     *
      * @default false
      */
     showDuration?: boolean | undefined;
     /**
-     * Start time in milliseconds (from Date.now()).
-     * Required when `showDuration` is true.
+     * Start time in milliseconds (from Date.now()). Required when `showDuration`
+     * is true.
      */
     startTime?: number | undefined;
     /**
      * Color to apply to the footer message.
+     *
      * @default 'gray'
      */
     color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | 'red' | 'gray' | undefined;
 }
 export interface SummaryStats {
-    /** Total number of items processed */
+    /**
+     * Total number of items processed.
+     */
     total?: number | undefined;
-    /** Number of successful items */
+    /**
+     * Number of successful items.
+     */
     success?: number | undefined;
-    /** Number of failed items */
+    /**
+     * Number of failed items.
+     */
     failed?: number | undefined;
-    /** Number of skipped items */
+    /**
+     * Number of skipped items.
+     */
     skipped?: number | undefined;
-    /** Number of warnings */
+    /**
+     * Number of warnings.
+     */
     warnings?: number | undefined;
-    /** Number of errors */
+    /**
+     * Number of errors.
+     */
     errors?: number | undefined;
-    /** Duration in milliseconds (timestamp value, not elapsed time) */
+    /**
+     * Duration in milliseconds (timestamp value, not elapsed time)
+     */
     duration?: number | undefined;
 }
 /**
  * Create a formatted footer with optional message, timestamp, and duration.
  * Useful for marking the end of CLI output or showing completion status.
  *
- * @param message - Optional message to display in footer
- * @param options - Footer formatting options
- * @returns Formatted footer string with border and optional info
- *
  * @example
- * ```ts
- * const startTime = Date.now()
- * // ... do work
- * console.log(createFooter('Build complete', {
- *   width: 60,
- *   color: 'green',
- *   showDuration: true,
- *   startTime
- * }))
- * ```
+ *   ;```ts
+ *   const startTime = Date.now()
+ *   // ... do work
+ *   console.log(
+ *     createFooter('Build complete', {
+ *       width: 60,
+ *       color: 'green',
+ *       showDuration: true,
+ *       startTime,
+ *     }),
+ *   )
+ *   ```
+ *
+ * @param message - Optional message to display in footer.
+ * @param options - Footer formatting options.
+ *
+ * @returns Formatted footer string with border and optional info
  */
 export declare function createFooter(message?: string | undefined, options?: FooterOptions): string;
 /**
@@ -76,37 +98,39 @@ export declare function createFooter(message?: string | undefined, options?: Foo
  * Automatically formats success/failure/warning counts with appropriate colors.
  * Useful for test results, build summaries, or batch operation reports.
  *
- * @param stats - Statistics to display in the summary
- * @param options - Footer formatting options
- * @returns Formatted summary footer string with colored indicators
- *
  * @example
- * ```ts
- * console.log(createSummaryFooter({
- *   total: 150,
- *   success: 145,
- *   failed: 3,
- *   skipped: 2,
- *   warnings: 5
- * }))
- * // Output: Total: 150 | ✓ 145 passed | ✗ 3 failed | ○ 2 skipped | ⚠ 5 warnings
- * // ========================================
- * ```
+ *   ;```ts
+ *   console.log(
+ *     createSummaryFooter({
+ *       total: 150,
+ *       success: 145,
+ *       failed: 3,
+ *       skipped: 2,
+ *       warnings: 5,
+ *     }),
+ *   )
+ *   // Output: Total: 150 | ✓ 145 passed | ✗ 3 failed | ○ 2 skipped | ⚠ 5 warnings
+ *   // ========================================
+ *   ```
+ *
+ * @param stats - Statistics to display in the summary.
+ * @param options - Footer formatting options.
+ *
+ * @returns Formatted summary footer string with colored indicators
  */
 export declare function createSummaryFooter(stats: SummaryStats, options?: FooterOptions): string;
 /**
- * Print a footer with optional success message.
- * Uses `─` border character for a lighter appearance.
- * Fixed width of 55 characters to match `printHeader()`.
- *
- * @param message - Optional message to display (shown in green)
+ * Print a footer with optional success message. Uses `─` border character for a
+ * lighter appearance. Fixed width of 55 characters to match `printHeader()`.
  *
  * @example
- * ```ts
- * printFooter('Analysis complete')
- * // Output:
- * // ───────────────────────────────────────────────────
- * // Analysis complete (in green)
- * ```
+ *   ;```ts
+ *   printFooter('Analysis complete')
+ *   // Output:
+ *   // ───────────────────────────────────────────────────
+ *   // Analysis complete (in green)
+ *   ```
+ *
+ * @param message - Optional message to display (shown in green)
  */
 export declare function printFooter(message?: string | undefined): void;

package/dist/stdio/footer.js

@@ -36,8 +36,12 @@ __export(footer_exports, {
 });
 module.exports = __toCommonJS(footer_exports);
 var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
+var import_format = require("../strings/format");
+var import_array = require("../primordials/array");
+var import_default = require("../logger/default");
+var import_symbols = require("../logger/symbols");
+var import_date = require("../primordials/date");
+const logger = (0, import_default.getDefaultLogger)();
 function createFooter(message, options) {
   const {
     borderChar = "=",
@@ -47,43 +51,49 @@ function createFooter(message, options) {
     startTime,
     width = 80
   } = { __proto__: null, ...options };
-  const border = (0, import_strings.repeatString)(borderChar, width);
+  const border = (0, import_format.repeatString)(borderChar, width);
   const lines = [];
   if (message) {
     const colorFn = color && import_yoctocolors_cjs.default[color] ? import_yoctocolors_cjs.default[color] : (s) => s;
-    (0, import_primordials.ArrayPrototypePush)(lines, colorFn(message));
+    (0, import_array.ArrayPrototypePush)(lines, colorFn(message));
   }
   if (showTimestamp) {
-    const timestamp = new import_primordials.DateCtor().toISOString();
-    (0, import_primordials.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.gray(`Completed at: ${timestamp}`));
+    const timestamp = new import_date.DateCtor().toISOString();
+    (0, import_array.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.gray(`Completed at: ${timestamp}`));
   }
   if (showDuration && startTime) {
-    const duration = (0, import_primordials.DateNow)() - startTime;
+    const duration = (0, import_date.DateNow)() - startTime;
     const seconds = (duration / 1e3).toFixed(2);
-    (0, import_primordials.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.gray(`Duration: ${seconds}s`));
+    (0, import_array.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.gray(`Duration: ${seconds}s`));
   }
-  (0, import_primordials.ArrayPrototypePush)(lines, border);
+  (0, import_array.ArrayPrototypePush)(lines, border);
   return lines.join("\n");
 }
 function createSummaryFooter(stats, options) {
   const parts = [];
   if (stats.total !== void 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, `Total: ${stats.total}`);
+    (0, import_array.ArrayPrototypePush)(parts, `Total: ${stats.total}`);
   }
   if (stats.success !== void 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, import_yoctocolors_cjs.default.green(`\u2713 ${stats.success} passed`));
+    (0, import_array.ArrayPrototypePush)(
+      parts,
+      `${import_symbols.LOG_SYMBOLS["success"]} ${stats.success} passed`
+    );
   }
   if (stats.failed !== void 0 && stats.failed > 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, import_yoctocolors_cjs.default.red(`\u2717 ${stats.failed} failed`));
+    (0, import_array.ArrayPrototypePush)(parts, `${import_symbols.LOG_SYMBOLS["fail"]} ${stats.failed} failed`);
   }
   if (stats.skipped !== void 0 && stats.skipped > 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, import_yoctocolors_cjs.default.yellow(`\u25CB ${stats.skipped} skipped`));
+    (0, import_array.ArrayPrototypePush)(parts, `${import_symbols.LOG_SYMBOLS["skip"]} ${stats.skipped} skipped`);
   }
   if (stats.warnings !== void 0 && stats.warnings > 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, import_yoctocolors_cjs.default.yellow(`\u26A0 ${stats.warnings} warnings`));
+    (0, import_array.ArrayPrototypePush)(
+      parts,
+      `${import_symbols.LOG_SYMBOLS["warn"]} ${stats.warnings} warnings`
+    );
   }
   if (stats.errors !== void 0 && stats.errors > 0) {
-    (0, import_primordials.ArrayPrototypePush)(parts, import_yoctocolors_cjs.default.red(`\u2717 ${stats.errors} errors`));
+    (0, import_array.ArrayPrototypePush)(parts, `${import_symbols.LOG_SYMBOLS["fail"]} ${stats.errors} errors`);
   }
   const message = parts.join(" | ");
   return createFooter(message, {
@@ -93,10 +103,10 @@ function createSummaryFooter(stats, options) {
   });
 }
 function printFooter(message) {
-  const border = (0, import_strings.repeatString)("\u2500", 55);
-  console.log(border);
+  const border = (0, import_format.repeatString)("\u2500", 55);
+  logger.log(border);
   if (message) {
-    console.log(import_yoctocolors_cjs.default.green(message));
+    logger.log(import_yoctocolors_cjs.default.green(message));
   }
 }
 // Annotate the CommonJS export names for ESM import in node: