@jsenv/humanize 1.5.2 → 1.7.0

package/src/js_value/number.js

@@ -1,101 +0,0 @@
-// https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/rules/numeric-separators-style.js
-
-export const inspectNumber = (value, { numericSeparator }) => {
-  if (isNegativeZero(value)) {
-    return "-0";
-  }
-  // isNaN
-  // eslint-disable-next-line no-self-compare
-  if (value !== value) {
-    return "NaN";
-  }
-  if (value === Infinity) {
-    return "Infinity";
-  }
-  if (value === -Infinity) {
-    return "-Infinity";
-  }
-  const numberString = String(value);
-  if (!numericSeparator) {
-    return numberString;
-  }
-  const {
-    number,
-    mark = "",
-    sign = "",
-    power = "",
-  } = numberString.match(
-    /^(?<number>.*?)(?:(?<mark>e)(?<sign>[+-])?(?<power>\d+))?$/i,
-  ).groups;
-  const numberWithSeparators = formatNumber(number);
-  const powerWithSeparators = addSeparator(power, {
-    minimumDigits: 5,
-    groupLength: 3,
-  });
-  return `${numberWithSeparators}${mark}${sign}${powerWithSeparators}`;
-};
-
-// Use this and instead of Object.is(value, -0)
-// because in some corner cases firefox returns false
-// for Object.is(-0, -0)
-const isNegativeZero = (value) => {
-  return value === 0 && 1 / value === -Infinity;
-};
-
-const formatNumber = (numberString) => {
-  const parts = numberString.split(".");
-  const [integer, fractional] = parts;
-
-  if (parts.length === 2) {
-    const integerWithSeparators = addSeparator(integer, {
-      minimumDigits: 5,
-      groupLength: 3,
-    });
-    return `${integerWithSeparators}.${fractional}`;
-  }
-
-  return addSeparator(integer, {
-    minimumDigits: 5,
-    groupLength: 3,
-  });
-};
-
-const addSeparator = (numberString, { minimumDigits, groupLength }) => {
-  if (numberString[0] === "-") {
-    return `-${groupDigits(numberString.slice(1), {
-      minimumDigits,
-      groupLength,
-    })}`;
-  }
-  return groupDigits(numberString, { minimumDigits, groupLength });
-};
-
-const groupDigits = (digits, { minimumDigits, groupLength }) => {
-  const digitCount = digits.length;
-  if (digitCount < minimumDigits) {
-    return digits;
-  }
-
-  let digitsWithSeparator = digits.slice(-groupLength);
-  let remainingDigits = digits.slice(0, -groupLength);
-  while (remainingDigits.length) {
-    const group = remainingDigits.slice(-groupLength);
-    remainingDigits = remainingDigits.slice(0, -groupLength);
-    digitsWithSeparator = `${group}_${digitsWithSeparator}`;
-  }
-  return digitsWithSeparator;
-};
-
-// const addSeparatorFromLeft = (value, { minimumDigits, groupLength }) => {
-//   const { length } = value;
-//   if (length < minimumDigits) {
-//     return value;
-//   }
-
-//   const parts = [];
-//   for (let start = 0; start < length; start += groupLength) {
-//     const end = Math.min(start + groupLength, length);
-//     parts.push(value.slice(start, end));
-//   }
-//   return parts.join("_");
-// };

package/src/js_value/number_object.js

@@ -1,9 +0,0 @@
-import { inspectConstructor } from "./constructor.js";
-
-export const inspectNumberObject = (
-  value,
-  { nestedHumanize, useNew, parenthesis },
-) => {
-  const numberSource = nestedHumanize(value.valueOf());
-  return inspectConstructor(`Number(${numberSource})`, { useNew, parenthesis });
-};

package/src/js_value/object.js

@@ -1,78 +0,0 @@
-import {
-  preNewLineAndIndentation,
-  wrapNewLineAndIndentation,
-} from "../utils/indentation.js";
-import { inspectConstructor } from "./constructor.js";
-
-export const inspectObject = (
-  value,
-  {
-    nestedHumanize,
-    seen = [],
-    depth,
-    indentUsingTab,
-    indentSize,
-    objectConstructor,
-    parenthesis,
-    useNew,
-  },
-) => {
-  if (seen.indexOf(value) > -1) return "Symbol.for('circular')";
-
-  seen.push(value);
-
-  const propertySourceArray = [];
-  Object.getOwnPropertyNames(value).forEach((propertyName) => {
-    const propertyNameAsNumber = parseInt(propertyName, 10);
-    const propertyNameSource = nestedHumanize(
-      Number.isInteger(propertyNameAsNumber)
-        ? propertyNameAsNumber
-        : propertyName,
-    );
-    propertySourceArray.push({
-      nameOrSymbolSource: propertyNameSource,
-      valueSource: nestedHumanize(value[propertyName], { seen }),
-    });
-  });
-  Object.getOwnPropertySymbols(value).forEach((symbol) => {
-    propertySourceArray.push({
-      nameOrSymbolSource: `[${nestedHumanize(symbol)}]`,
-      valueSource: nestedHumanize(value[symbol], { seen }),
-    });
-  });
-
-  let propertiesSource = "";
-  propertySourceArray.forEach(({ nameOrSymbolSource, valueSource }, index) => {
-    if (index === 0) {
-      propertiesSource += `${nameOrSymbolSource}: ${valueSource}`;
-    } else {
-      propertiesSource += `,${preNewLineAndIndentation(
-        `${nameOrSymbolSource}: ${valueSource}`,
-        {
-          depth,
-          indentUsingTab,
-          indentSize,
-        },
-      )}`;
-    }
-  });
-
-  let objectSource;
-  if (propertiesSource.length) {
-    objectSource = `${wrapNewLineAndIndentation(propertiesSource, {
-      depth,
-      indentUsingTab,
-      indentSize,
-    })}`;
-  } else {
-    objectSource = "";
-  }
-
-  if (objectConstructor) {
-    objectSource = `Object({${objectSource}})`;
-  } else {
-    objectSource = `{${objectSource}}`;
-  }
-
-  return inspectConstructor(objectSource, { parenthesis, useNew });
-};

package/src/js_value/regexp.js

@@ -1 +0,0 @@
-export const inspectRegExp = (value) => value.toString();

package/src/js_value/string.js

@@ -1,141 +0,0 @@
-const DOUBLE_QUOTE = `"`;
-const SINGLE_QUOTE = `'`;
-const BACKTICK = "`";
-
-export const inspectString = (
-  value,
-  {
-    quote = "auto",
-    canUseTemplateString = false,
-    preserveLineBreaks = false,
-    quoteDefault = DOUBLE_QUOTE,
-  } = {},
-) => {
-  quote =
-    quote === "auto"
-      ? determineQuote(value, { canUseTemplateString, quoteDefault })
-      : quote;
-  if (quote === BACKTICK) {
-    return `\`${escapeTemplateStringSpecialCharacters(value)}\``;
-  }
-  return surroundStringWith(value, { quote, preserveLineBreaks });
-};
-
-// https://github.com/mgenware/string-to-template-literal/blob/main/src/main.ts#L1
-const escapeTemplateStringSpecialCharacters = (string) => {
-  string = String(string);
-  let i = 0;
-  let escapedString = "";
-  while (i < string.length) {
-    const char = string[i];
-    i++;
-    escapedString += isTemplateStringSpecialChar(char) ? `\\${char}` : char;
-  }
-  return escapedString;
-};
-
-const isTemplateStringSpecialChar = (char) =>
-  templateStringSpecialChars.indexOf(char) > -1;
-const templateStringSpecialChars = ["\\", "`", "$"];
-
-export const determineQuote = (
-  string,
-  { canUseTemplateString, quoteDefault = DOUBLE_QUOTE } = {},
-) => {
-  const containsDoubleQuote = string.includes(DOUBLE_QUOTE);
-  if (!containsDoubleQuote) {
-    return DOUBLE_QUOTE;
-  }
-  const containsSimpleQuote = string.includes(SINGLE_QUOTE);
-  if (!containsSimpleQuote) {
-    return SINGLE_QUOTE;
-  }
-  if (canUseTemplateString) {
-    const containsBackTick = string.includes(BACKTICK);
-    if (!containsBackTick) {
-      return BACKTICK;
-    }
-  }
-  const doubleQuoteCount = string.split(DOUBLE_QUOTE).length - 1;
-  const singleQuoteCount = string.split(SINGLE_QUOTE).length - 1;
-  if (singleQuoteCount > doubleQuoteCount) {
-    return DOUBLE_QUOTE;
-  }
-  if (doubleQuoteCount > singleQuoteCount) {
-    return SINGLE_QUOTE;
-  }
-  return quoteDefault;
-};
-
-const inspectChar = (char, { quote, preserveLineBreaks }) => {
-  const point = char.charCodeAt(0);
-  if (preserveLineBreaks && (char === "\n" || char === "\r")) {
-    return char;
-  }
-  if (
-    char === quote ||
-    point === 92 ||
-    point < 32 ||
-    (point > 126 && point < 160) ||
-    // line separators
-    point === 8232 ||
-    point === 8233
-  ) {
-    const replacement =
-      char === quote
-        ? `\\${quote}`
-        : point === 8232
-          ? "\\u2028"
-          : point === 8233
-            ? "\\u2029"
-            : meta[point];
-    return replacement;
-  }
-  return char;
-};
-
-// https://github.com/jsenv/jsenv-uneval/blob/6c97ef9d8f2e9425a66f2c88347e0a118d427f3a/src/internal/escapeString.js#L3
-// https://github.com/jsenv/jsenv-inspect/blob/bb11de3adf262b68f71ed82b0a37d4528dd42229/src/internal/string.js#L3
-// https://github.com/joliss/js-string-escape/blob/master/index.js
-// http://javascript.crockford.com/remedial.html
-const surroundStringWith = (string, { quote, preserveLineBreaks }) => {
-  let result = "";
-  let last = 0;
-  const lastIndex = string.length;
-  let i = 0;
-  while (i < lastIndex) {
-    const char = string[i];
-    const replacement = inspectChar(char, { quote, preserveLineBreaks });
-    if (char !== replacement) {
-      if (last === i) {
-        result += replacement;
-      } else {
-        result += `${string.slice(last, i)}${replacement}`;
-      }
-      last = i + 1;
-    }
-    i++;
-  }
-  if (last !== lastIndex) {
-    result += string.slice(last);
-  }
-  return `${quote}${result}${quote}`;
-};
-
-// prettier-ignore
-const meta = [
-  '\\x00', '\\x01', '\\x02', '\\x03', '\\x04', '\\x05', '\\x06', '\\x07', // x07
-  '\\b', '\\t', '\\n', '\\x0B', '\\f', '\\r', '\\x0E', '\\x0F',           // x0F
-  '\\x10', '\\x11', '\\x12', '\\x13', '\\x14', '\\x15', '\\x16', '\\x17', // x17
-  '\\x18', '\\x19', '\\x1A', '\\x1B', '\\x1C', '\\x1D', '\\x1E', '\\x1F', // x1F
-  '', '', '', '', '', '', '', "\\'", '', '', '', '', '', '', '', '',      // x2F
-  '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',         // x3F
-  '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',         // x4F
-  '', '', '', '', '', '', '', '', '', '', '', '', '\\\\', '', '', '',     // x5F
-  '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',         // x6F
-  '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '\\x7F',    // x7F
-  '\\x80', '\\x81', '\\x82', '\\x83', '\\x84', '\\x85', '\\x86', '\\x87', // x87
-  '\\x88', '\\x89', '\\x8A', '\\x8B', '\\x8C', '\\x8D', '\\x8E', '\\x8F', // x8F
-  '\\x90', '\\x91', '\\x92', '\\x93', '\\x94', '\\x95', '\\x96', '\\x97', // x97
-  '\\x98', '\\x99', '\\x9A', '\\x9B', '\\x9C', '\\x9D', '\\x9E', '\\x9F', // x9F
-];

package/src/js_value/string_object.js

@@ -1,10 +0,0 @@
-import { inspectConstructor } from "./constructor.js";
-
-export const inspectStringObject = (
-  value,
-  { nestedHumanize, useNew, parenthesis },
-) => {
-  const stringSource = nestedHumanize(value.valueOf());
-
-  return inspectConstructor(`String(${stringSource})`, { useNew, parenthesis });
-};

package/src/js_value/symbol.js

@@ -1,24 +0,0 @@
-export const inspectSymbol = (value, { nestedHumanize, parenthesis }) => {
-  const symbolDescription = symbolToDescription(value);
-  const symbolDescriptionSource = symbolDescription
-    ? nestedHumanize(symbolDescription)
-    : "";
-  const symbolSource = `Symbol(${symbolDescriptionSource})`;
-
-  if (parenthesis) return `${symbolSource}`;
-  return symbolSource;
-};
-
-const symbolToDescription =
-  "description" in Symbol.prototype
-    ? (symbol) => symbol.description
-    : (symbol) => {
-        const toStringResult = symbol.toString();
-        const openingParenthesisIndex = toStringResult.indexOf("(");
-        const closingParenthesisIndex = toStringResult.indexOf(")");
-        const symbolDescription = toStringResult.slice(
-          openingParenthesisIndex + 1,
-          closingParenthesisIndex,
-        );
-        return symbolDescription;
-      };

package/src/js_value/undefined.js

@@ -1 +0,0 @@
-export const inspectUndefined = () => "undefined";

package/src/log/LOG_LEVELS.js

@@ -1,9 +0,0 @@
-export const LOG_LEVEL_OFF = "off";
-
-export const LOG_LEVEL_DEBUG = "debug";
-
-export const LOG_LEVEL_INFO = "info";
-
-export const LOG_LEVEL_WARN = "warn";
-
-export const LOG_LEVEL_ERROR = "error";

package/src/log/call_orderer.js

@@ -1,39 +0,0 @@
-export const createCallOrderer = () => {
-  const queue = [];
-  const callWhenPreviousExecutionAreDone = (executionIndex, callback) => {
-    if (queue[executionIndex]) {
-      throw new Error(`${executionIndex} already used`);
-    }
-
-    let allBeforeAreDone = true;
-    if (executionIndex > 0) {
-      let beforeIndex = executionIndex - 1;
-      do {
-        const value = queue[beforeIndex];
-        if (!value) {
-          allBeforeAreDone = false;
-          break;
-        }
-      } while (beforeIndex--);
-    }
-    if (!allBeforeAreDone) {
-      queue[executionIndex] = callback;
-      return;
-    }
-    queue[executionIndex] = true;
-    callback();
-    let afterIndex = executionIndex + 1;
-    while (afterIndex < queue.length) {
-      const value = queue[afterIndex];
-      if (value === undefined) {
-        break;
-      }
-      if (typeof value === "function") {
-        queue[afterIndex] = true;
-        value();
-      }
-      afterIndex++;
-    }
-  };
-  return callWhenPreviousExecutionAreDone;
-};

package/src/log/detailed_message.js

@@ -1,29 +0,0 @@
-export const createDetailedMessage = (message, details = {}) => {
-  let text = `${message}`;
-  const namedSectionsText = renderNamedSections(details);
-  if (namedSectionsText) {
-    text += `
-${namedSectionsText}`;
-  }
-  return text;
-};
-
-export const renderNamedSections = (namedSections) => {
-  let text = "";
-  let keys = Object.keys(namedSections);
-  for (const key of keys) {
-    const isLastKey = key === keys[keys.length - 1];
-    const value = namedSections[key];
-    text += `--- ${key} ---
-${
-  Array.isArray(value)
-    ? value.join(`
-`)
-    : value
-}`;
-    if (!isLastKey) {
-      text += "\n";
-    }
-  }
-  return text;
-};

package/src/log/details.js

@@ -1,26 +0,0 @@
-import { ANSI } from "../ansi/ansi_node.js";
-
-export const renderDetails = (data) => {
-  const details = [];
-  for (const key of Object.keys(data)) {
-    const value = data[key];
-    let valueString = "";
-    valueString += ANSI.color(`${key}:`, ANSI.GREY);
-    const useNonGreyAnsiColor =
-      typeof value === "string" && value.includes("\x1b");
-    valueString += " ";
-    valueString += useNonGreyAnsiColor
-      ? value
-      : ANSI.color(String(value), ANSI.GREY);
-    details.push(valueString);
-  }
-  if (details.length === 0) {
-    return "";
-  }
-
-  let string = "";
-  string += ` ${ANSI.color("(", ANSI.GREY)}`;
-  string += details.join(ANSI.color(", ", ANSI.GREY));
-  string += ANSI.color(")", ANSI.GREY);
-  return string;
-};

package/src/log/dynamic_log.js

@@ -1,186 +0,0 @@
-/*
- * see also https://github.com/vadimdemedes/ink
- */
-
-import { measureTextWidth } from "@jsenv/terminal-text-size";
-import ansiEscapes from "ansi-escapes";
-
-export const createDynamicLog = ({
-  stream = process.stdout,
-  clearTerminalAllowed,
-  onVerticalOverflow = () => {},
-  onWriteFromOutside = () => {},
-} = {}) => {
-  const { columns = 80, rows = 24 } = stream;
-  const dynamicLog = {
-    destroyed: false,
-    onVerticalOverflow,
-    onWriteFromOutside,
-  };
-
-  let lastOutput = "";
-  let lastOutputFromOutside = "";
-  let clearAttemptResult;
-  let writing = false;
-
-  const getErasePreviousOutput = () => {
-    // nothing to clear
-    if (!lastOutput) {
-      return "";
-    }
-    if (clearAttemptResult !== undefined) {
-      return "";
-    }
-
-    const logLines = lastOutput.split(/\r\n|\r|\n/);
-    let visualLineCount = 0;
-    for (const logLine of logLines) {
-      const width = measureTextWidth(logLine);
-      if (width === 0) {
-        visualLineCount++;
-      } else {
-        visualLineCount += Math.ceil(width / columns);
-      }
-    }
-
-    if (visualLineCount > rows) {
-      if (clearTerminalAllowed) {
-        clearAttemptResult = true;
-        return ansiEscapes.clearTerminal;
-      }
-      // the whole log cannot be cleared because it's vertically to long
-      // (longer than terminal height)
-      // readline.moveCursor cannot move cursor higher than screen height
-      // it means we would only clear the visible part of the log
-      // better keep the log untouched
-      clearAttemptResult = false;
-      dynamicLog.onVerticalOverflow();
-      return "";
-    }
-
-    clearAttemptResult = true;
-    return ansiEscapes.eraseLines(visualLineCount);
-  };
-
-  const update = (string) => {
-    if (dynamicLog.destroyed) {
-      throw new Error("Cannot write log after destroy");
-    }
-    let stringToWrite = string;
-    if (lastOutput) {
-      if (lastOutputFromOutside) {
-        // We don't want to clear logs written by other code,
-        // it makes output unreadable and might erase precious information
-        // To detect this we put a spy on the stream.
-        // The spy is required only if we actually wrote something in the stream
-        // something else than this code has written in the stream
-        // so we just write without clearing (append instead of replacing)
-        lastOutput = "";
-        lastOutputFromOutside = "";
-      } else {
-        stringToWrite = `${getErasePreviousOutput()}${string}`;
-      }
-    }
-    writing = true;
-    stream.write(stringToWrite);
-    lastOutput = string;
-    writing = false;
-    clearAttemptResult = undefined;
-  };
-
-  const clearDuringFunctionCall = (
-    callback,
-    ouputAfterCallback = lastOutput,
-  ) => {
-    // 1. Erase the current log
-    // 2. Call callback (expect to write something on stdout)
-    // 3. Restore the current log
-    // During step 2. we expect a "write from outside" so we uninstall
-    // the stream spy during function call
-    update("");
-
-    writing = true;
-    callback(update);
-    lastOutput = "";
-    writing = false;
-
-    update(ouputAfterCallback);
-  };
-
-  const writeFromOutsideEffect = (value) => {
-    if (!lastOutput) {
-      // we don't care if the log never wrote anything
-      // or if last update() wrote an empty string
-      return;
-    }
-    if (writing) {
-      return;
-    }
-    lastOutputFromOutside = value;
-    dynamicLog.onWriteFromOutside(value);
-  };
-
-  let removeStreamSpy;
-  if (stream === process.stdout) {
-    const removeStdoutSpy = spyStreamOutput(
-      process.stdout,
-      writeFromOutsideEffect,
-    );
-    const removeStderrSpy = spyStreamOutput(
-      process.stderr,
-      writeFromOutsideEffect,
-    );
-    removeStreamSpy = () => {
-      removeStdoutSpy();
-      removeStderrSpy();
-    };
-  } else {
-    removeStreamSpy = spyStreamOutput(stream, writeFromOutsideEffect);
-  }
-
-  const destroy = () => {
-    dynamicLog.destroyed = true;
-    if (removeStreamSpy) {
-      removeStreamSpy();
-      removeStreamSpy = null;
-      lastOutput = "";
-      lastOutputFromOutside = "";
-    }
-  };
-
-  Object.assign(dynamicLog, {
-    update,
-    destroy,
-    stream,
-    clearDuringFunctionCall,
-  });
-  return dynamicLog;
-};
-
-// maybe https://github.com/gajus/output-interceptor/tree/v3.0.0 ?
-// the problem with listening data on stdout
-// is that node.js will later throw error if stream gets closed
-// while something listening data on it
-const spyStreamOutput = (stream, callback) => {
-  let output = "";
-  let installed = true;
-  const originalWrite = stream.write;
-  stream.write = function (...args /* chunk, encoding, callback */) {
-    output += args;
-    callback(output);
-    return originalWrite.call(this, ...args);
-  };
-
-  const uninstall = () => {
-    if (!installed) {
-      return;
-    }
-    stream.write = originalWrite;
-    installed = false;
-  };
-
-  return () => {
-    uninstall();
-    return output;
-  };
-};