@sequencemedia/gulp-cli 1.0.48 → 1.1.0

package/index.mjs

@@ -7,23 +7,23 @@ import Liftoff from '@sequencemedia/liftoff'
 import interpret from 'interpret'
 import v8flags from 'v8flags'
 
-import logger from './lib/logger.mjs'
-import ansi from './lib/ansi.mjs'
-import exit from './lib/exit.mjs'
-import tildify from './lib/tildify.mjs'
-import getProcessTitle from './lib/get-process-title.mjs'
-import cliOptions from './lib/cli-options.mjs'
-import getCompletion from './lib/get-completion.mjs'
-
-import listenForLevelEvents from './lib/log/listen-for-level-events.mjs'
-
-import loadConfigFiles from './lib/config/load-files.mjs'
-import mergeConfigToCliFlags from './lib/config/cli-flags.mjs'
-import mergeConfigToEnvFlags from './lib/config/env-flags.mjs'
-
-import runVersion from './lib/run-version.mjs'
-import runVerify from './lib/run-verify.mjs'
-import run from './lib/index.mjs'
+import logger from './src/logger.mjs'
+import ansi from './src/ansi.mjs'
+import exit from './src/exit.mjs'
+import tildify from './src/tildify.mjs'
+import getProcessTitle from './src/get-process-title.mjs'
+import cliOptions from './src/cli-options.mjs'
+import getCompletion from './src/get-completion.mjs'
+
+import listenForLevelEvents from './src/log/listen-for-level-events.mjs'
+
+import loadConfigFiles from './src/config/load-files.mjs'
+import mergeConfigToCliFlags from './src/config/cli-flags.mjs'
+import mergeConfigToEnvFlags from './src/config/env-flags.mjs'
+
+import runVersion from './src/run-version.mjs'
+import runVerify from './src/run-verify.mjs'
+import run from './src/index.mjs'
 
 // Set env var for ORIGINAL cwd
 // before anything touches it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sequencemedia/gulp-cli",
-  "version": "1.0.48",
+  "version": "1.1.0",
   "description": "The command line interface to Gulp",
   "keywords": [
     "build",
@@ -77,7 +77,7 @@
     "gulp.1"
   ],
   "imports": {
-    "#gulp-cli/lib/*": "./lib/*.mjs",
+    "#gulp-cli/src/*": "./src/*.mjs",
     "#gulp-cli": "./index.mjs",
     "#where-am-i": "./where-am-i.mjs"
   }

package/lib/ansi.mjs

@@ -1,46 +0,0 @@
-import ansiColors from 'ansi-colors'
-import colorSupport from 'color-support'
-
-const HAS_NO_COLOR = process.argv.includes('--no-color')
-const HAS_COLOR = process.argv.includes('--color')
-const HAS_COLOR_SUPPORT = hasColorSupport(colorSupport())
-
-function hasColorSupport ({ hasBasic, has256, has16m }) {
-  return (
-    hasBasic ||
-    has256 ||
-    has16m
-  )
-}
-
-function hasColor () {
-  if (HAS_NO_COLOR) {
-    return false
-  }
-
-  return (
-    HAS_COLOR ||
-    HAS_COLOR_SUPPORT
-  )
-}
-
-function noColor (message) {
-  return message
-}
-
-export default (
-  hasColor()
-    ? ansiColors
-    : {
-        red: noColor,
-        green: noColor,
-        blue: noColor,
-        magenta: noColor,
-        cyan: noColor,
-        white: noColor,
-        gray: noColor,
-        bgred: noColor,
-        bold: noColor,
-        yellow: noColor
-      }
-)

package/lib/cli-options.mjs

@@ -1,120 +0,0 @@
-import ansi from './ansi.mjs'
-
-export default {
-  help: {
-    alias: 'h',
-    type: 'boolean',
-    desc: ansi.gray(
-      'Show this help.')
-  },
-  version: {
-    alias: 'v',
-    type: 'boolean',
-    desc: ansi.gray(
-      'Print the global and local gulp versions.')
-  },
-  require: {
-    type: 'string',
-    requiresArg: true,
-    desc: ansi.gray(
-      'Will require a module before running the gulpfile. ' +
-      'This is useful for transpilers but also has other applications.')
-  },
-  gulpfile: {
-    alias: 'f',
-    type: 'string',
-    requiresArg: true,
-    desc: ansi.gray(
-      'Manually set path of gulpfile. Useful if you have multiple gulpfiles. ' +
-      'This will set the CWD to the gulpfile directory as well.')
-  },
-  cwd: {
-    type: 'string',
-    requiresArg: true,
-    desc: ansi.gray(
-      'Manually set the CWD. The search for the gulpfile, ' +
-      'as well as the relativity of all requires will be from here.')
-  },
-  verify: {
-    desc: ansi.gray(
-      'Will verify plugins referenced in project\'s package.json against ' +
-      'the plugins blacklist.')
-  },
-  tasks: {
-    alias: 'T',
-    type: 'boolean',
-    desc: ansi.gray(
-      'Print the task dependency tree for the loaded gulpfile.')
-  },
-  'tasks-list': {
-    type: 'boolean',
-    desc: ansi.gray(
-      'Print a list of tasks for the loaded gulpfile.')
-  },
-  'tasks-json': {
-    desc: ansi.gray(
-      'Print the task dependency tree, ' +
-      'in JSON format, for the loaded gulpfile.')
-  },
-  'tasks-depth': {
-    alias: 'depth',
-    type: 'number',
-    requiresArg: true,
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Specify the depth of the task dependency tree.')
-  },
-  'compact-tasks': {
-    type: 'boolean',
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Reduce the output of task dependency tree by printing ' +
-      'only top tasks and their child tasks.')
-  },
-  'sort-tasks': {
-    type: 'boolean',
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Will sort top tasks of task dependency tree.')
-  },
-  color: {
-    type: 'boolean',
-    desc: ansi.gray(
-      'Will force gulp and gulp plugins to display colors, ' +
-      'even when no color support is detected.')
-  },
-  'no-color': {
-    type: 'boolean',
-    desc: ansi.gray(
-      'Will force gulp and gulp plugins to not display colors, ' +
-      'even when color support is detected.')
-  },
-  silent: {
-    alias: 'S',
-    type: 'boolean',
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Suppress all gulp logging.')
-  },
-  continue: {
-    type: 'boolean',
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Continue execution of tasks upon failure.')
-  },
-  series: {
-    type: 'boolean',
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Run tasks given on the CLI in series (the default is parallel).')
-  },
-  'log-level': {
-    alias: 'L',
-    // Type isn't needed because count acts as a boolean
-    count: true,
-    default: undefined, // To detect if this cli option is specified.
-    desc: ansi.gray(
-      'Set the loglevel. -L for least verbose and -LLLL for most verbose. ' +
-      '-LLL is default.')
-  }
-}

package/lib/config/cli-flags.mjs

@@ -1,21 +0,0 @@
-import copyProps from 'copy-props'
-
-const fromTo = {
-  'flags.silent': 'silent',
-  'flags.continue': 'continue',
-  'flags.series': 'series',
-  'flags.logLevel': 'logLevel',
-  'flags.compactTasks': 'compactTasks',
-  'flags.tasksDepth': 'tasksDepth',
-  'flags.sortTasks': 'sortTasks'
-}
-
-export default function mergeConfigToCliFlags (cliProps, configProps) {
-  return (
-    copyProps(configProps, cliProps, fromTo, (configProps, cliProps) => {
-      if (cliProps.value === undefined) {
-        return configProps.value
-      }
-    })
-  )
-}

package/lib/config/env-flags.mjs

@@ -1,41 +0,0 @@
-import path from 'node:path'
-import copyProps from 'copy-props'
-
-const toFrom = {
-  configPath: 'flags.gulpfile',
-  configBase: 'flags.gulpfile',
-  require: 'flags.require',
-  nodeFlags: 'flags.nodeFlags'
-}
-
-function getConvert (cliProps) {
-  return function convert (config, env) {
-    if (env.keyChain === 'configBase') {
-      if (cliProps.gulpfile === undefined) {
-        return path.dirname(config.value)
-      }
-      return
-    }
-
-    if (env.keyChain === 'configPath') {
-      if (cliProps.gulpfile === undefined) {
-        return config.value
-      }
-      return
-    }
-
-    if (env.keyChain === 'require') {
-      return [].concat(env.value, config.value)
-    }
-
-    if (env.keyChain === 'nodeFlags') {
-      return [].concat(config.value || [])
-    }
-  }
-}
-
-export default function mergeConfigToEnvFlags (envProps, configProps, cliProps) {
-  return (
-    copyProps(envProps, configProps, toFrom, getConvert(cliProps), true) // This must reverse because `flags.gulpfile` determines 2 different properties
-  )
-}

package/lib/config/load-files.mjs

@@ -1,50 +0,0 @@
-import copyProps from 'copy-props'
-import {
-  join,
-  extname,
-  resolve,
-  dirname
-} from 'node:path'
-
-function getConfig (module) {
-  if (Reflect.has(module, 'default')) return Reflect.get(module, 'default')
-  return module
-}
-
-export default async function loadConfigFiles (configFiles = {}, configFileOrder = []) {
-  const config = {}
-
-  const keyList = (
-    configFileOrder
-      .filter((key) => configFiles[key])
-  )
-
-  while (keyList.length) {
-    const key = keyList.shift()
-    const filePath = configFiles[key]
-
-    try {
-      const module = (
-        extname(filePath) === '.json'
-          ? await import(resolve(join(process.cwd(), filePath)), { assert: { type: 'json' } })
-          : await import(resolve(join(process.cwd(), filePath)))
-      )
-
-      copyProps(getConfig(module), config, ({ keyChain, value }) => {
-        if (keyChain === 'flags.gulpfile') {
-          return resolve(dirname(filePath), value)
-        }
-
-        return value
-      })
-    } catch (e) {
-      const {
-        code
-      } = e
-
-      if (code !== 'ERR_MODULE_NOT_FOUND') console.error(e)
-    }
-  }
-
-  return config
-}

package/lib/exit.mjs

@@ -1,8 +0,0 @@
-// Fix stdout truncation on windows
-export default function exit (code) {
-  if (process.platform === 'win32' && process.stdout.writableLength) {
-    process.stdout.once('drain', () => { process.exit(code) })
-    return
-  }
-  process.exit(code)
-}

package/lib/format-error.mjs

@@ -1,19 +0,0 @@
-// Format orchestrator errors
-export default function formatError (e) {
-  if (!e.error) {
-    return e.message
-  }
-
-  // PluginError
-  if (typeof e.error.showStack === 'boolean') {
-    return e.error.toString()
-  }
-
-  // Normal error
-  if (e.error.stack) {
-    return e.error.stack
-  }
-
-  // Unknown (string, number, etc.)
-  return new Error(String(e.error)).stack
-}

package/lib/get-blacklist.mjs

@@ -1,7 +0,0 @@
-const URL = 'https://raw.githubusercontent.com/gulpjs/plugins/master/src/blackList.json'
-
-export default async function getBlacklist () {
-  const response = await fetch(URL)
-
-  return response.json()
-}

package/lib/get-completion.mjs

@@ -1,21 +0,0 @@
-import path from 'node:path'
-
-import {
-  readFile
-} from 'node:fs/promises'
-
-export default async function getCompletion (completionType) {
-  if (typeof completionType !== 'string') {
-    throw new Error('Completion type not provided')
-  }
-
-  try {
-    const filePath = path.join('./completion', completionType)
-    const fileData = await readFile(filePath, 'utf8')
-    console.log(fileData.toString().trim())
-    process.exit(0)
-  } catch (e) {
-    console.error(`echo "Completion type "${completionType}" not found"`)
-    process.exit(5)
-  }
-}

package/lib/get-duplicate.mjs

@@ -1,80 +0,0 @@
-const DEFAULT_NODE_FACTORY = {
-  topNode: getDuplicateOf,
-  taskNode: getDuplicateOf,
-  childNode: getDuplicateOf
-}
-
-function getDuplicateOf (node) {
-  return Object.fromEntries(Object.entries(node))
-}
-
-function hasCompactTasks ({ compactTasks = false }) {
-  return String(compactTasks) === 'true'
-}
-
-function getTasksDepth ({ tasksDepth }) {
-  return (
-    typeof tasksDepth === 'number' && !isNaN(tasksDepth)
-      ? Math.max(1, tasksDepth)
-      : null
-  )
-}
-
-function nonRecursiveDuplicateNode (child, parent, nodeFactory) {
-  const dupe = nodeFactory.childNode(child)
-  dupe.nodes = []
-
-  parent.nodes.push(dupe)
-
-  if (child.branch) {
-    duplicateNodesFor(child, nonRecursiveDuplicateNode, dupe, nodeFactory)
-  }
-}
-
-function recursiveDuplicateNode (child, parent, maximumDepth, currentDepth, nodeFactory) {
-  const dupe = nodeFactory.childNode(child)
-  dupe.nodes = []
-
-  parent.nodes.push(dupe)
-
-  if (!maximumDepth || maximumDepth > currentDepth) {
-    duplicateNodesFor(child, recursiveDuplicateNode, dupe, maximumDepth, currentDepth + 1, nodeFactory)
-  }
-}
-
-function duplicateNodesFor ({ nodes }, duplicate, ...args) {
-  if (Array.isArray(nodes)) {
-    nodes
-      .forEach((node) => {
-        duplicate(node, ...args)
-      })
-  }
-}
-
-function duplicateNode (node, tree, cliProps, nodeFactory = DEFAULT_NODE_FACTORY) {
-  const dupe = nodeFactory.taskNode(node)
-  dupe.nodes = []
-
-  tree.nodes.push(dupe)
-
-  if (hasCompactTasks(cliProps)) {
-    duplicateNodesFor(node, nonRecursiveDuplicateNode, dupe, nodeFactory)
-  } else {
-    const maximumDepth = getTasksDepth(cliProps)
-
-    if (!maximumDepth || maximumDepth > 1) {
-      duplicateNodesFor(node, recursiveDuplicateNode, dupe, maximumDepth, 2, nodeFactory)
-    }
-  }
-}
-
-function duplicateTree (tree = {}, cliProps = {}, nodeFactory = DEFAULT_NODE_FACTORY) {
-  const dupe = nodeFactory.topNode(tree)
-  dupe.nodes = []
-
-  duplicateNodesFor(tree, duplicateNode, dupe, cliProps, nodeFactory)
-
-  return dupe
-}
-
-export default duplicateTree

package/lib/get-package-blacklist.mjs

@@ -1,23 +0,0 @@
-import matchdep from 'matchdep'
-
-/**
- * Given a collection of plugin names verifies this collection against
- * the blacklist. Returns an object with:
- * [plugin name]=>[blacklisting reason]
- * or an empty object if none of the dependencies to check are blacklisted.
- *
- * @param packageJson - The package JSON
- * @param blacklistJson - The blacklist JSON
- */
-function getPackageBlacklist (packageJson, blacklistJson) {
-  return (
-    matchdep
-      .filterAll(Object.keys(blacklistJson), packageJson)
-      .reduce((blacklist, dependency) => {
-        blacklist[dependency] = blacklistJson[dependency]
-        return blacklist
-      }, {})
-  )
-}
-
-export default getPackageBlacklist

package/lib/get-process-title.mjs

@@ -1,3 +0,0 @@
-export default function getProcessTitle (argv = []) {
-  return ['gulp'].concat(argv).join(' ').trim()
-}

package/lib/get-task.mjs

@@ -1,41 +0,0 @@
-import isObject from 'isobject'
-
-function isString (value) {
-  return typeof value === 'string'
-}
-
-function isFunction (value) {
-  return value instanceof Function
-}
-
-function getDescription (task = {}) {
-  if (isString(task.description)) {
-    return task.description
-  }
-
-  if (isFunction(task.unwrap)) {
-    return getDescription(task.unwrap())
-  }
-}
-
-function getFlags (task = {}) {
-  if (isObject(task.flags)) {
-    return task.flags
-  }
-
-  if (isFunction(task.unwrap)) {
-    return getFlags(task.unwrap())
-  }
-}
-
-function getTask (gulp) {
-  return function getTaskFor (name) {
-    const task = gulp.task(name)
-    return {
-      description: getDescription(task),
-      flags: getFlags(task)
-    }
-  }
-}
-
-export default getTask

package/lib/index.mjs

@@ -1,59 +0,0 @@
-import stdout from 'mute-stdout'
-
-import listenForGulpEvents from './log/listen-for-gulp-events.mjs'
-import listenForSyncEvents from './log/listen-for-sync-events.mjs'
-import registerGulpTasks from './register-gulp-tasks.mjs'
-
-import runGulpTasks from './run-gulp-tasks.mjs'
-
-function getImportFromModulePath (params) {
-  const {
-    envProps: {
-      modulePath
-    }
-  } = params
-
-  return (
-    import(modulePath)
-      .then(({ default: gulp }) => Object.assign(params, { gulp }))
-  )
-}
-
-function getImportFromConfigPath (params) {
-  const {
-    envProps: {
-      configPath
-    }
-  } = params
-
-  return (
-    import(configPath)
-      .then((tasks) => Object.assign(params, { tasks }))
-  )
-}
-
-function isSilent (cliProps) {
-  return (cliProps.tasksList || cliProps.tasks || cliProps.tasksJson)
-}
-
-async function run (cliProps, envProps, configProps = {}) {
-  if (isSilent(cliProps)) stdout.mute()
-
-  const { gulp, tasks } = (
-    await Promise.resolve({ cliProps, envProps, configProps })
-      .then(getImportFromModulePath)
-      .then(getImportFromConfigPath)
-  )
-
-  listenForGulpEvents(gulp)
-  listenForSyncEvents(gulp, cliProps)
-  registerGulpTasks(gulp, tasks)
-
-  stdout.unmute()
-
-  return (
-    runGulpTasks(gulp, cliProps, envProps, configProps)
-  )
-}
-
-export default run

package/lib/log/listen-for-gulp-events.mjs

@@ -1,46 +0,0 @@
-import prettyHrtime from 'pretty-hrtime'
-
-import logger from '#gulp-cli/lib/logger'
-import ansi from '#gulp-cli/lib/ansi'
-import formatError from '#gulp-cli/lib/format-error'
-
-const errors = new Set()
-
-function start (event) {
-  const level = event.branch ? 'debug' : 'info'
-  logger[level](`Starting '${ansi.cyan(event.name)}'...`)
-}
-
-function stop (event) {
-  const level = event.branch ? 'debug' : 'info'
-  logger[level](`Finished '${ansi.cyan(event.name)}' after ${ansi.magenta(prettyHrtime(event.duration))}`)
-}
-
-function error (event) {
-  const level = event.branch ? 'debug' : 'error'
-  logger[level](`'${ansi.cyan(event.name)}' ${ansi.red('errored after')} ${ansi.magenta(prettyHrtime(event.duration))}`)
-
-  // Exit if we have logged this before
-  if (errors.has(event.error)) return
-
-  // If we haven't logged this before, log it and add it to the error list
-  logger.error(formatError(event))
-  errors.add(event.error)
-}
-
-function stopListeningForGulpEvents (gulp) {
-  gulp
-    .removeListener('start', start)
-    .removeListener('stop', stop)
-    .removeListener('error', error)
-}
-
-// Wire up logging events
-export default function listenForGulpEvents (gulp) {
-  stopListeningForGulpEvents(gulp)
-
-  gulp
-    .on('start', start)
-    .on('stop', stop)
-    .on('error', error)
-}

package/lib/log/listen-for-level-events.mjs

@@ -1,49 +0,0 @@
-import fancyLog from 'fancy-log'
-import logger from '#gulp-cli/lib/logger'
-
-const noop = () => {}
-
-// The sorting of the levels is
-// significant.
-const levels = [
-  'error', // -L: Logs error events.
-  'warn', // -LL: Logs warn and error events.
-  'info', // -LLL: Logs info, warn and error events.
-  'debug' // -LLLL: Logs all log levels.
-]
-
-function stopListeningForLevelEvents () {
-  levels
-    .forEach((level) => {
-      if (level === 'error') {
-        logger.removeListener(level, noop).removeListener(level, fancyLog.error)
-      } else {
-        logger.removeListener(level, fancyLog)
-      }
-    })
-}
-
-// Wire up log levels
-export default function listenForLevelEvents (cliProps) {
-  // Remove previous listeners to enable to call this twice.
-  stopListeningForLevelEvents()
-
-  // Silent?
-  if (cliProps.tasksList || cliProps.tasksJson || cliProps.help || cliProps.version || cliProps.silent) {
-    // Keep from crashing process when silent
-    logger.on('error', noop)
-  } else {
-    // Default level is 3 (info)
-    const loglevel = cliProps.logLevel || 3
-
-    levels
-      .filter((level, i) => level && i < loglevel)
-      .forEach((level) => {
-        if (level === 'error') {
-          logger.on(level, fancyLog.error)
-        } else {
-          logger.on(level, fancyLog)
-        }
-      })
-  }
-}

package/lib/log/listen-for-sync-events.mjs

@@ -1,60 +0,0 @@
-import logger from '#gulp-cli/lib/logger'
-import ansi from '#gulp-cli/lib/ansi'
-
-const tasks = new Map()
-
-function warn () {
-  if (tasks.size) {
-    const taskNames = Array.from(tasks.values()).join(', ')
-
-    process.exitCode = 1
-
-    logger.warn(
-      ansi.red('The following tasks did not complete:')
-    )
-
-    logger.warn(
-      ansi.cyan(taskNames)
-    )
-
-    logger.warn(
-      ansi.red('Did you forget to signal async completion?')
-    )
-  }
-}
-
-function start ({ uid, name }) {
-  tasks.set(uid, name)
-}
-
-function clear ({ uid }) {
-  tasks.delete(uid)
-}
-
-function clearAll () {
-  tasks.clear()
-}
-
-function stopListeningForSyncEvents (gulp) {
-  // Ensure to detach
-  process
-    .removeListener('exit', warn)
-
-  gulp
-    .removeListener('start', start)
-    .removeListener('stop', clear)
-    .removeListener('error', clear).removeListener('error', clearAll)
-}
-
-export default function listenForSyncEvents (gulp, cliProps) {
-  stopListeningForSyncEvents(gulp)
-
-  process
-    .once('exit', warn)
-
-  // When not running in --continue mode we need to clear everything on error
-  gulp
-    .on('start', start)
-    .on('stop', clear)
-    .on('error', cliProps.continue ? clear : clearAll)
-}

package/lib/log/tasks-json.mjs

@@ -1,16 +0,0 @@
-import {
-  writeFile
-} from 'node:fs/promises'
-
-import getDuplicate from '#gulp-cli/lib/get-duplicate'
-
-export default function logTasksJson (tree, cliProps) {
-  const dupe = getDuplicate(tree, cliProps)
-  const json = JSON.stringify(dupe)
-
-  // Write to a file if not `true`
-  if (cliProps.tasksJson !== true) return writeFile(cliProps.tasksJson, json, 'utf8')
-
-  // Otherwise
-  console.log(json.trim())
-}

package/lib/log/tasks-list.mjs

@@ -1,3 +0,0 @@
-export default function logTasksList ({ nodes = [] }) {
-  console.log(nodes.join('\n').trim())
-}

package/lib/log/tasks.mjs

@@ -1,163 +0,0 @@
-import archy from 'archy'
-
-import sortBy from 'array-sort'
-import isObject from 'isobject'
-
-import logger from '#gulp-cli/lib/logger'
-import ansi from '#gulp-cli/lib/ansi'
-import getDuplicate from '#gulp-cli/lib/get-duplicate'
-
-function getLineInfoCollector (lineInfo) {
-  return {
-    topTask (node) {
-      lineInfo.push({
-        name: node.label,
-        desc: node.desc,
-        type: 'top'
-      })
-    },
-    option (opt) {
-      lineInfo.push({
-        name: opt.label,
-        desc: opt.desc,
-        type: 'option'
-      })
-    },
-    childTask (node) {
-      lineInfo.push({
-        name: node.label,
-        type: 'child'
-      })
-    }
-  }
-}
-
-function getNodeFactory (getTask, entryObserver) {
-  return {
-    topNode (node) {
-      return {
-        label: node.label
-      }
-    },
-
-    taskNode (node) {
-      const task = getTask(node.label) || {}
-
-      const newNode = {
-        label: node.label,
-        desc: typeof task.description === 'string' ? task.description : '',
-        cliProps: []
-      }
-      entryObserver.topTask(newNode)
-
-      if (isObject(task.flags)) {
-        Object.keys(task.flags)
-          .sort()
-          .filter(Boolean)
-          .forEach((flag) => {
-            const opt = {
-              label: flag,
-              desc: typeof task.flags[flag] === 'string' ? task.flags[flag] : ''
-            }
-            entryObserver.option(opt)
-            newNode.cliProps.push(opt)
-            newNode.label += '\n' + opt.label // The way of archy for options.
-          })
-      }
-
-      return newNode
-    },
-
-    childNode (node) {
-      const newChild = {
-        label: node.label
-      }
-      entryObserver.childTask(newChild)
-      newChild.label = '' // Because don't use child tasks to calc indents.
-
-      return newChild
-    }
-  }
-}
-
-function getSpacerForLineIndents (tree, lineInfo) {
-  let maxSize = 0
-  const sizes = []
-
-  archy(tree)
-    .split('\n')
-    .slice(1, -1)
-    .forEach((line, index) => {
-      const info = lineInfo[index]
-      if (info.type === 'top' || info.type === 'option') {
-        maxSize = Math.max(maxSize, line.length)
-        sizes.push(line.length)
-      } else {
-        sizes.push(0)
-      }
-    })
-
-  maxSize += 3
-
-  return function getSpacerFor (index) {
-    return Array(maxSize - sizes[index]).join(' ')
-  }
-}
-
-function getLinesContainingOnlyBranches (tree) {
-  tree.nodes
-    .forEach((node) => {
-      node.label = ''
-      node.cliProps
-        .forEach(() => {
-          node.label += '\n'
-        })
-    })
-
-  return archy(tree)
-    .split('\n')
-    .slice(1, -1)
-}
-
-function logLines (lines, spacer, lineInfo) {
-  lines
-    .forEach((branch, index) => {
-      const info = lineInfo[index]
-
-      let line = ansi.white(branch)
-
-      if (info.type === 'top') {
-        line += ansi.cyan(info.name)
-        if (info.desc.length > 0) {
-          line += spacer(index) + ansi.white(info.desc)
-        }
-      } else if (info.type === 'option') {
-        line += ansi.magenta(info.name)
-        if (info.desc.length > 0) {
-          line += spacer(index) + ansi.white('…' + info.desc)
-        }
-      } else { // If (info.type === 'child') {
-        line += ansi.white(info.name)
-      }
-
-      logger.info(line)
-    })
-}
-
-// Wire up logger tasks
-export default function logTasks (tree, cliProps, getTask) {
-  if (cliProps.sortTasks) {
-    tree.nodes = sortBy(tree.nodes, 'label')
-  }
-
-  const lineInfo = []
-  const entryObserver = getLineInfoCollector(lineInfo)
-  const nodeFactory = getNodeFactory(getTask, entryObserver)
-
-  const dupe = getDuplicate(tree, cliProps, nodeFactory)
-  const spacer = getSpacerForLineIndents(dupe, lineInfo)
-  const lines = getLinesContainingOnlyBranches(dupe)
-
-  logger.info(dupe.label)
-  logLines(lines, spacer, lineInfo)
-}

package/lib/logger.mjs

@@ -1,3 +0,0 @@
-import getLogger from '@sequencemedia/gulp-log'
-
-export default getLogger('gulp-cli')

package/lib/register-gulp-tasks.mjs

@@ -1,7 +0,0 @@
-export default function registerGulpTasks (gulp, tasks) {
-  Object.entries(tasks)
-    .filter(([taskName, task]) => (taskName || task.displayName) && task instanceof Function)
-    .forEach(([taskName, task]) => {
-      gulp.task(task.displayName || taskName, task)
-    })
-}

package/lib/run-gulp-tasks-json-tree.mjs

@@ -1,14 +0,0 @@
-import tildify from './tildify.mjs'
-
-import logTasksJson from './log/tasks-json.mjs'
-
-export default function runGulpTasksJsonTree (gulp, cliProps, envProps, configProps) {
-  const tree = gulp.tree({ deep: true })
-  if (configProps.description && typeof configProps.description === 'string') {
-    tree.label = configProps.description
-  } else {
-    tree.label = `Tasks for ${tildify(envProps.configPath)}`
-  }
-
-  return logTasksJson(tree, cliProps)
-}

package/lib/run-gulp-tasks-list-tree.mjs

@@ -1,7 +0,0 @@
-import logTasksList from './log/tasks-list.mjs'
-
-export default function runGulpTasksListTree (gulp) {
-  const tree = gulp.tree()
-
-  return logTasksList(tree)
-}

package/lib/run-gulp-tasks-tree.mjs

@@ -1,16 +0,0 @@
-import ansi from './ansi.mjs'
-import tildify from './tildify.mjs'
-
-import logTasks from './log/tasks.mjs'
-import getTask from './get-task.mjs'
-
-export default function runGulpTasksTree (gulp, cliProps, envProps, configProps) {
-  const tree = gulp.tree({ deep: true })
-  if (configProps.description && typeof configProps.description === 'string') {
-    tree.label = configProps.description
-  } else {
-    tree.label = `Tasks for ${ansi.magenta(tildify(envProps.configPath))}`
-  }
-
-  return logTasks(tree, cliProps, getTask(gulp))
-}

package/lib/run-gulp-tasks.mjs

@@ -1,45 +0,0 @@
-import logger from './logger.mjs'
-import ansi from './ansi.mjs'
-import exit from './exit.mjs'
-import tildify from './tildify.mjs'
-
-import runGulpTasksListTree from './run-gulp-tasks-list-tree.mjs'
-import runGulpTasksTree from './run-gulp-tasks-tree.mjs'
-import runGulpTasksJsonTree from './run-gulp-tasks-json-tree.mjs'
-
-function getMethodFromCliProps ({ series = false }) {
-  return series ? 'series' : 'parallel'
-}
-
-function getTasksFromCliProps ({ _: tasks = [] }) {
-  return (
-    tasks.length ? [...tasks] : ['default']
-  )
-}
-
-export default function runGulpTasks (gulp, cliProps, envProps, configProps) {
-  if (cliProps.tasksList) return runGulpTasksListTree(gulp)
-
-  if (cliProps.tasks) return runGulpTasksTree(gulp, cliProps, envProps, configProps)
-
-  if (cliProps.tasksJson) return runGulpTasksJsonTree(gulp, cliProps, envProps, configProps)
-
-  try {
-    const {
-      configPath
-    } = envProps
-
-    logger.info(`Using gulpfile ${ansi.magenta(tildify(configPath))}`)
-
-    const method = getMethodFromCliProps(cliProps)
-    const tasks = getTasksFromCliProps(cliProps)
-
-    return (
-      gulp[method](tasks)((e) => e && exit(1))
-    )
-  } catch ({ message }) {
-    logger.error(ansi.red(message))
-    logger.error('To list available tasks run: gulp --tasks')
-    exit(1)
-  }
-}

package/lib/run-verify.mjs

@@ -1,55 +0,0 @@
-import path from 'node:path'
-
-import {
-  readFile
-} from 'node:fs/promises'
-
-import logger from './logger.mjs'
-import ansi from './ansi.mjs'
-import exit from './exit.mjs'
-import tildify from './tildify.mjs'
-
-import getBlacklist from './get-blacklist.mjs'
-import getPackageBlacklist from './get-package-blacklist.mjs'
-
-function getPackagePath (envProps, cliProps) {
-  let packagePath = cliProps.verify !== true ? cliProps.verify : './package.json'
-
-  if (path.resolve(packagePath) !== path.normalize(packagePath)) {
-    packagePath = path.join(path.normalize(envProps.cwd), packagePath)
-  }
-
-  return packagePath
-}
-
-async function getPackageJson (packagePath) {
-  const fileData = await readFile(packagePath)
-  return JSON.parse(fileData.toString())
-}
-
-export default async function runVerify (envProps, cliProps) {
-  const packagePath = getPackagePath(envProps, cliProps)
-
-  logger.info(`Verifying dependencies in ${ansi.magenta(tildify(packagePath))}`)
-  try {
-    const blacklistJson = await getBlacklist()
-    const packageJson = await getPackageJson(packagePath)
-    const packageBlacklist = getPackageBlacklist(packageJson, blacklistJson)
-
-    const dependencies = Object.entries(packageBlacklist)
-    if (dependencies.length) {
-      logger.warn(ansi.red('Blacklisted dependencies in this project:'))
-      dependencies
-        .forEach(([name, reason]) => {
-          logger.warn(`${ansi.bgred(name)}: ${reason}`)
-        })
-      exit(1)
-    }
-
-    logger.info(ansi.green('There are no blacklisted dependencies in this project'))
-    exit(0)
-  } catch ({ message }) {
-    logger.error(`${ansi.red('Failed to verify dependencies.')} Could not get blacklist - ${message}`)
-    exit(1)
-  }
-}

package/lib/run-version.mjs

@@ -1,26 +0,0 @@
-import {
-  join
-} from 'node:path'
-
-import exit from './exit.mjs'
-
-import ROOT from '#where-am-i'
-
-async function getGulpCliVersion () {
-  const {
-    default: {
-      version
-    }
-  } = await import(join(ROOT, 'package.json'), { assert: { type: 'json' } })
-  return version
-}
-
-function getGulpVersion ({ modulePackage: { version = 'unknown' } = {} }) {
-  return version
-}
-
-export default async function runVersion (envProps) {
-  console.log(`Gulp CLI version: ${await getGulpCliVersion()}`)
-  console.log(`Gulp version: ${getGulpVersion(envProps)}`)
-  exit(0)
-}

package/lib/tildify.mjs

@@ -1,5 +0,0 @@
-import replaceHomedir from 'replace-homedir'
-
-export default function tildify (filePath) {
-  return replaceHomedir(filePath, '~')
-}