@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/strings/transform.js

@@ -1,79 +1,120 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 transform_exports = {};
-__export(transform_exports, {
-  stripBom: () => stripBom,
-  toKebabCase: () => toKebabCase,
-  trimNewlines: () => trimNewlines
-});
-module.exports = __toCommonJS(transform_exports);
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+
+//#region src/strings/transform.ts
+/**
+* @file String transformations: `stripBom`, `toKebabCase`, `trimNewlines`. All
+*   three are pure functions with no side effects.
+*/
+/**
+* Strip the Byte Order Mark (BOM) from the beginning of a string.
+*
+* The BOM (U+FEFF) is a Unicode character that can appear at the start of a
+* text file to indicate byte order and encoding. In UTF-16 (JavaScript's
+* internal string representation), it appears as 0xFEFF. This function removes
+* it if present, leaving the rest of the string unchanged.
+*
+* Most text processing doesn't need to handle the BOM explicitly, but it can
+* cause issues when parsing JSON, CSV, or other structured data formats that
+* don't expect a leading invisible character.
+*
+* @example
+*   ;```ts
+*   stripBom('hello world') // 'hello world'
+*   stripBom('hello world') // 'hello world'
+*   stripBom('') // ''
+*   ```
+*
+* @param str - The string to strip BOM from.
+*
+* @returns The string without BOM
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function stripBom(str) {
-  return str.length > 0 && (0, import_string.StringPrototypeCharCodeAt)(str, 0) === 65279 ? (0, import_string.StringPrototypeSlice)(str, 1) : str;
+	return str.length > 0 && require_primordials_string.StringPrototypeCharCodeAt(str, 0) === 65279 ? require_primordials_string.StringPrototypeSlice(str, 1) : str;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Convert a string to kebab-case (handles camelCase and snake_case).
+*
+* Transforms strings from camelCase or snake_case to kebab-case by:
+*
+* - Converting uppercase letters to lowercase
+* - Inserting hyphens before uppercase letters (for camelCase)
+* - Replacing underscores with hyphens (for snake_case)
+*
+* Handles mixed formats (camelCase, snake_case, acronyms) in one pass. Returns
+* empty string for empty input.
+*
+* @example
+*   ;```ts
+*   toKebabCase('helloWorld') // 'hello-world'
+*   toKebabCase('hello_world') // 'hello-world'
+*   toKebabCase('XMLHttpRequest') // 'xmlhttp-request'
+*   toKebabCase('iOS_Version') // 'i-os-version'
+*   toKebabCase('') // ''
+*   ```
+*
+* @param str - The string to convert.
+*
+* @returns The kebab-case string
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function toKebabCase(str) {
-  if (!str.length) {
-    return str;
-  }
-  return (0, import_string.StringPrototypeReplace)(str, /([a-z]+[0-9]*)([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
+	if (!str.length) return str;
+	return require_primordials_string.StringPrototypeReplace(str, /([a-z]+[0-9]*)([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Trim newlines from the beginning and end of a string.
+*
+* Removes all leading and trailing newline characters (both `\n` and `\r`) from
+* a string, while preserving any newlines in the middle. This is similar to
+* `String.prototype.trim()` but specifically targets newlines instead of all
+* whitespace.
+*
+* Optimized for performance by checking the first and last characters before
+* doing any string manipulation. Returns the original string unchanged if no
+* newlines are found at the edges.
+*
+* @example
+*   ;```ts
+*   trimNewlines('\n\nhello\n\n') // 'hello'
+*   trimNewlines('\r\nworld\r\n') // 'world'
+*   trimNewlines('hello\nworld') // 'hello\nworld' (middle preserved)
+*   trimNewlines('  hello  ') // '  hello  ' (spaces not trimmed)
+*   trimNewlines('hello') // 'hello'
+*   ```
+*
+* @param str - The string to trim.
+*
+* @returns The string with leading and trailing newlines removed
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function trimNewlines(str) {
-  const { length } = str;
-  if (length === 0) {
-    return str;
-  }
-  const first = (0, import_string.StringPrototypeCharCodeAt)(str, 0);
-  const noFirstNewline = first !== 13 && first !== 10;
-  if (length === 1) {
-    return noFirstNewline ? str : "";
-  }
-  const last = (0, import_string.StringPrototypeCharCodeAt)(str, length - 1);
-  const noLastNewline = last !== 13 && last !== 10;
-  if (noFirstNewline && noLastNewline) {
-    return str;
-  }
-  let start = 0;
-  let end = length;
-  while (start < end) {
-    const code = (0, import_string.StringPrototypeCharCodeAt)(str, start);
-    if (code !== 13 && code !== 10) {
-      break;
-    }
-    start += 1;
-  }
-  while (end > start) {
-    const code = (0, import_string.StringPrototypeCharCodeAt)(str, end - 1);
-    if (code !== 13 && code !== 10) {
-      break;
-    }
-    end -= 1;
-  }
-  return start === 0 && end === length ? str : (0, import_string.StringPrototypeSlice)(str, start, end);
+	const { length } = str;
+	if (length === 0) return str;
+	const first = require_primordials_string.StringPrototypeCharCodeAt(str, 0);
+	const noFirstNewline = first !== 13 && first !== 10;
+	if (length === 1) return noFirstNewline ? str : "";
+	const last = require_primordials_string.StringPrototypeCharCodeAt(str, length - 1);
+	if (noFirstNewline && last !== 13 && last !== 10) return str;
+	let start = 0;
+	let end = length;
+	while (start < end) {
+		const code = require_primordials_string.StringPrototypeCharCodeAt(str, start);
+		if (code !== 13 && code !== 10) break;
+		start += 1;
+	}
+	while (end > start) {
+		const code = require_primordials_string.StringPrototypeCharCodeAt(str, end - 1);
+		if (code !== 13 && code !== 10) break;
+		end -= 1;
+	}
+	return start === 0 && end === length ? str : require_primordials_string.StringPrototypeSlice(str, start, end);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  stripBom,
-  toKebabCase,
-  trimNewlines
-});
+
+//#endregion
+exports.stripBom = stripBom;
+exports.toKebabCase = toKebabCase;
+exports.trimNewlines = trimNewlines;

package/dist/strings/types.js

@@ -1,18 +1,2 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/strings/width.js

@@ -1,95 +1,102 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 width_exports = {};
-__export(width_exports, {
-  getEastAsianWidth: () => getEastAsianWidth,
-  stringWidth: () => stringWidth
-});
-module.exports = __toCommonJS(width_exports);
-var import_strip = require("../ansi/strip");
-var import_regexp = require("../primordials/regexp");
-var import_string = require("../primordials/string");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_regexp = require('../primordials/regexp.js');
+const require_ansi_strip = require('../ansi/strip.js');
+
+//#region src/strings/width.ts
+/**
+* @file `stringWidth` — calculate visual terminal width. Based on string-width
+*   by Sindre Sorhus
+*   (https://socket.dev/npm/package/string-width/overview/7.2.0, MIT). Why this
+*   lives in its own leaf:
+*
+*   - It carries a heavy module-level setup: `Intl.Segmenter` instance,
+*     feature-detected regex patterns (with `'v'` flag fallback to `'u'`), and
+*     a lazy `eastAsianWidth` accessor.
+*   - The function body is ~150 lines of carefully-commented Unicode handling —
+*     keeping it isolated makes it easy to review changes without touching the
+*     rest of the strings surface. See the comments inside for the algorithm
+*     details and Unicode Standard Annex #11 references.
+*/
 let _eastAsianWidth;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getEastAsianWidth() {
-  if (_eastAsianWidth === void 0) {
-    _eastAsianWidth = require("../external/get-east-asian-width").eastAsianWidth;
-  }
-  return _eastAsianWidth;
+	if (_eastAsianWidth === void 0) _eastAsianWidth = require("../external/get-east-asian-width").eastAsianWidth;
+	return _eastAsianWidth;
 }
 const segmenter = new Intl.Segmenter();
 let zeroWidthClusterRegex;
 let leadingNonPrintingRegex;
 let emojiRegex;
 try {
-  zeroWidthClusterRegex = new RegExp("^(?:\\p{Default_Ignorable_Code_Point}|\\p{Control}|\\p{Mark}|\\p{Surrogate})+$", "v");
-  leadingNonPrintingRegex = new RegExp("^[\\p{Default_Ignorable_Code_Point}\\p{Control}\\p{Format}\\p{Mark}\\p{Surrogate}]+", "v");
-  emojiRegex = new RegExp("^\\p{RGI_Emoji}$", "v");
+	zeroWidthClusterRegex = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Mark}|\p{Surrogate})+$/v;
+	leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}\p{Surrogate}]+/v;
+	emojiRegex = /^\p{RGI_Emoji}$/v;
 } catch {
-  zeroWidthClusterRegex = new RegExp("^(?:\\p{Default_Ignorable_Code_Point}|\\p{Control}|\\p{Mark})+$", "u");
-  leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}]+/u;
-  emojiRegex = new RegExp("^\\p{Extended_Pictographic}$", "u");
+	zeroWidthClusterRegex = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Mark})+$/u;
+	leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}]+/u;
+	emojiRegex = /^\p{Extended_Pictographic}$/u;
 }
-// @__NO_SIDE_EFFECTS__
+/* c8 ignore stop */
+/**
+* Get the visual width of a string in terminal columns.
+*
+* Calculates how many columns a string will occupy when displayed in a
+* terminal, accounting for: - ANSI escape codes (stripped before calculation) -
+* Wide characters (CJK ideographs, fullwidth forms) that take 2 columns - Emoji
+* (including complex sequences) that take 2 columns - Combining marks and
+* zero-width characters (take 0 columns) - East Asian Width properties
+* (Fullwidth, Wide, Halfwidth, Narrow, etc.)
+*
+* @example
+*   ;```ts
+*   stringWidth('hello') // 5
+*   stringWidth('⚡') // 2 (lightning bolt is wide)
+*   stringWidth('✦') // 1 (star is narrow)
+*   stringWidth('漢字') // 4 (CJK × 2 cols each)
+*   stringWidth('\x1b[31mred\x1b[0m') // 3 (ANSI stripped)
+*   stringWidth('👍🏽') // 2 (emoji + skin tone = 1 cluster)
+*   stringWidth('é') // 1 (combining accent = 0 width)
+*   ```
+*
+* @param text - The string to measure.
+*
+* @returns The visual width in terminal columns
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function stringWidth(text) {
-  if (typeof text !== "string" || !text.length) {
-    return 0;
-  }
-  const plainText = (0, import_strip.stripAnsi)(text);
-  if (!plainText.length) {
-    return 0;
-  }
-  let width = 0;
-  const eastAsianWidthOptions = { ambiguousAsWide: false };
-  const eastAsianWidth = /* @__PURE__ */ getEastAsianWidth();
-  for (const { segment } of segmenter.segment(plainText)) {
-    if ((0, import_regexp.RegExpPrototypeTest)(zeroWidthClusterRegex, segment)) {
-      continue;
-    }
-    if ((0, import_regexp.RegExpPrototypeTest)(emojiRegex, segment)) {
-      width += 2;
-      continue;
-    }
-    const baseSegment = segment.replace(leadingNonPrintingRegex, "");
-    const codePoint = (0, import_string.StringPrototypeCodePointAt)(baseSegment, 0);
-    if (codePoint === void 0) {
-      continue;
-    }
-    width += eastAsianWidth(codePoint, eastAsianWidthOptions);
-    if (segment.length > 1) {
-      for (const char of segment.slice(1)) {
-        const charCode = (0, import_string.StringPrototypeCharCodeAt)(char, 0);
-        if (charCode >= 65280 && charCode <= 65519) {
-          const trailingCodePoint = (0, import_string.StringPrototypeCodePointAt)(char, 0);
-          if (trailingCodePoint !== void 0) {
-            width += eastAsianWidth(trailingCodePoint, eastAsianWidthOptions);
-          }
-        }
-      }
-    }
-  }
-  return width;
+	if (typeof text !== "string" || !text.length) return 0;
+	/* c8 ignore next */
+	const plainText = /* @__PURE__ */ require_ansi_strip.stripAnsi(text);
+	if (!plainText.length) return 0;
+	let width = 0;
+	const eastAsianWidthOptions = { ambiguousAsWide: false };
+	const eastAsianWidth = /* @__PURE__ */ getEastAsianWidth();
+	for (const { segment } of segmenter.segment(plainText)) {
+		if (require_primordials_regexp.RegExpPrototypeTest(zeroWidthClusterRegex, segment)) continue;
+		if (require_primordials_regexp.RegExpPrototypeTest(emojiRegex, segment)) {
+			width += 2;
+			continue;
+		}
+		const codePoint = require_primordials_string.StringPrototypeCodePointAt(segment.replace(leadingNonPrintingRegex, ""), 0);
+		if (codePoint === void 0) continue;
+		/* c8 ignore next - External eastAsianWidth call */
+		width += eastAsianWidth(codePoint, eastAsianWidthOptions);
+		if (segment.length > 1) for (const char of segment.slice(1)) {
+			const charCode = require_primordials_string.StringPrototypeCharCodeAt(char, 0);
+			if (charCode >= 65280 && charCode <= 65519) {
+				const trailingCodePoint = require_primordials_string.StringPrototypeCodePointAt(char, 0);
+				if (trailingCodePoint !== void 0)
+ /* c8 ignore next - External eastAsianWidth call */
+				width += eastAsianWidth(trailingCodePoint, eastAsianWidthOptions);
+			}
+		}
+	}
+	return width;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getEastAsianWidth,
-  stringWidth
-});
+
+//#endregion
+exports.getEastAsianWidth = getEastAsianWidth;
+exports.stringWidth = stringWidth;

package/dist/tables/bordered.js

@@ -1,84 +1,84 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 bordered_exports = {};
-__export(bordered_exports, {
-  formatTable: () => formatTable
-});
-module.exports = __toCommonJS(bordered_exports);
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_array = require("../primordials/array");
-var import_math = require("../primordials/math");
-var import_padding = require("./padding");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_math = require('../primordials/math.js');
+const require_primordials_array = require('../primordials/array.js');
+const require_tables_padding = require('./padding.js');
+let src_external_yoctocolors_cjs = require("../external/yoctocolors-cjs");
+src_external_yoctocolors_cjs = require_runtime.__toESM(src_external_yoctocolors_cjs);
+
+//#region src/tables/bordered.ts
+/**
+* @file Bordered table renderer using Unicode box-drawing characters (`┌`, `─`,
+*   `│`, `┴`, …). The right choice when the output context renders box-drawing
+*   reliably (modern terminals, GitHub markdown, most CI runners). Shares
+*   column-width calculation, alignment, and padding with the simple renderer
+*   via `./padding`.
+*/
+/**
+* Format data as an ASCII table with borders.
+*
+* @example
+*   import { formatTable } from '@socketsecurity/lib/tables/bordered'
+*   import colors from 'yoctocolors-cjs'
+*
+*   const data = [
+*     { name: 'lodash', version: '4.17.21', issues: 0 },
+*     { name: 'react', version: '18.2.0', issues: 2 },
+*   ]
+*   const columns = [
+*     { key: 'name', header: 'Package' },
+*     { key: 'version', header: 'Version', align: 'center' },
+*     {
+*       key: 'issues',
+*       header: 'Issues',
+*       align: 'right',
+*       color: v => (v === '0' ? colors.green(v) : colors.red(v)),
+*     },
+*   ]
+*   console.log(formatTable(data, columns))
+*   // Output:
+*   // ┌─────────┬─────────┬────────┐
+*   // │ Package │ Version │ Issues │
+*   // ├─────────┼─────────┼────────┤
+*   // │ lodash  │ 4.17.21 │      0 │
+*   // │ react   │ 18.2.0  │      2 │
+*   // └─────────┴─────────┴────────┘
+*
+* @param data - Array of data objects.
+* @param columns - Column configuration.
+*
+* @returns Formatted table string
+*/
 function formatTable(data, columns) {
-  if (data.length === 0) {
-    return "(no data)";
-  }
-  const widths = columns.map((col) => {
-    const headerWidth = (0, import_padding.displayWidth)(col.header);
-    const maxDataWidth = (0, import_math.MathMax)(
-      ...data.map((row) => (0, import_padding.displayWidth)(String(row[col.key] ?? "")))
-    );
-    return col.width ?? (0, import_math.MathMax)(headerWidth, maxDataWidth);
-  });
-  const lines = [];
-  const topBorder = `\u250C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u252C\u2500")}\u2500\u2510`;
-  (0, import_array.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(topBorder));
-  const headerCells = columns.map((col, i) => {
-    const text = import_yoctocolors_cjs.default.bold(col.header);
-    return (0, import_padding.padText)(text, widths[i], col.align);
-  });
-  (0, import_array.ArrayPrototypePush)(
-    lines,
-    import_yoctocolors_cjs.default.dim("\u2502 ") + headerCells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
-  );
-  const headerSep = `\u251C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u253C\u2500")}\u2500\u2524`;
-  (0, import_array.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(headerSep));
-  for (const row of data) {
-    const cells = columns.map((col, i) => {
-      let value = String(row[col.key] ?? "");
-      if (col.color) {
-        value = col.color(value);
-      }
-      return (0, import_padding.padText)(value, widths[i], col.align);
-    });
-    (0, import_array.ArrayPrototypePush)(
-      lines,
-      import_yoctocolors_cjs.default.dim("\u2502 ") + cells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
-    );
-  }
-  const bottomBorder = `\u2514\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2534\u2500")}\u2500\u2518`;
-  (0, import_array.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(bottomBorder));
-  return lines.join("\n");
+	if (data.length === 0) return "(no data)";
+	const widths = columns.map((col) => {
+		const headerWidth = require_tables_padding.displayWidth(col.header);
+		const maxDataWidth = require_primordials_math.MathMax(...data.map((row) => require_tables_padding.displayWidth(String(row[col.key] ?? ""))));
+		return col.width ?? require_primordials_math.MathMax(headerWidth, maxDataWidth);
+	});
+	const lines = [];
+	const topBorder = `┌─${widths.map((w) => "─".repeat(w)).join("─┬─")}─┐`;
+	require_primordials_array.ArrayPrototypePush(lines, src_external_yoctocolors_cjs.default.dim(topBorder));
+	const headerCells = columns.map((col, i) => {
+		return require_tables_padding.padText(src_external_yoctocolors_cjs.default.bold(col.header), widths[i], col.align);
+	});
+	require_primordials_array.ArrayPrototypePush(lines, src_external_yoctocolors_cjs.default.dim("│ ") + headerCells.join(src_external_yoctocolors_cjs.default.dim(" │ ")) + src_external_yoctocolors_cjs.default.dim(" │"));
+	const headerSep = `├─${widths.map((w) => "─".repeat(w)).join("─┼─")}─┤`;
+	require_primordials_array.ArrayPrototypePush(lines, src_external_yoctocolors_cjs.default.dim(headerSep));
+	for (const row of data) {
+		const cells = columns.map((col, i) => {
+			let value = String(row[col.key] ?? "");
+			if (col.color) value = col.color(value);
+			return require_tables_padding.padText(value, widths[i], col.align);
+		});
+		require_primordials_array.ArrayPrototypePush(lines, src_external_yoctocolors_cjs.default.dim("│ ") + cells.join(src_external_yoctocolors_cjs.default.dim(" │ ")) + src_external_yoctocolors_cjs.default.dim(" │"));
+	}
+	const bottomBorder = `└─${widths.map((w) => "─".repeat(w)).join("─┴─")}─┘`;
+	require_primordials_array.ArrayPrototypePush(lines, src_external_yoctocolors_cjs.default.dim(bottomBorder));
+	return lines.join("\n");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  formatTable
-});
+
+//#endregion
+exports.formatTable = formatTable;