Esm refactor

.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.9.0"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint and test
+        run: npm test

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));

cmd/channel-manipulation/bandbool.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -58,7 +55,7 @@ const handler = (args) => {
 };
 
 // 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",

cmd/channel-manipulation/ensure-alpha.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#ensurealpha
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -62,7 +59,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "ensureAlpha [alpha]",
   describe: "Ensure the output image has an alpha transparency channel",
   builder,

cmd/channel-manipulation/extract-channel.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -61,7 +58,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "extractChannel <channel>",
   describe: "Extract a single channel from a multi-channel image",
   builder,

cmd/channel-manipulation/join-channel.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#joinchannel
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -54,7 +51,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "joinChannel <images..>",
   describe: "Join one or more channels to the image",
   builder,

cmd/channel-manipulation/remove-alpha.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-channel#removealpha
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Command builder.
 const builder = (yargs) => {
@@ -40,11 +37,11 @@ const builder = (yargs) => {
 };
 
 // Command handler.
-const handler = (args) =>
+const handler = () =>
   queue.push(["removeAlpha", (sharp) => sharp.removeAlpha()]);
 
 // Exports.
-module.exports = {
+export default {
   command: "removeAlpha",
   describe: "Remove alpha channel, if any",
   builder,

cmd/colour-manipulation/greyscale.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#greyscale
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Command builder.
 const builder = (yargs) => {
@@ -43,11 +40,10 @@ const builder = (yargs) => {
 };
 
 // Command handler.
-const handler = (args) =>
-  queue.push(["greyscale", (sharp) => sharp.greyscale()]);
+const handler = () => 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",

cmd/colour-manipulation/pipeline-colourspace.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -62,7 +59,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "pipelineColourspace <colourspace>",
   aliases: "pipelineColorspace",
   describe: "Set the pipeline colourspace",

cmd/colour-manipulation/tint.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-colour#tint
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -52,7 +49,7 @@ const builder = (yargs) => {
 const handler = (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",

cmd/colour-manipulation/tocolourspace.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -59,7 +56,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "toColourspace <colourspace>",
   aliases: "toColorspace",
   describe: "Set the output colourspace",

cmd/compositing/composite.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Helpers.
 function getValueAt(arrayLike, index) {
@@ -206,7 +203,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "composite [images..]",
   describe:
     "Composite image(s) over the processed (resized, extracted etc.) image",

cmd/operations/affine.js

@@ -23,15 +23,10 @@
 
 // @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 queue from "../../lib/queue.js";
+import { pick } from "../../lib/utils.js";
 
 // Configure.
 const placeholders = {
@@ -110,7 +105,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "affine <matrix..>",
   describe: "Perform an affine transform on an image",
   builder,

cmd/operations/blur.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#blur
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -87,7 +84,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "blur [sigma]",
   describe: "Blur the image",
   builder,

cmd/operations/boolean.js

@@ -23,12 +23,9 @@
 
 // @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";
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -63,7 +60,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "boolean <operand> <operator>",
   describe: "Perform a bitwise boolean operation with operand image",
   builder,

cmd/operations/clahe.js

@@ -23,11 +23,8 @@
 
 // @see https://sharp.pixelplumbing.com/api-operation#clahe
 
-// Strict mode.
-"use strict";
-
 // Local modules.
-const queue = require("../../lib/queue");
+import queue from "../../lib/queue.js";
 
 // Configure.
 const positionals = {
@@ -79,7 +76,7 @@ const handler = (args) => {
 };
 
 // Exports.
-module.exports = {
+export default {
   command: "clahe <width> <height>",
   describe: "Perform contrast limiting adaptive histogram equalization CLAHE",
   builder,