@design-edito/tools 0.4.5 → 0.4.11

package/node/images/format/index.js

@@ -1,831 +1,280 @@
-// src/node/images/format/index.ts
-import zod from "zod";
-
-// src/agnostic/numbers/clamp/index.ts
-function clamp(num, bound1, bound2) {
-  const min = Math.min(bound1, bound2);
-  const max = Math.max(bound1, bound2);
-  return Math.min(Math.max(num, min), max);
-}
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-
-// src/node/images/utils/index.ts
-import { readFile } from "node:fs/promises";
-import sharp from "sharp";
-
-// src/agnostic/numbers/absolute-modulo/index.ts
-function absoluteModulo(nbr, modulo) {
-  return (nbr % modulo + modulo) % modulo;
-}
-
-// src/agnostic/objects/is-object/index.ts
-function isObject(unk) {
-  return typeof unk === "object";
-}
-function isNonNullObject(unk) {
-  return unk !== null && isObject(unk);
-}
-
-// src/agnostic/colors/cssColorsMap.ts
-var cssColors = {
-  aliceblue: { r: 240, g: 248, b: 255 },
-  antiquewhite: { r: 250, g: 235, b: 215 },
-  aqua: { r: 0, g: 255, b: 255 },
-  aquamarine: { r: 127, g: 255, b: 212 },
-  azure: { r: 240, g: 255, b: 255 },
-  beige: { r: 245, g: 245, b: 220 },
-  bisque: { r: 255, g: 228, b: 196 },
-  black: { r: 0, g: 0, b: 0 },
-  blanchedalmond: { r: 255, g: 235, b: 205 },
-  blue: { r: 0, g: 0, b: 255 },
-  blueviolet: { r: 138, g: 43, b: 226 },
-  brown: { r: 165, g: 42, b: 42 },
-  burlywood: { r: 222, g: 184, b: 135 },
-  cadetblue: { r: 95, g: 158, b: 160 },
-  chartreuse: { r: 127, g: 255, b: 0 },
-  chocolate: { r: 210, g: 105, b: 30 },
-  coral: { r: 255, g: 127, b: 80 },
-  cornflowerblue: { r: 100, g: 149, b: 237 },
-  cornsilk: { r: 255, g: 248, b: 220 },
-  crimson: { r: 220, g: 20, b: 60 },
-  cyan: { r: 0, g: 255, b: 255 },
-  darkblue: { r: 0, g: 0, b: 139 },
-  darkcyan: { r: 0, g: 139, b: 139 },
-  darkgoldenrod: { r: 184, g: 134, b: 11 },
-  darkgray: { r: 169, g: 169, b: 169 },
-  darkgreen: { r: 0, g: 100, b: 0 },
-  darkgrey: { r: 169, g: 169, b: 169 },
-  darkkhaki: { r: 189, g: 183, b: 107 },
-  darkmagenta: { r: 139, g: 0, b: 139 },
-  darkolivegreen: { r: 85, g: 107, b: 47 },
-  darkorange: { r: 255, g: 140, b: 0 },
-  darkorchid: { r: 153, g: 50, b: 204 },
-  darkred: { r: 139, g: 0, b: 0 },
-  darksalmon: { r: 233, g: 150, b: 122 },
-  darkseagreen: { r: 143, g: 188, b: 143 },
-  darkslateblue: { r: 72, g: 61, b: 139 },
-  darkslategray: { r: 47, g: 79, b: 79 },
-  darkslategrey: { r: 47, g: 79, b: 79 },
-  darkturquoise: { r: 0, g: 206, b: 209 },
-  darkviolet: { r: 148, g: 0, b: 211 },
-  deeppink: { r: 255, g: 20, b: 147 },
-  deepskyblue: { r: 0, g: 191, b: 255 },
-  dimgray: { r: 105, g: 105, b: 105 },
-  dimgrey: { r: 105, g: 105, b: 105 },
-  dodgerblue: { r: 30, g: 144, b: 255 },
-  firebrick: { r: 178, g: 34, b: 34 },
-  floralwhite: { r: 255, g: 250, b: 240 },
-  forestgreen: { r: 34, g: 139, b: 34 },
-  fuchsia: { r: 255, g: 0, b: 255 },
-  gainsboro: { r: 220, g: 220, b: 220 },
-  ghostwhite: { r: 248, g: 248, b: 255 },
-  gold: { r: 255, g: 215, b: 0 },
-  goldenrod: { r: 218, g: 165, b: 32 },
-  gray: { r: 128, g: 128, b: 128 },
-  green: { r: 0, g: 128, b: 0 },
-  greenyellow: { r: 173, g: 255, b: 47 },
-  grey: { r: 128, g: 128, b: 128 },
-  honeydew: { r: 240, g: 255, b: 240 },
-  hotpink: { r: 255, g: 105, b: 180 },
-  indianred: { r: 205, g: 92, b: 92 },
-  indigo: { r: 75, g: 0, b: 130 },
-  ivory: { r: 255, g: 255, b: 240 },
-  khaki: { r: 240, g: 230, b: 140 },
-  lavender: { r: 230, g: 230, b: 250 },
-  lavenderblush: { r: 255, g: 240, b: 245 },
-  lawngreen: { r: 124, g: 252, b: 0 },
-  lemonchiffon: { r: 255, g: 250, b: 205 },
-  lightblue: { r: 173, g: 216, b: 230 },
-  lightcoral: { r: 240, g: 128, b: 128 },
-  lightcyan: { r: 224, g: 255, b: 255 },
-  lightgoldenrodyellow: { r: 250, g: 250, b: 210 },
-  lightgray: { r: 211, g: 211, b: 211 },
-  lightgreen: { r: 144, g: 238, b: 144 },
-  lightgrey: { r: 211, g: 211, b: 211 },
-  lightpink: { r: 255, g: 182, b: 193 },
-  lightsalmon: { r: 255, g: 160, b: 122 },
-  lightseagreen: { r: 32, g: 178, b: 170 },
-  lightskyblue: { r: 135, g: 206, b: 250 },
-  lightslategray: { r: 119, g: 136, b: 153 },
-  lightslategrey: { r: 119, g: 136, b: 153 },
-  lightsteelblue: { r: 176, g: 196, b: 222 },
-  lightyellow: { r: 255, g: 255, b: 224 },
-  lime: { r: 0, g: 255, b: 0 },
-  limegreen: { r: 50, g: 205, b: 50 },
-  linen: { r: 250, g: 240, b: 230 },
-  magenta: { r: 255, g: 0, b: 255 },
-  maroon: { r: 128, g: 0, b: 0 },
-  mediumaquamarine: { r: 102, g: 205, b: 170 },
-  mediumblue: { r: 0, g: 0, b: 205 },
-  mediumorchid: { r: 186, g: 85, b: 211 },
-  mediumpurple: { r: 147, g: 112, b: 219 },
-  mediumseagreen: { r: 60, g: 179, b: 113 },
-  mediumslateblue: { r: 123, g: 104, b: 238 },
-  mediumspringgreen: { r: 0, g: 250, b: 154 },
-  mediumturquoise: { r: 72, g: 209, b: 204 },
-  mediumvioletred: { r: 199, g: 21, b: 133 },
-  midnightblue: { r: 25, g: 25, b: 112 },
-  mintcream: { r: 245, g: 255, b: 250 },
-  mistyrose: { r: 255, g: 228, b: 225 },
-  moccasin: { r: 255, g: 228, b: 181 },
-  navajowhite: { r: 255, g: 222, b: 173 },
-  navy: { r: 0, g: 0, b: 128 },
-  oldlace: { r: 253, g: 245, b: 230 },
-  olive: { r: 128, g: 128, b: 0 },
-  olivedrab: { r: 107, g: 142, b: 35 },
-  orange: { r: 255, g: 165, b: 0 },
-  orangered: { r: 255, g: 69, b: 0 },
-  orchid: { r: 218, g: 112, b: 214 },
-  palegoldenrod: { r: 238, g: 232, b: 170 },
-  palegreen: { r: 152, g: 251, b: 152 },
-  paleturquoise: { r: 175, g: 238, b: 238 },
-  palevioletred: { r: 219, g: 112, b: 147 },
-  papayawhip: { r: 255, g: 239, b: 213 },
-  peachpuff: { r: 255, g: 218, b: 185 },
-  peru: { r: 205, g: 133, b: 63 },
-  pink: { r: 255, g: 192, b: 203 },
-  plum: { r: 221, g: 160, b: 221 },
-  powderblue: { r: 176, g: 224, b: 230 },
-  purple: { r: 128, g: 0, b: 128 },
-  rebeccapurple: { r: 102, g: 51, b: 153 },
-  red: { r: 255, g: 0, b: 0 },
-  rosybrown: { r: 188, g: 143, b: 143 },
-  royalblue: { r: 65, g: 105, b: 225 },
-  saddlebrown: { r: 139, g: 69, b: 19 },
-  salmon: { r: 250, g: 128, b: 114 },
-  sandybrown: { r: 244, g: 164, b: 96 },
-  seagreen: { r: 46, g: 139, b: 87 },
-  seashell: { r: 255, g: 245, b: 238 },
-  sienna: { r: 160, g: 82, b: 45 },
-  silver: { r: 192, g: 192, b: 192 },
-  skyblue: { r: 135, g: 206, b: 235 },
-  slateblue: { r: 106, g: 90, b: 205 },
-  slategray: { r: 112, g: 128, b: 144 },
-  slategrey: { r: 112, g: 128, b: 144 },
-  snow: { r: 255, g: 250, b: 250 },
-  springgreen: { r: 0, g: 255, b: 127 },
-  steelblue: { r: 70, g: 130, b: 180 },
-  tan: { r: 210, g: 180, b: 140 },
-  teal: { r: 0, g: 128, b: 128 },
-  thistle: { r: 216, g: 191, b: 216 },
-  tomato: { r: 255, g: 99, b: 71 },
-  turquoise: { r: 64, g: 224, b: 208 },
-  violet: { r: 238, g: 130, b: 238 },
-  wheat: { r: 245, g: 222, b: 179 },
-  white: { r: 255, g: 255, b: 255 },
-  whitesmoke: { r: 245, g: 245, b: 245 },
-  yellow: { r: 255, g: 255, b: 0 },
-  yellowgreen: { r: 154, g: 205, b: 50 }
-};
-
-// src/agnostic/colors/typechecks/index.ts
-var isHex = (color) => {
-  if (typeof color !== "string") return false;
-  if (!color.startsWith("#")) return false;
-  const withoutHash = color.slice(1);
-  const withoutHashLength = withoutHash.length;
-  const allowedLengths = [3, 4, 6, 8];
-  if (!allowedLengths.includes(withoutHashLength)) return false;
-  return /^[0-9a-f]+$/igm.test(withoutHash);
-};
-var isRgb = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { r, g, b, a } = color;
-  if (typeof r !== "number") return false;
-  if (typeof g !== "number") return false;
-  if (typeof b !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isHsl = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { h, s, l, a } = color;
-  if (typeof h !== "number") return false;
-  if (typeof s !== "number") return false;
-  if (typeof l !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isHsb = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { h, s, b, a } = color;
-  if (typeof h !== "number") return false;
-  if (typeof s !== "number") return false;
-  if (typeof b !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isLab = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { l, a, b, al } = color;
-  if (typeof l !== "number") return false;
-  if (typeof a !== "number") return false;
-  if (typeof b !== "number") return false;
-  if (al !== void 0 && typeof al !== "number") return false;
-  return true;
-};
-var isLch = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { l, c, h, a } = color;
-  if (typeof l !== "number") return false;
-  if (typeof c !== "number") return false;
-  if (typeof h !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isCmyk = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { c, m, y, k, a } = color;
-  if (typeof c !== "number") return false;
-  if (typeof m !== "number") return false;
-  if (typeof y !== "number") return false;
-  if (typeof k !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isXyz = (color) => {
-  if (!isNonNullObject(color)) return false;
-  const { x, y, z, a } = color;
-  if (typeof x !== "number") return false;
-  if (typeof y !== "number") return false;
-  if (typeof z !== "number") return false;
-  if (a !== void 0 && typeof a !== "number") return false;
-  return true;
-};
-var isCssColor = (color) => typeof color === "string" && cssColors[color] !== void 0;
-var isColor = (color) => {
-  if (isHex(color)) return true;
-  if (isCssColor(color)) return true;
-  if (isRgb(color)) return true;
-  if (isHsl(color)) return true;
-  if (isHsb(color)) return true;
-  if (isCmyk(color)) return true;
-  if (isXyz(color)) return true;
-  if (isLab(color)) return true;
-  if (isLch(color)) return true;
-  return false;
-};
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/agnostic/colors/tidy/index.ts
-function tidy(color) {
-  const _color = color;
-  if (isRgb(_color)) return {
-    r: clamp(_color.r, 0, 255),
-    g: clamp(_color.g, 0, 255),
-    b: clamp(_color.b, 0, 255),
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isHsl(_color)) return {
-    h: absoluteModulo(_color.h, 360),
-    s: clamp(_color.s, 0, 100),
-    l: clamp(_color.l, 0, 100),
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isHsb(_color)) return {
-    h: absoluteModulo(_color.h, 360),
-    s: clamp(_color.s, 0, 100),
-    b: clamp(_color.b, 0, 100),
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isCmyk(_color)) return {
-    c: clamp(_color.c, 0, 100),
-    m: clamp(_color.m, 0, 100),
-    y: clamp(_color.y, 0, 100),
-    k: clamp(_color.k, 0, 100),
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isXyz(_color)) return {
-    x: _color.x,
-    y: _color.y,
-    z: _color.z,
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isLab(_color)) return {
-    l: clamp(_color.l, 0, 100),
-    a: _color.a,
-    b: _color.b,
-    al: clamp(_color.al ?? 1, 0, 1)
-  };
-  if (isLch(_color)) return {
-    l: clamp(_color.l, 0, 100),
-    c: Math.max(0, _color.c),
-    h: clamp(_color.h, 0, 360),
-    a: clamp(_color.a ?? 1, 0, 1)
-  };
-  if (isCssColor(_color)) return tidy(toRgb(_color));
-  if (isHex(_color)) return toHex(tidy(toRgb(_color)));
-  const _typecheck = true;
-  throw new Error(`Invalid color input: ${unknownToString(_color)}`);
-}
-
-// src/agnostic/colors/convert/index.ts
-function _hex2rgb(hex) {
-  if (!isHex(hex)) throw new Error(`invalid hex color ${unknownToString(hex)}`);
-  let hexString = hex;
-  const inputHex = hexString;
-  const startsWithHash = hexString.startsWith("#");
-  if (!startsWithHash) throw new Error(`invalid hex color ${inputHex}`);
-  hexString = hexString.slice(1);
-  if (hexString.length === 3) {
-    hexString = hexString.split("").map((c) => c + c).join("") + "ff";
-  } else if (hexString.length === 4) {
-    hexString = hexString.split("").map((c) => c + c).join("");
-  } else if (hexString.length === 6) {
-    hexString = hexString + "ff";
-  } else if (hexString.length !== 8) throw new Error(`invalid hex color ${inputHex}`);
-  const r = parseInt(hexString.slice(0, 2), 16);
-  const g = parseInt(hexString.slice(2, 4), 16);
-  const b = parseInt(hexString.slice(4, 6), 16);
-  const a = parseInt(hexString.slice(6, 8), 16) / 255;
-  return { r, g, b, a };
-}
-function _rgb2hex(rgb) {
-  const { r, g, b, a = 1 } = rgb;
-  const rHex = Math.round(r).toString(16).padStart(2, "0");
-  const gHex = Math.round(g).toString(16).padStart(2, "0");
-  const bHex = Math.round(b).toString(16).padStart(2, "0");
-  const aHex = Math.round(a * 255).toString(16).padStart(2, "0");
-  const returned = `#${rHex}${gHex}${bHex}${aHex}`;
-  if (!isHex(returned)) {
-    throw new Error(`invalid hex color output ${unknownToString(returned)}`);
-  }
-  return returned;
-}
-function _css2rgb(color) {
-  if (color in cssColors) return cssColors[color];
-  return void 0;
-}
-var cssColorsWithHex = Object.entries(cssColors).map(([cssColor, rgba]) => ({
-  name: cssColor,
-  hex: _rgb2hex(rgba),
-  rgba
-}));
-function _hsl2rgb(hsl) {
-  const { h, s, l, a = 1 } = hsl;
-  const H = absoluteModulo(h, 360) / 360;
-  const S = Math.max(0, Math.min(1, s / 100));
-  const L = Math.max(0, Math.min(1, l / 100));
-  const A = Math.max(0, Math.min(1, a));
-  const hue2rgb = (p, q, t) => {
-    if (t < 0) t += 1;
-    if (t > 1) t -= 1;
-    if (t < 1 / 6) return p + (q - p) * 6 * t;
-    if (t < 1 / 2) return q;
-    if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
-    return p;
-  };
-  let r;
-  let g;
-  let b;
-  if (S === 0) {
-    r = g = b = L;
-  } else {
-    const q = L < 0.5 ? L * (1 + S) : L + S - L * S;
-    const p = 2 * L - q;
-    r = hue2rgb(p, q, H + 1 / 3);
-    g = hue2rgb(p, q, H);
-    b = hue2rgb(p, q, H - 1 / 3);
-  }
-  return {
-    r: Math.round(r * 255),
-    g: Math.round(g * 255),
-    b: Math.round(b * 255),
-    a: A
-  };
-}
-function _hsb2rgb(hsb) {
-  const { h, s, b, a = 1 } = hsb;
-  const H = absoluteModulo(h, 360) / 360;
-  const S = Math.max(0, Math.min(1, s / 100));
-  const B = Math.max(0, Math.min(1, b / 100));
-  const A = Math.max(0, Math.min(1, a));
-  const i = Math.floor(H * 6);
-  const f = H * 6 - i;
-  const p = B * (1 - S);
-  const q = B * (1 - f * S);
-  const t = B * (1 - (1 - f) * S);
-  let r;
-  let g;
-  let blue;
-  switch (absoluteModulo(i, 6)) {
-    case 0:
-      r = B;
-      g = t;
-      blue = p;
-      break;
-    case 1:
-      r = q;
-      g = B;
-      blue = p;
-      break;
-    case 2:
-      r = p;
-      g = B;
-      blue = t;
-      break;
-    case 3:
-      r = p;
-      g = q;
-      blue = B;
-      break;
-    case 4:
-      r = t;
-      g = p;
-      blue = B;
-      break;
-    case 5:
-      r = B;
-      g = p;
-      blue = q;
-      break;
-    default:
-      r = g = blue = 0;
-  }
-  return {
-    r: Math.round(r * 255),
-    g: Math.round(g * 255),
-    b: Math.round(blue * 255),
-    a: A
-  };
-}
-function _cmyk2rgb(cmyka) {
-  const { c, m, y, k, a = 1 } = cmyka;
-  const C = Math.max(0, Math.min(100, c)) / 100;
-  const M = Math.max(0, Math.min(100, m)) / 100;
-  const Y = Math.max(0, Math.min(100, y)) / 100;
-  const K = Math.max(0, Math.min(100, k)) / 100;
-  const A = Math.max(0, Math.min(1, a));
-  const R = 1 - Math.min(1, C * (1 - K) + K);
-  const G = 1 - Math.min(1, M * (1 - K) + K);
-  const B = 1 - Math.min(1, Y * (1 - K) + K);
-  return {
-    r: Math.round(R * 255),
-    g: Math.round(G * 255),
-    b: Math.round(B * 255),
-    a: A
-  };
-}
-function _xyz2rgb(xyza) {
-  const { x, y, z, a = 1 } = xyza;
-  const X = x / 100;
-  const Y = y / 100;
-  const Z = z / 100;
-  const A = Math.max(0, Math.min(1, a));
-  let R = X * 3.2404542 + Y * -1.5371385 + Z * -0.4985314;
-  let G = X * -0.969266 + Y * 1.8760108 + Z * 0.041556;
-  let B = X * 0.0556434 + Y * -0.2040259 + Z * 1.0572252;
-  const GAMMA_THRESHOLD = 31308e-7;
-  const GAMMA_EXPONENT = 1 / 2.4;
-  const GAMMA_MULT = 1.055;
-  const GAMMA_OFFSET = 0.055;
-  const LINEAR_DIVISOR = 12.92;
-  const gammaCorrect = (c) => c <= GAMMA_THRESHOLD ? c * LINEAR_DIVISOR : GAMMA_MULT * Math.pow(c, GAMMA_EXPONENT) - GAMMA_OFFSET;
-  R = gammaCorrect(R);
-  G = gammaCorrect(G);
-  B = gammaCorrect(B);
-  return {
-    r: Math.round(Math.max(0, Math.min(1, R)) * 255),
-    g: Math.round(Math.max(0, Math.min(1, G)) * 255),
-    b: Math.round(Math.max(0, Math.min(1, B)) * 255),
-    a: A
-  };
-}
-function _lab2xyz(lab) {
-  const { l, a: A = 0, b: B = 0, al: alpha = 1 } = lab;
-  const REF_X = 95.047;
-  const REF_Y = 100;
-  const REF_Z = 108.883;
-  const fy = (l + 16) / 116;
-  const fx = fy + A / 500;
-  const fz = fy - B / 200;
-  const fx3 = Math.pow(fx, 3);
-  const fz3 = Math.pow(fz, 3);
-  const fy3 = Math.pow(fy, 3);
-  const epsilon = 8856e-6;
-  const kappa = 903.3;
-  const X = fx3 > epsilon ? fx3 : (116 * fx - 16) / kappa;
-  const Y = l > kappa * epsilon ? fy3 : l / kappa;
-  const Z = fz3 > epsilon ? fz3 : (116 * fz - 16) / kappa;
-  return {
-    x: X * REF_X,
-    y: Y * REF_Y,
-    z: Z * REF_Z,
-    a: Math.max(0, Math.min(1, alpha))
-  };
-}
-function _lch2lab(lch) {
-  const { l, c, h, a = 1 } = lch;
-  const hRad = h * Math.PI / 180;
-  const A = c * Math.cos(hRad);
-  const B = c * Math.sin(hRad);
-  return { l, a: A, b: B, al: a };
-}
-function toRgb(color) {
-  if (isRgb(color)) return color;
-  if (isHsl(color)) return _hsl2rgb(color);
-  if (isHsb(color)) return _hsb2rgb(color);
-  if (isCmyk(color)) return _cmyk2rgb(color);
-  if (isCssColor(color)) return _css2rgb(color);
-  if (isHex(color)) return _hex2rgb(color);
-  if (isXyz(color)) return _xyz2rgb(color);
-  if (isLab(color)) return _xyz2rgb(_lab2xyz(color));
-  if (isLch(color)) return _xyz2rgb(_lab2xyz(_lch2lab(color)));
-  throw new Error(`Invalid color input: ${unknownToString(color)}`);
-}
-function toHex(color) {
-  if (isHex(color)) return color;
-  const rgbColor = toRgb(color);
-  return _rgb2hex(rgbColor);
-}
-
-// src/node/images/utils/index.ts
-function toSharpColor(color) {
-  const rgb = tidy(toRgb(color));
-  return {
-    r: rgb.r,
-    g: rgb.g,
-    b: rgb.b,
-    alpha: rgb.a
-  };
-}
-function isDuckTypedSharpInstance(obj) {
-  if (!isNonNullObject(obj)) return false;
-  return "avif" in obj && "clone" in obj && "gif" in obj && "heif" in obj && "jpeg" in obj && "heif" in obj && "metadata" in obj && "png" in obj && "resize" in obj && "tiff" in obj && "webp" in obj && typeof obj.avif === "function" && typeof obj.clone === "function" && typeof obj.gif === "function" && typeof obj.heif === "function" && typeof obj.jpeg === "function" && typeof obj.heif === "function" && typeof obj.metadata === "function" && typeof obj.png === "function" && typeof obj.resize === "function" && typeof obj.tiff === "function" && typeof obj.webp === "function";
-}
-function toCreateOptions(options) {
-  return {
-    width: options.width ?? 100,
-    height: options.height ?? 100,
-    channels: options.channels ?? 4,
-    background: options.background !== void 0 ? toSharpColor(options.background) : toSharpColor("white"),
-    noise: options.noise !== void 0 ? { ...options.noise, type: "gaussian" } : void 0,
-    pageHeight: options.pageHeight
-  };
-}
-async function toSharpInstance(imageLike, clone = false) {
-  if (typeof imageLike === "string") return sharp(await readFile(imageLike));
-  if (Buffer.isBuffer(imageLike)) return sharp(imageLike);
-  if (isDuckTypedSharpInstance(imageLike)) return clone ? imageLike.clone() : imageLike;
-  return sharp({ create: toCreateOptions(imageLike) });
-}
-
-// src/node/images/format/index.ts
-var formatCommonOptionsSchema = zod.object({
-  width: zod.number().optional(),
-  height: zod.number().optional(),
-  fit: zod.enum(["contain", "cover", "fill", "inside", "outside"]).optional(),
-  position: zod.union([zod.number(), zod.string()]).optional(),
-  background: zod.custom(isColor).optional(),
-  kernel: zod.enum(["nearest", "cubic", "mitchell", "lanczos2", "lanczos3", "mks2013", "mks2021"]).optional(),
-  withoutEnlargement: zod.boolean().optional(),
-  withoutReduction: zod.boolean().optional(),
-  fastShrinkOnLoad: zod.boolean().optional()
+import zod from 'zod';
+import { clamp } from '../../../agnostic/numbers/clamp/index.js';
+import * as Outcome from '../../../agnostic/misc/outcome/index.js';
+import { toSharpColor, toSharpInstance } from '../utils/index.js';
+import { isColor } from '../../../agnostic/colors/typechecks/index.js';
+/* * * * * * * * * * * * * * *
+ * SCHEMAS
+ * * * * * * * * * * * * * * */
+const formatCommonOptionsSchema = zod.object({
+    width: zod.number().optional(),
+    height: zod.number().optional(),
+    fit: zod.enum(['contain', 'cover', 'fill', 'inside', 'outside']).optional(),
+    position: zod.union([zod.number(), zod.string()]).optional(),
+    background: zod.custom(isColor).optional(),
+    kernel: zod.enum(['nearest', 'cubic', 'mitchell', 'lanczos2', 'lanczos3', 'mks2013', 'mks2021']).optional(),
+    withoutEnlargement: zod.boolean().optional(),
+    withoutReduction: zod.boolean().optional(),
+    fastShrinkOnLoad: zod.boolean().optional()
 });
-var formatJpgOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.union([zod.literal("jpg"), zod.literal("jpeg")]),
-  quality: zod.number().optional(),
-  force: zod.boolean().optional(),
-  progressive: zod.boolean().optional(),
-  chromaSubsampling: zod.string().optional(),
-  trellisQuantisation: zod.boolean().optional(),
-  overshootDeringing: zod.boolean().optional(),
-  optimizeScans: zod.boolean().optional(),
-  optimizeCoding: zod.boolean().optional(),
-  quantizationTable: zod.number().optional(),
-  mozjpeg: zod.boolean().optional()
+const formatJpgOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.union([zod.literal('jpg'), zod.literal('jpeg')]),
+    quality: zod.number().optional(),
+    force: zod.boolean().optional(),
+    progressive: zod.boolean().optional(),
+    chromaSubsampling: zod.string().optional(),
+    trellisQuantisation: zod.boolean().optional(),
+    overshootDeringing: zod.boolean().optional(),
+    optimizeScans: zod.boolean().optional(),
+    optimizeCoding: zod.boolean().optional(),
+    quantizationTable: zod.number().optional(),
+    mozjpeg: zod.boolean().optional()
 });
-var formatPngOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.literal("png"),
-  quality: zod.number().optional(),
-  force: zod.boolean().optional(),
-  progressive: zod.boolean().optional(),
-  compressionLevel: zod.number().min(0).max(9).optional(),
-  adaptiveFiltering: zod.boolean().optional(),
-  effort: zod.number().min(1).max(10).optional(),
-  palette: zod.boolean().optional(),
-  colors: zod.number().min(1).max(256).optional(),
-  dither: zod.number().min(0).max(1).optional()
+const formatPngOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.literal('png'),
+    quality: zod.number().optional(),
+    force: zod.boolean().optional(),
+    progressive: zod.boolean().optional(),
+    compressionLevel: zod.number().min(0).max(9).optional(),
+    adaptiveFiltering: zod.boolean().optional(),
+    effort: zod.number().min(1).max(10).optional(),
+    palette: zod.boolean().optional(),
+    colors: zod.number().min(1).max(256).optional(),
+    dither: zod.number().min(0).max(1).optional()
 });
-var formatWebpOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.literal("webp"),
-  quality: zod.number().optional(),
-  force: zod.boolean().optional(),
-  alphaQuality: zod.number().optional(),
-  lossless: zod.boolean().optional(),
-  nearLossless: zod.boolean().optional(),
-  smartSubsample: zod.boolean().optional(),
-  smartDeblock: zod.boolean().optional(),
-  effort: zod.number().optional(),
-  minSize: zod.boolean().optional(),
-  mixed: zod.boolean().optional(),
-  preset: zod.enum(["default", "picture", "photo", "drawing", "icon", "text"]).optional(),
-  loop: zod.number().optional(),
-  delay: zod.union([zod.number(), zod.array(zod.number())]).optional()
+const formatWebpOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.literal('webp'),
+    quality: zod.number().optional(),
+    force: zod.boolean().optional(),
+    alphaQuality: zod.number().optional(),
+    lossless: zod.boolean().optional(),
+    nearLossless: zod.boolean().optional(),
+    smartSubsample: zod.boolean().optional(),
+    smartDeblock: zod.boolean().optional(),
+    effort: zod.number().optional(),
+    minSize: zod.boolean().optional(),
+    mixed: zod.boolean().optional(),
+    preset: zod.enum(['default', 'picture', 'photo', 'drawing', 'icon', 'text']).optional(),
+    loop: zod.number().optional(),
+    delay: zod.union([zod.number(), zod.array(zod.number())]).optional()
 });
-var formatAvifOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.literal("avif"),
-  quality: zod.number().optional(),
-  force: zod.boolean().optional(),
-  lossless: zod.boolean().optional(),
-  effort: zod.number().optional(),
-  chromaSubsampling: zod.string().optional(),
-  bitdepth: zod.union([zod.literal(8), zod.literal(10), zod.literal(12)]).optional()
+const formatAvifOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.literal('avif'),
+    quality: zod.number().optional(),
+    force: zod.boolean().optional(),
+    lossless: zod.boolean().optional(),
+    effort: zod.number().optional(),
+    chromaSubsampling: zod.string().optional(),
+    bitdepth: zod.union([zod.literal(8), zod.literal(10), zod.literal(12)]).optional()
 });
-var formatTiffOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.literal("tiff"),
-  quality: zod.number().optional(),
-  compression: zod.enum(["none", "jpeg", "deflate", "packbits", "ccittfax4", "lzw", "webp", "zstd", "jp2k"]).optional(),
-  force: zod.boolean().optional(),
-  predictor: zod.enum(["none", "horizontal", "float"]).optional(),
-  pyramid: zod.boolean().optional(),
-  tile: zod.boolean().optional(),
-  tileWidth: zod.number().optional(),
-  tileHeight: zod.number().optional(),
-  xres: zod.number().optional(),
-  yres: zod.number().optional(),
-  bitdepth: zod.union([zod.literal(1), zod.literal(2), zod.literal(4), zod.literal(8)]).optional(),
-  miniswhite: zod.boolean().optional(),
-  resolutionUnit: zod.enum(["inch", "cm"]).optional()
+const formatTiffOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.literal('tiff'),
+    quality: zod.number().optional(),
+    compression: zod.enum(['none', 'jpeg', 'deflate', 'packbits', 'ccittfax4', 'lzw', 'webp', 'zstd', 'jp2k']).optional(),
+    force: zod.boolean().optional(),
+    predictor: zod.enum(['none', 'horizontal', 'float']).optional(),
+    pyramid: zod.boolean().optional(),
+    tile: zod.boolean().optional(),
+    tileWidth: zod.number().optional(),
+    tileHeight: zod.number().optional(),
+    xres: zod.number().optional(),
+    yres: zod.number().optional(),
+    bitdepth: zod.union([zod.literal(1), zod.literal(2), zod.literal(4), zod.literal(8)]).optional(),
+    miniswhite: zod.boolean().optional(),
+    resolutionUnit: zod.enum(['inch', 'cm']).optional()
 });
-var formatHeifOptionsSchema = formatCommonOptionsSchema.extend({
-  type: zod.literal("heif"),
-  quality: zod.number().optional(),
-  force: zod.boolean().optional(),
-  compression: zod.enum(["av1", "hevc"]).optional(),
-  lossless: zod.boolean().optional(),
-  effort: zod.number().optional(),
-  chromaSubsampling: zod.string().optional(),
-  bitdepth: zod.union([zod.literal(8), zod.literal(10), zod.literal(12)]).optional()
+const formatHeifOptionsSchema = formatCommonOptionsSchema.extend({
+    type: zod.literal('heif'),
+    quality: zod.number().optional(),
+    force: zod.boolean().optional(),
+    compression: zod.enum(['av1', 'hevc']).optional(),
+    lossless: zod.boolean().optional(),
+    effort: zod.number().optional(),
+    chromaSubsampling: zod.string().optional(),
+    bitdepth: zod.union([zod.literal(8), zod.literal(10), zod.literal(12)]).optional()
 });
-var formatKeepOptionsSchema = formatCommonOptionsSchema;
-var formatOptionsSchema = zod.union([
-  formatJpgOptionsSchema,
-  formatPngOptionsSchema,
-  formatWebpOptionsSchema,
-  formatAvifOptionsSchema,
-  formatTiffOptionsSchema,
-  formatHeifOptionsSchema,
-  formatKeepOptionsSchema
+const formatKeepOptionsSchema = formatCommonOptionsSchema;
+const formatOptionsSchema = zod.union([
+    formatJpgOptionsSchema,
+    formatPngOptionsSchema,
+    formatWebpOptionsSchema,
+    formatAvifOptionsSchema,
+    formatTiffOptionsSchema,
+    formatHeifOptionsSchema,
+    formatKeepOptionsSchema
 ]);
-var isFormatCommonOptions = (options) => formatCommonOptionsSchema.safeParse(options).success;
-var isFormatJpgOptions = (options) => formatJpgOptionsSchema.safeParse(options).success;
-var isFormatPngOptions = (options) => formatPngOptionsSchema.safeParse(options).success;
-var isFormatWebpOptions = (options) => formatWebpOptionsSchema.safeParse(options).success;
-var isFormatAvifOptions = (options) => formatAvifOptionsSchema.safeParse(options).success;
-var isFormatTiffOptions = (options) => formatTiffOptionsSchema.safeParse(options).success;
-var isFormatHeifOptions = (options) => formatHeifOptionsSchema.safeParse(options).success;
-var isFormatOptions = (options) => formatOptionsSchema.safeParse(options).success;
-var toSharpResizeOptions = (options) => {
-  return {
-    width: options.width,
-    height: options.height,
-    fit: options.fit,
-    position: options.position,
-    background: options.background !== void 0 ? toSharpColor(options.background) : void 0,
-    kernel: options.kernel,
-    withoutEnlargement: options.withoutEnlargement,
-    withoutReduction: options.withoutReduction,
-    fastShrinkOnLoad: options.fastShrinkOnLoad
-  };
+/* * * * * * * * * * * * * * *
+ * TYPECHECKS
+ * * * * * * * * * * * * * * */
+/** Type guard to check if options match FormatCommonOptions. */
+export const isFormatCommonOptions = (options) => formatCommonOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatJpgOptions. */
+export const isFormatJpgOptions = (options) => formatJpgOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatPngOptions. */
+export const isFormatPngOptions = (options) => formatPngOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatWebpOptions. */
+export const isFormatWebpOptions = (options) => formatWebpOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatAvifOptions. */
+export const isFormatAvifOptions = (options) => formatAvifOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatTiffOptions. */
+export const isFormatTiffOptions = (options) => formatTiffOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatHeifOptions. */
+export const isFormatHeifOptions = (options) => formatHeifOptionsSchema.safeParse(options).success;
+/** Type guard to check if options match FormatOptions. */
+export const isFormatOptions = (options) => formatOptionsSchema.safeParse(options).success;
+/* * * * * * * * * * * * * * *
+ * CONVERTERS
+ * * * * * * * * * * * * * * */
+/** Converts FormatCommonOptions to Sharp resize options. */
+export const toSharpResizeOptions = (options) => {
+    return {
+        width: options.width,
+        height: options.height,
+        fit: options.fit,
+        position: options.position,
+        background: options.background !== undefined
+            ? toSharpColor(options.background)
+            : undefined,
+        kernel: options.kernel,
+        withoutEnlargement: options.withoutEnlargement,
+        withoutReduction: options.withoutReduction,
+        fastShrinkOnLoad: options.fastShrinkOnLoad
+    };
 };
-var toSharpJpegOptions = (options) => {
-  return {
-    quality: options.quality,
-    force: options.force,
-    progressive: options.progressive,
-    chromaSubsampling: options.chromaSubsampling,
-    trellisQuantisation: options.trellisQuantisation,
-    overshootDeringing: options.overshootDeringing,
-    optimizeScans: options.optimizeScans,
-    optimizeCoding: options.optimizeCoding,
-    quantizationTable: options.quantizationTable,
-    mozjpeg: options.mozjpeg
-  };
+/** Converts FormatJpgOptions to Sharp JPEG options. */
+export const toSharpJpegOptions = (options) => {
+    return {
+        quality: options.quality,
+        force: options.force,
+        progressive: options.progressive,
+        chromaSubsampling: options.chromaSubsampling,
+        trellisQuantisation: options.trellisQuantisation,
+        overshootDeringing: options.overshootDeringing,
+        optimizeScans: options.optimizeScans,
+        optimizeCoding: options.optimizeCoding,
+        quantizationTable: options.quantizationTable,
+        mozjpeg: options.mozjpeg
+    };
 };
-var toSharpPngOptions = (options) => {
-  return {
-    quality: options.quality,
-    force: options.force,
-    progressive: options.progressive,
-    compressionLevel: options.compressionLevel,
-    adaptiveFiltering: options.adaptiveFiltering,
-    effort: options.effort,
-    palette: options.palette,
-    colors: options.colors,
-    dither: options.dither
-  };
+/** Converts FormatPngOptions to Sharp PNG options. */
+export const toSharpPngOptions = (options) => {
+    return {
+        quality: options.quality,
+        force: options.force,
+        progressive: options.progressive,
+        compressionLevel: options.compressionLevel,
+        adaptiveFiltering: options.adaptiveFiltering,
+        effort: options.effort,
+        palette: options.palette,
+        colors: options.colors,
+        dither: options.dither
+    };
 };
-var toSharpWebpOptions = (options) => {
-  return {
-    quality: options.quality,
-    loop: options.loop,
-    delay: options.delay,
-    force: options.force,
-    alphaQuality: options.alphaQuality,
-    lossless: options.lossless,
-    nearLossless: options.nearLossless,
-    smartSubsample: options.smartSubsample,
-    smartDeblock: options.smartDeblock,
-    effort: options.effort,
-    minSize: options.minSize,
-    mixed: options.mixed,
-    preset: options.preset
-  };
+/** Converts FormatWebpOptions to Sharp WebP options. */
+export const toSharpWebpOptions = (options) => {
+    return {
+        quality: options.quality,
+        loop: options.loop,
+        delay: options.delay,
+        force: options.force,
+        alphaQuality: options.alphaQuality,
+        lossless: options.lossless,
+        nearLossless: options.nearLossless,
+        smartSubsample: options.smartSubsample,
+        smartDeblock: options.smartDeblock,
+        effort: options.effort,
+        minSize: options.minSize,
+        mixed: options.mixed,
+        preset: options.preset
+    };
 };
-var toSharpAvifOptions = (options) => {
-  return {
-    force: options.force,
-    quality: options.quality,
-    lossless: options.lossless,
-    effort: options.effort,
-    chromaSubsampling: options.chromaSubsampling,
-    bitdepth: options.bitdepth
-  };
+/** Converts FormatAvifOptions to Sharp AVIF options. */
+export const toSharpAvifOptions = (options) => {
+    return {
+        force: options.force,
+        quality: options.quality,
+        lossless: options.lossless,
+        effort: options.effort,
+        chromaSubsampling: options.chromaSubsampling,
+        bitdepth: options.bitdepth
+    };
 };
-var toSharpTiffOptions = (options) => {
-  return {
-    force: options.force,
-    quality: options.quality,
-    compression: options.compression,
-    predictor: options.predictor,
-    pyramid: options.pyramid,
-    tile: options.tile,
-    tileWidth: options.tileWidth,
-    tileHeight: options.tileHeight,
-    xres: options.xres,
-    yres: options.yres,
-    bitdepth: options.bitdepth,
-    miniswhite: options.miniswhite,
-    resolutionUnit: options.resolutionUnit
-  };
+/** Converts FormatTiffOptions to Sharp TIFF options. */
+export const toSharpTiffOptions = (options) => {
+    return {
+        force: options.force,
+        quality: options.quality,
+        compression: options.compression,
+        predictor: options.predictor,
+        pyramid: options.pyramid,
+        tile: options.tile,
+        tileWidth: options.tileWidth,
+        tileHeight: options.tileHeight,
+        xres: options.xres,
+        yres: options.yres,
+        bitdepth: options.bitdepth,
+        miniswhite: options.miniswhite,
+        resolutionUnit: options.resolutionUnit
+    };
 };
-var toSharpHeifOptions = (options) => {
-  return {
-    force: options.force,
-    quality: options.quality,
-    compression: options.compression,
-    lossless: options.lossless,
-    effort: options.effort,
-    chromaSubsampling: options.chromaSubsampling,
-    bitdepth: options.bitdepth
-  };
+/** Converts FormatHeifOptions to Sharp HEIF options. */
+export const toSharpHeifOptions = (options) => {
+    return {
+        force: options.force,
+        quality: options.quality,
+        compression: options.compression,
+        lossless: options.lossless,
+        effort: options.effort,
+        chromaSubsampling: options.chromaSubsampling,
+        bitdepth: options.bitdepth
+    };
 };
-async function format(input, options) {
-  const sharpInstance = await toSharpInstance(input);
-  const resizeOptions = toSharpResizeOptions(options);
-  const resizedInstance = sharpInstance.resize(resizeOptions);
-  if (isFormatJpgOptions(options)) return makeSuccess(await resizedInstance.jpeg(toSharpJpegOptions(options)).toBuffer());
-  if (isFormatPngOptions(options)) return makeSuccess(await resizedInstance.png(toSharpPngOptions(options)).toBuffer());
-  if (isFormatWebpOptions(options)) return makeSuccess(await resizedInstance.webp(toSharpWebpOptions(options)).toBuffer());
-  if (isFormatAvifOptions(options)) return makeSuccess(await resizedInstance.avif(toSharpAvifOptions(options)).toBuffer());
-  if (isFormatTiffOptions(options)) return makeSuccess(await resizedInstance.tiff(toSharpTiffOptions(options)).toBuffer());
-  if (isFormatHeifOptions(options)) return makeSuccess(await resizedInstance.heif(toSharpHeifOptions(options)).toBuffer());
-  return makeSuccess(await resizedInstance.toBuffer());
+/* * * * * * * * * * * * * * *
+ * FUNCTIONS
+ * * * * * * * * * * * * * * */
+/**
+ * Formats an image with the specified options.
+ *
+ * The function resizes and converts the image to the specified format (JPG, PNG, WebP,
+ * AVIF, TIFF, HEIF, or keeps the original format) based on the provided options.
+ *
+ * @param input - The image to format. Can be a Sharp instance, Buffer, CreateOptions, or file path.
+ * @param options - Format and resize options. See `FormatOptions` for details.
+ * @returns
+ * - On success:  `Outcome.makeSuccess(buffer)` containing the formatted image.
+ * - On failure:  `Outcome.makeFailure(errStr)`.
+ */
+export async function format(input, options) {
+    const sharpInstance = await toSharpInstance(input);
+    const resizeOptions = toSharpResizeOptions(options);
+    const resizedInstance = sharpInstance.resize(resizeOptions);
+    if (isFormatJpgOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.jpeg(toSharpJpegOptions(options)).toBuffer());
+    if (isFormatPngOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.png(toSharpPngOptions(options)).toBuffer());
+    if (isFormatWebpOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.webp(toSharpWebpOptions(options)).toBuffer());
+    if (isFormatAvifOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.avif(toSharpAvifOptions(options)).toBuffer());
+    if (isFormatTiffOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.tiff(toSharpTiffOptions(options)).toBuffer());
+    if (isFormatHeifOptions(options))
+        return Outcome.makeSuccess(await resizedInstance.heif(toSharpHeifOptions(options)).toBuffer());
+    return Outcome.makeSuccess(await resizedInstance.toBuffer());
 }
-var toWidth = async (input, width) => await (await toSharpInstance(input)).resize({ width }).toBuffer();
-var toHeight = async (input, height) => await (await toSharpInstance(input)).resize({ height }).toBuffer();
-var toJpg = async (input, quality) => await (await toSharpInstance(input)).jpeg({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toPng = async (input, quality, compressionLevel) => await (await toSharpInstance(input)).png({ quality: clamp(quality ?? 100, 1, 100), compressionLevel }).toBuffer();
-var toWebp = async (input, quality) => await (await toSharpInstance(input)).webp({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toAvif = async (input, quality) => await (await toSharpInstance(input)).avif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toTiff = async (input, quality, compression) => await (await toSharpInstance(input)).tiff({ quality: clamp(quality ?? 100, 1, 100), compression }).toBuffer();
-var toHeif = async (input, quality) => await (await toSharpInstance(input)).heif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-export {
-  format,
-  isFormatAvifOptions,
-  isFormatCommonOptions,
-  isFormatHeifOptions,
-  isFormatJpgOptions,
-  isFormatOptions,
-  isFormatPngOptions,
-  isFormatTiffOptions,
-  isFormatWebpOptions,
-  toAvif,
-  toHeif,
-  toHeight,
-  toJpg,
-  toPng,
-  toSharpAvifOptions,
-  toSharpHeifOptions,
-  toSharpJpegOptions,
-  toSharpPngOptions,
-  toSharpResizeOptions,
-  toSharpTiffOptions,
-  toSharpWebpOptions,
-  toTiff,
-  toWebp,
-  toWidth
-};
+/** Resizes an image to a specific width while maintaining aspect ratio. */
+export const toWidth = async (input, width) => await (await toSharpInstance(input)).resize({ width }).toBuffer();
+/** Resizes an image to a specific height while maintaining aspect ratio. */
+export const toHeight = async (input, height) => await (await toSharpInstance(input)).resize({ height }).toBuffer();
+/** Converts an image to JPEG format. */
+export const toJpg = async (input, quality) => await (await toSharpInstance(input)).jpeg({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+/** Converts an image to PNG format. */
+export const toPng = async (input, quality, compressionLevel) => await (await toSharpInstance(input)).png({ quality: clamp(quality ?? 100, 1, 100), compressionLevel }).toBuffer();
+/** Converts an image to WebP format. */
+export const toWebp = async (input, quality) => await (await toSharpInstance(input)).webp({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+/** Converts an image to AVIF format. */
+export const toAvif = async (input, quality) => await (await toSharpInstance(input)).avif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+/** Converts an image to TIFF format. */
+export const toTiff = async (input, quality, compression) => await (await toSharpInstance(input)).tiff({ quality: clamp(quality ?? 100, 1, 100), compression }).toBuffer();
+/** Converts an image to HEIF format. */
+export const toHeif = async (input, quality) => await (await toSharpInstance(input)).heif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();