@towles/tool 0.0.120 → 0.0.121

package/packages/shared/node_modules/consola/dist/shared/consola.DwRq1yyg.cjs

@@ -0,0 +1,312 @@
+'use strict';
+
+const tty = require('node:tty');
+
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
+
+const tty__namespace = /*#__PURE__*/_interopNamespaceCompat(tty);
+
+const {
+  env = {},
+  argv = [],
+  platform = ""
+} = typeof process === "undefined" ? {} : process;
+const isDisabled = "NO_COLOR" in env || argv.includes("--no-color");
+const isForced = "FORCE_COLOR" in env || argv.includes("--color");
+const isWindows = platform === "win32";
+const isDumbTerminal = env.TERM === "dumb";
+const isCompatibleTerminal = tty__namespace && tty__namespace.isatty && tty__namespace.isatty(1) && env.TERM && !isDumbTerminal;
+const isCI = "CI" in env && ("GITHUB_ACTIONS" in env || "GITLAB_CI" in env || "CIRCLECI" in env);
+const isColorSupported = !isDisabled && (isForced || isWindows && !isDumbTerminal || isCompatibleTerminal || isCI);
+function replaceClose(index, string, close, replace, head = string.slice(0, Math.max(0, index)) + replace, tail = string.slice(Math.max(0, index + close.length)), next = tail.indexOf(close)) {
+  return head + (next < 0 ? tail : replaceClose(next, tail, close, replace));
+}
+function clearBleed(index, string, open, close, replace) {
+  return index < 0 ? open + string + close : open + replaceClose(index, string, close, replace) + close;
+}
+function filterEmpty(open, close, replace = open, at = open.length + 1) {
+  return (string) => string || !(string === "" || string === void 0) ? clearBleed(
+    ("" + string).indexOf(close, at),
+    string,
+    open,
+    close,
+    replace
+  ) : "";
+}
+function init(open, close, replace) {
+  return filterEmpty(`\x1B[${open}m`, `\x1B[${close}m`, replace);
+}
+const colorDefs = {
+  reset: init(0, 0),
+  bold: init(1, 22, "\x1B[22m\x1B[1m"),
+  dim: init(2, 22, "\x1B[22m\x1B[2m"),
+  italic: init(3, 23),
+  underline: init(4, 24),
+  inverse: init(7, 27),
+  hidden: init(8, 28),
+  strikethrough: init(9, 29),
+  black: init(30, 39),
+  red: init(31, 39),
+  green: init(32, 39),
+  yellow: init(33, 39),
+  blue: init(34, 39),
+  magenta: init(35, 39),
+  cyan: init(36, 39),
+  white: init(37, 39),
+  gray: init(90, 39),
+  bgBlack: init(40, 49),
+  bgRed: init(41, 49),
+  bgGreen: init(42, 49),
+  bgYellow: init(43, 49),
+  bgBlue: init(44, 49),
+  bgMagenta: init(45, 49),
+  bgCyan: init(46, 49),
+  bgWhite: init(47, 49),
+  blackBright: init(90, 39),
+  redBright: init(91, 39),
+  greenBright: init(92, 39),
+  yellowBright: init(93, 39),
+  blueBright: init(94, 39),
+  magentaBright: init(95, 39),
+  cyanBright: init(96, 39),
+  whiteBright: init(97, 39),
+  bgBlackBright: init(100, 49),
+  bgRedBright: init(101, 49),
+  bgGreenBright: init(102, 49),
+  bgYellowBright: init(103, 49),
+  bgBlueBright: init(104, 49),
+  bgMagentaBright: init(105, 49),
+  bgCyanBright: init(106, 49),
+  bgWhiteBright: init(107, 49)
+};
+function createColors(useColor = isColorSupported) {
+  return useColor ? colorDefs : Object.fromEntries(Object.keys(colorDefs).map((key) => [key, String]));
+}
+const colors = createColors();
+function getColor(color, fallback = "reset") {
+  return colors[color] || colors[fallback];
+}
+function colorize(color, text) {
+  return getColor(color)(text);
+}
+
+const ansiRegex = [
+  String.raw`[\u001B\u009B][[\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\d\/#&.:=?%@~_]+)*|[a-zA-Z\d]+(?:;[-a-zA-Z\d\/#&.:=?%@~_]*)*)?\u0007)`,
+  String.raw`(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))`
+].join("|");
+function stripAnsi(text) {
+  return text.replace(new RegExp(ansiRegex, "g"), "");
+}
+function centerAlign(str, len, space = " ") {
+  const free = len - str.length;
+  if (free <= 0) {
+    return str;
+  }
+  const freeLeft = Math.floor(free / 2);
+  let _str = "";
+  for (let i = 0; i < len; i++) {
+    _str += i < freeLeft || i >= freeLeft + str.length ? space : str[i - freeLeft];
+  }
+  return _str;
+}
+function rightAlign(str, len, space = " ") {
+  const free = len - str.length;
+  if (free <= 0) {
+    return str;
+  }
+  let _str = "";
+  for (let i = 0; i < len; i++) {
+    _str += i < free ? space : str[i - free];
+  }
+  return _str;
+}
+function leftAlign(str, len, space = " ") {
+  let _str = "";
+  for (let i = 0; i < len; i++) {
+    _str += i < str.length ? str[i] : space;
+  }
+  return _str;
+}
+function align(alignment, str, len, space = " ") {
+  switch (alignment) {
+    case "left": {
+      return leftAlign(str, len, space);
+    }
+    case "right": {
+      return rightAlign(str, len, space);
+    }
+    case "center": {
+      return centerAlign(str, len, space);
+    }
+    default: {
+      return str;
+    }
+  }
+}
+
+const boxStylePresets = {
+  solid: {
+    tl: "\u250C",
+    tr: "\u2510",
+    bl: "\u2514",
+    br: "\u2518",
+    h: "\u2500",
+    v: "\u2502"
+  },
+  double: {
+    tl: "\u2554",
+    tr: "\u2557",
+    bl: "\u255A",
+    br: "\u255D",
+    h: "\u2550",
+    v: "\u2551"
+  },
+  doubleSingle: {
+    tl: "\u2553",
+    tr: "\u2556",
+    bl: "\u2559",
+    br: "\u255C",
+    h: "\u2500",
+    v: "\u2551"
+  },
+  doubleSingleRounded: {
+    tl: "\u256D",
+    tr: "\u256E",
+    bl: "\u2570",
+    br: "\u256F",
+    h: "\u2500",
+    v: "\u2551"
+  },
+  singleThick: {
+    tl: "\u250F",
+    tr: "\u2513",
+    bl: "\u2517",
+    br: "\u251B",
+    h: "\u2501",
+    v: "\u2503"
+  },
+  singleDouble: {
+    tl: "\u2552",
+    tr: "\u2555",
+    bl: "\u2558",
+    br: "\u255B",
+    h: "\u2550",
+    v: "\u2502"
+  },
+  singleDoubleRounded: {
+    tl: "\u256D",
+    tr: "\u256E",
+    bl: "\u2570",
+    br: "\u256F",
+    h: "\u2550",
+    v: "\u2502"
+  },
+  rounded: {
+    tl: "\u256D",
+    tr: "\u256E",
+    bl: "\u2570",
+    br: "\u256F",
+    h: "\u2500",
+    v: "\u2502"
+  }
+};
+const defaultStyle = {
+  borderColor: "white",
+  borderStyle: "rounded",
+  valign: "center",
+  padding: 2,
+  marginLeft: 1,
+  marginTop: 1,
+  marginBottom: 1
+};
+function box(text, _opts = {}) {
+  const opts = {
+    ..._opts,
+    style: {
+      ...defaultStyle,
+      ..._opts.style
+    }
+  };
+  const textLines = text.split("\n");
+  const boxLines = [];
+  const _color = getColor(opts.style.borderColor);
+  const borderStyle = {
+    ...typeof opts.style.borderStyle === "string" ? boxStylePresets[opts.style.borderStyle] || boxStylePresets.solid : opts.style.borderStyle
+  };
+  if (_color) {
+    for (const key in borderStyle) {
+      borderStyle[key] = _color(
+        borderStyle[key]
+      );
+    }
+  }
+  const paddingOffset = opts.style.padding % 2 === 0 ? opts.style.padding : opts.style.padding + 1;
+  const height = textLines.length + paddingOffset;
+  const width = Math.max(
+    ...textLines.map((line) => stripAnsi(line).length),
+    opts.title ? stripAnsi(opts.title).length : 0
+  ) + paddingOffset;
+  const widthOffset = width + paddingOffset;
+  const leftSpace = opts.style.marginLeft > 0 ? " ".repeat(opts.style.marginLeft) : "";
+  if (opts.style.marginTop > 0) {
+    boxLines.push("".repeat(opts.style.marginTop));
+  }
+  if (opts.title) {
+    const title = _color ? _color(opts.title) : opts.title;
+    const left = borderStyle.h.repeat(
+      Math.floor((width - stripAnsi(opts.title).length) / 2)
+    );
+    const right = borderStyle.h.repeat(
+      width - stripAnsi(opts.title).length - stripAnsi(left).length + paddingOffset
+    );
+    boxLines.push(
+      `${leftSpace}${borderStyle.tl}${left}${title}${right}${borderStyle.tr}`
+    );
+  } else {
+    boxLines.push(
+      `${leftSpace}${borderStyle.tl}${borderStyle.h.repeat(widthOffset)}${borderStyle.tr}`
+    );
+  }
+  const valignOffset = opts.style.valign === "center" ? Math.floor((height - textLines.length) / 2) : opts.style.valign === "top" ? height - textLines.length - paddingOffset : height - textLines.length;
+  for (let i = 0; i < height; i++) {
+    if (i < valignOffset || i >= valignOffset + textLines.length) {
+      boxLines.push(
+        `${leftSpace}${borderStyle.v}${" ".repeat(widthOffset)}${borderStyle.v}`
+      );
+    } else {
+      const line = textLines[i - valignOffset];
+      const left = " ".repeat(paddingOffset);
+      const right = " ".repeat(width - stripAnsi(line).length);
+      boxLines.push(
+        `${leftSpace}${borderStyle.v}${left}${line}${right}${borderStyle.v}`
+      );
+    }
+  }
+  boxLines.push(
+    `${leftSpace}${borderStyle.bl}${borderStyle.h.repeat(widthOffset)}${borderStyle.br}`
+  );
+  if (opts.style.marginBottom > 0) {
+    boxLines.push("".repeat(opts.style.marginBottom));
+  }
+  return boxLines.join("\n");
+}
+
+exports.align = align;
+exports.box = box;
+exports.centerAlign = centerAlign;
+exports.colorize = colorize;
+exports.colors = colors;
+exports.getColor = getColor;
+exports.leftAlign = leftAlign;
+exports.rightAlign = rightAlign;
+exports.stripAnsi = stripAnsi;

package/packages/shared/node_modules/consola/dist/utils.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+const box = require('./shared/consola.DwRq1yyg.cjs');
+require('node:tty');
+
+function formatTree(items, options) {
+  options = {
+    prefix: "  ",
+    ellipsis: "...",
+    ...options
+  };
+  const tree = _buildTree(items, options).join("");
+  if (options && options.color) {
+    return box.colorize(options.color, tree);
+  }
+  return tree;
+}
+function _buildTree(items, options) {
+  const chunks = [];
+  const total = items.length - 1;
+  for (let i = 0; i <= total; i++) {
+    const item = items[i];
+    const isItemString = typeof item === "string";
+    const isLimit = options?.maxDepth != null && options.maxDepth <= 0;
+    if (isLimit) {
+      const ellipsis = `${options.prefix}${options.ellipsis}
+`;
+      return [
+        isItemString ? ellipsis : item.color ? box.colorize(item.color, ellipsis) : ellipsis
+        // prettier-ignore
+      ];
+    }
+    const isLast = i === total;
+    const prefix = isLast ? `${options?.prefix}\u2514\u2500` : `${options?.prefix}\u251C\u2500`;
+    if (isItemString) {
+      chunks.push(`${prefix}${item}
+`);
+    } else {
+      const log = `${prefix}${item.text}
+`;
+      chunks.push(item.color ? box.colorize(item.color, log) : log);
+      if (item.children) {
+        const _tree = _buildTree(item.children, {
+          ...options,
+          maxDepth: options?.maxDepth == null ? void 0 : options.maxDepth - 1,
+          prefix: `${options?.prefix}${isLast ? "  " : "\u2502  "}`
+        });
+        chunks.push(..._tree);
+      }
+    }
+  }
+  return chunks;
+}
+
+exports.align = box.align;
+exports.box = box.box;
+exports.centerAlign = box.centerAlign;
+exports.colorize = box.colorize;
+exports.colors = box.colors;
+exports.getColor = box.getColor;
+exports.leftAlign = box.leftAlign;
+exports.rightAlign = box.rightAlign;
+exports.stripAnsi = box.stripAnsi;
+exports.formatTree = formatTree;

package/packages/shared/node_modules/consola/dist/utils.d.cts

@@ -0,0 +1,286 @@
+type BoxBorderStyle = {
+    /**
+     * Top left corner
+     * @example `┌`
+     * @example `╔`
+     * @example `╓`
+     */
+    tl: string;
+    /**
+     * Top right corner
+     * @example `┐`
+     * @example `╗`
+     * @example `╖`
+     */
+    tr: string;
+    /**
+     * Bottom left corner
+     * @example `└`
+     * @example `╚`
+     * @example `╙`
+     */
+    bl: string;
+    /**
+     * Bottom right corner
+     * @example `┘`
+     * @example `╝`
+     * @example `╜`
+     */
+    br: string;
+    /**
+     * Horizontal line
+     * @example `─`
+     * @example `═`
+     * @example `─`
+     */
+    h: string;
+    /**
+     * Vertical line
+     * @example `│`
+     * @example `║`
+     * @example `║`
+     */
+    v: string;
+};
+declare const boxStylePresets: Record<string, BoxBorderStyle>;
+type BoxStyle = {
+    /**
+     * The border color
+     * @default 'white'
+     */
+    borderColor: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright";
+    /**
+     * The border style
+     * @default 'solid'
+     * @example 'single-double-rounded'
+     * @example
+     * ```ts
+     * {
+     *   tl: '┌',
+     *   tr: '┐',
+     *   bl: '└',
+     *   br: '┘',
+     *   h: '─',
+     *   v: '│',
+     * }
+     * ```
+     */
+    borderStyle: BoxBorderStyle | keyof typeof boxStylePresets;
+    /**
+     * The vertical alignment of the text
+     * @default 'center'
+     */
+    valign: "top" | "center" | "bottom";
+    /**
+     * The padding of the box
+     * @default 2
+     */
+    padding: number;
+    /**
+     * The left margin of the box
+     * @default 1
+     */
+    marginLeft: number;
+    /**
+     * The top margin of the box
+     * @default 1
+     */
+    marginTop: number;
+    /**
+     * The top margin of the box
+     * @default 1
+     */
+    marginBottom: number;
+};
+/**
+ * The border options of the box
+ */
+type BoxOpts = {
+    /**
+     * Title that will be displayed on top of the box
+     * @example 'Hello World'
+     * @example 'Hello {name}'
+     */
+    title?: string;
+    style?: Partial<BoxStyle>;
+};
+/**
+ * Creates a styled box with text content, customisable via options.
+ * @param {string} text - The text to display in the box.
+ * @param {BoxOpts} [_opts={}] - Optional settings for the appearance and behaviour of the box. See {@link BoxOpts}.
+ * @returns {string} The formatted box as a string, ready for printing or logging.
+ */
+declare function box(text: string, _opts?: BoxOpts): string;
+
+/**
+ * Based on https://github.com/jorgebucaran/colorette
+ * Read LICENSE file for more information
+ * https://github.com/jorgebucaran/colorette/blob/20fc196d07d0f87c61e0256eadd7831c79b24108/index.js
+ */
+declare const colorDefs: {
+    reset: (string: string) => string;
+    bold: (string: string) => string;
+    dim: (string: string) => string;
+    italic: (string: string) => string;
+    underline: (string: string) => string;
+    inverse: (string: string) => string;
+    hidden: (string: string) => string;
+    strikethrough: (string: string) => string;
+    black: (string: string) => string;
+    red: (string: string) => string;
+    green: (string: string) => string;
+    yellow: (string: string) => string;
+    blue: (string: string) => string;
+    magenta: (string: string) => string;
+    cyan: (string: string) => string;
+    white: (string: string) => string;
+    gray: (string: string) => string;
+    bgBlack: (string: string) => string;
+    bgRed: (string: string) => string;
+    bgGreen: (string: string) => string;
+    bgYellow: (string: string) => string;
+    bgBlue: (string: string) => string;
+    bgMagenta: (string: string) => string;
+    bgCyan: (string: string) => string;
+    bgWhite: (string: string) => string;
+    blackBright: (string: string) => string;
+    redBright: (string: string) => string;
+    greenBright: (string: string) => string;
+    yellowBright: (string: string) => string;
+    blueBright: (string: string) => string;
+    magentaBright: (string: string) => string;
+    cyanBright: (string: string) => string;
+    whiteBright: (string: string) => string;
+    bgBlackBright: (string: string) => string;
+    bgRedBright: (string: string) => string;
+    bgGreenBright: (string: string) => string;
+    bgYellowBright: (string: string) => string;
+    bgBlueBright: (string: string) => string;
+    bgMagentaBright: (string: string) => string;
+    bgCyanBright: (string: string) => string;
+    bgWhiteBright: (string: string) => string;
+};
+type ColorName = keyof typeof colorDefs;
+type ColorFunction = (text: string | number) => string;
+/**
+ * An object containing functions for colouring text. Each function corresponds to a terminal colour. See {@link ColorName} for available colours.
+ */
+declare const colors: Record<ColorName, ColorFunction>;
+/**
+ * Gets a colour function by name, with an option for a fallback colour if the requested colour is not found.
+ * @param {ColorName} color - The name of the colour function to get. See {@link ColorName}.
+ * @param {ColorName} [fallback="reset"] - The name of the fallback colour function if the requested colour is not found. See {@link ColorName}.
+ * @returns {ColorFunction} The colour function that corresponds to the requested colour, or the fallback colour function. See {@link ColorFunction}.
+ */
+declare function getColor(color: ColorName, fallback?: ColorName): ColorFunction;
+/**
+ * Applies a specified colour to a given text string or number.
+ * @param {ColorName} color - The colour to apply. See {@link ColorName}.
+ * @param {string | number} text - The text to colour.
+ * @returns {string} The coloured text.
+ */
+declare function colorize(color: ColorName, text: string | number): string;
+
+/**
+ * Removes ANSI escape codes from a given string. This is particularly useful for
+ * processing text that contains formatting codes, such as colours or styles, so that the
+ * the raw text without any visual formatting.
+ *
+ * @param {string} text - The text string from which to strip the ANSI escape codes.
+ * @returns {string} The text without ANSI escape codes.
+ */
+declare function stripAnsi(text: string): string;
+/**
+ * Centers a string within a specified total width, padding it with spaces or another specified character.
+ * If the string is longer than the total width, it is returned as is.
+ *
+ * @param {string} str - The string to centre.
+ * @param {number} len - The total width in which to centre the string.
+ * @param {string} [space=" "] - The character to use for padding. Defaults to a space.
+ * @returns {string} The centred string.
+ */
+declare function centerAlign(str: string, len: number, space?: string): string;
+/**
+ * Right-justifies a string within a given total width, padding it with whitespace or another specified character.
+ * If the string is longer than the total width, it is returned as is.
+ *
+ * @param {string} str - The string to right-justify.
+ * @param {number} len - The total width to align the string.
+ * @param {string} [space=" "] - The character to use for padding. Defaults to a space.
+ * @returns {string} The right-justified string.
+ */
+declare function rightAlign(str: string, len: number, space?: string): string;
+/**
+ * Left-aligns a string within a given total width, padding it with whitespace or another specified character on the right.
+ * If the string is longer than the total width, it is returned as is.
+ *
+ * @param {string} str - The string to align left.
+ * @param {number} len - The total width to align the string.
+ * @param {string} [space=" "] - The character to use for padding. Defaults to a space.
+ * @returns {string} The left-justified string.
+ */
+declare function leftAlign(str: string, len: number, space?: string): string;
+/**
+ * Aligns a string (left, right, or centre) within a given total width, padding it with spaces or another specified character.
+ * If the string is longer than the total width, it is returned as is. This function acts as a wrapper for individual alignment functions.
+ *
+ * @param {"left" | "right" | "centre"} alignment - The desired alignment of the string.
+ * @param {string} str - The string to align.
+ * @param {number} len - The total width in which to align the string.
+ * @param {string} [space=" "] - The character to use for padding. Defaults to a space.
+ * @returns {string} The aligned string, according to the given alignment.
+ */
+declare function align(alignment: "left" | "right" | "center", str: string, len: number, space?: string): string;
+
+type TreeItemObject = {
+    /**
+     * Text of the item
+     */
+    text: string;
+    /**
+     * Children of the item
+     */
+    children?: TreeItem[];
+    /**
+     * Color of the item
+     */
+    color?: ColorName;
+};
+type TreeItem = string | TreeItemObject;
+type TreeOptions = {
+    /**
+     * Color of the tree
+     */
+    color?: ColorName;
+    /**
+     * Prefix of the tree
+     *
+     * @default "  "
+     */
+    prefix?: string;
+    /**
+     * The max depth of tree
+     */
+    maxDepth?: number;
+    /**
+     * Ellipsis of the tree
+     *
+     * @default "..."
+     */
+    ellipsis?: string;
+};
+/**
+ * Formats a hierarchical list of items into a string representing a tree structure.
+ * Each item in the tree can be a simple string or an object defining the text of the item,
+ * optional children, and colour. The tree structure can be customised with options
+ * Specify the overall colour and the prefix used for indentation and tree lines.
+ *
+ * @param {TreeItem[]} items - An array of items to include in the tree. Each item can be
+ * either a string or an object with `text', `children' and `colour' properties.
+ * @param {TreeOptions} [options] - Optional settings to customise the appearance of the tree, including
+ * the colour of the tree text and the prefix for branches. See {@link TreeOptions}.
+ * @returns {string} The formatted tree as a string, ready for printing to the console or elsewhere.
+ */
+declare function formatTree(items: TreeItem[], options?: TreeOptions): string;
+
+export { type BoxBorderStyle, type BoxOpts, type BoxStyle, type ColorFunction, type ColorName, type TreeItem, type TreeItemObject, type TreeOptions, align, box, centerAlign, colorize, colors, formatTree, getColor, leftAlign, rightAlign, stripAnsi };