@artifact-kit/deckkit-pro 0.1.0

package/COMMERCIAL-LICENSE.md

@@ -0,0 +1,5 @@
+# DeckKit Pro Commercial License
+
+DeckKit Pro is proprietary commercial software. Use, copying, modification,
+distribution, and sublicensing require a separate written commercial agreement
+with Artifact Kit.

package/README.md

@@ -0,0 +1,50 @@
+# @artifact-kit/deckkit-pro
+
+Commercial DeckKit plugin bundle.
+
+## Usage
+
+```ts
+import DeckKit from '@artifact-kit/deckkit'
+import deckkitPro from '@artifact-kit/deckkit-pro'
+
+const deck = new DeckKit()
+deck.use(deckkitPro())
+
+const slide = deck.addSlide()
+slide.addShape(deck.ShapeType.rect, {
+  x: 1,
+  y: 1,
+  w: 5,
+  h: 2,
+  fill: {
+    type: 'gradient',
+    angle: 90,
+    stops: [
+      { position: 0, color: 'FF5A5F' },
+      { position: 1, color: '2D9CDB' },
+    ],
+  },
+})
+```
+
+## SVG to PNG
+
+```ts
+import { renderSvgToPng, writeSvgToPng } from '@artifact-kit/deckkit-pro/svg-to-png'
+
+const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="120" height="80">...</svg>'
+const png = await renderSvgToPng(svg, {
+  width: 240,
+  height: 160,
+})
+
+await writeSvgToPng(svg, 'output.png')
+```
+
+CLI:
+
+```bash
+node dist/svg-to-png-cli.js '<svg xmlns="http://www.w3.org/2000/svg" width="120" height="80">...</svg>' -o output.png
+node dist/svg-to-png-cli.js input.svg -o output.png --width 240 --height 160
+```

package/dist/cli.cjs

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+const node_fs = require("node:fs");
+const promises = require("node:fs/promises");
+const node_path = require("node:path");
+const image = require("./image.cjs");
+const svgToPng = require("./svg-to-png.cjs");
+const FIT_VALUES = /* @__PURE__ */ new Set(["cover", "contain", "fill", "inside", "outside"]);
+const COMMANDS = {
+  "image-info": runImageInfo,
+  crop: runCrop,
+  "svg-to-png": runSvgToPng,
+  compare: runCompare,
+  overlay: runOverlay,
+  resize: runResize,
+  "sample-color": runSampleColor
+};
+async function main(args) {
+  const command = args[0];
+  if (!command || command === "-h" || command === "--help") {
+    printUsage();
+    return;
+  }
+  const handler = COMMANDS[command];
+  if (!handler) {
+    throw new Error(`Unknown command: ${command}`);
+  }
+  await handler(args.slice(1));
+}
+async function runImageInfo(args) {
+  const input = readPositional(args, 0, "image");
+  const info = await image.getImageInfo(input);
+  console.log(JSON.stringify(info));
+}
+async function runCrop(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const output = readRequiredOption(options, "output");
+  const buffer = await image.cropImage(input, {
+    x: readRequiredNumberOption(options, "x"),
+    y: readRequiredNumberOption(options, "y"),
+    width: readRequiredNumberOption(options, "w"),
+    height: readRequiredNumberOption(options, "h")
+  });
+  await image.writeImage(buffer, output);
+  console.log(output);
+}
+async function runSvgToPng(args) {
+  const input = readPositional(args, 0, "svg|string");
+  const options = parseOptions(args.slice(1));
+  const output = options.output ?? "output.png";
+  const fit = options.fit;
+  if (fit !== void 0 && !FIT_VALUES.has(fit)) {
+    throw new Error(`Invalid --fit value "${fit}". Expected one of: ${Array.from(FIT_VALUES).join(", ")}`);
+  }
+  const svgOptions = {
+    width: readOptionalNumberOption(options, "width"),
+    height: readOptionalNumberOption(options, "height"),
+    density: readOptionalNumberOption(options, "density"),
+    fit,
+    background: options.background,
+    compressionLevel: readOptionalNumberOption(options, "compression-level")
+  };
+  await svgToPng.writeSvgToPng(await readSvgInput(input), output, svgOptions);
+  console.log(output);
+}
+async function runCompare(args) {
+  const reference = readPositional(args, 0, "reference image");
+  const generated = readPositional(args, 1, "generated image");
+  const options = parseOptions(args.slice(2));
+  const output = readRequiredOption(options, "output");
+  const buffer = await image.compareImages(reference, generated, {
+    background: options.background,
+    gap: readOptionalNumberOption(options, "gap")
+  });
+  await image.writeImage(buffer, output);
+  console.log(output);
+}
+async function runOverlay(args) {
+  const reference = readPositional(args, 0, "reference image");
+  const generated = readPositional(args, 1, "generated image");
+  const options = parseOptions(args.slice(2));
+  const output = readRequiredOption(options, "output");
+  const buffer = await image.overlayImages(reference, generated, {
+    opacity: readOptionalNumberOption(options, "opacity"),
+    background: options.background
+  });
+  await image.writeImage(buffer, output);
+  console.log(output);
+}
+async function runResize(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const output = readRequiredOption(options, "output");
+  const fit = options.fit;
+  if (fit !== void 0 && !FIT_VALUES.has(fit)) {
+    throw new Error(`Invalid --fit value "${fit}". Expected one of: ${Array.from(FIT_VALUES).join(", ")}`);
+  }
+  const resizeOptions = {
+    width: readOptionalNumberOption(options, "width"),
+    height: readOptionalNumberOption(options, "height"),
+    fit,
+    background: options.background
+  };
+  const buffer = await image.resizeImage(input, resizeOptions);
+  await image.writeImage(buffer, output);
+  console.log(output);
+}
+async function runSampleColor(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const color = await image.sampleColor(input, readRequiredNumberOption(options, "x"), readRequiredNumberOption(options, "y"));
+  console.log(JSON.stringify(color));
+}
+function parseOptions(args) {
+  const options = {};
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (!arg.startsWith("-")) {
+      throw new Error(`Unexpected argument: ${arg}`);
+    }
+    const key = arg.replace(/^-+/, "");
+    options[normalizeOptionName(key)] = readValue(args, ++index, arg);
+  }
+  return options;
+}
+function normalizeOptionName(name) {
+  switch (name) {
+    case "o":
+      return "output";
+    default:
+      return name;
+  }
+}
+async function readSvgInput(input) {
+  if (node_fs.existsSync(input)) {
+    return promises.readFile(input, "utf8");
+  }
+  return input;
+}
+function readPositional(args, index, label) {
+  const value = args[index];
+  if (!value || value.startsWith("-")) {
+    throw new Error(`Missing ${label}`);
+  }
+  return value;
+}
+function readRequiredOption(options, name) {
+  const value = options[name];
+  if (!value) {
+    throw new Error(`Missing --${name}`);
+  }
+  return value;
+}
+function readOptionalNumberOption(options, name) {
+  const value = options[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  const number = Number(value);
+  if (!Number.isFinite(number)) {
+    throw new Error(`Invalid numeric value for --${name}`);
+  }
+  return number;
+}
+function readRequiredNumberOption(options, name) {
+  const value = readOptionalNumberOption(options, name);
+  if (value === void 0) {
+    throw new Error(`Missing --${name}`);
+  }
+  return value;
+}
+function readValue(args, index, option) {
+  const value = args[index];
+  if (!value) {
+    throw new Error(`Missing value for ${option}`);
+  }
+  return value;
+}
+function printUsage() {
+  const command = node_path.basename(process.argv[1] ?? "cli.js", node_path.extname(process.argv[1] ?? ""));
+  console.log(`Usage:
+  node ${command}.js image-info <image>
+  node ${command}.js crop <image> --x <px> --y <px> --w <px> --h <px> -o <png>
+  node ${command}.js svg-to-png <svg|string> -o <png>
+  node ${command}.js compare <ref> <generated> -o <png>
+  node ${command}.js overlay <ref> <generated> -o <png> --opacity <0-1>
+  node ${command}.js resize <image> --width <px> --height <px> -o <png>
+  node ${command}.js sample-color <image> --x <px> --y <px>`);
+}
+main(process.argv.slice(2)).catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/dist/cli.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { sampleColor, resizeImage, writeImage, overlayImages, compareImages, cropImage, getImageInfo } from "./image.js";
+import { writeSvgToPng } from "./svg-to-png.js";
+const FIT_VALUES = /* @__PURE__ */ new Set(["cover", "contain", "fill", "inside", "outside"]);
+const COMMANDS = {
+  "image-info": runImageInfo,
+  crop: runCrop,
+  "svg-to-png": runSvgToPng,
+  compare: runCompare,
+  overlay: runOverlay,
+  resize: runResize,
+  "sample-color": runSampleColor
+};
+async function main(args) {
+  const command = args[0];
+  if (!command || command === "-h" || command === "--help") {
+    printUsage();
+    return;
+  }
+  const handler = COMMANDS[command];
+  if (!handler) {
+    throw new Error(`Unknown command: ${command}`);
+  }
+  await handler(args.slice(1));
+}
+async function runImageInfo(args) {
+  const input = readPositional(args, 0, "image");
+  const info = await getImageInfo(input);
+  console.log(JSON.stringify(info));
+}
+async function runCrop(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const output = readRequiredOption(options, "output");
+  const buffer = await cropImage(input, {
+    x: readRequiredNumberOption(options, "x"),
+    y: readRequiredNumberOption(options, "y"),
+    width: readRequiredNumberOption(options, "w"),
+    height: readRequiredNumberOption(options, "h")
+  });
+  await writeImage(buffer, output);
+  console.log(output);
+}
+async function runSvgToPng(args) {
+  const input = readPositional(args, 0, "svg|string");
+  const options = parseOptions(args.slice(1));
+  const output = options.output ?? "output.png";
+  const fit = options.fit;
+  if (fit !== void 0 && !FIT_VALUES.has(fit)) {
+    throw new Error(`Invalid --fit value "${fit}". Expected one of: ${Array.from(FIT_VALUES).join(", ")}`);
+  }
+  const svgOptions = {
+    width: readOptionalNumberOption(options, "width"),
+    height: readOptionalNumberOption(options, "height"),
+    density: readOptionalNumberOption(options, "density"),
+    fit,
+    background: options.background,
+    compressionLevel: readOptionalNumberOption(options, "compression-level")
+  };
+  await writeSvgToPng(await readSvgInput(input), output, svgOptions);
+  console.log(output);
+}
+async function runCompare(args) {
+  const reference = readPositional(args, 0, "reference image");
+  const generated = readPositional(args, 1, "generated image");
+  const options = parseOptions(args.slice(2));
+  const output = readRequiredOption(options, "output");
+  const buffer = await compareImages(reference, generated, {
+    background: options.background,
+    gap: readOptionalNumberOption(options, "gap")
+  });
+  await writeImage(buffer, output);
+  console.log(output);
+}
+async function runOverlay(args) {
+  const reference = readPositional(args, 0, "reference image");
+  const generated = readPositional(args, 1, "generated image");
+  const options = parseOptions(args.slice(2));
+  const output = readRequiredOption(options, "output");
+  const buffer = await overlayImages(reference, generated, {
+    opacity: readOptionalNumberOption(options, "opacity"),
+    background: options.background
+  });
+  await writeImage(buffer, output);
+  console.log(output);
+}
+async function runResize(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const output = readRequiredOption(options, "output");
+  const fit = options.fit;
+  if (fit !== void 0 && !FIT_VALUES.has(fit)) {
+    throw new Error(`Invalid --fit value "${fit}". Expected one of: ${Array.from(FIT_VALUES).join(", ")}`);
+  }
+  const resizeOptions = {
+    width: readOptionalNumberOption(options, "width"),
+    height: readOptionalNumberOption(options, "height"),
+    fit,
+    background: options.background
+  };
+  const buffer = await resizeImage(input, resizeOptions);
+  await writeImage(buffer, output);
+  console.log(output);
+}
+async function runSampleColor(args) {
+  const input = readPositional(args, 0, "image");
+  const options = parseOptions(args.slice(1));
+  const color = await sampleColor(input, readRequiredNumberOption(options, "x"), readRequiredNumberOption(options, "y"));
+  console.log(JSON.stringify(color));
+}
+function parseOptions(args) {
+  const options = {};
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (!arg.startsWith("-")) {
+      throw new Error(`Unexpected argument: ${arg}`);
+    }
+    const key = arg.replace(/^-+/, "");
+    options[normalizeOptionName(key)] = readValue(args, ++index, arg);
+  }
+  return options;
+}
+function normalizeOptionName(name) {
+  switch (name) {
+    case "o":
+      return "output";
+    default:
+      return name;
+  }
+}
+async function readSvgInput(input) {
+  if (existsSync(input)) {
+    return readFile(input, "utf8");
+  }
+  return input;
+}
+function readPositional(args, index, label) {
+  const value = args[index];
+  if (!value || value.startsWith("-")) {
+    throw new Error(`Missing ${label}`);
+  }
+  return value;
+}
+function readRequiredOption(options, name) {
+  const value = options[name];
+  if (!value) {
+    throw new Error(`Missing --${name}`);
+  }
+  return value;
+}
+function readOptionalNumberOption(options, name) {
+  const value = options[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  const number = Number(value);
+  if (!Number.isFinite(number)) {
+    throw new Error(`Invalid numeric value for --${name}`);
+  }
+  return number;
+}
+function readRequiredNumberOption(options, name) {
+  const value = readOptionalNumberOption(options, name);
+  if (value === void 0) {
+    throw new Error(`Missing --${name}`);
+  }
+  return value;
+}
+function readValue(args, index, option) {
+  const value = args[index];
+  if (!value) {
+    throw new Error(`Missing value for ${option}`);
+  }
+  return value;
+}
+function printUsage() {
+  const command = basename(process.argv[1] ?? "cli.js", extname(process.argv[1] ?? ""));
+  console.log(`Usage:
+  node ${command}.js image-info <image>
+  node ${command}.js crop <image> --x <px> --y <px> --w <px> --h <px> -o <png>
+  node ${command}.js svg-to-png <svg|string> -o <png>
+  node ${command}.js compare <ref> <generated> -o <png>
+  node ${command}.js overlay <ref> <generated> -o <png> --opacity <0-1>
+  node ${command}.js resize <image> --width <px> --height <px> -o <png>
+  node ${command}.js sample-color <image> --x <px> --y <px>`);
+}
+main(process.argv.slice(2)).catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/dist/gradient-fill.cjs

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const SCHEME_COLOR_NAMES = /* @__PURE__ */ new Set(["tx1", "tx2", "bg1", "bg2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6"]);
+const HEX_COLOR = /^[0-9a-fA-F]{6}$/;
+function setupGradientFill(context) {
+  context.addFillRenderer(renderGradientFill);
+}
+function renderGradientFill(props) {
+  if (!isGradientFillProps(props)) return void 0;
+  const stops = props.stops.slice().sort((a, b) => normalizeStopPosition(a.position) - normalizeStopPosition(b.position)).map((stop) => renderGradientStop(stop)).join("");
+  const angle = normalizeAngle(props.angle ?? 90);
+  const xmlAngle = Math.round(normalizeAngle(360 - angle) * 6e4);
+  const rotWithShape = props.rotateWithShape === false ? "0" : "1";
+  return `<a:gradFill rotWithShape="${rotWithShape}"><a:gsLst>${stops}</a:gsLst><a:lin ang="${xmlAngle}" scaled="0"/></a:gradFill>`;
+}
+function isGradientFillProps(props) {
+  if (typeof props !== "object" || props === null) return false;
+  const fill = props;
+  return fill.type === "gradient" && Array.isArray(fill.stops) && fill.stops.length >= 2;
+}
+function normalizeAngle(angle) {
+  return (angle % 360 + 360) % 360;
+}
+function normalizeStopPosition(position) {
+  const percent = position > 1 ? position / 100 : position;
+  return Math.min(1, Math.max(0, percent));
+}
+function renderGradientStop(stop) {
+  const position = Math.round(normalizeStopPosition(stop.position) * 1e5);
+  return `<a:gs pos="${position}">${renderColor(stop.color, stop.transparency)}</a:gs>`;
+}
+function renderColor(color, transparency) {
+  const colorVal = color.replace("#", "");
+  const alpha = typeof transparency === "number" ? `<a:alpha val="${Math.round((100 - transparency) * 1e3)}"/>` : "";
+  if (HEX_COLOR.test(colorVal)) {
+    return alpha ? `<a:srgbClr val="${colorVal.toUpperCase()}">${alpha}</a:srgbClr>` : `<a:srgbClr val="${colorVal.toUpperCase()}"/>`;
+  }
+  if (SCHEME_COLOR_NAMES.has(colorVal)) {
+    return alpha ? `<a:schemeClr val="${colorVal}">${alpha}</a:schemeClr>` : `<a:schemeClr val="${colorVal}"/>`;
+  }
+  throw new Error(`Invalid gradient stop color: ${color}`);
+}
+exports.renderGradientFill = renderGradientFill;
+exports.setupGradientFill = setupGradientFill;

package/dist/gradient-fill.js

@@ -0,0 +1,44 @@
+const SCHEME_COLOR_NAMES = /* @__PURE__ */ new Set(["tx1", "tx2", "bg1", "bg2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6"]);
+const HEX_COLOR = /^[0-9a-fA-F]{6}$/;
+function setupGradientFill(context) {
+  context.addFillRenderer(renderGradientFill);
+}
+function renderGradientFill(props) {
+  if (!isGradientFillProps(props)) return void 0;
+  const stops = props.stops.slice().sort((a, b) => normalizeStopPosition(a.position) - normalizeStopPosition(b.position)).map((stop) => renderGradientStop(stop)).join("");
+  const angle = normalizeAngle(props.angle ?? 90);
+  const xmlAngle = Math.round(normalizeAngle(360 - angle) * 6e4);
+  const rotWithShape = props.rotateWithShape === false ? "0" : "1";
+  return `<a:gradFill rotWithShape="${rotWithShape}"><a:gsLst>${stops}</a:gsLst><a:lin ang="${xmlAngle}" scaled="0"/></a:gradFill>`;
+}
+function isGradientFillProps(props) {
+  if (typeof props !== "object" || props === null) return false;
+  const fill = props;
+  return fill.type === "gradient" && Array.isArray(fill.stops) && fill.stops.length >= 2;
+}
+function normalizeAngle(angle) {
+  return (angle % 360 + 360) % 360;
+}
+function normalizeStopPosition(position) {
+  const percent = position > 1 ? position / 100 : position;
+  return Math.min(1, Math.max(0, percent));
+}
+function renderGradientStop(stop) {
+  const position = Math.round(normalizeStopPosition(stop.position) * 1e5);
+  return `<a:gs pos="${position}">${renderColor(stop.color, stop.transparency)}</a:gs>`;
+}
+function renderColor(color, transparency) {
+  const colorVal = color.replace("#", "");
+  const alpha = typeof transparency === "number" ? `<a:alpha val="${Math.round((100 - transparency) * 1e3)}"/>` : "";
+  if (HEX_COLOR.test(colorVal)) {
+    return alpha ? `<a:srgbClr val="${colorVal.toUpperCase()}">${alpha}</a:srgbClr>` : `<a:srgbClr val="${colorVal.toUpperCase()}"/>`;
+  }
+  if (SCHEME_COLOR_NAMES.has(colorVal)) {
+    return alpha ? `<a:schemeClr val="${colorVal}">${alpha}</a:schemeClr>` : `<a:schemeClr val="${colorVal}"/>`;
+  }
+  throw new Error(`Invalid gradient stop color: ${color}`);
+}
+export {
+  renderGradientFill,
+  setupGradientFill
+};

package/dist/image.cjs

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const promises = require("node:fs/promises");
+const node_path = require("node:path");
+const sharp = require("sharp");
+async function getImageInfo(input) {
+  const metadata = await sharp(input).metadata();
+  return {
+    width: metadata.width,
+    height: metadata.height,
+    format: metadata.format,
+    channels: metadata.channels,
+    space: metadata.space,
+    hasAlpha: metadata.hasAlpha,
+    density: metadata.density,
+    size: metadata.size
+  };
+}
+async function cropImage(input, options) {
+  return sharp(input).extract({
+    left: options.x,
+    top: options.y,
+    width: options.width,
+    height: options.height
+  }).png().toBuffer();
+}
+async function resizeImage(input, options) {
+  const image = sharp(input).resize({
+    width: options.width,
+    height: options.height,
+    fit: options.fit ?? "contain",
+    background: options.background
+  });
+  return image.png().toBuffer();
+}
+async function sampleColor(input, x, y) {
+  const { data, info } = await sharp(input).ensureAlpha().extract({ left: x, top: y, width: 1, height: 1 }).raw().toBuffer({ resolveWithObject: true });
+  return {
+    x,
+    y,
+    r: data[0] ?? 0,
+    g: data[1] ?? 0,
+    b: data[2] ?? 0,
+    alpha: info.channels >= 4 ? data[3] : void 0
+  };
+}
+async function compareImages(reference, generated, options = {}) {
+  const [refBuffer, genBuffer] = await Promise.all([
+    sharp(reference).png().toBuffer(),
+    sharp(generated).png().toBuffer()
+  ]);
+  const [refInfo, genInfo] = await Promise.all([getImageInfo(refBuffer), getImageInfo(genBuffer)]);
+  const gap = options.gap ?? 12;
+  const width = (refInfo.width ?? 0) + (genInfo.width ?? 0) + gap;
+  const height = Math.max(refInfo.height ?? 0, genInfo.height ?? 0);
+  return sharp({
+    create: {
+      width,
+      height,
+      channels: 4,
+      background: options.background ?? { r: 255, g: 255, b: 255, alpha: 1 }
+    }
+  }).composite([
+    { input: refBuffer, left: 0, top: 0 },
+    { input: genBuffer, left: (refInfo.width ?? 0) + gap, top: 0 }
+  ]).png().toBuffer();
+}
+async function overlayImages(reference, generated, options = {}) {
+  const refInfo = await getImageInfo(reference);
+  const refWidth = refInfo.width ?? 1;
+  const refHeight = refInfo.height ?? 1;
+  const generatedBuffer = await withOpacity(
+    await sharp(generated).resize({ width: refWidth, height: refHeight, fit: "contain" }).ensureAlpha().png().toBuffer(),
+    options.opacity ?? 0.5
+  );
+  return sharp(reference).resize({ width: refWidth, height: refHeight, fit: "contain", background: options.background }).composite([{ input: generatedBuffer, left: 0, top: 0 }]).png().toBuffer();
+}
+async function withOpacity(input, opacity) {
+  const clampedOpacity = Math.max(0, Math.min(1, opacity));
+  const { data, info } = await sharp(input).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  for (let index = 3; index < data.length; index += info.channels) {
+    data[index] = Math.round((data[index] ?? 0) * clampedOpacity);
+  }
+  return sharp(data, {
+    raw: {
+      width: info.width,
+      height: info.height,
+      channels: info.channels
+    }
+  }).png().toBuffer();
+}
+async function writeImage(buffer, output) {
+  await promises.mkdir(node_path.dirname(output), { recursive: true });
+  await sharp(buffer).toFile(output);
+}
+exports.compareImages = compareImages;
+exports.cropImage = cropImage;
+exports.getImageInfo = getImageInfo;
+exports.overlayImages = overlayImages;
+exports.resizeImage = resizeImage;
+exports.sampleColor = sampleColor;
+exports.writeImage = writeImage;