@macrulez/mediatoolz 0.0.0-stage → 0.1.0

package/dist/commands/image-batch/sharpen.d.ts

@@ -0,0 +1,46 @@
+import type { Command } from 'commander';
+export declare const SHARPEN_TARGETS: readonly ["screen", "matte", "glossy"];
+export declare const SHARPEN_AMOUNTS: readonly ["low", "standard", "high"];
+export declare const SHARPEN_FINE_KEYS: readonly ["radius", "flat", "jagged", "threshold"];
+export type SharpenTarget = (typeof SHARPEN_TARGETS)[number];
+export type SharpenAmount = (typeof SHARPEN_AMOUNTS)[number];
+export type SharpenFineKey = (typeof SHARPEN_FINE_KEYS)[number];
+export interface SharpenFields {
+    for?: SharpenTarget;
+    amount?: SharpenAmount;
+    radius?: number;
+    flat?: number;
+    jagged?: number;
+    threshold?: number;
+}
+export interface SharpenLayer extends SharpenFields {
+    preset?: string;
+}
+export interface SharpenSpec extends SharpenFields {
+    for: SharpenTarget;
+    amount: SharpenAmount;
+}
+export interface SharpenParams {
+    sigma: number;
+    m1: number;
+    m2: number;
+    x1?: number;
+}
+export declare const SHARPEN_RANGES: Record<SharpenFineKey, readonly [number, number]>;
+export declare function completeSharpen(fields: SharpenFields): SharpenSpec;
+export declare function sharpenParams(spec: SharpenSpec): SharpenParams;
+export declare function describeSharpen(fields: SharpenLayer): string;
+export declare function parseSharpenFields(object: Record<string, unknown>, at: string, allowPreset: boolean): SharpenLayer;
+export declare function parseSharpenLayer(value: unknown, at: string): SharpenLayer;
+export declare function expandSharpen(layer: SharpenLayer, presets: Record<string, SharpenFields> | undefined, at: string): SharpenFields;
+export interface SharpenFlagOptions {
+    sharpen?: string;
+    sharpenFor?: string;
+    sharpenAmount?: string;
+    sharpenRadius?: string;
+    sharpenFlat?: string;
+    sharpenJagged?: string;
+    sharpenThreshold?: string;
+}
+export declare function parseSharpenFlags(options: SharpenFlagOptions): SharpenLayer | undefined;
+export declare function addSharpenFlags(command: Command, withPreset?: boolean): Command;

package/dist/commands/image-batch/sharpen.js

@@ -0,0 +1,159 @@
+import { ImageBatchUsageError } from './errors.js';
+export const SHARPEN_TARGETS = ['screen', 'matte', 'glossy'];
+export const SHARPEN_AMOUNTS = ['low', 'standard', 'high'];
+export const SHARPEN_FINE_KEYS = ['radius', 'flat', 'jagged', 'threshold'];
+export const SHARPEN_RANGES = {
+    radius: [0.000001, 10],
+    flat: [0, 1_000_000],
+    jagged: [0, 1_000_000],
+    threshold: [0, 1_000_000],
+};
+const RADIUS = { screen: 0.6, matte: 1, glossy: 1.4 };
+const STRENGTH = {
+    low: { m1: 0.5, m2: 1.5 },
+    standard: { m1: 1, m2: 3 },
+    high: { m1: 1.8, m2: 5 },
+};
+const LAYER_KEYS = ['preset', 'for', 'amount', ...SHARPEN_FINE_KEYS];
+const FIELD_KEYS = LAYER_KEYS.filter((key) => key !== 'preset');
+export function completeSharpen(fields) {
+    return { ...fields, for: fields.for ?? 'screen', amount: fields.amount ?? 'standard' };
+}
+export function sharpenParams(spec) {
+    const strength = STRENGTH[spec.amount];
+    return {
+        sigma: spec.radius ?? RADIUS[spec.for],
+        m1: spec.flat ?? strength.m1,
+        m2: spec.jagged ?? strength.m2,
+        ...(spec.threshold !== undefined ? { x1: spec.threshold } : {}),
+    };
+}
+export function describeSharpen(fields) {
+    const parts = [];
+    if (fields.preset !== undefined)
+        parts.push(fields.preset);
+    if (fields.for !== undefined)
+        parts.push(`for ${fields.for}`);
+    if (fields.amount !== undefined)
+        parts.push(fields.amount);
+    for (const key of SHARPEN_FINE_KEYS) {
+        if (fields[key] !== undefined)
+            parts.push(`${key} ${fields[key]}`);
+    }
+    return parts.join(', ');
+}
+function rangeText(key) {
+    const [min, max] = SHARPEN_RANGES[key];
+    return `${min} to ${max}`;
+}
+function checkFine(key, value, where) {
+    const [min, max] = SHARPEN_RANGES[key];
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max) {
+        throw new ImageBatchUsageError(`${where}: expected a number from ${rangeText(key)}`);
+    }
+    return value;
+}
+export function parseSharpenFields(object, at, allowPreset) {
+    const allowed = allowPreset ? LAYER_KEYS : FIELD_KEYS;
+    for (const key of Object.keys(object)) {
+        if (!allowed.includes(key)) {
+            throw new ImageBatchUsageError(`${at}: unknown key "${key}" — expected ${allowed.join(', ')}`);
+        }
+    }
+    const layer = {};
+    if (object.preset !== undefined) {
+        if (typeof object.preset !== 'string' || object.preset === '') {
+            throw new ImageBatchUsageError(`${at}.preset: expected the name of a sharpen preset`);
+        }
+        layer.preset = object.preset;
+    }
+    if (object.for !== undefined) {
+        if (!SHARPEN_TARGETS.includes(object.for)) {
+            throw new ImageBatchUsageError(`${at}.for: expected one of ${SHARPEN_TARGETS.join(', ')}`);
+        }
+        layer.for = object.for;
+    }
+    if (object.amount !== undefined) {
+        if (!SHARPEN_AMOUNTS.includes(object.amount)) {
+            throw new ImageBatchUsageError(`${at}.amount: expected one of ${SHARPEN_AMOUNTS.join(', ')}`);
+        }
+        layer.amount = object.amount;
+    }
+    for (const key of SHARPEN_FINE_KEYS) {
+        if (object[key] !== undefined)
+            layer[key] = checkFine(key, object[key], `${at}.${key}`);
+    }
+    if (Object.keys(layer).length === 0) {
+        throw new ImageBatchUsageError(`${at}: expected at least one of ${allowed.join(', ')}`);
+    }
+    return layer;
+}
+export function parseSharpenLayer(value, at) {
+    if (typeof value === 'string') {
+        return parseSharpenFields({ preset: value }, at, true);
+    }
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ImageBatchUsageError(`${at}: expected a preset name or an object with ${LAYER_KEYS.join(', ')}`);
+    }
+    return parseSharpenFields(value, at, true);
+}
+export function expandSharpen(layer, presets, at) {
+    const { preset, ...own } = layer;
+    if (preset === undefined)
+        return own;
+    const base = presets?.[preset];
+    if (!base) {
+        throw new ImageBatchUsageError(`${at}: the sharpen preset "${preset}" is not loaded — see \`mediatoolz image-batch sharpen list\``);
+    }
+    return { ...base, ...own };
+}
+const FLAG_FINE = [
+    ['radius', 'sharpenRadius'],
+    ['flat', 'sharpenFlat'],
+    ['jagged', 'sharpenJagged'],
+    ['threshold', 'sharpenThreshold'],
+];
+export function parseSharpenFlags(options) {
+    const raw = {};
+    if (options.sharpen !== undefined)
+        raw.preset = options.sharpen;
+    if (options.sharpenFor !== undefined)
+        raw.for = options.sharpenFor;
+    if (options.sharpenAmount !== undefined)
+        raw.amount = options.sharpenAmount;
+    for (const [key, flag] of FLAG_FINE) {
+        const text = options[flag];
+        if (text === undefined)
+            continue;
+        const number = Number(text);
+        if (text.trim() === '' || !Number.isFinite(number)) {
+            throw new ImageBatchUsageError(`--sharpen-${key} must be a number from ${rangeText(key)}`);
+        }
+        raw[key] = number;
+    }
+    if (Object.keys(raw).length === 0)
+        return undefined;
+    try {
+        return parseSharpenFields(raw, 'sharpen', true);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ImageBatchUsageError(message
+            .replace(/^sharpen\.for/, '--sharpen-for')
+            .replace(/^sharpen\.amount/, '--sharpen-amount')
+            .replace(/^sharpen\.(radius|flat|jagged|threshold)/, '--sharpen-$1'));
+    }
+}
+export function addSharpenFlags(command, withPreset = true) {
+    if (withPreset) {
+        command.option('--sharpen <preset>', 'sharpen with a saved preset (see the sharpen command)');
+    }
+    return command
+        .option('--sharpen-for <target>', 'sharpen the result for: screen, matte or glossy')
+        .option('--sharpen-amount <amount>', 'sharpening amount: low, standard or high')
+        .option('--sharpen-radius <sigma>', 'sharpening radius (sigma), 0.000001 to 10')
+        .option('--sharpen-flat <n>', 'sharpening strength on flat areas, 0 to 1000000')
+        .option('--sharpen-jagged <n>', 'sharpening strength on sharp edges, 0 to 1000000')
+        .option('--sharpen-threshold <n>', 'edge threshold that separates flat from jagged, 0 to 1000000');
+}
+//# sourceMappingURL=sharpen.js.map

package/dist/commands/image-batch/sharpen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharpen.js","sourceRoot":"","sources":["../../../src/commands/image-batch/sharpen.ts"],"names":[],"mappings":"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"}

package/dist/commands/image-batch/template.d.ts

@@ -0,0 +1,45 @@
+export declare const TEMPLATE_VARIABLES: readonly ["name", "ext", "format", "dir", "width", "height", "size", "long", "short", "mp", "percent", "scale", "index", "hash", "date", "orig"];
+export type TemplateVariable = (typeof TEMPLATE_VARIABLES)[number];
+export type TemplateToken = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'var';
+    name: TemplateVariable;
+    param?: number;
+};
+export interface TemplateValues {
+    name: string;
+    ext: string;
+    format: string;
+    dir: string;
+    width: number;
+    height: number;
+    size: string;
+    long: number;
+    short: number;
+    mp: string;
+    percent: string;
+    scale: string;
+    index: number;
+    hash: string;
+    date: string;
+    orig: string;
+}
+export interface DefaultTemplateShape {
+    widths?: boolean;
+    heights?: boolean;
+    size?: boolean;
+    longEdge?: boolean;
+    shortEdge?: boolean;
+    megapixels?: boolean;
+    percent?: boolean;
+    scale?: boolean;
+}
+export declare function defaultTemplate(shape: DefaultTemplateShape): string;
+export declare function parseTemplate(text: string, where: string): TemplateToken[];
+export declare function templateUses(tokens: TemplateToken[], name: TemplateVariable): boolean;
+export declare function templateUsesAny(tokens: TemplateToken[], names: TemplateVariable[]): boolean;
+export declare function normalizeRelativePath(path: string, where: string): string;
+export declare function expandTemplate(tokens: TemplateToken[], values: TemplateValues, where: string): string;
+export declare function formatDate(date: Date): string;

package/dist/commands/image-batch/template.js

@@ -0,0 +1,142 @@
+import { didYouMean } from '../../utils/closest.js';
+import { ImageBatchUsageError } from './errors.js';
+export const TEMPLATE_VARIABLES = [
+    'name',
+    'ext',
+    'format',
+    'dir',
+    'width',
+    'height',
+    'size',
+    'long',
+    'short',
+    'mp',
+    'percent',
+    'scale',
+    'index',
+    'hash',
+    'date',
+    'orig',
+];
+const PARAMETERIZED = ['index', 'hash'];
+const DEFAULT_HASH_LENGTH = 8;
+const MAX_HASH_LENGTH = 40;
+const MAX_INDEX_PADDING = 12;
+const FORBIDDEN_SEGMENT_CHARS = /[<>:"|?*]/;
+export function defaultTemplate(shape) {
+    if (shape.widths)
+        return '{dir}/{name}-{width}w.{format}';
+    if (shape.heights)
+        return '{dir}/{name}-{height}h.{format}';
+    if (shape.size)
+        return '{dir}/{name}-{size}.{format}';
+    if (shape.longEdge)
+        return '{dir}/{name}-{long}l.{format}';
+    if (shape.shortEdge)
+        return '{dir}/{name}-{short}s.{format}';
+    if (shape.megapixels)
+        return '{dir}/{name}-{mp}mp.{format}';
+    if (shape.percent)
+        return '{dir}/{name}-{percent}pct.{format}';
+    if (shape.scale)
+        return '{dir}/{name}@{scale}x.{format}';
+    return '{dir}/{name}.{format}';
+}
+export function parseTemplate(text, where) {
+    if (text.trim() === '') {
+        throw new ImageBatchUsageError(`${where}: the name template is empty`);
+    }
+    if (/^([\\/]|[A-Za-z]:)/.test(text)) {
+        throw new ImageBatchUsageError(`${where}: the name template "${text}" is an absolute path — templates are always relative to the output folder`);
+    }
+    const tokens = [];
+    const pattern = /\{([a-zA-Z]+)(?::(\d+))?\}/g;
+    let last = 0;
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+        if (match.index > last)
+            tokens.push({ type: 'text', text: text.slice(last, match.index) });
+        const name = match[1];
+        if (!TEMPLATE_VARIABLES.includes(name)) {
+            throw new ImageBatchUsageError(`${where}: unknown variable {${name}} in "${text}".${didYouMean(name, TEMPLATE_VARIABLES)} Available: ${TEMPLATE_VARIABLES.map((v) => `{${v}}`).join(' ')}`);
+        }
+        const variable = name;
+        if (match[2] !== undefined) {
+            if (!PARAMETERIZED.includes(variable)) {
+                throw new ImageBatchUsageError(`${where}: {${variable}} takes no parameter (only ${PARAMETERIZED.map((v) => `{${v}:N}`).join(' and ')} do)`);
+            }
+            const param = Number(match[2]);
+            const limit = variable === 'hash' ? MAX_HASH_LENGTH : MAX_INDEX_PADDING;
+            if (param < 1 || param > limit) {
+                throw new ImageBatchUsageError(`${where}: {${variable}:${param}} must be 1–${limit}`);
+            }
+            tokens.push({ type: 'var', name: variable, param });
+        }
+        else {
+            tokens.push({ type: 'var', name: variable });
+        }
+        last = match.index + match[0].length;
+    }
+    if (last < text.length)
+        tokens.push({ type: 'text', text: text.slice(last) });
+    const literal = tokens
+        .filter((t) => t.type === 'text')
+        .map((t) => t.text)
+        .join('');
+    if (/[{}]/.test(literal)) {
+        throw new ImageBatchUsageError(`${where}: unbalanced "{" or "}" in the name template "${text}" — write variables as {name}`);
+    }
+    const shape = tokens.map((t) => (t.type === 'text' ? t.text : 'x')).join('');
+    if (shape.split(/[\\/]/).includes('..')) {
+        throw new ImageBatchUsageError(`${where}: the name template "${text}" must not contain ".." — results stay inside the output folder`);
+    }
+    return tokens;
+}
+export function templateUses(tokens, name) {
+    return tokens.some((token) => token.type === 'var' && token.name === name);
+}
+export function templateUsesAny(tokens, names) {
+    return names.some((name) => templateUses(tokens, name));
+}
+export function normalizeRelativePath(path, where) {
+    const segments = [];
+    for (const segment of path.split(/[\\/]/)) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            throw new ImageBatchUsageError(`${where}: "${path}" escapes the output folder`);
+        }
+        if (FORBIDDEN_SEGMENT_CHARS.test(segment) || [...segment].some((ch) => ch.charCodeAt(0) < 32)) {
+            throw new ImageBatchUsageError(`${where}: "${segment}" contains a character that is not allowed in a file name`);
+        }
+        segments.push(segment);
+    }
+    if (segments.length === 0) {
+        throw new ImageBatchUsageError(`${where}: the name template produced an empty path`);
+    }
+    return segments.join('/');
+}
+export function expandTemplate(tokens, values, where) {
+    const pieces = tokens.map((token) => {
+        if (token.type === 'text')
+            return token.text;
+        switch (token.name) {
+            case 'index':
+                return String(values.index).padStart(token.param ?? 1, '0');
+            case 'hash':
+                return values.hash.slice(0, token.param ?? DEFAULT_HASH_LENGTH);
+            case 'width':
+                return String(values.width);
+            case 'height':
+                return String(values.height);
+            default:
+                return String(values[token.name]);
+        }
+    });
+    return normalizeRelativePath(pieces.join(''), where);
+}
+export function formatDate(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+//# sourceMappingURL=template.js.map

package/dist/commands/image-batch/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/commands/image-batch/template.ts"],"names":[],"mappings":"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"}

package/dist/commands/image-hash/cache.d.ts

@@ -0,0 +1,14 @@
+import { type HashType } from './core.js';
+import type { ComputedHashes } from './hash.js';
+export interface CacheRecord extends ComputedHashes {
+    sig: string;
+    params: string;
+}
+export interface CacheFile {
+    version: 1;
+    files: Record<string, CacheRecord>;
+}
+export declare function emptyCache(): CacheFile;
+export declare function loadCache(path: string): CacheFile;
+export declare function saveCache(path: string, cache: CacheFile): void;
+export declare function cacheHit(record: CacheRecord | undefined, sig: string, params: string, types: HashType[]): ComputedHashes | null;

package/dist/commands/image-hash/cache.js

@@ -0,0 +1,40 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { ALL_TYPES } from './core.js';
+export function emptyCache() {
+    return { version: 1, files: {} };
+}
+export function loadCache(path) {
+    if (!existsSync(path))
+        return emptyCache();
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (parsed.version !== 1 || typeof parsed.files !== 'object' || parsed.files === null) {
+            return emptyCache();
+        }
+        return parsed;
+    }
+    catch {
+        return emptyCache();
+    }
+}
+export function saveCache(path, cache) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(cache)}\n`);
+}
+export function cacheHit(record, sig, params, types) {
+    if (!record || record.sig !== sig || record.params !== params)
+        return null;
+    for (const type of types) {
+        if (record[type] === undefined)
+            return null;
+    }
+    const hit = { width: record.width, height: record.height };
+    for (const type of ALL_TYPES) {
+        const value = record[type];
+        if (value !== undefined)
+            hit[type] = value;
+    }
+    return hit;
+}
+//# sourceMappingURL=cache.js.map

package/dist/commands/image-hash/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/commands/image-hash/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAiB,MAAM,WAAW,CAAA;AAapD,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,EAAE,CAAA;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAc,CAAA;QAClE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtF,OAAO,UAAU,EAAE,CAAA;QACrB,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAgB;IACtD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,MAA+B,EAC/B,GAAW,EACX,MAAc,EACd,KAAiB;IAEjB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAC1E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;IAC7C,CAAC;IACD,MAAM,GAAG,GAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IAC1E,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IAC5C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/commands/image-hash/core.d.ts

@@ -0,0 +1,61 @@
+export type HashType = 'hazehash' | 'blurhash' | 'thumbhash' | 'color' | 'preview';
+export declare const ALL_TYPES: HashType[];
+export declare const OUTPUT_FORMATS: readonly ["json", "plain", "csv", "ts", "js"];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+export declare const DEFAULT_IMAGE_EXTENSIONS: string[];
+export declare const DEFAULT_EXPORT_NAME = "imageHashes";
+export declare const DEFAULT_BLURHASH_COMPONENTS: {
+    x: number;
+    y: number;
+};
+export declare const DEFAULT_HAZEHASH_BUDGET = 28;
+export declare const MIN_HAZEHASH_BUDGET = 7;
+export declare const MAX_HAZEHASH_BUDGET = 48;
+export declare const DEFAULT_SAMPLE_SIZE = 100;
+export declare const MAX_SAMPLE_SIZE = 100;
+export declare const DEFAULT_CACHE_FILE = ".mediatoolz-image-hash-cache.json";
+export type Components = {
+    x: number;
+    y: number;
+} | 'auto';
+export declare class ImageHashUsageError extends Error {
+}
+export interface HashEntry {
+    file: string;
+    width: number;
+    height: number;
+    hazehash?: string;
+    blurhash?: string;
+    thumbhash?: string;
+    color?: string;
+    preview?: string;
+}
+export interface OutputUnit {
+    token: string;
+    content: string;
+}
+export declare function parseTypes(value: string): HashType[];
+export declare function orderTypes(types: Iterable<HashType>): HashType[];
+export declare function parseFormat(value: string): OutputFormat;
+export declare function parseComponents(value: string): Components;
+export declare function resolveComponents(components: Components, width: number, height: number): {
+    x: number;
+    y: number;
+};
+export declare function componentsLabel(components: Components): string;
+export declare function parseBudget(value: string): number;
+export declare function parseSampleSize(value: string): number;
+export declare function parseMaxPixels(value: string): number;
+export declare function parseExtensions(value: string): string[];
+export declare function withUpperCaseVariants(extensions: string[]): string[];
+export declare function validateExportName(name: string): string;
+export declare function isUrl(value: string): boolean;
+export declare function splitPathArguments(args: string[], exists?: (path: string) => boolean): string[];
+export declare function parseFileList(text: string): string[];
+export declare function defaultOutExtension(format: OutputFormat): string;
+export declare function normalizeOutExtension(value: string | undefined, format: OutputFormat): string;
+export declare function validateSuffix(suffix: string | undefined, types: HashType[], format: OutputFormat): string;
+export declare function formatAggregate(entries: HashEntry[], types: HashType[], format: OutputFormat, exportName: string): string;
+export declare function formatPerFile(entry: HashEntry, types: HashType[], format: OutputFormat): OutputUnit[];
+export declare function outputFileName(imagePath: string, suffix: string, token: string, extension: string): string;
+export declare function parseAggregate(content: string, format: OutputFormat): HashEntry[];