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

package/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.10.0"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint and test
+        run: npm test

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 6.1.0 (August 31, 2026)
+
+- Added a `{path}` output template for preserving directories matched by glob inputs ([#43](https://github.com/vseventer/sharp-cli/issues/43)).
+- Added percentage-based dimensions to the `resize` command ([#49](https://github.com/vseventer/sharp-cli/issues/49)).
+- Updated `sharp` dependency to 0.35.4.
+
+## 6.0.0 (August 21, 2026)
+
+- Added [`--limitInputChannels`](https://sharp.pixelplumbing.com/api-constructor/) input option.
+- Added `--dry` option to process images without writing output files.
+- Added [`--exact`](https://sharp.pixelplumbing.com/api-output#webp) output option.
+- Added [`--keepGainMap`](https://sharp.pixelplumbing.com/api-output#keepgainmap) and [`--withGainMap`](https://sharp.pixelplumbing.com/api-output#withgainmap) output options.
+- Added `--print` option to print input and output metadata as JSON ([#48](https://github.com/vseventer/sharp-cli/issues/48)).
+- Added [`--tune`](https://sharp.pixelplumbing.com/api-output#avif) output option.
+- Added [`--withDensity`](https://sharp.pixelplumbing.com/api-output#withdensity) output option.
+- Added [`--margin`](https://sharp.pixelplumbing.com/api-resize#trim) option to the `trim` command.
+- Removed `jpg` output format alias; use `jpeg` instead.
+- Added graceful handling of partial failures during batch image processing ([#98](https://github.com/vseventer/sharp-cli/issues/98)).
+- Fixes bug where format options could cause errors. Consequently, removed `jpg` output format alias; use `jpeg` instead ([#92](https://github.com/vseventer/sharp-cli/issues/92)).
+- Drop `must` dependency in favor of Node.js native `assert`.
+- Internal refactor from CommonJS to ESM.
+- Tightened `yargs` option configuration to require values.
+- Updated `sharp` dependency to 0.35.3.
+- Updated dependencies.
+- Requires Node.js 20.10.
+
 ## 5.3.0 (August 13, 2026)
 
 > Last release compatible with Node.js 18.

package/README.md

@@ -13,20 +13,17 @@ npm install @depup/sharp-cli
 
 | Field | Value |
 |-------|-------|
-| Original | [sharp-cli](https://www.npmjs.com/package/sharp-cli) @ 5.3.0 |
-| Processed | 2026-08-16 |
-| Smoke test | failed |
-| Deps updated | 5 |
+| Original | [sharp-cli](https://www.npmjs.com/package/sharp-cli) @ 6.1.0 |
+| Processed | 2026-09-06 |
+| Smoke test | passed |
+| Deps updated | 2 |
 
 ## Dependency Changes
 
 | Dependency | From | To |
 |------------|------|-----|
-| glob | 10.5.x | ^13.0.6 |
-| is-directory | 0.3.x | ^0.3.1 |
-| lodash.pick | 3.1.0 | ^4.4.0 |
-| sharp | 0.34.5 | ^0.35.3 |
-| yargs | ^17.6.2 | ^18.1.0 |
+| glob | 13.0.x | ^13.0.6 |
+| yargs | 17.7.x | ^18.1.0 |
 
 ---
 

package/bin/cli.js

@@ -22,11 +22,11 @@
  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
-// Strict mode.
-"use strict";
-
 // Package modules.
-const { hideBin } = require("yargs/helpers");
+import { hideBin } from "yargs/helpers";
+
+// Local modules.
+import sharp from "../lib/index.js";
 
 // Run.
-require("../lib")(hideBin(process.argv));
+sharp(hideBin(process.argv));

package/changes.json

@@ -1,26 +1,14 @@
 {
   "bumped": {
     "glob": {
-      "from": "10.5.x",
+      "from": "13.0.x",
       "to": "^13.0.6"
     },
-    "is-directory": {
-      "from": "0.3.x",
-      "to": "^0.3.1"
-    },
-    "lodash.pick": {
-      "from": "3.1.0",
-      "to": "^4.4.0"
-    },
-    "sharp": {
-      "from": "0.34.5",
-      "to": "^0.35.3"
-    },
     "yargs": {
-      "from": "^17.6.2",
+      "from": "17.7.x",
       "to": "^18.1.0"
     }
   },
-  "timestamp": "2026-08-16T00:30:09.495Z",
-  "totalUpdated": 5
+  "timestamp": "2026-09-06T01:03:46.036Z",
+  "totalUpdated": 2
 }

package/cmd/channel-manipulation/bandbool.js

@@ -23,12 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#bandbool
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Configure.
 const positionals = {
@@ -54,11 +50,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push(["bandbool", (sharp) => sharp.bandbool(args.operator)]);
+  return args["#queue"].push([
+    "bandbool",
+    (sharp) => sharp.bandbool(args.operator),
+  ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "bandbool <operator>",
   describe:
     "Perform a bitwise boolean operation on all input image channels (bands) to produce a single channel output image",

package/cmd/channel-manipulation/ensure-alpha.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#ensurealpha
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Configure.
 const positionals = {
   alpha: {
@@ -58,11 +52,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push(["ensureAlpha", (sharp) => sharp.ensureAlpha(args.alpha)]);
+  return args["#queue"].push([
+    "ensureAlpha",
+    (sharp) => sharp.ensureAlpha(args.alpha),
+  ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "ensureAlpha [alpha]",
   describe: "Ensure the output image has an alpha transparency channel",
   builder,

package/cmd/channel-manipulation/extract-channel.js

@@ -23,12 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#extractchannel
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Configure.
 const positionals = {
@@ -54,14 +50,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "extractChannel",
     (sharp) => sharp.extractChannel(args.channel),
   ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "extractChannel <channel>",
   describe: "Extract a single channel from a multi-channel image",
   builder,

package/cmd/channel-manipulation/join-channel.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#joinchannel
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Configure.
 const positionals = {
   images: {
@@ -50,11 +44,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push(["joinChannel", (sharp) => sharp.joinChannel(args.images)]);
+  return args["#queue"].push([
+    "joinChannel",
+    (sharp) => sharp.joinChannel(args.images),
+  ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "joinChannel <images..>",
   describe: "Join one or more channels to the image",
   builder,

package/cmd/channel-manipulation/remove-alpha.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#removealpha
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Command builder.
 const builder = (yargs) => {
   return yargs
@@ -41,10 +35,10 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) =>
-  queue.push(["removeAlpha", (sharp) => sharp.removeAlpha()]);
+  args["#queue"].push(["removeAlpha", (sharp) => sharp.removeAlpha()]);
 
 // Exports.
-module.exports = {
+export default {
   command: "removeAlpha",
   describe: "Remove alpha channel, if any",
   builder,

package/cmd/colour-manipulation/greyscale.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#greyscale
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Command builder.
 const builder = (yargs) => {
   return yargs
@@ -44,10 +38,10 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) =>
-  queue.push(["greyscale", (sharp) => sharp.greyscale()]);
+  args["#queue"].push(["greyscale", (sharp) => sharp.greyscale()]);
 
 // Exports.
-module.exports = {
+export default {
   command: "greyscale",
   aliases: "grayscale",
   describe: "Convert to 8-bit greyscale; 256 shades of grey",

package/cmd/colour-manipulation/pipeline-colourspace.js

@@ -1,7 +1,7 @@
 /*!
  * The MIT License (MIT)
  *
- * Copyright (c) 2022 Mark van Seventer
+ * Copyright (c) 2019 Mark van Seventer
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of
  * this software and associated documentation files (the "Software"), to deal in
@@ -23,12 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#tocolourspace
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Configure.
 const positionals = {
@@ -55,14 +51,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "pipelineColourspace",
     (sharp) => sharp.pipelineColourspace(args.colourspace),
   ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "pipelineColourspace <colourspace>",
   aliases: "pipelineColorspace",
   describe: "Set the pipeline colourspace",

package/cmd/colour-manipulation/tint.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#tint
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Configure.
 const positionals = {
   rgb: {
@@ -49,10 +43,11 @@ const builder = (yargs) => {
 };
 
 // Command handler.
-const handler = (args) => queue.push(["tint", (sharp) => sharp.tint(args.rgb)]);
+const handler = (args) =>
+  args["#queue"].push(["tint", (sharp) => sharp.tint(args.rgb)]);
 
 // Exports.
-module.exports = {
+export default {
   command: "tint <rgb>",
   describe:
     "Tint the image using the provided chroma while preserving the image luminance",

package/cmd/colour-manipulation/tocolourspace.js

@@ -23,12 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#tocolourspace
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Configure.
 const positionals = {
@@ -52,14 +48,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "toColourspace",
     (sharp) => sharp.toColourspace(args.colourspace),
   ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "toColourspace <colourspace>",
   aliases: "toColorspace",
   describe: "Set the output colourspace",

package/cmd/compositing/composite.js

@@ -23,12 +23,8 @@
 
 // @see http://sharp.pixelplumbing.com/api-composite#composite
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Helpers.
 function getValueAt(arrayLike, index) {
@@ -70,18 +66,22 @@ const options = {
     choices: [3, 4],
     default: 3,
     desc: "Number of channels of the blank overlay to be created",
+    nargs: 1,
   },
   "create.height": {
     desc: "Height of the blank overlay to be created",
+    nargs: 1,
     type: "number",
   },
   "create.width": {
     desc: "Width of the blank overlay to be created",
+    nargs: 1,
     type: "number",
   },
   density: {
     desc: "Number representing the DPI for vector images",
     defaultDescription: 72,
+    nargs: 1,
     type: "number",
   },
   gravity: {
@@ -92,6 +92,7 @@ const options = {
   left: {
     desc: "The pixel offset from the left edge",
     implies: "top",
+    nargs: 1,
     type: "number",
   },
   premultiplied: {
@@ -105,6 +106,7 @@ const options = {
   top: {
     desc: "The pixel offset from the top edge",
     implies: "left",
+    nargs: 1,
     type: "number",
   },
 };
@@ -180,7 +182,7 @@ const handler = (args) => {
   if (args.images) inputs.push(...args.images);
 
   // @see http://sharp.pixelplumbing.com/api-composite#composite
-  return queue.push([
+  return args["#queue"].push([
     "composite",
     (sharp) => {
       return sharp.composite(
@@ -194,6 +196,7 @@ const handler = (args) => {
           ignoreIcc: getValueAt(args.ignoreIcc),
           input,
           left: getValueAt(args.left, idx),
+          limitInputChannels: args.limitInputChannels,
           limitInputPixels: args.limitInputPixels,
           pdfBackground: args.pdfBackground,
           premultiplied: getValueAt(args.premultiplied, idx),
@@ -206,7 +209,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "composite [images..]",
   describe:
     "Composite image(s) over the processed (resized, extracted etc.) image",

package/cmd/operations/affine.js

@@ -1,7 +1,7 @@
 /*!
  * The MIT License (MIT)
  *
- * Copyright (c) 2022 Mark van Seventer
+ * Copyright (c) 2019 Mark van Seventer
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of
  * this software and associated documentation files (the "Software"), to deal in
@@ -23,15 +23,9 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#affine
 
-// Strict mode.
-"use strict";
-
-// Package modules.
-const pick = require("lodash.pick");
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
+import { pick } from "../../lib/utils.js";
 
 // Configure.
 const placeholders = {
@@ -51,21 +45,25 @@ const options = {
   idx: {
     defaultDescription: "0",
     desc: "The input horizontal offset",
+    nargs: 1,
     type: "number",
   },
   idy: {
     defaultDescription: "0",
     desc: "The input vertical offset",
+    nargs: 1,
     type: "number",
   },
   odx: {
     defaultDescription: "0",
     desc: "The output horizontal offset",
+    nargs: 1,
     type: "number",
   },
   ody: {
     defaultDescription: "0",
     desc: "The output vertical offset",
+    nargs: 1,
     type: "number",
   },
   interpolate: {
@@ -97,7 +95,7 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "affine",
     (sharp) => {
       const { matrix } = args;
@@ -110,7 +108,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "affine <matrix..>",
   describe: "Perform an affine transform on an image",
   builder,

package/cmd/operations/blur.js

@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#blur
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Configure.
 const positionals = {
   sigma: {
@@ -42,6 +36,7 @@ const options = {
   minAmplitude: {
     defaultDescription: 0.2,
     desc: "A smaller value will generate a larger, more accurate mask",
+    nargs: 1,
     type: "number",
   },
   precision: {
@@ -71,7 +66,7 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "blur",
     (sharp) => {
       if (args.minAmplitude || args.precision) {
@@ -87,7 +82,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "blur [sigma]",
   describe: "Blur the image",
   builder,

package/cmd/operations/boolean.js

@@ -23,12 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#boolean
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const constants = require("../../lib/constants");
-const queue = require("../../lib/queue");
+import constants from "../../lib/constants.js";
 
 // Configure.
 const positionals = {
@@ -56,14 +52,14 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "boolean",
     (sharp) => sharp.boolean(args.operand, args.operator),
   ]);
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "boolean <operand> <operator>",
   describe: "Perform a bitwise boolean operation with operand image",
   builder,

package/cmd/operations/clahe.js

@@ -1,7 +1,7 @@
 /*!
  * The MIT License (MIT)
  *
- * Copyright (c) 2022 Mark van Seventer
+ * Copyright (c) 2019 Mark van Seventer
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of
  * this software and associated documentation files (the "Software"), to deal in
@@ -23,12 +23,6 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#clahe
 
-// Strict mode.
-"use strict";
-
-// Local modules.
-const queue = require("../../lib/queue");
-
 // Configure.
 const positionals = {
   height: {
@@ -45,6 +39,7 @@ const options = {
   maxSlope: {
     defaultDescription: 3,
     desc: "Maximum value for the slope of the cumulative histogram",
+    nargs: 1,
     type: "number",
   },
 };
@@ -66,7 +61,7 @@ const builder = (yargs) => {
 
 // Command handler.
 const handler = (args) => {
-  return queue.push([
+  return args["#queue"].push([
     "clahe",
     (sharp) => {
       return sharp.clahe({
@@ -79,7 +74,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "clahe <width> <height>",
   describe: "Perform contrast limiting adaptive histogram equalization CLAHE",
   builder,