@depup/sharp-cli 5.2.0-depup.0

package/cmd/operations/median.js

@@ -0,0 +1,62 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#median
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  size: {
+    desc: 'Square mask size',
+    defaultDescription: 3,
+    type: 'number'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 median')
+    .example('$0 median 5')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#median')
+    .positional('size', positionals.size)
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['median', (sharp) => sharp.median(args.size)])
+}
+
+// Exports.
+module.exports = {
+  command: 'median [size]',
+  describe: 'Apply median filter',
+  builder,
+  handler
+}

package/cmd/operations/modulate.js

@@ -0,0 +1,78 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see http://sharp.pixelplumbing.com/api-operation#modulate
+
+// Strict mode.
+'use strict'
+
+// Package modules.
+const pick = require('lodash.pick')
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const options = {
+  brightness: {
+    desc: 'Brightness multiplier',
+    type: 'number'
+  },
+  hue: {
+    desc: 'Degrees for hue rotation',
+    type: 'number'
+  },
+  lightness: {
+    desc: 'Lightness addend',
+    type: 'number'
+  },
+  saturation: {
+    desc: 'Saturation multiplier',
+    type: 'number'
+  }
+}
+const optionNames = Object.keys(options)
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 modulate --brightness 2', 'Increase brightness by a factor of 2')
+    .example('$0 modulate --hue 180', 'Hue-rotate by 180 degrees')
+    .example('$0 modulate --lightness 50', 'Increase lightness by +50')
+    .example('$0 modulate --brightness 0.5 --saturation 0.5 --hue 90', 'Decrease brightness and saturation while also hue-rotating by 90 degrees')
+    .epilog('For more information on available options, please visit http://sharp.pixelplumbing.com/api-operation#modulate')
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['modulate', (sharp) => sharp.modulate(pick(args, optionNames))])
+
+// Exports.
+module.exports = {
+  command: 'modulate',
+  describe: 'Transforms the image using brightness, saturation, hue rotation, and lightness',
+  builder,
+  handler
+}

package/cmd/operations/negate.js

@@ -0,0 +1,60 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#negate
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const options = {
+  alpha: {
+    desc: 'Whether or not to negate any alpha channel',
+    type: 'boolean'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  const optionNames = Object.keys(options)
+  return yargs
+    .strict()
+    .example('$0 negate --no-alpha')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#negate')
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['negate', (sharp) => sharp.negate(args.alpha)])
+
+// Exports.
+module.exports = {
+  command: 'negate',
+  describe: 'Produce the "negative" of the image',
+  builder,
+  handler
+}

package/cmd/operations/normalise.js

@@ -0,0 +1,69 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#normalise
+
+// Strict mode.
+'use strict'
+
+// Package modules.
+const pick = require('lodash.pick')
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+const options = {
+  lower: {
+    default: 1,
+    desc: 'Percentile below which luminance values will be underexposed',
+    type: 'number'
+  },
+  upper: {
+    default: 99,
+    desc: 'Percentile below which luminance values will be overexposed',
+    type: 'number'
+  }
+}
+const optionNames = Object.keys(options)
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#normalise')
+    .example('$0 normalise')
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['normalise', (sharp) => sharp.normalise(pick(args, optionNames))])
+
+// Exports.
+module.exports = {
+  command: 'normalise',
+  aliases: 'normalize',
+  describe: 'Enhance output image contrast by stretching its luminance to cover the full dynamic range',
+  builder,
+  handler
+}

package/cmd/operations/recomb.js

@@ -0,0 +1,74 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.dimens.io/api-operation#recomb
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const placeholders = {
+  matrix: {
+    desc: 'Recombination matrix',
+    nargs: 3 * 3,
+    type: 'number'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 recomb 0.3588 0.7044 0.1368 0.2990 0.5870 0.1140 0.2392 0.4696 0.0912', 'The recomb will be applied to the output, in this case a sepia filter has been applied')
+    .epilog('For more information on available options, please visit https://sharp.dimens.io/api-operation#recomb')
+    .check(argv => {
+      if (!(Array.isArray(argv.matrix) && argv.matrix.length === 9)) {
+        throw new Error('Expected matrix positional to have 9 values')
+      }
+      return true
+    })
+    .positional('matrix', placeholders.matrix)
+}
+
+// Command handler.
+const handler = (args) => {
+  const { matrix } = args
+  return queue.push(['recomb', (sharp) => {
+    return sharp.recomb([
+      matrix.slice(0, 3),
+      matrix.slice(3, 6),
+      matrix.slice(6, 9)
+    ])
+  }])
+}
+
+// Exports.
+module.exports = {
+  command: 'recomb <matrix..>',
+  describe: 'Recomb the image with the specified matrix',
+  builder,
+  handler
+}

package/cmd/operations/rotate.js

@@ -0,0 +1,72 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#rotate
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  angle: {
+    defaultDescription: 'auto',
+    desc: 'Angle of rotation',
+    type: 'number'
+  }
+}
+
+const options = {
+  background: {
+    defaultDescription: '#000000',
+    desc: 'String parsed by the color module to extract values for red, green, blue and alpha',
+    type: 'string'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  const optionNames = Object.keys(options)
+  return yargs
+    .strict()
+    .example('$0 rotate', 'The output will be auto-rotated using EXIF Orientation tag')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#rotate')
+    .positional('angle', positionals.angle)
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['rotate', (sharp) => sharp.rotate(args.angle, { background: args.background })])
+}
+
+// Exports.
+module.exports = {
+  command: 'rotate [angle]',
+  describe: 'Rotate the output image',
+  builder,
+  handler
+}

package/cmd/operations/sharpen.js

@@ -0,0 +1,109 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#sharpen
+
+// Strict mode.
+'use strict'
+
+// Package modules.
+const pick = require('lodash.pick')
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  sigma: {
+    desc: 'The sigma of the Gaussian mask',
+    defaultDescription: '1 + radius / 2',
+    type: 'number'
+  }
+}
+
+const options = {
+  m1: {
+    alias: 'flat',
+    desc: 'The level of sharpening to apply to "flat" areas',
+    defaultDescription: 1.0,
+    type: 'number'
+  },
+  m2: {
+    alias: 'jagged',
+    desc: 'The level of sharpening to apply to "jagged" areas',
+    defaultDescription: 2.0,
+    type: 'number'
+  },
+  x1: {
+    desc: 'The threshold between "flat" and "jagged" areas',
+    defaultDescription: 2.0,
+    type: 'number'
+  },
+  y2: {
+    desc: 'The maximum amount of brightening',
+    defaultDescription: 10.0,
+    type: 'number'
+  },
+  y3: {
+    desc: 'The maximum amount of darkening',
+    defaultDescription: 20.0,
+    type: 'number'
+  }
+}
+const optionNames = Object.keys(options)
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 sharpen')
+    .example('$0 sharpen 2')
+    .example('$0 sharpen 2 --m1 0 --m2 3 --x1 3 --y2 15 --y3 15')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#sharpen')
+    .positional('sigma', positionals.sigma)
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => {
+  const options = {
+    ...pick(args, Object.keys(positionals)),
+    ...pick(args, optionNames)
+  }
+
+  return queue.push(['sharpen', (sharp) => {
+    if (Object.keys(options).length === 0) {
+      return sharp.sharpen()
+    }
+    return sharp.sharpen(options)
+  }])
+}
+
+// Exports.
+module.exports = {
+  command: 'sharpen [sigma]',
+  describe: 'Sharpen the image',
+  builder,
+  handler
+}

package/cmd/operations/threshold.js

@@ -0,0 +1,73 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#threshold
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  value: {
+    desc: 'A value in the range 0-255 representing the level at which the threshold will be applied',
+    defaultDescription: 128,
+    type: 'number'
+  }
+}
+
+const options = {
+  greyscale: {
+    alias: 'grayscale',
+    desc: 'Convert to single channel greyscale',
+    type: 'boolean'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  const optionNames = Object.keys(options)
+  return yargs
+    .strict()
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-operation#threshold')
+    .positional('value', positionals.value)
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['threshold', (sharp) => {
+    return sharp.threshold(args.value, { greyscale: args.greyscale })
+  }])
+}
+
+// Exports.
+module.exports = {
+  command: 'threshold [value]',
+  describe: 'Any pixel value greather than or equal to the threshold value will be set to 255, otherwise it will be set to 0',
+  builder,
+  handler
+}

package/cmd/operations/unflatten.js

@@ -0,0 +1,49 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * 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
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.dimens.io/api-operation#unflatten
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 unflatten')
+    .epilog('For more information on available options, please visit https://sharp.dimens.io/api-operation#unflatten')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['unflatten', (sharp) => sharp.unflatten()])
+
+// Exports.
+module.exports = {
+  command: 'unflatten',
+  describe: 'Ensure the image has an alpha channel with all white pixel values made fully transparent',
+  builder,
+  handler
+}