@macrulez/mediatoolz 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danil Lisin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,183 @@
-# Temporary Holding Version
+# **MediaToolz**
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+![MediaToolz](https://github.com/macrulezru/assets/blob/master/packages-images/mediatoolz.webp?raw=true)
+
+A small toolbox of CLI commands for images: resize, convert and recompress
+them in bulk by rules, and generate compact placeholders for them. One
+binary, one subcommand per job, each safe by default (a preview first, a
+backup before anything is overwritten).
+
+It started as part of [devtoolz](https://www.npmjs.com/package/@macrulez/devtoolz)
+and lives in its own package since devtoolz 0.5.0.
+
+## Features
+
+- **`image-hash`** — generates [hazehash](https://github.com/macrulezru/hazehash),
+  [blurhash](https://blurha.sh) and/or
+  [thumbhash](https://evanw.github.io/thumbhash/) placeholders for raster
+  images (jpg, png, webp, gif, avif, tiff). Takes files and/or
+  directories — several of each, comma-separated too — and `-r` walks
+  subdirectories. Prints to stdout by default; `-o <file>` collects
+  everything into one file, `--per-file` / `--out-dir <dir>` writes a
+  file per image (`photo.jpg` → `photo.jpg.blurhash.txt`, with
+  `--suffix` and `--out-ext` to rename). Formats: `json`, `plain` (just
+  the hash text, no newline), `csv`, and `ts`/`js` modules you can import
+  straight into the app. Without `-t` it makes blurhash and thumbhash; `-t hazehash` adds the
+  more compact and more accurate hazehash (`--budget` sets its size in
+  bytes, 28 by default). Besides the hashes it can produce the
+  dominant color and a tiny PNG preview (`-t all`), accepts `http(s)`
+  URLs and path lists from a file or stdin, and can keep an output file in
+  sync: `--cache` skips unchanged images, `--update --prune` merges into
+  the existing file, `--check` fails with exit code 1 when it is stale
+  (made for CI). `--dry-run` writes nothing and shows the result as a
+  table instead. Uses the native `sharp` library, which mediatoolz
+  offers to install on first use — see Requirements.
+- **`image-batch`** — produces resized, converted and recompressed versions
+  of raster images in bulk, by rules kept in a reusable **config** or given
+  as flags: `widths`, `heights`, `size`, `longEdge` / `shortEdge` (the same for
+  landscape and portrait), `megapixels`, `percent`, `scale` (`@2x`),
+  `matchOrientation`, `maxBytes` (`--max-size 200KB` lowers the quality as far
+  as needed), `formats` (jpg,
+  png, webp, avif, gif, tiff, heif or `original`), `fit` (`inside`,
+  `cover`, `contain`, …), codec options (`quality` as a number or a level
+  `low`/`medium`/`high`/`best`, `mozjpeg`, a png `palette`, webp `lossless`,
+  avif `effort`, …) and file names from a template
+  (`{dir}/{name}-{width}w.{format}`, with `{ext}`, `{index:3}`, `{hash}`,
+  `{scale}`, `{date}`). The config holds only the rules; the folders are
+  chosen on every run. Where the results go is one of three: `-o <dir>` — a
+  separate folder that repeats the source structure (`--flat` drops it);
+  `--beside` — next to each source; `--replace` — over the sources
+  themselves, each in its own format, to shrink oversized originals or
+  recompress them in place. `--replace` is guarded: it asks for
+  confirmation (`--yes` without a terminal), copies the originals to
+  `.image-batch-backup/<date>/` first with a `journal.json`, replaces a file
+  only if the result is smaller, never processes the same file twice with
+  the same settings, and `--dry-run` shows the real before/after sizes;
+  `image-batch restore <backup>` puts the originals back. Without a size
+  flag it only converts the format. `-r` walks
+  subfolders, `-i/--select` ticks files from an interactive list, `--list`
+  only prints them. A result an earlier run already made is skipped; any
+  other existing file is a conflict — a terminal asks once (overwrite this
+  / this and all next / skip / skip all / quit), without a terminal it is
+  skipped with exit code 1, or use `--overwrite`, `--skip-existing`,
+  `--no-overwrite`. `--hazehash` (`--budget`), `--blurhash`, `--thumbhash`,
+  `--dominant-color` with `--emit <file>` write a manifest of everything
+  produced, with the placeholders. `init` creates configs, and `config` shows, edits,
+  copies and deletes them (`.mediatoolz/image-batch/` in the project or
+  `~/.mediatoolz/image-batch/` for all projects). `sharpen` adds output
+  sharpening after the resize — by target and amount, with `radius`,
+  `flat`, `jagged` and `threshold` for fine control — and `image-batch
+sharpen` saves such settings as presets that configs and `--sharpen <name>`
+  use by name. Uses `sharp` too — see
+  Requirements.
+- **`ui`** — starts a local web interface and opens it in the browser, so the
+  commands can be run with forms, tables and previews instead of flags. Two
+  modules: **Image Hash** (a gallery of the placeholders decoded next to each
+  image) and **Image Batch** (convert, edit configs and sharpening presets with
+  a before and after preview, restore backups). It is part of the package,
+  listens on `127.0.0.1` only behind a one-time token, and writes nothing
+  without an explicit choice. `--port`, `--no-open`, `--cwd`.
+
+`image-hash` writes files only when you name an output (`-o`, `--per-file`,
+`--out-dir`) and prints to stdout otherwise; `image-batch` writes into the
+folder given with `-o`, next to the sources with `--beside`, and over them
+only with `--replace` — after a confirmation, with a backup. Every command
+supports `--json` for machine-readable output.
+
+## Requirements
+
+- Node.js 20+
+- The [`sharp`](https://sharp.pixelplumbing.com) image library. It ships
+  prebuilt binaries for the common platforms and is not installed with
+  mediatoolz — the first run of either command offers to install it into
+  `~/.mediatoolz/deps` (`-y` / `--yes` agrees up front, which is also what
+  you want in CI; without a terminal and without `--yes` the command stops
+  and says so). A `sharp` you already have installed alongside mediatoolz
+  is used as-is.
+
+## Installation
+
+```bash
+npm install -g @macrulez/mediatoolz
+```
+
+Or run it without installing:
+
+```bash
+npx @macrulez/mediatoolz image-batch ./photos -r -o ./out -f webp
+```
+
+## Quick start
+
+```bash
+mediatoolz image-hash public/img                 # blurhash + thumbhash of every image, as JSON on stdout
+mediatoolz image-hash public/img -r -t hazehash --budget 24 -o hashes.json   # hazehash of 24 bytes at most
+mediatoolz image-hash a.jpg,b.png,photos -r -t blurhash -f csv -o hashes.csv
+mediatoolz image-hash public/img -r -f plain --per-file   # photo.jpg.blurhash.txt + photo.jpg.thumbhash.txt
+mediatoolz image-hash public/img -r -f ts -t thumbhash -o src/placeholders.ts --name placeholders
+mediatoolz image-hash public/img -r --dry-run        # write nothing, show a table of the hashes
+mediatoolz image-hash public/img -r -t all --components auto -o hashes.json --cache --update --prune
+mediatoolz image-hash public/img -r -o hashes.json --check   # CI: exit 1 if hashes.json is stale
+
+mediatoolz image-batch ./src/images -r -o ./public/images -w 400,800,1200 -f avif,webp,jpg -q high
+mediatoolz image-batch ./photos -r -o ./out -c web             # apply the saved config "web"
+mediatoolz image-batch ./photos -r -o ./out -c web --select    # tick the files from a list first
+mediatoolz image-batch ./photos -r -o ./out -c web --dry-run   # show what would be written
+mediatoolz image-batch ./photos -r -o ./out -c web --hazehash --budget 20 --emit ./out/images.json
+mediatoolz image-batch ./photos -r -o ./out -f webp                   # only change the format, keep the size
+mediatoolz image-batch ./photos -r -o ./out --long 1600 -f webp,jpg --max-size 200KB   # by long side, capped weight
+mediatoolz image-batch ./assets -r --replace -w 1600 --dry-run    # preview shrinking originals in place
+mediatoolz image-batch ./assets -r --replace -w 1600               # do it: backup first, asks to confirm
+mediatoolz image-batch restore .image-batch-backup/20261007-233706  # put the originals back
+mediatoolz image-batch ./photos -r --beside -w 400 -f webp         # results next to each source
+mediatoolz image-batch init                      # create a config with a few questions
+mediatoolz image-batch config                    # pick a config: apply, show, edit, copy, delete
+mediatoolz image-batch sharpen new               # save a sharpening preset, then --sharpen <name>
+
+mediatoolz ui                                  # web interface for both commands
+mediatoolz ui --no-open --port 4477            # just print the address
+```
+
+Every command has built-in `--help` — `mediatoolz --help` lists both commands
+with their own flags inline; `mediatoolz <command> --help` for one command's
+full flag list with defaults.
+
+## Development
+
+```bash
+npm install
+npm run build      # tsc -> dist/, and the web interface
+npm test           # vitest
+npm run lint       # eslint .
+npm run format     # prettier --check .
+npm run typecheck  # tsc --noEmit
+```
+
+---
+
+## Documentation & links
+
+- 📖 **Full documentation:** [npm.vuecraft.ru/en/packages/mediatoolz](https://npm.vuecraft.ru/en/packages/mediatoolz/guide/overview.html)
+- 🌐 **VueCraft:** [vuecraft.ru/en](https://vuecraft.ru/en)
+- 👤 **Author:** [macrulez.ru/en](https://macrulez.ru/en)
+- 💻 **GitHub:** [macrulezru/mediatoolz](https://github.com/macrulezru/mediatoolz)
+- 📦 **NPM:** [@macrulez/mediatoolz](https://www.npmjs.com/package/@macrulez/mediatoolz)
+- 🐛 **Issues:** [github.com/macrulezru/mediatoolz/issues](https://github.com/macrulezru/mediatoolz/issues)
+
+---
+
+## License
+
+MIT
+
+---
+
+## 💖 Support the project
+
+Open source takes time and effort. If this library saves you time or brings value, consider supporting further development.
+
+<a href="https://donate.cryptocloud.plus/M6O34NIN" target="_blank">
+  <img src="https://img.shields.io/badge/Donate-CryptoCloud-8A2BE2?style=for-the-badge&logo=cryptocurrency&logoColor=white" alt="Donate via CryptoCloud">
+</a>
+
+Thank you for being part of this journey. ❤️

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { runImageHash } from './commands/image-hash/run.js';
+import { renderImageHashReport } from './commands/image-hash/report.js';
+import { DEFAULT_CACHE_FILE, DEFAULT_HAZEHASH_BUDGET, DEFAULT_IMAGE_EXTENSIONS, ImageHashUsageError, MAX_HAZEHASH_BUDGET, MIN_HAZEHASH_BUDGET, OUTPUT_FORMATS, parseBudget, parseComponents, parseExtensions, parseFileList, parseFormat, parseMaxPixels, parseSampleSize, parseTypes, } from './commands/image-hash/core.js';
+import { registerImageBatch } from './commands/image-batch/cli.js';
+import { registerUi } from './commands/ui/cli.js';
+import { createStyle } from './format/style.js';
+function wrapText(text, width) {
+    const words = text.split(' ');
+    const lines = [];
+    let current = '';
+    for (const word of words) {
+        const candidate = current ? `${current} ${word}` : word;
+        if (current && candidate.length > width) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines;
+}
+/**
+ * Commander's own one-line-per-command "Commands:" list puts a command's
+ * own flags inline after its name (`image-hash [options]`) and leaves
+ * their descriptions for a separate `<command> --help` run — fine for a
+ * CLI with one or two flags per command, but it means the top-level
+ * `--help` never actually shows what any flag does. This builds a
+ * two-level list instead (command, then each of its own options indented
+ * below it with its own description), used in place of commander's
+ * default via `configureHelp({ visibleCommands: () => [] })` +
+ * `addHelpText('after')` — same technique as lintsync's/polyrepo-cli's
+ * own `formatCommandsHelp`.
+ *
+ * A flag present on EVERY command, with the exact same `flags` string and
+ * description (not just the same name coincidentally meaning something
+ * slightly different per command), is pulled out into a "Common options"
+ * block instead of being repeated under each one. A flag shared by only
+ * SOME commands stays listed under each of those commands directly —
+ * tried hoisting those into their own labeled sub-group too, but it's
+ * harder to keep in your head which commands a "Common options (a, b)"
+ * block actually applies to than to just see the flag where it's used.
+ * This only changes how the help text is RENDERED — every flag is still
+ * fully declared on its own command for real parsing, so
+ * `mediatoolz <command> --cwd x` keeps working exactly as before; nothing
+ * here is a true commander-level global option.
+ */
+function formatCommandsHelp(commands) {
+    const real = commands.filter((cmd) => cmd.name() !== 'help');
+    // Which commands (by name) share the exact same flags+description for
+    // a given option, keyed on that pair so two different flags spelled
+    // the same but described differently never get merged.
+    const owners = new Map();
+    for (const cmd of real) {
+        for (const opt of cmd.options) {
+            const key = `${opt.flags}\u0000${opt.description}`;
+            const entry = owners.get(key) ?? { flags: opt.flags, desc: opt.description, commandCount: 0 };
+            entry.commandCount++;
+            owners.set(key, entry);
+        }
+    }
+    const universalRows = [];
+    const hoistedKeys = new Set();
+    for (const [key, entry] of owners) {
+        if (entry.commandCount !== real.length)
+            continue; // not on every command — stays with each one below
+        universalRows.push({ indent: 1, label: entry.flags, desc: entry.desc });
+        hoistedKeys.add(key);
+    }
+    const commandGroups = real.map((cmd) => {
+        const aliases = cmd.aliases();
+        const label = aliases.length > 0 ? `${cmd.name()}, ${aliases.join(', ')}` : cmd.name();
+        const ownRows = cmd.options
+            .filter((opt) => !hoistedKeys.has(`${opt.flags}\u0000${opt.description}`))
+            .map((opt) => ({ indent: 1, label: opt.flags, desc: opt.description }));
+        return [{ indent: 0, label, desc: cmd.description() }, ...ownRows];
+    });
+    const allRows = [universalRows, ...commandGroups].flat();
+    const labelWidth = Math.max(...allRows.map((r) => r.indent * 4 + r.label.length));
+    const totalWidth = (process.stdout.isTTY && process.stdout.columns) || 96;
+    const descWidth = Math.max(totalWidth - (2 + labelWidth + 2), 30);
+    function renderRow(row, lines) {
+        const fullLabel = ' '.repeat(row.indent * 4) + row.label;
+        const [firstLine, ...restLines] = wrapText(row.desc, descWidth);
+        lines.push(`  ${fullLabel.padEnd(labelWidth)}  ${firstLine ?? ''}`);
+        for (const cont of restLines) {
+            lines.push(`  ${' '.repeat(labelWidth)}  ${cont}`);
+        }
+    }
+    const lines = [];
+    if (universalRows.length > 0) {
+        lines.push('Common options (all commands):');
+        for (const row of universalRows)
+            renderRow(row, lines);
+        lines.push('');
+    }
+    lines.push('Commands:');
+    commandGroups.forEach((group, i) => {
+        if (i > 0)
+            lines.push('');
+        for (const row of group)
+            renderRow(row, lines);
+    });
+    return lines.join('\n');
+}
+const program = new Command();
+program.enablePositionalOptions();
+program
+    .name('mediatoolz')
+    .description('A small toolbox of CLI commands for images: resize, convert and recompress them in bulk, and generate placeholders')
+    // Hide commander's own one-line-per-command list (see formatCommandsHelp
+    // above for why) — the "after" text below replaces it with the
+    // two-level version instead of showing both.
+    .configureHelp({ visibleCommands: () => [] })
+    .addHelpText('after', () => `\n${formatCommandsHelp(program.commands)}`);
+program
+    .command('image-hash')
+    .description('Generate hazehash/blurhash/thumbhash placeholders (and dominant color, tiny preview) for raster images — to stdout, one file, or a file per image')
+    .argument('[paths...]', 'image files, directories and http(s) URLs (several allowed, comma-separated too)', [])
+    .option('--cwd <path>', 'root paths are resolved against', process.cwd())
+    .option('-r, --recursive', 'also walk subdirectories of every given directory', false)
+    .option('--files-from <file>', 'read more paths/URLs from a file, one per line (- = stdin, # starts a comment)')
+    .option('--ext <list>', 'comma-separated image extensions to pick up from directories', DEFAULT_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('-t, --type <list>', 'what to generate, comma-separated: hazehash, blurhash, thumbhash, color (dominant), preview (tiny PNG data URI); both = blurhash+thumbhash, all = everything', 'both')
+    .option('--budget <bytes>', `hazehash: maximum size of one hash in bytes, header included, ${MIN_HAZEHASH_BUDGET}-${MAX_HAZEHASH_BUDGET} (16-48 is the tuned range)`, String(DEFAULT_HAZEHASH_BUDGET))
+    .option('--components <XxY|auto>', 'blurhash components, each side 1-9, or auto to pick them by aspect ratio', '4x3')
+    .option('--size <px>', 'longest side the image is scaled down to before hashing (1-100)', '100')
+    .option('--max-pixels <n>', 'refuse images with more pixels than this (0 = no limit; default: sharp limit, ~268 million)')
+    .option('-f, --format <format>', `format of the generated hashes: ${OUTPUT_FORMATS.join(', ')} (plain = just the hash text); --json prints the full report instead`, 'json')
+    .option('--name <identifier>', 'exported constant name for --format ts/js', 'imageHashes')
+    .option('--key-base <dir>', 'make the file keys in the output relative to this directory')
+    .option('--key-prefix <text>', 'text put in front of every file key, e.g. / for URL-style keys')
+    .option('-o, --out <file>', 'write everything into one file instead of stdout')
+    .option('--update', 'merge into the existing -o file instead of replacing it', false)
+    .option('--prune', 'with --update, drop entries whose image no longer exists', false)
+    .option('--per-file', 'write one file per image, next to the image', false)
+    .option('--out-dir <dir>', 'write the per-image files into this directory (implies --per-file)')
+    .option('--suffix <text>', 'per-image file name suffix after the image file name, {type} = hazehash/blurhash/thumbhash/hash (default: .{type})')
+    .option('--out-ext <ext>', 'per-image file extension (default: by --format, plain = .txt)')
+    .option('--check', 'write nothing; exit 1 if the output files are missing or differ from the images', false)
+    .option('--cache [file]', `skip images that did not change since the last run, remembered in this file (default: ${DEFAULT_CACHE_FILE})`)
+    .option('--concurrency <n>', 'images processed in parallel', '4')
+    .option('--dry-run', 'write nothing — show the result as a table instead', false)
+    .option('-y, --yes', 'install the missing "sharp" image library without asking', false)
+    .option('--json', 'machine-readable output', false)
+    .option('--quiet', 'suppress output when there is nothing to report', 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)
+    .action(async (paths, options) => {
+    const style = createStyle({ plain: options.plain, color: options.color });
+    const showProgress = !options.json && !options.quiet && Boolean(process.stderr.isTTY) && !options.plain;
+    let progressShown = false;
+    try {
+        const listed = options.filesFrom !== undefined
+            ? parseFileList(readFileSync(options.filesFrom === '-' ? 0 : options.filesFrom, 'utf8'))
+            : [];
+        const report = await runImageHash({
+            paths: [...paths, ...listed],
+            cwd: resolve(options.cwd),
+            types: parseTypes(options.type),
+            recursive: options.recursive,
+            extensions: parseExtensions(options.ext),
+            ignoreGlobs: options.ignore,
+            respectGitignore: options.respectGitignore,
+            components: parseComponents(options.components),
+            budget: parseBudget(options.budget),
+            size: parseSampleSize(options.size),
+            ...(options.maxPixels !== undefined
+                ? { maxPixels: parseMaxPixels(options.maxPixels) }
+                : {}),
+            format: parseFormat(options.format),
+            exportName: options.name,
+            ...(options.keyBase !== undefined ? { keyBase: options.keyBase } : {}),
+            ...(options.keyPrefix !== undefined ? { keyPrefix: options.keyPrefix } : {}),
+            ...(options.out !== undefined ? { out: options.out } : {}),
+            update: options.update,
+            prune: options.prune,
+            perFile: options.perFile,
+            ...(options.outDir !== undefined ? { outDir: options.outDir } : {}),
+            ...(options.suffix !== undefined ? { suffix: options.suffix } : {}),
+            ...(options.outExt !== undefined ? { outExtension: options.outExt } : {}),
+            check: options.check,
+            ...(options.cache !== undefined
+                ? { cache: options.cache === true ? DEFAULT_CACHE_FILE : String(options.cache) }
+                : {}),
+            concurrency: Math.max(1, Number.parseInt(options.concurrency, 10) || 4),
+            assumeYes: options.yes,
+            dryRun: options.dryRun,
+            ...(showProgress
+                ? {
+                    onProgress: ({ done, total }) => {
+                        if (total < 2)
+                            return;
+                        progressShown = true;
+                        process.stderr.write(`\r${style.info(`Hashing ${done}/${total}`)}`);
+                    },
+                }
+                : {}),
+        });
+        if (progressShown)
+            process.stderr.write('\r\x1b[K');
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else if (report.stdout !== null) {
+            process.stdout.write(report.stdout);
+            for (const error of report.errors)
+                console.error(`${error.file} — ${error.message}`);
+        }
+        else {
+            const text = renderImageHashReport(report, {
+                quiet: options.quiet,
+                plain: options.plain,
+                color: options.color,
+            });
+            if (text)
+                console.log(text);
+        }
+        process.exitCode = report.exitCode;
+    }
+    catch (error) {
+        if (progressShown)
+            process.stderr.write('\r\x1b[K');
+        if (error instanceof ImageHashUsageError) {
+            console.error(`error: ${error.message}`);
+            process.exitCode = 2;
+            return;
+        }
+        throw error;
+    }
+});
+registerImageBatch(program);
+registerUi(program);
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

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

@@ -0,0 +1,22 @@
+export declare const DEFAULT_BACKUP_DIR = ".image-batch-backup";
+export declare const JOURNAL_FILE = "journal.json";
+export interface JournalEntry {
+    path: string;
+    backup: string;
+    bytesBefore: number;
+    bytesAfter: number;
+    hashBefore: string;
+    hashAfter: string;
+}
+export interface Journal {
+    version: 1;
+    createdAt: string;
+    cwd: string;
+    entries: JournalEntry[];
+}
+export declare function backupDirFor(cwd: string, base: string | undefined, now: Date): string;
+export declare function backupPathFor(backupDir: string, cwd: string, absolute: string): string;
+export declare function copyIntoBackup(source: string, backup: string): void;
+export declare function newJournal(cwd: string, now: Date): Journal;
+export declare function saveJournal(backupDir: string, journal: Journal): void;
+export declare function loadJournal(backupDir: string): Journal;

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

@@ -0,0 +1,55 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { ImageBatchUsageError } from './errors.js';
+export const DEFAULT_BACKUP_DIR = '.image-batch-backup';
+export const JOURNAL_FILE = 'journal.json';
+function stamp(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+}
+export function backupDirFor(cwd, base, now) {
+    const root = resolve(cwd, base ?? DEFAULT_BACKUP_DIR);
+    let dir = join(root, stamp(now));
+    let suffix = 1;
+    while (existsSync(dir)) {
+        suffix += 1;
+        dir = join(root, `${stamp(now)}-${suffix}`);
+    }
+    return dir;
+}
+export function backupPathFor(backupDir, cwd, absolute) {
+    const rel = relative(cwd, absolute);
+    if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) {
+        return join(backupDir, '_outside', absolute.replace(/[:\\/]+/g, '_'));
+    }
+    return join(backupDir, rel);
+}
+export function copyIntoBackup(source, backup) {
+    mkdirSync(dirname(backup), { recursive: true });
+    copyFileSync(source, backup);
+}
+export function newJournal(cwd, now) {
+    return { version: 1, createdAt: now.toISOString(), cwd, entries: [] };
+}
+export function saveJournal(backupDir, journal) {
+    mkdirSync(backupDir, { recursive: true });
+    writeFileSync(join(backupDir, JOURNAL_FILE), `${JSON.stringify(journal, null, 2)}\n`);
+}
+export function loadJournal(backupDir) {
+    const path = join(backupDir, JOURNAL_FILE);
+    if (!existsSync(path)) {
+        throw new ImageBatchUsageError(`${backupDir} has no ${JOURNAL_FILE} — pass the dated backup folder that --replace created`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        throw new ImageBatchUsageError(`${path}: not valid JSON — ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (parsed.version !== 1 || !Array.isArray(parsed.entries)) {
+        throw new ImageBatchUsageError(`${path}: not a journal written by image-batch`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=backup.js.map

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

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

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

@@ -0,0 +1,15 @@
+export interface BatchCacheEntry {
+    fingerprint: string;
+    bytes: number;
+    settingsKey?: string;
+    hash?: string;
+}
+export interface BatchCache {
+    version: 1;
+    outputs: Record<string, BatchCacheEntry>;
+}
+export declare function emptyBatchCache(): BatchCache;
+export declare function cacheKeyFor(placement: 'out' | 'beside' | 'replace', target: string, roots: string[]): string;
+export declare function defaultCachePath(key: string, baseDir?: string): string;
+export declare function loadBatchCache(path: string): BatchCache;
+export declare function saveBatchCache(path: string, cache: BatchCache): void;

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

@@ -0,0 +1,38 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+export function emptyBatchCache() {
+    return { version: 1, outputs: {} };
+}
+export function cacheKeyFor(placement, target, roots) {
+    if (placement === 'out')
+        return resolve(target);
+    return `${placement}:${roots
+        .map((root) => resolve(root))
+        .sort()
+        .join('|')}`;
+}
+export function defaultCachePath(key, baseDir = homedir()) {
+    const id = createHash('sha1').update(key.toLowerCase()).digest('hex').slice(0, 16);
+    return join(baseDir, '.mediatoolz', 'cache', 'image-batch', `${id}.json`);
+}
+export function loadBatchCache(path) {
+    if (!existsSync(path))
+        return emptyBatchCache();
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (parsed.version !== 1 || typeof parsed.outputs !== 'object' || parsed.outputs === null) {
+            return emptyBatchCache();
+        }
+        return parsed;
+    }
+    catch {
+        return emptyBatchCache();
+    }
+}
+export function saveBatchCache(path, cache) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(cache)}\n`);
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/commands/image-batch/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAclD,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,SAAuC,EACvC,MAAc,EACd,KAAe;IAEf,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,OAAO,GAAG,SAAS,IAAI,KAAK;SACzB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC5B,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,UAAkB,OAAO,EAAE;IACvE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClF,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;AAC3E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,eAAe,EAAE,CAAA;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAA;QACnE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1F,OAAO,eAAe,EAAE,CAAA;QAC1B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,EAAE,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAiB;IAC5D,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"}

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

@@ -0,0 +1,15 @@
+import type { Command } from 'commander';
+import { type BatchConfig } from './config.js';
+export declare function chooseConfig(options: {
+    config?: string;
+    cwd: string;
+    adHoc: boolean;
+    interactive: boolean;
+}, style: {
+    plain?: boolean;
+    color?: boolean;
+}): Promise<{
+    config: BatchConfig;
+    label?: string;
+}>;
+export declare function registerImageBatch(program: Command): void;