@jsenv/core 23.2.2 → 23.3.0

package/src/abort/process_teardown_events.js

@@ -1,59 +0,0 @@
-import { raceCallbacks } from "./callback_race.js"
-
-export const raceProcessTeardownEvents = (processTeardownEvents, callback) => {
-  return raceCallbacks(
-    {
-      ...(processTeardownEvents.SIGHUP ? SIGHUP_CALLBACK : {}),
-      ...(processTeardownEvents.SIGTERM ? SIGTERM_CALLBACK : {}),
-      ...(processTeardownEvents.SIGINT ? SIGINT_CALLBACK : {}),
-      ...(processTeardownEvents.beforeExit ? BEFORE_EXIT_CALLBACK : {}),
-      ...(processTeardownEvents.exit ? EXIT_CALLBACK : {}),
-    },
-    callback,
-  )
-}
-
-const SIGHUP_CALLBACK = {
-  SIGHUP: (cb) => {
-    process.on("SIGHUP", cb)
-    return () => {
-      process.removeListener("SIGHUP", cb)
-    }
-  },
-}
-
-const SIGTERM_CALLBACK = {
-  SIGTERM: (cb) => {
-    process.on("SIGTERM", cb)
-    return () => {
-      process.removeListener("SIGTERM", cb)
-    }
-  },
-}
-
-const BEFORE_EXIT_CALLBACK = {
-  beforeExit: (cb) => {
-    process.on("beforeExit", cb)
-    return () => {
-      process.removeListener("beforeExit", cb)
-    }
-  },
-}
-
-const EXIT_CALLBACK = {
-  exit: (cb) => {
-    process.on("exit", cb)
-    return () => {
-      process.removeListener("exit", cb)
-    }
-  },
-}
-
-const SIGINT_CALLBACK = {
-  SIGINT: (cb) => {
-    process.on("SIGINT", cb)
-    return () => {
-      process.removeListener("SIGINT", cb)
-    }
-  },
-}

package/src/internal/createCallbackList.js

@@ -1,21 +0,0 @@
-export const createCallbackList = () => {
-  const callbackSet = new Set()
-
-  const register = (callback) => {
-    callbackSet.add(callback)
-    return () => {
-      callbackSet.delete(callback)
-    }
-  }
-
-  const notify = (...args) => {
-    callbackSet.forEach((callback) => {
-      callback(...args)
-    })
-  }
-
-  return {
-    register,
-    notify,
-  }
-}

package/src/internal/executing/logUtils.js

@@ -1,30 +0,0 @@
-// https://github.com/yarnpkg/yarn/blob/master/src/reporters/console/util.js
-// https://github.com/yarnpkg/yarn/blob/master/src/reporters/console/progress-bar.js
-// https://github.com/sindresorhus/log-update/blob/master/index.js
-// see https://github.com/jsenv/jsenv-core/issues/59
-import readline from "node:readline"
-import tty from "node:tty"
-
-import { createSupportsColor } from "supports-color"
-
-const CLEAR_WHOLE_LINE = 0
-
-export const clearLine = (stdout = process.stdout) => {
-  if (createSupportsColor(stdout)) {
-    readline.clearLine(stdout, CLEAR_WHOLE_LINE)
-    readline.cursorTo(stdout, 0)
-  } else if (stdout instanceof tty.WriteStream) {
-    if (stdout.columns > 0) {
-      stdout.write(`\r${" ".repeat(stdout.columns - 1)}`)
-    }
-    stdout.write(`\r`)
-  }
-}
-
-export const toStartOfLine = (stdout = process.stdout) => {
-  if (createSupportsColor(stdout)) {
-    readline.cursorTo(stdout, 0)
-  } else {
-    stdout.write("\r")
-  }
-}

package/src/internal/executing/writeLog.js

@@ -1,106 +0,0 @@
-import readline from "readline"
-
-import stringWidth from "string-width"
-import { memoize } from "@jsenv/filesystem"
-
-export const writeLog = (
-  string,
-  { mightUpdate = true, stream = process.stdout } = {},
-) => {
-  string = `${string}
-`
-  stream.write(string)
-
-  const moveCursorToLineAbove = () => {
-    readline.moveCursor(stream, 0, -1)
-  }
-
-  const clearCursorLine = () => {
-    readline.clearLine(stream, 0)
-  }
-
-  const remove = memoize(() => {
-    const { columns = 80, rows = 24 } = stream
-    const logLines = string.split(/\r\n|\r|\n/)
-    let visualLineCount = 0
-    logLines.forEach((logLine) => {
-      const width = stringWidth(logLine)
-      visualLineCount += width === 0 ? 1 : Math.ceil(width / columns)
-    })
-
-    if (visualLineCount > rows) {
-      // 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
-      return
-    }
-
-    while (visualLineCount--) {
-      clearCursorLine()
-      if (visualLineCount > 0) {
-        moveCursorToLineAbove()
-      }
-    }
-    // an other version of the while above could the code below
-    // readline.moveCursor(stream, 0, -visualLineCount)
-    // readline.clearScreenDown(stream)
-  })
-
-  if (mightUpdate) {
-    const consoleModified = spyConsoleModification()
-
-    let updated = false
-    const update = (newString) => {
-      if (updated) {
-        console.warn(`cannot update twice`)
-        return null
-      }
-      updated = true
-
-      if (!consoleModified()) {
-        remove()
-      }
-      return writeLog(newString, { stream })
-    }
-
-    return { remove, update }
-  }
-
-  return {
-    remove,
-    update: null,
-  }
-}
-
-// 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 spyConsoleModification = () => {
-  const { stdout, stderr } = process
-  const originalStdoutWrite = stdout.write
-  const originalStdErrWrite = stderr.write
-
-  let modified = false
-
-  stdout.write = function (...args /* chunk, encoding, callback */) {
-    modified = true
-    return originalStdoutWrite.call(stdout, ...args)
-  }
-  stderr.write = function (...args) {
-    modified = true
-    return originalStdErrWrite.call(stderr, ...args)
-  }
-
-  const uninstall = () => {
-    stdout.write = originalStdoutWrite
-    stderr.write = originalStdErrWrite
-  }
-
-  return () => {
-    uninstall()
-    return modified
-  }
-}

package/src/internal/executing/writeLog.test-manual.js

@@ -1,62 +0,0 @@
-import { assert } from "@jsenv/assert"
-import { writeLog } from "./writeLog.js"
-
-{
-  const first = writeLog(`1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-18`)
-  const second = first.update(`a
-b
-c
-d
-e
-f
-g`)
-  second.update(`alpha
-beta
-gamma`)
-  // must be verfied by human eyes
-  // depending on terminal height
-  // either the whole log can be rewritten (updated)
-  // or it will be kept and second log appended at the bottom
-}
-
-{
-  const hello = writeLog(`hello
-foo`)
-  hello.update(`hello
-bar`)
-
-  const expected = `hello
-bar`
-  const actual = expected // must be verified by human eyes
-  assert({ actual, expected })
-}
-
-{
-  const hello = writeLog("hello")
-  console.log("hey")
-  const world = hello.update("world")
-  world.update("!")
-
-  const expected = `hello
-hey
-!`
-  const actual = expected // must be verified by human eyes
-  assert({ actual, expected })
-}

package/src/internal/logs/log_style.js

@@ -1,40 +0,0 @@
-import isUnicodeSupported from "is-unicode-supported"
-import { createSupportsColor } from "supports-color"
-
-const canUseUnicode = isUnicodeSupported()
-const processSupportsBasicColor = createSupportsColor(process.stdout).hasBasic
-let canUseColors = processSupportsBasicColor
-
-// GitHub workflow does support ANSI but "supports-color" returns false
-// because stream.isTTY returns false, see https://github.com/actions/runner/issues/241
-if (process.env.GITHUB_WORKFLOW) {
-  // Check on FORCE_COLOR is to ensure it is prio over GitHub workflow check
-  if (process.env.FORCE_COLOR !== "false") {
-    // in unit test we use process.env.FORCE_COLOR = 'false' to fake
-    // that colors are not supported. Let it have priority
-    canUseColors = true
-  }
-}
-
-// https://github.com/Marak/colors.js/blob/master/lib/styles.js
-export const ANSI_RED = "\x1b[31m"
-export const ANSI_GREEN = "\x1b[32m"
-export const ANSI_YELLOW = "\x1b[33m"
-export const ANSI_BLUE = "\x1b[34m"
-export const ANSI_MAGENTA = "\x1b[35m"
-export const ANSI_GREY = "\x1b[90m"
-export const ANSI_RESET = "\x1b[0m"
-
-export const setANSIColor = canUseColors
-  ? (text, ANSI_COLOR) => `${ANSI_COLOR}${text}${ANSI_RESET}`
-  : (text) => text
-
-export const commandSignColorLess = canUseUnicode ? `❯` : `>`
-export const okSignColorLess = canUseUnicode ? `✔` : `√`
-export const failureSignColorLess = canUseUnicode ? `✖` : `×`
-
-export const commandSign = setANSIColor(commandSignColorLess, ANSI_GREY) // ANSI_MAGENTA)
-export const okSign = setANSIColor(okSignColorLess, ANSI_GREEN)
-export const failureSign = setANSIColor(failureSignColorLess, ANSI_RED)
-export const infoSign = setANSIColor(canUseUnicode ? `ℹ` : `i`, ANSI_BLUE)
-export const warningSign = setANSIColor(canUseUnicode ? `⚠` : `‼`, ANSI_YELLOW)

package/src/signal/signal.js

@@ -1,65 +0,0 @@
-export const createSignal = ({ once = false } = {}) => {
-  let callbacks = []
-
-  const signal = {}
-
-  const addCallback = (callback) => {
-    if (typeof callback !== "function") {
-      throw new Error(`callback must be a function, got ${callback}`)
-    }
-
-    // don't register twice
-    const existingCallback = callbacks.find((callbackCandidate) => {
-      return callbackCandidate === callback
-    })
-    if (existingCallback) {
-      if (typeof process.emitWarning === "object") {
-        process.emitWarning(`Trying to register same callback twice`, {
-          CODE: "CALLBACK_DUPLICATION",
-          detail: `It's often the sign that code is executd more than once`,
-        })
-      } else {
-        console.warn(`Trying to add same callback twice`)
-      }
-    } else {
-      callbacks = [...callbacks, callback]
-    }
-
-    return () => {
-      callbacks = arrayWithout(callbacks, callback)
-    }
-  }
-
-  const emit = (value) => {
-    signal.emitted = true
-
-    const callbacksCopy = callbacks.slice()
-    if (once) {
-      callbacks.length = 0
-    }
-    callbacksCopy.forEach((callback) => {
-      callback(value)
-    })
-  }
-
-  signal.emitted = false
-  signal.addCallback = addCallback
-  signal.emit = emit
-
-  return signal
-}
-
-const arrayWithout = (array, item) => {
-  if (array.length === 0) return array
-  const arrayWithoutItem = []
-  let i = 0
-  while (i < array.length) {
-    const value = array[i]
-    i++
-    if (value === item) {
-      continue
-    }
-    arrayWithoutItem.push(value)
-  }
-  return arrayWithoutItem
-}