@design-edito/tools 0.4.4 → 0.4.6

package/node/images/format/index.js

@@ -1,267 +1,280 @@
-import {
-  toSharpColor,
-  toSharpInstance
-} from "../../../chunks/chunk-HMMPT3UM.js";
-import {
-  makeSuccess
-} from "../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../chunks/chunk-CVMYA5XK.js";
-import {
-  isColor
-} from "../../../chunks/chunk-OBSTP7YR.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-PUQUSA6S.js";
-import {
-  clamp
-} from "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
-
-// src/node/images/format/index.ts
-import zod from "zod";
-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();

package/node/images/index.d.ts

@@ -1,5 +1,5 @@
-export * as format from './format/index.js'
 export * as create from './create/index.js'
+export * as format from './format/index.js'
 export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

package/node/images/index.js

@@ -1,5 +1,5 @@
-export * as format from './format/index.js'
 export * as create from './create/index.js'
+export * as format from './format/index.js'
 export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

package/node/images/metadata/index.js

@@ -1,19 +1,11 @@
-import {
-  toSharpInstance
-} from "../../../chunks/chunk-HMMPT3UM.js";
-import "../../../chunks/chunk-CVMYA5XK.js";
-import "../../../chunks/chunk-OBSTP7YR.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-PUQUSA6S.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
-
-// src/node/images/metadata/index.ts
-async function metadata(imageInput) {
-  const sharpInstance = await toSharpInstance(imageInput);
-  return await sharpInstance.metadata();
+import { toSharpInstance } from '../utils/index.js';
+/**
+ * Retrieves metadata from an image.
+ *
+ * @param imageInput - The image to get metadata from. Can be a Sharp instance, Buffer, CreateOptions, or file path.
+ * @returns Image metadata including dimensions, format, color space, and other properties.
+ */
+export async function metadata(imageInput) {
+    const sharpInstance = await toSharpInstance(imageInput);
+    return await sharpInstance.metadata();
 }
-export {
-  metadata
-};