webpocalypse 1.0.0

package/README.md

@@ -0,0 +1,138 @@
+# webpocalypse
+
+> Batch convert images to WebP/AVIF — fully local, no server, no API calls.
+
+```
+npx webpocalypse ./public --format webp --quality 80 --max-width 1920
+```
+
+Recursively scans a directory, converts every `.jpg`, `.jpeg`, `.png` to WebP
+and/or AVIF using [sharp](https://sharp.pixelplumbing.com/), preserves the full
+folder structure, and reports per-file savings.
+
+---
+
+## Install
+
+```bash
+npm install -g webpocalypse
+# or run without installing:
+npx webpocalypse <input> [options]
+```
+
+---
+
+## Usage
+
+```
+webpocalypse <input> [options]
+
+Arguments:
+  input                   Directory of images to convert
+
+Options:
+  -f, --format <format>   Output format: webp | avif | both  (default: webp)
+  -q, --quality <number>  Compression quality 1–100          (default: 80)
+  --lossless              Lossless compression
+  --max-width  <px>       Maximum output width  (no upscaling)
+  --max-height <px>       Maximum output height (no upscaling)
+  -o, --out <path>        Output directory      (default: <input>-optimized)
+  --in-place              Replace source directory safely via temp dir
+  -h, --help              Show help
+  -V, --version           Show version
+```
+
+---
+
+## Examples
+
+```bash
+# WebP at quality 80 (default)
+webpocalypse ./images
+
+# Both WebP + AVIF
+webpocalypse ./images --format both --quality 75
+
+# Resize + convert
+webpocalypse ./public/photos --format webp --max-width 1920 --quality 85
+
+# Lossless WebP
+webpocalypse ./assets --format webp --lossless
+
+# Custom output directory
+webpocalypse ./src/images --format avif --out ./dist/images
+
+# Overwrite source in-place (safe: uses temp dir, rolls back on failure)
+webpocalypse ./public --format webp --in-place
+```
+
+---
+
+## Output
+
+```
+webpocalypse v1.0.0
+  Input:   /home/user/project/public/images
+  Output:  /home/user/project/public/images-optimized
+  Format:  both  Quality: 80
+  Files:   42 images found → 84 outputs
+
+File                                        Original    Converted     Savings
+─────────────────────────────────────────────────────────────────────────────
+  hero.webp                                     1.2 MB       149 KB         88%
+  hero.avif                                     1.2 MB       218 KB         82%
+  icons/logo.webp                                45 KB        12 KB         73%
+  icons/logo.avif                                45 KB         9 KB         80%
+  ...
+─────────────────────────────────────────────────────────────────────────────
+
+✔ 84 files converted
+✔ 56.2 MB → 9.1 MB (84% saved)
+
+Output: /home/user/project/public/images-optimized
+```
+
+---
+
+## Behavior
+
+| Extension        | Action                         |
+|------------------|-------------------------------|
+| `.jpg` / `.jpeg` | Re-encoded via sharp           |
+| `.png`           | Re-encoded via sharp           |
+| `.webp` / `.avif`| Copied as-is (no re-encoding)  |
+
+### `--in-place` safety
+
+1. All files are written to a temporary directory first.
+2. **Only if every conversion succeeds**, the source directory is replaced atomically.
+3. On any failure the source is left completely untouched and the temp dir is cleaned up.
+
+### Exit codes
+
+| Code | Meaning                  |
+|------|--------------------------|
+| `0`  | All files processed OK   |
+| `1`  | One or more files failed |
+
+---
+
+## Project structure
+
+```
+src/
+  index.ts    Entry point & orchestration
+  cli.ts      Argument parsing (commander)
+  scan.ts     Recursive directory traversal
+  convert.ts  sharp encoding logic + p-limit concurrency
+  writer.ts   Output & in-place replacement logic
+  logger.ts   Table, summary, formatting helpers
+  types.ts    Shared TypeScript types
+```
+
+---
+
+## Requirements
+
+- Node.js ≥ 18
+- Runs on Linux, macOS, Windows (sharp ships pre-built binaries)

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+import type { CliOptions } from './types.js';
+export declare function parseArgs(argv: string[]): {
+    inputDir: string;
+    options: CliOptions;
+};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAI3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAiEnF"}

package/dist/cli.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const VALID_FORMATS = ['webp', 'avif', 'both'];
+function parseArgs(argv) {
+    const program = new commander_1.Command();
+    program
+        .name('webpocalypse')
+        .description('Batch convert images to WebP/AVIF with quality control and directory structure preservation')
+        .version('1.0.0')
+        .argument('<input>', 'Input directory containing images to convert')
+        .option('-f, --format <format>', 'Output format: webp, avif, or both', 'webp')
+        .option('-q, --quality <number>', 'Compression quality (50–100)', '80')
+        .option('--lossless', 'Use lossless compression', false)
+        .option('--max-width <number>', 'Maximum output width in pixels (no upscaling)')
+        .option('--max-height <number>', 'Maximum output height in pixels (no upscaling)')
+        .option('-o, --out <path>', 'Output directory (default: <input>-optimized)')
+        .option('--in-place', 'Overwrite source directory safely via temp dir', false);
+    program.parse(argv);
+    const opts = program.opts();
+    const [inputArg] = program.args;
+    if (!inputArg) {
+        program.error('Missing required argument: <input>');
+    }
+    const format = opts.format;
+    if (!VALID_FORMATS.includes(format)) {
+        program.error(`Invalid format "${format}". Must be one of: ${VALID_FORMATS.join(', ')}`);
+    }
+    const quality = parseInt(opts.quality, 10);
+    if (isNaN(quality) || quality < 1 || quality > 100) {
+        program.error(`Invalid quality "${opts.quality}". Must be a number between 1 and 100`);
+    }
+    let maxWidth;
+    if (opts.maxWidth !== undefined) {
+        maxWidth = parseInt(opts.maxWidth, 10);
+        if (isNaN(maxWidth) || maxWidth <= 0) {
+            program.error(`Invalid --max-width "${opts.maxWidth}". Must be a positive integer`);
+        }
+    }
+    let maxHeight;
+    if (opts.maxHeight !== undefined) {
+        maxHeight = parseInt(opts.maxHeight, 10);
+        if (isNaN(maxHeight) || maxHeight <= 0) {
+            program.error(`Invalid --max-height "${opts.maxHeight}". Must be a positive integer`);
+        }
+    }
+    const inputDir = path_1.default.resolve(inputArg);
+    return {
+        inputDir,
+        options: {
+            format: format,
+            quality,
+            lossless: opts.lossless,
+            maxWidth,
+            maxHeight,
+            out: opts.out ? path_1.default.resolve(opts.out) : undefined,
+            inPlace: opts.inPlace,
+        },
+    };
+}
+//# 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/convert.d.ts

@@ -0,0 +1,7 @@
+import type { FileEntry, CliOptions, ConversionResult } from './types.js';
+/**
+ * Convert all files and write directly to outputDir.
+ * Calls onProgress after each file finishes (success or failure).
+ */
+export declare function convertFiles(files: FileEntry[], outputDir: string, options: CliOptions, onProgress: (result: ConversionResult) => void): Promise<ConversionResult[]>;
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgF1E;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC7C,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuD7B"}

package/dist/convert.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertFiles = convertFiles;
+const sharp_1 = __importDefault(require("sharp"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const p_limit_1 = __importDefault(require("p-limit"));
+const scan_js_1 = require("./scan.js");
+function applyResize(image, options) {
+    if (!options.maxWidth && !options.maxHeight)
+        return image;
+    return image.resize({
+        width: options.maxWidth,
+        height: options.maxHeight,
+        fit: 'inside',
+        withoutEnlargement: true,
+    });
+}
+async function encodeToFile(file, format, outputDir, options) {
+    const inputBuffer = fs_1.default.readFileSync(file.inputPath);
+    const originalSize = inputBuffer.length;
+    const outputRelativePath = (0, scan_js_1.replaceExtension)(file.relativePath, format);
+    const outputPath = path_1.default.join(outputDir, outputRelativePath);
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(outputPath));
+    let image = (0, sharp_1.default)(inputBuffer);
+    image = applyResize(image, options);
+    if (format === 'webp') {
+        await (options.lossless
+            ? image.webp({ lossless: true })
+            : image.webp({ quality: options.quality })).toFile(outputPath);
+    }
+    else {
+        // effort 2 (scale 0–9): ~10× faster than default 4 with negligible quality
+        // loss for web use. The default effort level locks the CPU.
+        await (options.lossless
+            ? image.avif({ lossless: true, effort: 2 })
+            : image.avif({ quality: options.quality, effort: 2 })).toFile(outputPath);
+    }
+    const convertedSize = fs_1.default.statSync(outputPath).size;
+    return {
+        inputPath: file.inputPath,
+        relativePath: file.relativePath,
+        outputPath,
+        outputRelativePath,
+        originalSize,
+        convertedSize,
+        success: true,
+        skipped: false,
+    };
+}
+async function passthroughFile(file, outputDir) {
+    const outputPath = path_1.default.join(outputDir, file.relativePath);
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(outputPath));
+    await fs_extra_1.default.copy(file.inputPath, outputPath);
+    const size = fs_1.default.statSync(file.inputPath).size;
+    return {
+        inputPath: file.inputPath,
+        relativePath: file.relativePath,
+        outputPath,
+        outputRelativePath: file.relativePath,
+        originalSize: size,
+        convertedSize: size,
+        success: true,
+        skipped: true,
+    };
+}
+/**
+ * Convert all files and write directly to outputDir.
+ * Calls onProgress after each file finishes (success or failure).
+ */
+async function convertFiles(files, outputDir, options, onProgress) {
+    // AVIF is much heavier to encode — reduce concurrency to avoid CPU saturation
+    const concurrency = options.format === 'avif' ? 3
+        : options.format === 'both' ? 4
+            : 6;
+    const limit = (0, p_limit_1.default)(concurrency);
+    const allResults = [];
+    const tasks = files.flatMap((file) => {
+        if ((0, scan_js_1.isPassthrough)(file.inputPath)) {
+            return [
+                limit(async () => {
+                    const result = await passthroughFile(file, outputDir);
+                    allResults.push(result);
+                    onProgress(result);
+                }),
+            ];
+        }
+        const formats = options.format === 'both' ? ['webp', 'avif'] : [options.format];
+        return formats.map((fmt) => limit(async () => {
+            let result;
+            try {
+                result = await encodeToFile(file, fmt, outputDir, options);
+            }
+            catch (err) {
+                const stat = (() => {
+                    try {
+                        return fs_1.default.statSync(file.inputPath);
+                    }
+                    catch {
+                        return null;
+                    }
+                })();
+                result = {
+                    inputPath: file.inputPath,
+                    relativePath: file.relativePath,
+                    outputPath: '',
+                    outputRelativePath: (0, scan_js_1.replaceExtension)(file.relativePath, fmt),
+                    originalSize: stat?.size ?? 0,
+                    convertedSize: 0,
+                    success: false,
+                    skipped: false,
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+            allResults.push(result);
+            onProgress(result);
+        }));
+    });
+    await Promise.all(tasks);
+    return allResults;
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+const cli_js_1 = require("./cli.js");
+const scan_js_1 = require("./scan.js");
+const writer_js_1 = require("./writer.js");
+const logger_js_1 = require("./logger.js");
+async function main() {
+    const { inputDir, options } = (0, cli_js_1.parseArgs)(process.argv);
+    // ── Validate input directory ──────────────────────────────────────────────
+    if (!fs_1.default.existsSync(inputDir)) {
+        console.error(chalk_1.default.red(`✖ Input directory not found: ${inputDir}`));
+        process.exit(1);
+    }
+    const stat = fs_1.default.statSync(inputDir);
+    if (!stat.isDirectory()) {
+        console.error(chalk_1.default.red(`✖ Input path is not a directory: ${inputDir}`));
+        process.exit(1);
+    }
+    // ── Scan ──────────────────────────────────────────────────────────────────
+    const spinner = (0, ora_1.default)({ text: 'Scanning for images…', stream: process.stderr }).start();
+    const files = (0, scan_js_1.scanDirectory)(inputDir);
+    spinner.stop();
+    if (files.length === 0) {
+        console.log(chalk_1.default.yellow('⚠ No supported images found in: ') + inputDir);
+        console.log(chalk_1.default.dim('  Supported formats: .jpg, .jpeg, .png, .webp, .avif'));
+        process.exit(0);
+    }
+    // Each file may produce 1 or 2 output files (when --format both)
+    const totalOutputs = files.reduce((sum, f) => {
+        const isPassthrough = /\.(webp|avif)$/i.test(f.inputPath);
+        return sum + (isPassthrough ? 1 : options.format === 'both' ? 2 : 1);
+    }, 0);
+    const outputDir = options.inPlace
+        ? inputDir
+        : (options.out ?? `${inputDir}-optimized`);
+    console.log();
+    console.log(chalk_1.default.bold('webpocalypse') +
+        chalk_1.default.dim(` v${getVersion()}`));
+    console.log(chalk_1.default.dim('  Input:   ') + inputDir);
+    console.log(chalk_1.default.dim('  Output:  ') + (options.inPlace ? chalk_1.default.yellow(outputDir + ' (in-place)') : outputDir));
+    console.log(chalk_1.default.dim('  Format:  ') + options.format +
+        chalk_1.default.dim('  Quality: ') + (options.lossless ? 'lossless' : String(options.quality)) +
+        (options.maxWidth ? chalk_1.default.dim('  Max-W: ') + options.maxWidth : '') +
+        (options.maxHeight ? chalk_1.default.dim('  Max-H: ') + options.maxHeight : ''));
+    console.log(chalk_1.default.dim(`  Files:   ${files.length} image${files.length !== 1 ? 's' : ''} found → ${totalOutputs} output${totalOutputs !== 1 ? 's' : ''}`));
+    // ── Convert ───────────────────────────────────────────────────────────────
+    (0, logger_js_1.printTableHeader)();
+    let doneCount = 0;
+    const isTTY = Boolean(process.stderr.isTTY);
+    // Only spin in interactive terminals; in CI/piped output just print rows.
+    const progressSpinner = isTTY
+        ? (0, ora_1.default)({ text: (0, logger_js_1.progressText)(0, totalOutputs, ''), stream: process.stderr }).start()
+        : null;
+    const allResults = [];
+    function onProgress(result) {
+        doneCount++;
+        if (progressSpinner) {
+            progressSpinner.clear();
+        }
+        (0, logger_js_1.printResultRow)(result);
+        allResults.push(result);
+        if (progressSpinner && doneCount < totalOutputs) {
+            progressSpinner.text = (0, logger_js_1.progressText)(doneCount, totalOutputs, result.outputRelativePath);
+            progressSpinner.render();
+        }
+    }
+    try {
+        const { results, outputDir: finalOutputDir } = await (0, writer_js_1.writeOutput)(inputDir, files, options, onProgress);
+        progressSpinner?.stop();
+        // Sort results by path for a stable display order
+        results.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+        const summary = (0, logger_js_1.buildSummary)(results);
+        (0, logger_js_1.printSummary)(summary, finalOutputDir);
+        process.exit(summary.failureCount > 0 ? 1 : 0);
+    }
+    catch (err) {
+        progressSpinner?.stop();
+        console.error();
+        console.error(chalk_1.default.red('✖ Fatal error: ') + (err instanceof Error ? err.message : String(err)));
+        process.exit(1);
+    }
+}
+function getVersion() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const pkg = require('../package.json');
+        return pkg.version;
+    }
+    catch {
+        return '?';
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,4CAAoB;AACpB,8CAAsB;AACtB,kDAA0B;AAC1B,qCAAqC;AACrC,uCAA0C;AAC1C,2CAA0C;AAC1C,2CAMqB;AAGrB,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAA,kBAAS,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,6EAA6E;IAC7E,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACtF,MAAM,KAAK,GAAG,IAAA,uBAAa,EAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,GAAG,QAAQ,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC3C,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO;QAC/B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,QAAQ,YAAY,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,cAAc,CAAC;QAC1B,eAAK,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,EAAE,CAAC,CAC/B,CAAC;IACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,QAAQ,CACpC,CAAC;IACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAK,CAAC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CACnG,CAAC;IACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM;QACzC,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpF,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CACtE,CAAC;IACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,YAAY,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC7I,CAAC;IAEF,6EAA6E;IAC7E,IAAA,4BAAgB,GAAE,CAAC;IAEnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,0EAA0E;IAC1E,MAAM,eAAe,GAAG,KAAK;QAC3B,CAAC,CAAC,IAAA,aAAG,EAAC,EAAE,IAAI,EAAE,IAAA,wBAAY,EAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE;QAClF,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,SAAS,UAAU,CAAC,MAAwB;QAC1C,SAAS,EAAE,CAAC;QAEZ,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,IAAA,0BAAc,EAAC,MAAM,CAAC,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,eAAe,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;YAChD,eAAe,CAAC,IAAI,GAAG,IAAA,wBAAY,EAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACxF,eAAe,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,IAAA,uBAAW,EAC9D,QAAQ,EACR,KAAK,EACL,OAAO,EACP,UAAU,CACX,CAAC;QAEF,eAAe,EAAE,IAAI,EAAE,CAAC;QAExB,kDAAkD;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,IAAA,wBAAY,EAAC,OAAO,CAAC,CAAC;QACtC,IAAA,wBAAY,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,EAAE,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;QAC9D,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+import type { ConversionResult, ConversionSummary } from './types.js';
+export declare function formatBytes(bytes: number): string;
+export declare function printTableHeader(): void;
+export declare function printResultRow(result: ConversionResult): void;
+export declare function buildSummary(results: ConversionResult[]): ConversionSummary;
+export declare function printSummary(summary: ConversionSummary, outputDir: string): void;
+export declare function progressText(done: number, total: number, currentFile: string): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAItE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAgCD,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAwC7D;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CA8B3E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAwChF;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIrF"}

package/dist/logger.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = formatBytes;
+exports.printTableHeader = printTableHeader;
+exports.printResultRow = printResultRow;
+exports.buildSummary = buildSummary;
+exports.printSummary = printSummary;
+exports.progressText = progressText;
+const chalk_1 = __importDefault(require("chalk"));
+// ─── Formatting helpers ──────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const exp = Math.min(Math.floor(Math.log2(bytes) / 10), units.length - 1);
+    const value = bytes / Math.pow(1024, exp);
+    return `${value.toFixed(value < 10 ? 1 : 0)} ${units[exp]}`;
+}
+function pct(original, converted) {
+    if (original === 0)
+        return '—';
+    const saved = ((original - converted) / original) * 100;
+    return `${saved >= 0 ? saved.toFixed(0) : '+' + Math.abs(saved).toFixed(0)}%`;
+}
+function truncatePath(p, maxLen) {
+    if (p.length <= maxLen)
+        return p.padEnd(maxLen);
+    return '…' + p.slice(-(maxLen - 1));
+}
+// ─── Results table ───────────────────────────────────────────────────────────
+const COL = {
+    file: 40,
+    original: 10,
+    converted: 11,
+    savings: 10,
+};
+const HEADER = chalk_1.default.bold(truncatePath('File', COL.file) + '  ' +
+    'Original'.padStart(COL.original) + '  ' +
+    'Converted'.padStart(COL.converted) + '  ' +
+    'Savings'.padStart(COL.savings));
+const DIVIDER = '─'.repeat(COL.file + COL.original + COL.converted + COL.savings + 6);
+function printTableHeader() {
+    console.log();
+    console.log(HEADER);
+    console.log(chalk_1.default.dim(DIVIDER));
+}
+function printResultRow(result) {
+    if (!result.success) {
+        console.log(chalk_1.default.red('✖ ') +
+            chalk_1.default.red(truncatePath(result.relativePath, COL.file - 2)) +
+            '  ' +
+            chalk_1.default.dim(`Failed: ${result.error ?? 'unknown error'}`));
+        return;
+    }
+    const displayPath = result.skipped
+        ? result.relativePath + chalk_1.default.dim(' (copy)')
+        : result.outputRelativePath;
+    const fileCol = truncatePath(displayPath, COL.file);
+    const savings = pct(result.originalSize, result.convertedSize);
+    const savingsNum = result.originalSize
+        ? ((result.originalSize - result.convertedSize) / result.originalSize) * 100
+        : 0;
+    let savingsStr;
+    if (result.skipped) {
+        savingsStr = chalk_1.default.dim('—');
+    }
+    else if (savingsNum >= 20) {
+        savingsStr = chalk_1.default.green(savings.padStart(COL.savings));
+    }
+    else if (savingsNum >= 0) {
+        savingsStr = chalk_1.default.yellow(savings.padStart(COL.savings));
+    }
+    else {
+        savingsStr = chalk_1.default.red(savings.padStart(COL.savings));
+    }
+    console.log(chalk_1.default.dim('  ') +
+        fileCol.padEnd(COL.file) + '  ' +
+        chalk_1.default.dim(formatBytes(result.originalSize).padStart(COL.original)) + '  ' +
+        chalk_1.default.cyan(formatBytes(result.convertedSize).padStart(COL.converted)) + '  ' +
+        savingsStr);
+}
+// ─── Summary ─────────────────────────────────────────────────────────────────
+function buildSummary(results) {
+    let totalOriginalBytes = 0;
+    let totalConvertedBytes = 0;
+    let successCount = 0;
+    let failureCount = 0;
+    let skippedCount = 0;
+    for (const r of results) {
+        if (!r.success) {
+            failureCount++;
+            totalOriginalBytes += r.originalSize;
+        }
+        else if (r.skipped) {
+            skippedCount++;
+            totalOriginalBytes += r.originalSize;
+            totalConvertedBytes += r.convertedSize;
+        }
+        else {
+            successCount++;
+            totalOriginalBytes += r.originalSize;
+            totalConvertedBytes += r.convertedSize;
+        }
+    }
+    return {
+        totalFiles: results.length,
+        successCount,
+        failureCount,
+        skippedCount,
+        totalOriginalBytes,
+        totalConvertedBytes,
+    };
+}
+function printSummary(summary, outputDir) {
+    console.log(chalk_1.default.dim(DIVIDER));
+    console.log();
+    const { successCount, failureCount, skippedCount, totalOriginalBytes, totalConvertedBytes } = summary;
+    if (successCount > 0) {
+        const savings = totalOriginalBytes > 0
+            ? Math.round(((totalOriginalBytes - totalConvertedBytes) / totalOriginalBytes) * 100)
+            : 0;
+        console.log(chalk_1.default.green('✔') + ' ' +
+            chalk_1.default.bold(`${successCount} file${successCount !== 1 ? 's' : ''} converted`));
+        console.log(chalk_1.default.green('✔') + ' ' +
+            `${formatBytes(totalOriginalBytes)} → ${formatBytes(totalConvertedBytes)} ` +
+            chalk_1.default.bold.green(`(${savings}% saved)`));
+    }
+    if (skippedCount > 0) {
+        console.log(chalk_1.default.dim('·') + ' ' +
+            chalk_1.default.dim(`${skippedCount} file${skippedCount !== 1 ? 's' : ''} copied as-is`));
+    }
+    if (failureCount > 0) {
+        console.log(chalk_1.default.red('✖') + ' ' +
+            chalk_1.default.red.bold(`${failureCount} file${failureCount !== 1 ? 's' : ''} failed`));
+    }
+    console.log();
+    console.log(chalk_1.default.dim('Output: ') + chalk_1.default.cyan(outputDir));
+    console.log();
+}
+// ─── Spinner helpers ─────────────────────────────────────────────────────────
+function progressText(done, total, currentFile) {
+    const pctDone = total > 0 ? Math.round((done / total) * 100) : 0;
+    const truncated = currentFile.length > 40 ? '…' + currentFile.slice(-39) : currentFile;
+    return `[${done}/${total}] ${pctDone}% — ${truncated}`;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/scan.d.ts

@@ -0,0 +1,11 @@
+import type { FileEntry } from './types.js';
+export declare function isSupportedImage(filename: string): boolean;
+export declare function isPassthrough(filename: string): boolean;
+export declare function replaceExtension(filePath: string, newExt: string): string;
+/**
+ * Recursively walk a directory and collect all supported image files.
+ * Returns paths relative to the given root so that directory structure
+ * can be replicated in the output.
+ */
+export declare function scanDirectory(rootDir: string): FileEntry[];
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAoB1D"}

package/dist/scan.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSupportedImage = isSupportedImage;
+exports.isPassthrough = isPassthrough;
+exports.replaceExtension = replaceExtension;
+exports.scanDirectory = scanDirectory;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// Extensions that will be re-encoded by sharp
+const CONVERTIBLE_EXTENSIONS = new Set(['.jpg', '.jpeg', '.png']);
+// Extensions that are already in a target format — copy as-is
+const PASSTHROUGH_EXTENSIONS = new Set(['.webp', '.avif']);
+const ALL_SUPPORTED = new Set([...CONVERTIBLE_EXTENSIONS, ...PASSTHROUGH_EXTENSIONS]);
+function isSupportedImage(filename) {
+    const ext = filename.toLowerCase().slice(filename.lastIndexOf('.'));
+    return ALL_SUPPORTED.has(ext);
+}
+function isPassthrough(filename) {
+    const ext = filename.toLowerCase().slice(filename.lastIndexOf('.'));
+    return PASSTHROUGH_EXTENSIONS.has(ext);
+}
+function replaceExtension(filePath, newExt) {
+    const dotIndex = filePath.lastIndexOf('.');
+    const base = dotIndex !== -1 ? filePath.slice(0, dotIndex) : filePath;
+    return `${base}.${newExt}`;
+}
+/**
+ * Recursively walk a directory and collect all supported image files.
+ * Returns paths relative to the given root so that directory structure
+ * can be replicated in the output.
+ */
+function scanDirectory(rootDir) {
+    const entries = [];
+    function walk(dir) {
+        const items = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        for (const item of items) {
+            const fullPath = path_1.default.join(dir, item.name);
+            if (item.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (item.isFile() && isSupportedImage(item.name)) {
+                const relativePath = path_1.default.relative(rootDir, fullPath);
+                entries.push({ inputPath: fullPath, relativePath });
+            }
+        }
+    }
+    walk(rootDir);
+    return entries;
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":";;;;;AAYA,4CAGC;AAED,sCAGC;AAED,4CAIC;AAOD,sCAoBC;AArDD,4CAAoB;AACpB,gDAAwB;AAGxB,8CAA8C;AAC9C,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE,8DAA8D;AAC9D,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,sBAAsB,EAAE,GAAG,sBAAsB,CAAC,CAAC,CAAC;AAEtF,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,MAAc;IAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtE,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,SAAS,IAAI,CAAC,GAAW;QACvB,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE3C,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export type OutputFormat = 'webp' | 'avif' | 'both';
+export interface CliOptions {
+    format: OutputFormat;
+    quality: number;
+    lossless: boolean;
+    maxWidth?: number;
+    maxHeight?: number;
+    out?: string;
+    inPlace: boolean;
+}
+export interface FileEntry {
+    inputPath: string;
+    relativePath: string;
+}
+export interface ConversionResult {
+    inputPath: string;
+    relativePath: string;
+    outputPath: string;
+    outputRelativePath: string;
+    originalSize: number;
+    convertedSize: number;
+    success: boolean;
+    skipped: boolean;
+    error?: string;
+}
+export interface ConversionSummary {
+    totalFiles: number;
+    successCount: number;
+    failureCount: number;
+    skippedCount: number;
+    totalOriginalBytes: number;
+    totalConvertedBytes: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/writer.d.ts

@@ -0,0 +1,25 @@
+import type { CliOptions, ConversionResult } from './types.js';
+import type { FileEntry } from './types.js';
+/**
+ * Determine the final output directory from CLI options.
+ * - `--out <path>` wins if provided
+ * - `--in-place` uses a temp dir (caller must finalize after success)
+ * - Default: `<inputDir>-optimized`
+ */
+export declare function resolveOutputDir(inputDir: string, options: CliOptions): string;
+/**
+ * Run conversion and write output.
+ *
+ * For --in-place:
+ *   1. Write everything to a temporary directory.
+ *   2. Only if ALL conversions succeed, atomically replace the source directory.
+ *   3. On any failure, leave the source untouched and clean up the temp dir.
+ *
+ * For normal output:
+ *   Write directly to the resolved output directory.
+ */
+export declare function writeOutput(inputDir: string, files: FileEntry[], options: CliOptions, onProgress: (result: ConversionResult) => void): Promise<{
+    results: ConversionResult[];
+    outputDir: string;
+}>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAI9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC7C,OAAO,CAAC;IAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAS7D"}

package/dist/writer.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOutputDir = resolveOutputDir;
+exports.writeOutput = writeOutput;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const convert_js_1 = require("./convert.js");
+/**
+ * Determine the final output directory from CLI options.
+ * - `--out <path>` wins if provided
+ * - `--in-place` uses a temp dir (caller must finalize after success)
+ * - Default: `<inputDir>-optimized`
+ */
+function resolveOutputDir(inputDir, options) {
+    if (options.out)
+        return options.out;
+    if (options.inPlace)
+        return ''; // placeholder; writer uses a temp dir internally
+    return `${inputDir}-optimized`;
+}
+/**
+ * Run conversion and write output.
+ *
+ * For --in-place:
+ *   1. Write everything to a temporary directory.
+ *   2. Only if ALL conversions succeed, atomically replace the source directory.
+ *   3. On any failure, leave the source untouched and clean up the temp dir.
+ *
+ * For normal output:
+ *   Write directly to the resolved output directory.
+ */
+async function writeOutput(inputDir, files, options, onProgress) {
+    if (options.inPlace) {
+        return runInPlace(inputDir, files, options, onProgress);
+    }
+    const outputDir = resolveOutputDir(inputDir, options);
+    await fs_extra_1.default.ensureDir(outputDir);
+    const results = await (0, convert_js_1.convertFiles)(files, outputDir, options, onProgress);
+    return { results, outputDir };
+}
+async function runInPlace(inputDir, files, options, onProgress) {
+    const tempDir = path_1.default.join(os_1.default.tmpdir(), `webpocalypse-${process.pid}-${Date.now()}`);
+    try {
+        await fs_extra_1.default.ensureDir(tempDir);
+        const results = await (0, convert_js_1.convertFiles)(files, tempDir, options, onProgress);
+        const hasFailures = results.some((r) => !r.success);
+        if (hasFailures) {
+            // Leave source untouched; clean up temp
+            await fs_extra_1.default.remove(tempDir);
+            return { results, outputDir: inputDir };
+        }
+        // All succeeded — replace source directory atomically
+        const backupDir = `${inputDir}.bak-${Date.now()}`;
+        await fs_extra_1.default.move(inputDir, backupDir);
+        try {
+            await fs_extra_1.default.move(tempDir, inputDir);
+            await fs_extra_1.default.remove(backupDir);
+        }
+        catch (moveErr) {
+            // Restore from backup on failure
+            await fs_extra_1.default.move(backupDir, inputDir);
+            await fs_extra_1.default.remove(tempDir).catch(() => undefined);
+            throw moveErr;
+        }
+        return { results, outputDir: inputDir };
+    }
+    catch (err) {
+        await fs_extra_1.default.remove(tempDir).catch(() => undefined);
+        throw err;
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "webpocalypse",
+  "version": "1.0.0",
+  "description": "CLI tool for batch image conversion to WebP/AVIF with quality control and directory structure preservation",
+  "keywords": ["image", "conversion", "webp", "avif", "optimization", "cli"],
+  "author": "",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "bin": {
+    "webpocalypse": "dist/index.js"
+  },
+  "files": ["dist"],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.1.0",
+    "p-limit": "^6.1.0",
+    "sharp": "^0.33.4"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.14.0",
+    "typescript": "^5.4.5"
+  }
+}