@design-edito/tools 0.3.0 → 1.0.1

package/node/files/subpaths/index.js

@@ -1,122 +0,0 @@
-import {
-  matchesSome
-} from "../../../chunks/chunk-R3AWQXMY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/node/files/subpaths/index.ts
-import { promises as fs } from "node:fs";
-import path from "node:path";
-var defaultListContext = {
-  depth: 0,
-  lstats: null,
-  rootPath: null
-};
-var fillListContext = (input) => {
-  return {
-    ...defaultListContext,
-    ...input
-  };
-};
-var defaultListOptions = {
-  directories: true,
-  files: true,
-  symlinks: true,
-  hidden: true,
-  followSimlinks: false,
-  dedupeSimlinksContents: false,
-  maxDepth: Infinity,
-  returnRelative: false,
-  exclude: null,
-  include: null,
-  filter: () => true
-};
-var fillOptions = (input) => {
-  return {
-    ...defaultListOptions,
-    ...input
-  };
-};
-async function list(...args) {
-  const [inputPath, _options] = args;
-  const options = fillOptions(_options ?? {});
-  const subpaths = await listAbsoluteSubpaths(...args);
-  return options.returnRelative ? subpaths.map((subpath) => path.relative(inputPath, subpath)) : subpaths;
-}
-async function listAbsoluteSubpaths(inputPath, _options = {}, __private_context = {}) {
-  const options = fillOptions(_options);
-  const _private_context = fillListContext(__private_context);
-  if (_private_context.rootPath === null) {
-    _private_context.rootPath = inputPath;
-  }
-  const subpaths = [];
-  if (_private_context.depth > options.maxDepth) return subpaths;
-  try {
-    const pathStat = _private_context.lstats ?? await fs.lstat(inputPath);
-    if (!pathStat.isDirectory()) return subpaths;
-  } catch (err) {
-    return subpaths;
-  }
-  const childrenRelPaths = await fs.readdir(inputPath);
-  await Promise.all(childrenRelPaths.map(async (childRelPath) => {
-    const childAbsPath = path.join(inputPath, childRelPath);
-    const childRelFromRootPath = path.relative(_private_context.rootPath ?? inputPath, childAbsPath);
-    const childLstats = await fs.lstat(childAbsPath);
-    try {
-      const isDirectory = childLstats.isDirectory();
-      const isSymlink = childLstats.isSymbolicLink();
-      const isFile = !isDirectory && !isSymlink;
-      const isHidden = path.basename(childAbsPath).startsWith(".");
-      const type = isDirectory ? "directory" : isSymlink ? "symlink" : "file";
-      if (isDirectory && options.directories === false) throw true;
-      if (isSymlink && options.symlinks === false) throw false;
-      if (isFile && options.files === false) throw false;
-      if (isHidden && options.hidden === false) throw false;
-      const realPath = isSymlink ? await fs.realpath(childAbsPath) : childAbsPath;
-      const childPathForFilters = options.returnRelative ? childRelFromRootPath : childAbsPath;
-      const isInExclude = matchesSome(childPathForFilters, options.exclude ?? []);
-      const isInInclude = matchesSome(childPathForFilters, options.include ?? []);
-      if (isInExclude && !isInInclude) throw false;
-      const isInFilter = await options.filter(childPathForFilters, { type, hidden: isHidden, realPath });
-      if (!isInFilter) throw true;
-      if (isSymlink) {
-        if (options.followSimlinks === false) subpaths.push(childAbsPath);
-        else {
-          const childSubpaths = await listAbsoluteSubpaths(realPath, options, {
-            ..._private_context,
-            depth: _private_context.depth + 1
-          });
-          subpaths.push(realPath, ...childSubpaths);
-        }
-      } else {
-        if (isDirectory) {
-          const childSubpaths = await listAbsoluteSubpaths(childAbsPath, options, {
-            ..._private_context,
-            depth: _private_context.depth + 1,
-            lstats: childLstats
-          });
-          subpaths.push(childAbsPath, ...childSubpaths);
-        } else {
-          subpaths.push(childAbsPath);
-        }
-      }
-    } catch (err) {
-      if (typeof err !== "boolean") throw new Error(`This try/catch block should only throw booleans`);
-      const shouldDiveDeeper = err;
-      if (!shouldDiveDeeper) return [];
-      const childSubpaths = await listAbsoluteSubpaths(childAbsPath, options, {
-        ..._private_context,
-        depth: _private_context.depth + 1,
-        lstats: childLstats
-      });
-      subpaths.push(...childSubpaths);
-    }
-  }));
-  return options.dedupeSimlinksContents ? Array.from(new Set(subpaths)) : subpaths;
-}
-export {
-  defaultListContext,
-  defaultListOptions,
-  fillListContext,
-  fillOptions,
-  list
-};

package/node/ftps/directory/copy-dir/index.d.ts

@@ -1,28 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type CopyDirOptions = {
-    /**
-     * If `false` and a destination file already exists, copying aborts.
-     * @default false
-     */
-    overwrite?: boolean;
-    /**
-     * When `true`, creates any missing directories in the destination path
-     * (`ftpClient.ensureDir`) before writing files.
-     * @default true
-     */
-    ensureDir?: boolean;
-};
-/**
- * Recursively copies every file under `sourceDir` to the same relative path
- * beneath `targetDir` on an FTP server, streaming data to avoid buffering.
- *
- * @param {Client}  ftpClient  - The FTP client instance.
- * @param {string}  sourceDir  - The source directory path to copy from.
- * @param {string}  targetDir  - The target directory path to copy to.
- * @param {CopyDirOptions} [options] - Optional parameters for the operation.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - Success: `Outcome.makeSuccess(true)` if the copy succeeds.
- * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
- */
-export declare function copyDir(ftpClient: Client, sourceDir: string, targetDir: string, options?: CopyDirOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/directory/copy-dir/index.js

@@ -1,9 +0,0 @@
-import {
-  copyDir
-} from "../../../../chunks/chunk-RGQNRTBI.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  copyDir
-};

package/node/ftps/directory/list/index.d.ts

@@ -1,12 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-/**
- * Lists all direct children files under a given directory on an FTP server.
- *
- * This function returns only the immediate files (not recursive) under the specified directory.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} directoryPath - The directory path to list files under.
- * @returns {Promise<Outcome.Either<string[], string>>} Returns either a success with an array of file paths, or a failure with an error message.
- */
-export declare function list(ftpClient: Client, directoryPath: string): Promise<Outcome.Either<string[], string>>;

package/node/ftps/directory/list/index.js

@@ -1,9 +0,0 @@
-import {
-  list
-} from "../../../../chunks/chunk-DBNCEHTT.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  list
-};

package/node/ftps/directory/move-dir/index.d.ts

@@ -1,26 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type MoveDirOptions = {
-    /** If false and `targetDir` exists, the operation is aborted. Defaults to false. */
-    overwrite?: boolean;
-    /** If true, ensures the parent directory of `targetDir` exists before moving. Defaults to true. */
-    ensureDir?: boolean;
-};
-/**
- * Renames (moves) a directory on an FTP server.
- * Most FTP servers allow `RNFR /path/old` + `RNTO /path/new` to move a tree
- * atomically. Falling back to manual copy/delete would be expensive, so this
- * util simply performs `rename`.
- *
- * If `ensureDir` is true (default), the parent directory of `targetDir` is
- * created if it does not exist.
- *
- * @param {Client} ftpClient - The FTP client instance.
- * @param {string} sourceDir - The source directory path to move from.
- * @param {string} targetDir - The target directory path to move to.
- * @param {MoveDirOptions} [options] - Optional parameters for the operation.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`:
- * - On success: `Outcome.makeSuccess(true)` indicating the move was successful.
- * - On failure: `Outcome.makeFailure(errStr)` with an error message if the move fails.
- */
-export declare function moveDir(ftpClient: Client, sourceDir: string, targetDir: string, options?: MoveDirOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/directory/move-dir/index.js

@@ -1,9 +0,0 @@
-import {
-  moveDir
-} from "../../../../chunks/chunk-PTN2V757.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  moveDir
-};

package/node/ftps/directory/remove-dir/index.d.ts

@@ -1,25 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type RemoveDirOptions = {
-    /**
-     * If **true** (default) the function ignores the case where `directoryPath`
-     * does not exist and simply returns success.
-     * If **false** and the path is missing, the function returns a failure.
-     * @default true
-     */
-    ignoreMissing?: boolean;
-};
-/**
- * Recursively deletes a directory (and all contents) on an FTP server.
- *
- * @param {Client} ftpClient            - The FTP client instance.
- * @param {string} directoryPath        - The path of the directory to delete.
- * @param {RemoveDirOptions} [options]  - Optional configuration.
- * @param {boolean} [options.ignoreMissing=true] - Whether to ignore a missing directory.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success: `Outcome.makeSuccess(true)` – deletion succeeded, or directory
- *   was absent and `ignoreMissing` is true.
- * - On failure: `Outcome.makeFailure(errStr)` if deletion fails, or directory
- *   absent and `ignoreMissing` is false.
- */
-export declare function removeDir(ftpClient: Client, directoryPath: string, options?: RemoveDirOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/directory/remove-dir/index.js

@@ -1,9 +0,0 @@
-import {
-  removeDir
-} from "../../../../chunks/chunk-W5VY535B.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  removeDir
-};

package/node/ftps/file/copy/index.d.ts

@@ -1,28 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type CopyOptions = {
-    /**
-     * If `false` and the target already exists, the operation is aborted.
-     * @default false
-     */
-    overwrite?: boolean;
-    /**
-     * If `true`, ensures that the target directory hierarchy exists before the
-     * upload starts (creates missing folders with `ensureDir`).
-     * @default true
-     */
-    ensureDir?: boolean;
-};
-/**
- * Copies a file from one path to another on the same FTP server, streaming the
- * data instead of buffering it in memory.
- *
- * @param {Client}  ftpClient  - The basic‑ftp client instance.
- * @param {string}  sourcePath - The path of the source file.
- * @param {string}  targetPath - The destination path.
- * @param {CopyOptions} [options] - Optional copy configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success:  `Outcome.makeSuccess(true)`.
- * - On failure:  `Outcome.makeFailure(errStr)`.
- */
-export declare function copy(ftpClient: Client, sourcePath: string, targetPath: string, options?: CopyOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/file/copy/index.js

@@ -1,9 +0,0 @@
-import {
-  copy
-} from "../../../../chunks/chunk-7B2E2NGH.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  copy
-};

package/node/ftps/file/download/index.d.ts

@@ -1,22 +0,0 @@
-import { Readable } from 'node:stream';
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type DownloadOptions = {
-    startAt?: number;
-};
-/**
- * Downloads a file from a specified FTP server.
- *
- * This function downloads a file from the given FTP server at the specified source path,
- * returning the file content as a Readable stream. The download process can be customized
- * using optional download options.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} sourcePath - The path of the file to be downloaded from the FTP server.
- * @param {DownloadOptions} [options] - Optional settings for configuring the download process.
- * @param {number} [options.startAt] - The byte offset at which to start downloading the file.
- * @returns {Promise<Outcome.Either<Readable, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(stream) containing the downloaded file's content as a Readable stream.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the download fails.
- */
-export declare function download(ftpClient: Client, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;

package/node/ftps/file/download/index.js

@@ -1,9 +0,0 @@
-import {
-  download
-} from "../../../../chunks/chunk-54KPQCVI.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  download
-};

package/node/ftps/file/exists/index.d.ts

@@ -1,21 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-/**
- * Checks if a *file* (not a directory) exists on a specified FTP server.
- *
- * `ftpClient.list(parentDir)` returns an array of `FileInfo` objects:
- *   • `type === FileType.File`          → regular file
- *   • `type === FileType.Directory`     → directory
- *   • `type === FileType.SymbolicLink`  → symlink
- *
- * The function reports **true** only for `FileType.File` or
- * `FileType.SymbolicLink`, mirroring the SFTP behaviour where `'-'` and `'l'`
- * are considered files.
- *
- * @param {Client} ftpClient  - The basic‑ftp client instance.
- * @param {string} sourcePath - The full path to check on the FTP server.
- * @returns {Promise<Outcome.Either<boolean, string>>}
- * - Success: `Outcome.makeSuccess(true | false)` – true only if a file exists.
- * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
- */
-export declare function exists(ftpClient: Client, sourcePath: string): Promise<Outcome.Either<boolean, string>>;

package/node/ftps/file/exists/index.js

@@ -1,9 +0,0 @@
-import {
-  exists
-} from "../../../../chunks/chunk-J5D4OQ5U.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  exists
-};

package/node/ftps/file/move/index.d.ts

@@ -1,38 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type MoveOptions = {
-    /**
-     * When `true`, ensures that the parent directory of `targetPath` exists
-     * before attempting the rename (`ftpClient.ensureDir`).
-     * @default true
-     */
-    ensureDir?: boolean;
-    /**
-     * When `false` (default) and `targetPath` already exists, the move is aborted
-     * and a failure is returned.
-     * @default false
-     */
-    overwrite?: boolean;
-};
-/**
- * Moves (renames) a file on an FTP server.
- *
- * The function performs a simple `rename` operation, which moves the file from
- * `sourcePath` to `targetPath`.  It supports two safety features:
- *
- * 1. **ensureDir** – If enabled, the parent directory of `targetPath`
- *    is created with `ftpClient.ensureDir` before the rename.
- * 2. **overwrite** – If disabled (default) the function first checks whether
- *    an object already exists at `targetPath`; if so, it aborts.
- *
- * @param {Client} ftpClient  - The basic‑ftp client instance.
- * @param {string} sourcePath - The full path of the source file.
- * @param {string} targetPath - The full destination path.
- * @param {MoveOptions} [options] - Optional move configuration.
- * @param {boolean} [options.ensureDir=true]  - Whether to create missing parent directories.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing destination.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success: `Outcome.makeSuccess(true)`.
- * - On failure: `Outcome.makeFailure(errStr)`.
- */
-export declare function move(ftpClient: Client, sourcePath: string, targetPath: string, options?: MoveOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/file/move/index.js

@@ -1,9 +0,0 @@
-import {
-  move
-} from "../../../../chunks/chunk-DBZAJJUF.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  move
-};

package/node/ftps/file/remove/index.d.ts

@@ -1,20 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type RemoveOptions = {
-    ignoreMissing?: boolean;
-};
-/**
- * Removes a file from a specified FTP server.
- *
- * This function removes the file located at the given path on the FTP server.
- * The deletion process can be customized using optional delete options.
- * If the `ignoreMissing` option is true, it does not treat a missing file as an error.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} targetPath - The path of the file to delete on the FTP server.
- * @param {RemoveOptions} [options] - Optional settings for configuring the deletion process.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(true) indicating the deletion was successful.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the deletion fails.
- */
-export declare function remove(ftpClient: Client, targetPath: string, options?: RemoveOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/file/remove/index.js

@@ -1,9 +0,0 @@
-import {
-  remove
-} from "../../../../chunks/chunk-S2I77NEE.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  remove
-};

package/node/ftps/file/stat/index.d.ts

@@ -1,17 +0,0 @@
-import { Client as FtpClient, FileInfo } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export interface Stat {
-    size?: number;
-    modifiedAt?: Date;
-    permissions?: string;
-    raw: FileInfo;
-}
-/**
- * Retrieves metadata for a single file on an FTP server by listing its parent
- * directory and matching the entry.
- *
- * @param {FtpClient} ftp – basic‑ftp client.
- * @param {string} path  – Remote file path.
- * @returns {Promise<Outcome.Either<Stat, string>>}
- */
-export declare function stat(ftp: FtpClient, path: string): Promise<Outcome.Either<Stat, string>>;

package/node/ftps/file/stat/index.js

@@ -1,9 +0,0 @@
-import {
-  stat
-} from "../../../../chunks/chunk-BQABPH3I.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  stat
-};

package/node/ftps/file/upload/index.d.ts

@@ -1,24 +0,0 @@
-import { Readable } from 'node:stream';
-import { Client, UploadOptions as BasicFtpUploadOptions } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type UploadOptions = BasicFtpUploadOptions & {
-    ensureDir?: boolean;
-    overwrite?: boolean;
-};
-/**
- * Uploads a file stream to a specified FTP server.
- *
- * This function uploads the provided file stream to the given FTP server at the specified target path.
- * The upload process can be customized using optional upload options.
- * If the `ensureDir` option is true, it ensures that the target directory exists before uploading.
- * If the `overwrite` option is false, it prevents overwriting an existing file.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} targetPath - The target path where the file will be stored on the FTP server.
- * @param {Readable} fileStream - The file content to be uploaded.
- * @param {UploadOptions} [options] - Optional settings for configuring the upload process.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(true) indicating the upload was successful.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the upload fails.
- */
-export declare function upload(ftpClient: Client, targetPath: string, fileStream: Readable, options?: UploadOptions): Promise<Outcome.Either<true, string>>;

package/node/ftps/file/upload/index.js

@@ -1,9 +0,0 @@
-import {
-  upload
-} from "../../../../chunks/chunk-AOEOW5XW.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  upload
-};

package/node/images/create/index.d.ts

@@ -1,9 +0,0 @@
-import sharp from 'sharp';
-import type { CreateOptions } from '../types.js';
-/**
- * Creates a new image using Sharp with the specified options.
- *
- * @param options - Image creation options. See `CreateOptions` for details.
- * @returns A Sharp instance ready for further image operations.
- */
-export declare function create(options: CreateOptions): Promise<sharp.Sharp>;

package/node/images/create/index.js

@@ -1,19 +0,0 @@
-import {
-  toCreateOptions
-} from "../../../chunks/chunk-P6K7NPUZ.js";
-import "../../../chunks/chunk-LU47ASMQ.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-JDINERKY.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-KRYJVBO5.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/node/images/create/index.ts
-import sharp from "sharp";
-async function create(options) {
-  return sharp({ create: toCreateOptions(options) });
-}
-export {
-  create
-};

package/node/images/format/index.d.ts

@@ -1,62 +0,0 @@
-import sharp from 'sharp';
-import * as Outcome from '../../../agnostic/misc/outcome/index.js';
-import type { FormatCommonOptions, FormatJpgOptions, FormatPngOptions, FormatWebpOptions, FormatAvifOptions, FormatTiffOptions, FormatHeifOptions, FormatOptions, ImageLike } from '../types.js';
-/** Type guard to check if options match FormatCommonOptions. */
-export declare const isFormatCommonOptions: (options: unknown) => options is FormatCommonOptions;
-/** Type guard to check if options match FormatJpgOptions. */
-export declare const isFormatJpgOptions: (options: unknown) => options is FormatJpgOptions;
-/** Type guard to check if options match FormatPngOptions. */
-export declare const isFormatPngOptions: (options: unknown) => options is FormatPngOptions;
-/** Type guard to check if options match FormatWebpOptions. */
-export declare const isFormatWebpOptions: (options: unknown) => options is FormatWebpOptions;
-/** Type guard to check if options match FormatAvifOptions. */
-export declare const isFormatAvifOptions: (options: unknown) => options is FormatAvifOptions;
-/** Type guard to check if options match FormatTiffOptions. */
-export declare const isFormatTiffOptions: (options: unknown) => options is FormatTiffOptions;
-/** Type guard to check if options match FormatHeifOptions. */
-export declare const isFormatHeifOptions: (options: unknown) => options is FormatHeifOptions;
-/** Type guard to check if options match FormatOptions. */
-export declare const isFormatOptions: (options: unknown) => options is FormatOptions;
-/** Converts FormatCommonOptions to Sharp resize options. */
-export declare const toSharpResizeOptions: (options: FormatCommonOptions) => sharp.ResizeOptions;
-/** Converts FormatJpgOptions to Sharp JPEG options. */
-export declare const toSharpJpegOptions: (options: FormatJpgOptions) => sharp.JpegOptions;
-/** Converts FormatPngOptions to Sharp PNG options. */
-export declare const toSharpPngOptions: (options: FormatPngOptions) => sharp.PngOptions;
-/** Converts FormatWebpOptions to Sharp WebP options. */
-export declare const toSharpWebpOptions: (options: FormatWebpOptions) => sharp.WebpOptions;
-/** Converts FormatAvifOptions to Sharp AVIF options. */
-export declare const toSharpAvifOptions: (options: FormatAvifOptions) => sharp.AvifOptions;
-/** Converts FormatTiffOptions to Sharp TIFF options. */
-export declare const toSharpTiffOptions: (options: FormatTiffOptions) => sharp.TiffOptions;
-/** Converts FormatHeifOptions to Sharp HEIF options. */
-export declare const toSharpHeifOptions: (options: FormatHeifOptions) => sharp.HeifOptions;
-/**
- * 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 declare function format(input: ImageLike, options: FormatOptions): Promise<Outcome.Either<Buffer, string>>;
-/** Resizes an image to a specific width while maintaining aspect ratio. */
-export declare const toWidth: (input: ImageLike, width: number) => Promise<Buffer>;
-/** Resizes an image to a specific height while maintaining aspect ratio. */
-export declare const toHeight: (input: ImageLike, height: number) => Promise<Buffer>;
-/** Converts an image to JPEG format. */
-export declare const toJpg: (input: ImageLike, quality?: number) => Promise<Buffer>;
-/** Converts an image to PNG format. */
-export declare const toPng: (input: ImageLike, quality?: number, compressionLevel?: FormatPngOptions["compressionLevel"]) => Promise<Buffer>;
-/** Converts an image to WebP format. */
-export declare const toWebp: (input: ImageLike, quality?: number) => Promise<Buffer>;
-/** Converts an image to AVIF format. */
-export declare const toAvif: (input: ImageLike, quality?: number) => Promise<Buffer>;
-/** Converts an image to TIFF format. */
-export declare const toTiff: (input: ImageLike, quality?: number, compression?: FormatTiffOptions["compression"]) => Promise<Buffer>;
-/** Converts an image to HEIF format. */
-export declare const toHeif: (input: ImageLike, quality?: number) => Promise<Buffer>;