@depup/sharp-cli 5.3.0-depup.0 → 6.0.0-depup.0

package/lib/cli.js

@@ -21,18 +21,52 @@
  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
-// Strict mode.
-"use strict";
-
 // Package modules.
-const pick = require("lodash.pick");
-const sharp = require("sharp");
-const yargs = require("yargs");
+import sharp from "sharp";
+import yargs from "yargs";
 
 // Local modules.
-const constants = require("./constants");
-const pkg = require("../package.json");
-const queue = require("./queue");
+import affine from "../cmd/operations/affine.js";
+import bandbool from "../cmd/channel-manipulation/bandbool.js";
+import blur from "../cmd/operations/blur.js";
+import boolean from "../cmd/operations/boolean.js";
+import clahe from "../cmd/operations/clahe.js";
+import composite from "../cmd/compositing/composite.js";
+import convolve from "../cmd/operations/convolve.js";
+import dilate from "../cmd/operations/dilate.js";
+import ensureAlpha from "../cmd/channel-manipulation/ensure-alpha.js";
+import erode from "../cmd/operations/erode.js";
+import extend from "../cmd/resizing/extend.js";
+import extract from "../cmd/resizing/extract.js";
+import extractChannel from "../cmd/channel-manipulation/extract-channel.js";
+import flatten from "../cmd/operations/flatten.js";
+import flip from "../cmd/operations/flip.js";
+import flop from "../cmd/operations/flop.js";
+import gamma from "../cmd/operations/gamma.js";
+import greyscale from "../cmd/colour-manipulation/greyscale.js";
+import joinChannel from "../cmd/channel-manipulation/join-channel.js";
+import linear from "../cmd/operations/linear.js";
+import median from "../cmd/operations/median.js";
+import modulate from "../cmd/operations/modulate.js";
+import negate from "../cmd/operations/negate.js";
+import normalise from "../cmd/operations/normalise.js";
+import pipelineColourspace from "../cmd/colour-manipulation/pipeline-colourspace.js";
+import recomb from "../cmd/operations/recomb.js";
+import removeAlpha from "../cmd/channel-manipulation/remove-alpha.js";
+import resize from "../cmd/resizing/resize.js";
+import rotate from "../cmd/operations/rotate.js";
+import sharpen from "../cmd/operations/sharpen.js";
+import threshold from "../cmd/operations/threshold.js";
+import tint from "../cmd/colour-manipulation/tint.js";
+import tile from "../cmd/output.js";
+import toColourspace from "../cmd/colour-manipulation/tocolourspace.js";
+import trim from "../cmd/resizing/trim.js";
+import unflatten from "../cmd/operations/unflatten.js";
+import constants from "./constants.js";
+import { pick } from "./utils.js";
+
+// Assets.
+import pkg from "../package.json" with { type: "json" };
 
 // Configure.
 const IS_TEXT_TERMINAL = process.stdin.isTTY;
@@ -44,6 +78,20 @@ const optimize = "Optimization Options";
 const output = "Output Options";
 
 const globalOptions = {
+  dry: {
+    alias: "n",
+    desc: "Process images without writing output files",
+    group: global,
+    type: "boolean",
+  },
+
+  print: {
+    desc: "Print input and output metadata as JSON",
+    group: global,
+    implies: IS_TEXT_TERMINAL ? undefined : "dry",
+    type: "boolean",
+  },
+
   // @see https://sharp.pixelplumbing.com/api-constructor/
   input: {
     alias: "i",
@@ -52,6 +100,7 @@ const globalOptions = {
     desc: "Path to (an) image file(s)",
     group: global,
     implies: "output",
+    requiresArg: true,
     type: "array",
   },
 
@@ -62,6 +111,7 @@ const globalOptions = {
     demand: IS_TEXT_TERMINAL,
     desc: "Directory or URI template to write the image files to",
     group: global,
+    nargs: 1,
     type: "string",
   },
 
@@ -69,12 +119,13 @@ const globalOptions = {
   timeout: {
     desc: "Number of seconds after which processing will be stopped",
     group: global,
+    nargs: 1,
     type: "number",
   },
 };
 
 // @see https://sharp.pixelplumbing.com/api-constructor
-const inputOptions = {
+export const inputOptions = {
   animated: {
     desc: "Read all frames/pages of an animated image",
     group: input,
@@ -85,18 +136,19 @@ const inputOptions = {
     group: input,
     type: "boolean",
   },
-  failOn: {
-    choices: constants.FAIL_ON,
-    defaultDescription: "warning",
-    desc: "Level of sensitivity to invalid images",
-    group: input,
-  },
   density: {
     desc: "DPI for vector images",
     defaultDescription: 72,
     group: input,
+    nargs: 1,
     type: "number",
   },
+  failOn: {
+    choices: constants.FAIL_ON,
+    defaultDescription: "warning",
+    desc: "Level of sensitivity to invalid images",
+    group: input,
+  },
   ignoreIcc: {
     default: false,
     desc: "Should the embedded ICC profile, if any, be ignored",
@@ -107,24 +159,35 @@ const inputOptions = {
     desc: "Level to extract from a multi-level input (OpenSlide), zero based",
     defaultDescription: 0,
     group: input,
+    nargs: 1,
     type: "number",
   },
   limitInputPixels: {
     defaultDescription: 0x3fff * 0x3fff,
     desc: "Do not process input images where the number of pixels (width x height) exceeds this limit",
     group: input,
+    nargs: 1,
+    type: "number",
+  },
+  limitInputChannels: {
+    defaultDescription: 5,
+    desc: "Do not process input images where the number of channels exceeds this limit",
+    group: input,
+    nargs: 1,
     type: "number",
   },
   page: {
     defaultDescription: 0,
     desc: "Page number to start extracting from for multi-page input",
     group: input,
+    nargs: 1,
     type: "number",
   },
   pages: {
     defaultDescription: 1,
     desc: "Number of pages to extract for multi-page input",
     group: input,
+    nargs: 1,
     type: "number",
   },
   pdfBackground: {
@@ -142,6 +205,7 @@ const inputOptions = {
     defaultDescription: -1,
     desc: "subIFD to extract for OME-TIFF",
     group: input,
+    nargs: 1,
     type: "number",
   },
   unlimited: {
@@ -165,6 +229,7 @@ const outputOptions = {
     desc: "zlib compression level",
     defaultDescription: 6,
     group: output,
+    nargs: 1,
     type: "number",
   },
 
@@ -184,6 +249,14 @@ const outputOptions = {
     type: "boolean",
   },
 
+  // @see https://sharp.pixelplumbing.com/api-output#keepgainmap
+  keepGainMap: {
+    conflicts: "withGainMap",
+    desc: "Attempt to process the image and gain map separately, recombining them into a single output image",
+    group: output,
+    type: "boolean",
+  },
+
   // @see https://sharp.pixelplumbing.com/api-output#withmetadata
   metadata: {
     alias: ["m", "withMetadata"],
@@ -194,6 +267,7 @@ const outputOptions = {
   "metadata.density": {
     desc: "Number of pixels per inch (DPI)",
     group: output,
+    nargs: 1,
     type: "number",
   },
   "metadata.exif": {
@@ -211,9 +285,26 @@ const outputOptions = {
   "metadata.orientation": {
     desc: "Used to update the EXIF Orientation tag",
     group: output,
+    nargs: 1,
     type: "number",
   },
 
+  // @see https://sharp.pixelplumbing.com/api-output#withdensity
+  withDensity: {
+    desc: "Set output density (DPI) in EXIF metadata",
+    group: output,
+    nargs: 1,
+    type: "number",
+  },
+
+  // @see https://sharp.pixelplumbing.com/api-output#withgainmap
+  withGainMap: {
+    conflicts: "keepGainMap",
+    desc: "Convert the main image to HDR (High Dynamic Range) before further processing",
+    group: output,
+    type: "boolean",
+  },
+
   // @see https://sharp.pixelplumbing.com/api-output#jpeg
   // @see https://sharp.pixelplumbing.com/api-output#png
   progressive: {
@@ -232,6 +323,7 @@ const outputOptions = {
     desc: "Quality",
     defaultDescription: "80",
     group: output,
+    nargs: 1,
     type: "number",
   },
 };
@@ -249,6 +341,7 @@ const optimizationOptions = {
     desc: "Quality of alpha layer",
     defaultDescription: "80",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -258,6 +351,7 @@ const optimizationOptions = {
     defaultDescription: 8,
     desc: "Reduce bitdepth to 1, 2, or 4 bit",
     group: optimize,
+    nargs: 1,
   },
 
   // @see https://sharp.pixelplumbing.com/api-output#avif
@@ -276,6 +370,7 @@ const optimizationOptions = {
     defaultDescription: 256,
     desc: "Maximum number of palette entries",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -291,6 +386,7 @@ const optimizationOptions = {
   delay: {
     desc: "Delay(s) between animation frames",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -300,6 +396,7 @@ const optimizationOptions = {
     desc: "Level of Floyd-Steinberg error diffusion",
     defaultDescription: "1.0",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -312,15 +409,24 @@ const optimizationOptions = {
     defaultDescription: "7 (GIF, PNG) / 4",
     desc: "Level of CPU effort to reduce file size",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
+  // @see https://sharp.pixelplumbing.com/api-output#webp
+  exact: {
+    desc: "Preserve the colour data in transparent pixels",
+    group: optimize,
+    type: "boolean",
+  },
+
   // @see https://sharp.pixelplumbing.com/api-output#heif
   hbitdepth: {
     choices: [8, 10, 12],
     defaultDescription: 8,
     desc: "Set bitdepth to 8, 10, or 12 bit",
     group: optimize,
+    nargs: 1,
   },
 
   // @see https://sharp.pixelplumbing.com/api-output#heif
@@ -335,6 +441,7 @@ const optimizationOptions = {
   interFrameMaxError: {
     desc: "Maximum inter-frame error for transparency",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -342,6 +449,7 @@ const optimizationOptions = {
   interPaletteMaxError: {
     desc: "Maximum inter-palette error for palette reuse",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -350,6 +458,7 @@ const optimizationOptions = {
     default: 0,
     desc: "Number of animation iterations",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -465,6 +574,7 @@ const optimizationOptions = {
     defaultDescription: "0",
     desc: "Quantization table to use",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -510,6 +620,7 @@ const optimizationOptions = {
   tileHeight: {
     desc: "Vertical tile size",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -517,6 +628,7 @@ const optimizationOptions = {
   tileWidth: {
     desc: "Horizontal tile size",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -527,11 +639,21 @@ const optimizationOptions = {
     type: "boolean",
   },
 
+  // @see https://sharp.pixelplumbing.com/api-output#avif
+  // @see https://sharp.pixelplumbing.com/api-output#heif
+  tune: {
+    choices: constants.TUNE,
+    defaultDescription: "auto",
+    desc: "Tune output for a quality metric",
+    group: optimize,
+  },
+
   // @see https://sharp.pixelplumbing.com/api-output#tiff
   xres: {
     defaultDescription: "1.0",
     desc: "Horizontal resolution",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 
@@ -540,6 +662,7 @@ const optimizationOptions = {
     defaultDescription: "1.0",
     desc: "Vertical resolution",
     group: optimize,
+    nargs: 1,
     type: "number",
   },
 };
@@ -551,8 +674,13 @@ const options = {
   ...optimizationOptions,
 };
 
+// Helpers.
+function createContext() {
+  return { "#queue": [] };
+}
+
 // Configure.
-const cli = yargs
+const cli = yargs()
   .parserConfiguration({ "populate--": true })
   .strict()
   .usage("$0 <options> [command..]")
@@ -591,324 +719,336 @@ const cli = yargs
   .group(["help", "version"], "Misc. Options")
 
   // Commands.
-  // Avoid `yargs.commandDir()` as it uses insertion order, not alphabetical.
-  .command(require("../cmd/operations/affine"))
-  .command(require("../cmd/channel-manipulation/bandbool"))
-  .command(require("../cmd/operations/blur"))
-  .command(require("../cmd/operations/boolean"))
-  .command(require("../cmd/operations/clahe"))
-  .command(require("../cmd/compositing/composite"))
-  .command(require("../cmd/operations/convolve"))
-  .command(require("../cmd/operations/dilate"))
-  .command(require("../cmd/channel-manipulation/ensure-alpha"))
-  .command(require("../cmd/operations/erode"))
-  .command(require("../cmd/resizing/extend"))
-  .command(require("../cmd/resizing/extract"))
-  .command(require("../cmd/channel-manipulation/extract-channel"))
-  .command(require("../cmd/operations/flatten"))
-  .command(require("../cmd/operations/flip"))
-  .command(require("../cmd/operations/flop"))
-  .command(require("../cmd/operations/gamma"))
-  .command(require("../cmd/colour-manipulation/greyscale"))
-  .command(require("../cmd/channel-manipulation/join-channel"))
-  .command(require("../cmd/operations/linear"))
-  .command(require("../cmd/operations/median"))
-  .command(require("../cmd/operations/modulate"))
-  .command(require("../cmd/operations/negate"))
-  .command(require("../cmd/operations/normalise"))
-  .command(require("../cmd/colour-manipulation/pipeline-colourspace"))
-  .command(require("../cmd/operations/recomb"))
-  .command(require("../cmd/channel-manipulation/remove-alpha"))
-  .command(require("../cmd/resizing/resize"))
-  .command(require("../cmd/operations/rotate"))
-  .command(require("../cmd/operations/sharpen"))
-  .command(require("../cmd/operations/threshold"))
-  .command(require("../cmd/colour-manipulation/tint"))
-  .command(require("../cmd/output"))
-  .command(require("../cmd/colour-manipulation/tocolourspace"))
-  .command(require("../cmd/resizing/trim"))
-  .command(require("../cmd/operations/unflatten"));
-
-// Helpers.
-const originalParse = cli.parse.bind(cli);
-const promisifiedParse = (...args) => {
-  return new Promise((resolve, reject) => {
-    originalParse(...args, (err, argv, output) => {
-      if (err) {
-        reject(err);
-      }
-      if (argv.v || argv.help) {
-        reject(output);
-      }
+  .command(affine)
+  .command(bandbool)
+  .command(blur)
+  .command(boolean)
+  .command(clahe)
+  .command(composite)
+  .command(convolve)
+  .command(dilate)
+  .command(ensureAlpha)
+  .command(erode)
+  .command(extend)
+  .command(extract)
+  .command(extractChannel)
+  .command(flatten)
+  .command(flip)
+  .command(flop)
+  .command(gamma)
+  .command(greyscale)
+  .command(joinChannel)
+  .command(linear)
+  .command(median)
+  .command(modulate)
+  .command(negate)
+  .command(normalise)
+  .command(pipelineColourspace)
+  .command(recomb)
+  .command(removeAlpha)
+  .command(resize)
+  .command(rotate)
+  .command(sharpen)
+  .command(threshold)
+  .command(tint)
+  .command(tile)
+  .command(toColourspace)
+  .command(trim)
+  .command(unflatten);
+
+// Intercept parsing as to orchestrate commands.
+cli.parseAsync = async function (args, context = createContext()) {
+  // Capture parsing result as a promise.
+  const argv = await new Promise((resolve, reject) => {
+    return cli.parse(args, context, (err, argv, output) => {
+      if (err) reject(err);
+      if (argv.help || argv.v) reject(output);
       resolve(argv);
     });
   });
-};
 
-// Exports.
-module.exports = cli;
-module.exports.inputOptions = Object.keys(inputOptions);
-module.exports.parse = function recursiveParse(args, context = {}) {
-  return promisifiedParse(args, context).then((argv) => {
-    // Handle arguments.
-    // NOTE Use queue.unshift to apply global options first.
-
-    // Global options.
-
-    // Require at least one input file.
-    // NOTE: check here b/c https://github.com/yargs/yargs/issues/403
-    if (argv.input && argv.input.length === 0) {
-      throw new Error("Not enough arguments following: i, input");
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#timeout
-    if (argv.timeout) {
-      queue.unshift([
-        "timeout",
-        (sharp) => sharp.timeout({ seconds: argv.timeout }),
-      ]);
-    }
-
-    // Output options.
-
-    // @see https://sharp.pixelplumbing.com/api-output#toformat
-    if (argv.format) {
-      queue.unshift([
-        "format",
-        (sharp) =>
-          sharp.toFormat(argv.format, { compression: argv.hcompression }),
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#withmetadata
-    if (argv.metadata) {
-      queue.unshift([
-        "withMetadata",
-        (sharp) => sharp.withMetadata(argv.metadata),
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#heif
-    const { heif } = sharp.format;
-    if (
-      argv.hcompression !== optimizationOptions.hcompression.default || // HEIF-specific.
-      // Ensure libheif is installed before applying generic options.
-      (heif.input &&
-        heif.input.file &&
-        (argv.effort !== undefined ||
-          argv.hbitdepth ||
-          argv.lossless ||
-          argv.quality))
-    ) {
-      queue.unshift([
-        "heif",
-        (sharp) => {
-          return sharp.heif({
-            bitdepth: argv.hbitdepth,
-            compression: argv.hcompression,
-            effort: argv.effort,
-            force: false,
-            lossless: argv.lossless,
-            quality: argv.quality,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#avif
-    if (
-      argv.chromaSubsampling ||
-      argv.effort !== undefined ||
-      argv.lossless ||
-      argv.quality
-    ) {
-      queue.unshift([
-        "avif",
-        (sharp) => {
-          return sharp.avif({
-            chromaSubsampling: argv.chromaSubsampling,
-            effort: argv.effort,
-            force: false,
-            lossless: argv.lossless,
-            quality: argv.quality,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#gif
-    if (
-      argv.colors ||
-      argv.effort !== undefined ||
-      argv.dither !== undefined ||
-      argv.interFrameMaxError ||
-      argv.interPaletteMaxError ||
-      argv.keepDuplicateFrames ||
-      argv.loop ||
-      argv.delay !== undefined ||
-      argv.progressive ||
-      argv.reuse
-    ) {
-      queue.unshift([
-        "gif",
-        (sharp) => {
-          return sharp.gif({
-            colors: argv.colors,
-            force: false,
-            effort: argv.effort,
-            dither: argv.dither,
-            interFrameMaxError: argv.interFrameMaxError,
-            interPaletteMaxError: argv.interPaletteMaxError,
-            keepDuplicateFrames: argv.keepDuplicateFrames,
-            loop: argv.loop,
-            delay: argv.delay,
-            progressive: argv.progressive,
-            reuse: argv.reuse,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#jpeg
-    if (
-      argv.chromaSubsampling ||
-      argv.mozjpeg ||
-      argv.optimise ||
-      argv.optimiseCoding !== true ||
-      argv.optimiseScans ||
-      argv.overshootDeringing ||
-      argv.progressive ||
-      argv.quantisationTable ||
-      argv.quality ||
-      argv.trellisQuantisation
-    ) {
-      queue.unshift([
-        "jpeg",
-        (sharp) => {
-          return sharp.jpeg({
-            chromaSubsampling: argv.chromaSubsampling,
-            force: false,
-            mozjpeg: argv.mozjpeg,
-            optimiseCoding: argv.optimiseCoding,
-            optimiseScans: argv.optimise || argv.optimiseScans,
-            overshootDeringing: argv.optimise || argv.overshootDeringing,
-            progressive: argv.progressive,
-            quality: argv.quality,
-            quantisationTable: argv.quantisationTable,
-            trellisQuantisation: argv.optimise || argv.trellisQuantisation,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#png
-    if (
-      argv.adaptiveFiltering ||
-      argv.colors ||
-      argv.compressionLevel !== undefined ||
-      argv.dither !== undefined ||
-      argv.effort ||
-      argv.palette ||
-      argv.progressive
-    ) {
-      queue.unshift([
-        "png",
-        (sharp) => {
-          return sharp.png({
-            adaptiveFiltering: argv.adaptiveFiltering,
-            colors: argv.colors,
-            compressionLevel: argv.compressionLevel,
-            dither: argv.dither,
-            effort: argv.effort,
-            force: false,
-            palette: argv.palette,
-            progressive: argv.progressive,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#tiff
-    if (
-      argv.bigtiff ||
-      argv.bitdepth ||
-      argv.compression !== optimizationOptions.compression.default ||
-      argv.predictor !== optimizationOptions.predictor.default ||
-      argv.miniswhite ||
-      argv.pyramid ||
-      argv.quality ||
-      argv.resolutionUnit ||
-      argv.tileBackground ||
-      argv.tileHeight ||
-      argv.tileWidth ||
-      argv.xres ||
-      argv.yres
-    ) {
-      queue.unshift([
-        "tiff",
-        (sharp) => {
-          return sharp.tiff({
-            background: argv.tileBackground,
-            bigtiff: argv.bigtiff,
-            bitdepth: argv.bitdepth,
-            compression: argv.compression,
-            force: false,
-            miniswhite: argv.miniswhite,
-            predictor: argv.predictor,
-            pyramid: argv.pyramid,
-            quality: argv.quality,
-            resolutionUnit: argv.resolutionUnit,
-            tile: argv.tileWidth !== undefined || argv.tileHeight !== undefined,
-            tileHeight: argv.tileHeight || argv.tileWidth,
-            tileWidth: argv.tileWidth || argv.tileHeight,
-            xres: argv.xres,
-            yres: argv.yres,
-          });
-        },
-      ]);
-    }
-
-    // @see https://sharp.pixelplumbing.com/api-output#webp
-    if (
-      argv.alphaQuality ||
-      argv.quality ||
-      argv.lossless ||
-      argv.minSize ||
-      argv.mixed ||
-      argv.nearLossless ||
-      argv.effort !== undefined ||
-      argv.preset !== optimizationOptions.preset.default ||
-      argv.smartDeblock ||
-      argv.smartSubsample
-    ) {
-      queue.unshift([
-        "webp",
-        (sharp) => {
-          return sharp.webp({
-            alphaQuality: argv.alphaQuality,
-            effort: argv.effort,
-            force: false,
-            lossless: argv.lossless,
-            minSize: argv.minSize,
-            mixed: argv.mixed,
-            nearLossless: argv.nearLossless,
-            preset: argv.preset,
-            quality: argv.quality,
-            smartDeblock: argv.smartDeblock,
-            smartSubsample: argv.smartSubsample,
-          });
-        },
-      ]);
-    }
-
-    // Invoke with remaining arguments (if any).
-    const { "--": remainingargv = [] } = argv;
-    if (remainingargv.length > 0) {
-      return recursiveParse(remainingargv, {
-        ...context,
-        ...pick(argv, Object.keys(options)), // Retain options.
-      });
-    }
-    return argv;
-  });
+  // Invoke with remaining arguments (if any). Carry over global options.
+  const remainingArgv = argv["--"] ?? [];
+  if (remainingArgv.length > 0) {
+    const globalArgv = pick(argv, Object.keys(options));
+    return cli.default(globalArgv).parseAsync(remainingArgv, context);
+  }
+
+  // Apply global options (once).
+  const queue = context["#queue"];
+
+  // @see https://sharp.pixelplumbing.com/api-output#timeout
+  if (argv.timeout) {
+    queue.unshift([
+      "timeout",
+      (sharp) => sharp.timeout({ seconds: argv.timeout }),
+    ]);
+  }
+
+  // Output options.
+
+  // @see https://sharp.pixelplumbing.com/api-output#toformat
+  if (argv.format) {
+    queue.unshift([
+      "format",
+      (sharp) =>
+        sharp.toFormat(argv.format, { compression: argv.hcompression }),
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#keepgainmap
+  if (argv.keepGainMap) {
+    queue.unshift(["keepGainMap", (sharp) => sharp.keepGainMap()]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#withmetadata
+  if (argv.metadata) {
+    queue.unshift([
+      "withMetadata",
+      (sharp) => sharp.withMetadata(argv.metadata),
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#withdensity
+  if (argv.withDensity !== undefined) {
+    queue.unshift([
+      "withDensity",
+      (sharp) => sharp.withDensity(argv.withDensity),
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#withgainmap
+  if (argv.withGainMap) {
+    queue.unshift(["withGainMap", (sharp) => sharp.withGainMap()]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#heif
+  const { heif } = sharp.format;
+  if (
+    argv.hcompression !== optimizationOptions.hcompression.default || // HEIF-specific.
+    // Ensure libheif is installed before applying generic options.
+    (heif.input &&
+      heif.input.file &&
+      (argv.effort !== undefined ||
+        argv.hbitdepth ||
+        argv.lossless ||
+        argv.quality ||
+        argv.tune))
+  ) {
+    queue.unshift([
+      "heif",
+      (sharp, { format } = {}) => {
+        if (format && format !== "heif") return sharp;
+        return sharp.heif({
+          bitdepth: argv.hbitdepth,
+          compression: argv.hcompression,
+          effort: argv.effort,
+          force: false,
+          lossless: argv.lossless,
+          quality: argv.quality,
+          tune: argv.tune,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#avif
+  if (
+    argv.chromaSubsampling ||
+    argv.effort !== undefined ||
+    argv.lossless ||
+    argv.quality ||
+    argv.tune
+  ) {
+    queue.unshift([
+      "avif",
+      (sharp, { format } = {}) => {
+        if (format && format !== "avif") return sharp;
+        return sharp.avif({
+          chromaSubsampling: argv.chromaSubsampling,
+          effort: argv.effort,
+          force: false,
+          lossless: argv.lossless,
+          quality: argv.quality,
+          tune: argv.tune,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#gif
+  if (
+    argv.colors ||
+    argv.effort !== undefined ||
+    argv.dither !== undefined ||
+    argv.interFrameMaxError ||
+    argv.interPaletteMaxError ||
+    argv.keepDuplicateFrames ||
+    argv.loop ||
+    argv.delay !== undefined ||
+    argv.progressive ||
+    argv.reuse
+  ) {
+    queue.unshift([
+      "gif",
+      (sharp, { format } = {}) => {
+        if (format && format !== "gif") return sharp;
+        return sharp.gif({
+          colors: argv.colors,
+          force: false,
+          effort: argv.effort,
+          dither: argv.dither,
+          interFrameMaxError: argv.interFrameMaxError,
+          interPaletteMaxError: argv.interPaletteMaxError,
+          keepDuplicateFrames: argv.keepDuplicateFrames,
+          loop: argv.loop,
+          delay: argv.delay,
+          progressive: argv.progressive,
+          reuse: argv.reuse,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#jpeg
+  if (
+    argv.chromaSubsampling ||
+    argv.mozjpeg ||
+    argv.optimise ||
+    argv.optimiseCoding !== true ||
+    argv.optimiseScans ||
+    argv.overshootDeringing ||
+    argv.progressive ||
+    argv.quantisationTable ||
+    argv.quality ||
+    argv.trellisQuantisation
+  ) {
+    queue.unshift([
+      "jpeg",
+      (sharp, { format } = {}) => {
+        if (format && format !== "jpeg") return sharp;
+        return sharp.jpeg({
+          chromaSubsampling: argv.chromaSubsampling,
+          force: false,
+          mozjpeg: argv.mozjpeg,
+          optimiseCoding: argv.optimiseCoding,
+          optimiseScans: argv.optimise || argv.optimiseScans,
+          overshootDeringing: argv.optimise || argv.overshootDeringing,
+          progressive: argv.progressive,
+          quality: argv.quality,
+          quantisationTable: argv.quantisationTable,
+          trellisQuantisation: argv.optimise || argv.trellisQuantisation,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#png
+  if (
+    argv.adaptiveFiltering ||
+    argv.colors ||
+    argv.compressionLevel !== undefined ||
+    argv.dither !== undefined ||
+    argv.effort ||
+    argv.palette ||
+    argv.progressive
+  ) {
+    queue.unshift([
+      "png",
+      (sharp, { format } = {}) => {
+        if (format && format !== "png") return sharp;
+        return sharp.png({
+          adaptiveFiltering: argv.adaptiveFiltering,
+          colors: argv.colors,
+          compressionLevel: argv.compressionLevel,
+          dither: argv.dither,
+          effort: argv.effort,
+          force: false,
+          palette: argv.palette,
+          progressive: argv.progressive,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#tiff
+  if (
+    argv.bigtiff ||
+    argv.bitdepth ||
+    argv.compression !== optimizationOptions.compression.default ||
+    argv.predictor !== optimizationOptions.predictor.default ||
+    argv.miniswhite ||
+    argv.pyramid ||
+    argv.quality ||
+    argv.resolutionUnit ||
+    argv.tileBackground ||
+    argv.tileHeight ||
+    argv.tileWidth ||
+    argv.xres ||
+    argv.yres
+  ) {
+    queue.unshift([
+      "tiff",
+      (sharp, { format } = {}) => {
+        if (format && format !== "tiff") return sharp;
+        return sharp.tiff({
+          background: argv.tileBackground,
+          bigtiff: argv.bigtiff,
+          bitdepth: argv.bitdepth,
+          compression: argv.compression,
+          force: false,
+          miniswhite: argv.miniswhite,
+          predictor: argv.predictor,
+          pyramid: argv.pyramid,
+          quality: argv.quality,
+          resolutionUnit: argv.resolutionUnit,
+          tile: argv.tileWidth !== undefined || argv.tileHeight !== undefined,
+          tileHeight: argv.tileHeight || argv.tileWidth,
+          tileWidth: argv.tileWidth || argv.tileHeight,
+          xres: argv.xres,
+          yres: argv.yres,
+        });
+      },
+    ]);
+  }
+
+  // @see https://sharp.pixelplumbing.com/api-output#webp
+  if (
+    argv.alphaQuality ||
+    argv.quality ||
+    argv.lossless ||
+    argv.minSize ||
+    argv.mixed ||
+    argv.nearLossless ||
+    argv.effort !== undefined ||
+    argv.exact ||
+    argv.preset !== optimizationOptions.preset.default ||
+    argv.smartDeblock ||
+    argv.smartSubsample
+  ) {
+    queue.unshift([
+      "webp",
+      (sharp, { format } = {}) => {
+        if (format && format !== "webp") return sharp;
+        return sharp.webp({
+          alphaQuality: argv.alphaQuality,
+          effort: argv.effort,
+          exact: argv.exact,
+          force: false,
+          lossless: argv.lossless,
+          minSize: argv.minSize,
+          mixed: argv.mixed,
+          nearLossless: argv.nearLossless,
+          preset: argv.preset,
+          quality: argv.quality,
+          smartDeblock: argv.smartDeblock,
+          smartSubsample: argv.smartSubsample,
+        });
+      },
+    ]);
+  }
+
+  return argv;
 };
+
+export default cli;