@macrulez/devtoolz 0.3.2 → 0.4.0

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

@@ -0,0 +1,308 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createStyle } from '../../format/style.js';
+import { askText, defaultTerminal, isInteractive, singleSelect } from '../../utils/tty.js';
+import { splitList } from '../../utils/split-list.js';
+import { MAX_HAZEHASH_BUDGET, MIN_HAZEHASH_BUDGET, parseBudget, parseExtensions, parseFileList, parseMaxPixels, } from '../image-hash/core.js';
+import { parseCodecArgs, parseQualityArg } from './codecs.js';
+import { discoverConfigs, emptyConfig, loadConfig, parseByteSize, resolveConfigRef, } from './config.js';
+import { ImageBatchUsageError } from './errors.js';
+import { FIT_MODES } from './geometry.js';
+import { BATCH_IMAGE_EXTENSIONS } from './inputs.js';
+import { registerImageBatchManagement } from './manage-cli.js';
+import { parseSharpenFlags } from './sharpen.js';
+import { renderImageBatchReport } from './report.js';
+import { runImageBatch } from './run.js';
+function parseNumberList(value, flag) {
+    const numbers = splitList(value).map(Number);
+    if (numbers.length === 0 || numbers.some((n) => !Number.isInteger(n) || n < 1 || n > 65535)) {
+        throw new ImageBatchUsageError(`${flag} must be whole numbers from 1 to 65535, e.g. 400,800,1200`);
+    }
+    return numbers;
+}
+function parseDecimalList(value, flag, min, max) {
+    const numbers = splitList(value).map(Number);
+    if (numbers.length === 0 || numbers.some((n) => !Number.isFinite(n) || n < min || n > max)) {
+        throw new ImageBatchUsageError(`${flag} must be numbers from ${min} to ${max}, e.g. 2,0.5`);
+    }
+    return numbers;
+}
+function overridesFrom(options) {
+    const overrides = {};
+    if (options.widths)
+        overrides.widths = parseNumberList(options.widths, '--widths');
+    if (options.heights)
+        overrides.heights = parseNumberList(options.heights, '--heights');
+    if (options.long)
+        overrides.longEdge = parseNumberList(options.long, '--long');
+    if (options.short)
+        overrides.shortEdge = parseNumberList(options.short, '--short');
+    if (options.megapixels) {
+        overrides.megapixels = parseDecimalList(options.megapixels, '--megapixels', 0.001, 1000);
+    }
+    if (options.percent)
+        overrides.percent = parseDecimalList(options.percent, '--percent', 0.1, 1000);
+    if (options.matchOrientation)
+        overrides.matchOrientation = true;
+    if (options.maxSize)
+        overrides.maxBytes = parseByteSize(options.maxSize, '--max-size');
+    const sharpen = parseSharpenFlags(options.sharpenFor, options.sharpenAmount);
+    if (sharpen)
+        overrides.sharpen = sharpen;
+    if (options.formats)
+        overrides.formats = splitList(options.formats);
+    if (options.quality)
+        overrides.quality = parseQualityArg(options.quality);
+    if (options.codec.length > 0)
+        overrides.codecs = parseCodecArgs(options.codec);
+    if (options.fit) {
+        if (!FIT_MODES.includes(options.fit)) {
+            throw new ImageBatchUsageError(`--fit must be one of ${FIT_MODES.join(', ')}`);
+        }
+        overrides.fit = options.fit;
+    }
+    if (options.name)
+        overrides.name = options.name;
+    if (options.flatten !== undefined)
+        overrides.flatten = options.flatten;
+    return Object.keys(overrides).length > 0 ? overrides : undefined;
+}
+function placeholdersFrom(options) {
+    const types = [];
+    if (options.hazehash)
+        types.push('hazehash');
+    if (options.blurhash)
+        types.push('blurhash');
+    if (options.thumbhash)
+        types.push('thumbhash');
+    if (options.dominantColor)
+        types.push('color');
+    if (types.length === 0) {
+        if (options.budget !== undefined) {
+            throw new ImageBatchUsageError(`--budget is the size of a hazehash (${MIN_HAZEHASH_BUDGET}–${MAX_HAZEHASH_BUDGET} bytes) — add --hazehash`);
+        }
+        return undefined;
+    }
+    const settings = { types };
+    if (options.budget !== undefined)
+        settings.budget = parseBudget(options.budget);
+    return settings;
+}
+function overwriteMode(options) {
+    if (options.overwrite === true)
+        return 'overwrite';
+    if (options.overwrite === false)
+        return 'error';
+    if (options.skipExisting)
+        return 'skip';
+    return undefined;
+}
+export async function chooseConfig(options, style) {
+    const discovered = discoverConfigs({ cwd: options.cwd });
+    let location;
+    if (options.config !== undefined) {
+        location = resolveConfigRef(options.config, discovered, options.cwd);
+    }
+    else if (!options.adHoc && discovered.length === 1) {
+        location = discovered[0];
+    }
+    else if (!options.adHoc && discovered.length > 1) {
+        if (!options.interactive) {
+            throw new ImageBatchUsageError(`several configs found — pick one with -c <name>: ${discovered.map((c) => c.name).join(', ')}`);
+        }
+        const s = createStyle(style);
+        const picked = await singleSelect(defaultTerminal(), discovered.map((candidate) => ({
+            label: candidate.name,
+            hint: `${candidate.scope} · ${candidate.path}`,
+            value: candidate,
+        })), { title: 'Which config should be applied?', help: 'enter pick · q cancel' }, s);
+        if (picked === null)
+            throw new ImageBatchUsageError('no config chosen');
+        location = picked;
+    }
+    if (!location)
+        return { config: emptyConfig() };
+    const { config } = await loadConfig(location);
+    return { config, label: location.name };
+}
+export function registerImageBatch(program) {
+    const command = program
+        .command('image-batch')
+        .description('Batch-resize and convert raster images by rules: sizes, formats, codec options and file names from a config or flags (subcommands: init, config, restore)')
+        .argument('[paths...]', 'image files, folders and globs to process (several allowed)', [])
+        .option('--cwd <path>', 'root paths are resolved against', process.cwd())
+        .option('-c, --config <name|file>', 'rules to apply: a saved config name or a path to a config file')
+        .option('-o, --out <dir>', 'folder the results go to (or use --beside / --replace); the sources are never touched')
+        .option('--beside', 'write the results next to each source, in the same folder (sources are not touched)', false)
+        .option('--replace', 'rewrite each source file in place, in its own format (originals are backed up first)', false)
+        .option('--backup [dir]', 'with --replace: where the originals are saved first (default: .image-batch-backup/<date>)')
+        .option('--no-backup', 'with --replace: do not keep a copy of the originals')
+        .option('--no-only-if-smaller', 'with --replace: also replace files when the result is not smaller')
+        .option('-r, --recursive', 'also walk subdirectories of every given folder', false)
+        .option('--files-from <file>', 'read more paths from a file, one per line (- = stdin, # starts a comment)')
+        .option('--ext <list>', 'comma-separated image extensions to pick up from folders', BATCH_IMAGE_EXTENSIONS.join(','))
+        .option('--ignore <glob>', 'extra ignore pattern (repeatable), on top of the built-in defaults', (val, prev) => [...prev, val], [])
+        .option('--no-respect-gitignore', "don't also honor the project's .gitignore")
+        .option('--include <glob>', 'only process images whose path (inside the given folder) matches (repeatable)', (val, prev) => [...prev, val], [])
+        .option('--exclude <glob>', 'skip images whose path (inside the given folder) matches (repeatable)', (val, prev) => [...prev, val], [])
+        .option('-w, --widths <list>', 'output widths in pixels, comma-separated, e.g. 400,800,1200')
+        .option('--heights <list>', 'output heights in pixels, comma-separated')
+        .option('--long <list>', 'size by the long side in pixels, comma-separated, whatever the orientation')
+        .option('--short <list>', 'size by the short side in pixels, comma-separated')
+        .option('--megapixels <list>', 'size by area in megapixels, comma-separated, e.g. 2,0.5')
+        .option('--percent <list>', 'size as a percentage of the source, comma-separated, e.g. 50,25')
+        .option('--match-orientation', 'turn a width x height box around for images of the other orientation', false)
+        .option('--max-size <size>', 'limit each file to this size, e.g. 200KB or 1.5MB, by lowering the quality as far as needed')
+        .option('--sharpen-for <target>', 'sharpen the result for: screen, matte or glossy')
+        .option('--sharpen-amount <amount>', 'sharpening amount: low, standard or high')
+        .option('-f, --formats <list>', 'output formats: jpg, png, webp, avif, gif, tiff, jp2, heif or original')
+        .option('-q, --quality <n|level|fmt=n,…>', 'quality: 82, a level (low, medium, high, best) or per format, e.g. jpg=82,webp=high')
+        .option('--codec <fmt.option=value>', 'one codec option, e.g. jpg.mozjpeg=true or png.colors=64 (repeatable)', (val, prev) => [...prev, val], [])
+        .option('--fit <mode>', `how the image fills the target box: ${FIT_MODES.join(', ')}`)
+        .option('--name <template>', 'output file name template: {name} {ext} {format} {dir} {width} {height} {size} {scale} {index} {hash} {date} {orig}')
+        .option('--flatten [color]', 'put images with transparency on a solid background (white unless a color is given)')
+        .option('--flat', 'put every result into the output folder itself, without the source subfolders', false)
+        .option('--hazehash', 'also compute a hazehash of every source (written to --emit)', false)
+        .option('--blurhash', 'also compute a blurhash of every source (written to --emit)', false)
+        .option('--thumbhash', 'also compute a thumbhash of every source (written to --emit)', false)
+        .option('--dominant-color', 'also compute the dominant color of every source (written to --emit)', false)
+        .option('--budget <bytes>', `hazehash: size of one hash in bytes, ${MIN_HAZEHASH_BUDGET}-${MAX_HAZEHASH_BUDGET} (default 28)`)
+        .option('--emit <file>', 'write a JSON manifest of everything that was produced')
+        .option('--key-prefix <text>', 'text put in front of every path in the manifest placeholders, e.g. /images/')
+        .option('-i, --select', 'pick the images from an interactive list before processing', false)
+        .option('--list', 'only print the images that would be processed', false)
+        .option('--overwrite', 'replace existing output files that this command did not make or that are out of date')
+        .option('--no-overwrite', 'fail (exit 1) when an output file already exists')
+        .option('--skip-existing', 'leave existing output files alone without failing', false)
+        .option('--force', 'regenerate everything, ignoring what an earlier run already made', false)
+        .option('--cache [file]', 'where the record of what was already made is kept (default: ~/.devtoolz/cache/image-batch)')
+        .option('--no-cache', 'do not keep or use that record')
+        .option('--concurrency <n>', 'images processed in parallel', '4')
+        .option('--max-pixels <n>', 'refuse images with more pixels than this (0 = no limit; default: sharp limit, ~268 million)')
+        .option('--dry-run', 'write nothing — show what would be done', false)
+        .option('-y, --yes', 'agree without asking: install the missing "sharp" library, confirm --replace', false)
+        .option('--json', 'machine-readable output', false)
+        .option('--quiet', 'suppress output when there is nothing to report', false)
+        .option('--verbose', 'list every produced file, not only problems', false)
+        .option('--plain', 'disable color/banner/celebration copy, even in a real terminal', false)
+        .option('--color', 'force colored output even when piped or in CI', false);
+    command.action(async (paths, options) => {
+        const style = { plain: options.plain, color: options.color };
+        const io = defaultTerminal();
+        const interactive = isInteractive(io) && !options.json;
+        const s = createStyle(style);
+        const showProgress = !options.json && !options.quiet && Boolean(process.stderr.isTTY) && !options.plain;
+        let progressShown = false;
+        try {
+            const cwd = resolve(options.cwd);
+            const listed = options.filesFrom !== undefined
+                ? parseFileList(readFileSync(options.filesFrom === '-' ? 0 : options.filesFrom, 'utf8'))
+                : [];
+            const overrides = overridesFrom(options);
+            const adHoc = overrides !== undefined;
+            const { config, label } = await chooseConfig({
+                cwd,
+                adHoc,
+                interactive,
+                ...(options.config !== undefined ? { config: options.config } : {}),
+            }, style);
+            let out = options.out;
+            if (out === undefined &&
+                !options.beside &&
+                !options.replace &&
+                interactive &&
+                !options.list) {
+                const answer = await askText(io, 'Where should the results go? (output folder)', s);
+                if (answer === null || answer.trim() === '') {
+                    throw new ImageBatchUsageError('no output folder given');
+                }
+                out = answer.trim();
+            }
+            const mode = overwriteMode(options);
+            const placeholders = placeholdersFrom(options);
+            const report = await runImageBatch({
+                paths: [...paths, ...listed],
+                cwd,
+                ...(out !== undefined ? { out } : {}),
+                beside: options.beside,
+                replace: options.replace,
+                ...(options.backup === false
+                    ? { backup: false }
+                    : typeof options.backup === 'string'
+                        ? { backup: options.backup }
+                        : {}),
+                ...(options.onlyIfSmaller === false ? { onlyIfSmaller: false } : {}),
+                config,
+                ...(label !== undefined ? { configLabel: label } : {}),
+                ...(overrides ? { overrides } : {}),
+                recursive: options.recursive,
+                extensions: parseExtensions(options.ext),
+                ignoreGlobs: options.ignore,
+                respectGitignore: options.respectGitignore,
+                include: options.include,
+                exclude: options.exclude,
+                flat: options.flat,
+                list: options.list,
+                select: options.select,
+                ...(mode ? { overwrite: mode } : {}),
+                force: options.force,
+                ...(placeholders ? { placeholders } : {}),
+                ...(options.emit !== undefined ? { emit: options.emit } : {}),
+                ...(options.keyPrefix !== undefined ? { keyPrefix: options.keyPrefix } : {}),
+                ...(options.cache === false
+                    ? { cache: false }
+                    : typeof options.cache === 'string'
+                        ? { cache: options.cache }
+                        : {}),
+                concurrency: Math.max(1, Number.parseInt(options.concurrency, 10) || 4),
+                ...(options.maxPixels !== undefined
+                    ? { maxPixels: parseMaxPixels(options.maxPixels) }
+                    : {}),
+                dryRun: options.dryRun,
+                assumeYes: options.yes,
+                interactive,
+                io,
+                style,
+                ...(showProgress
+                    ? {
+                        onProgress: ({ done, total }) => {
+                            if (total < 2)
+                                return;
+                            progressShown = true;
+                            process.stderr.write(`\r${s.info(`Processing ${done}/${total}`)}`);
+                        },
+                    }
+                    : {}),
+            });
+            if (progressShown)
+                process.stderr.write('\r\x1b[K');
+            if (options.json) {
+                const { ...printable } = report;
+                console.log(JSON.stringify(printable, null, 2));
+            }
+            else {
+                const text = renderImageBatchReport(report, {
+                    ...style,
+                    quiet: options.quiet,
+                    verbose: options.verbose,
+                });
+                if (text)
+                    console.log(text);
+            }
+            process.exitCode = report.exitCode;
+        }
+        catch (error) {
+            if (progressShown)
+                process.stderr.write('\r\x1b[K');
+            if (error instanceof ImageBatchUsageError) {
+                console.error(`error: ${error.message}`);
+                process.exitCode = 2;
+                return;
+            }
+            throw error;
+        }
+    });
+    command.enablePositionalOptions();
+    registerImageBatchManagement(command);
+}
+//# sourceMappingURL=cli.js.map

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

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

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

@@ -0,0 +1,38 @@
+export declare const OUTPUT_FORMATS: readonly ["jpg", "png", "webp", "avif", "gif", "tiff", "jp2", "heif"];
+export type OutputFormatName = (typeof OUTPUT_FORMATS)[number];
+export type FormatChoice = OutputFormatName | 'original';
+export declare const QUALITY_LEVELS: readonly ["low", "medium", "high", "best"];
+export type QualityLevel = (typeof QUALITY_LEVELS)[number];
+export type QualityValue = number | QualityLevel;
+export type QualityInput = QualityValue | Partial<Record<OutputFormatName, QualityValue>>;
+export type CodecValue = number | boolean | string;
+export type CodecOptions = Record<string, CodecValue>;
+export type CodecMap = Partial<Record<OutputFormatName, CodecOptions>>;
+interface OptionSpec {
+    kind: 'quality' | 'int' | 'number' | 'bool' | 'enum' | 'enum-int';
+    min?: number;
+    max?: number;
+    values?: readonly (string | number)[];
+}
+export declare const CODEC_SPECS: Record<OutputFormatName, Record<string, OptionSpec>>;
+export declare const BUILTIN_DEFAULTS: Record<OutputFormatName, CodecOptions>;
+export declare const FORMAT_EXTENSIONS: Record<OutputFormatName, string>;
+export declare function normalizeFormat(raw: string, where?: string): FormatChoice;
+export declare function isQualityLevel(value: unknown): value is QualityLevel;
+export declare function validateCodecOptions(format: OutputFormatName, options: Record<string, unknown>, where: string): CodecOptions;
+export declare function validateCodecMap(map: unknown, where: string): CodecMap;
+export declare function validateQualityInput(input: unknown, where: string): QualityInput;
+export declare function parseQualityArg(text: string): QualityInput;
+export declare function parseCodecArgs(args: string[]): CodecMap;
+export interface CodecLayer {
+    codecs?: CodecMap;
+    quality?: QualityInput;
+}
+export declare function resolveCodecOptions(format: OutputFormatName, layers: CodecLayer[]): CodecOptions;
+export declare function unsupportedFormats(sharp: unknown, formats: Iterable<OutputFormatName>): OutputFormatName[];
+export declare function supportsQualityLimit(format: OutputFormatName, codec: CodecOptions): boolean;
+export declare function qualityOf(format: OutputFormatName, codec: CodecOptions): number;
+export declare function sharpFormatName(format: OutputFormatName): string;
+export declare function toSharpOptions(options: CodecOptions): Record<string, CodecValue>;
+export declare function describeOptions(options: CodecOptions): string;
+export {};