@mediaproc/image 1.0.0

package/dist/commands/convert.js

@@ -0,0 +1,136 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import fs from 'fs';
+import { createSharpInstance } from '../utils/sharp.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+export function convertCommand(imageCmd) {
+    imageCmd
+        .command('convert <input>')
+        .description('Convert image to different format')
+        .option('-f, --format <format>', 'Output format: jpg, png, webp, avif, tiff, gif', 'webp')
+        .option('-o, --output <path>', 'Output file path')
+        .option('-q, --quality <quality>', 'Quality (1-100)', parseInt, 90)
+        .option('--compression <level>', 'PNG compression level (0-9)', parseInt, 9)
+        .option('--progressive', 'Use progressive/interlaced format')
+        .option('--dry-run', 'Show what would be done without executing')
+        .option('-v, --verbose', 'Verbose output')
+        .option('--help', 'Display help for convert command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'convert',
+                emoji: '🔄',
+                description: 'Convert images between different formats. Supports modern formats like WebP and AVIF for better compression and quality.',
+                usage: ['convert <input> -f <format>', 'convert <input> -f <format> -o <output>', 'convert <input> -f webp -q 85'],
+                options: [
+                    { flag: '-f, --format <format>', description: 'Output format: jpg, png, webp, avif, tiff, gif (default: webp)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>.<format>)' },
+                    { flag: '-q, --quality <quality>', description: 'Output quality 1-100 (default: 90)' },
+                    { flag: '--compression <level>', description: 'PNG compression level 0-9 (default: 9)' },
+                    { flag: '--progressive', description: 'Use progressive/interlaced format' },
+                    { flag: '--dry-run', description: 'Preview changes without executing' },
+                    { flag: '-v, --verbose', description: 'Show detailed output' }
+                ],
+                examples: [
+                    { command: 'convert photo.jpg -f webp', description: 'Convert JPG to WebP (modern, smaller)' },
+                    { command: 'convert image.png -f avif -q 80', description: 'Convert to AVIF with quality 80' },
+                    { command: 'convert pic.webp -f jpg', description: 'Convert WebP back to JPG' },
+                    { command: 'convert photo.jpg -f png --compression 9', description: 'Convert to PNG with max compression' },
+                    { command: 'convert image.png -f jpg --progressive', description: 'Convert to progressive JPG' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Format Guide',
+                        items: [
+                            'WebP - Modern format, 25-35% smaller than JPG/PNG',
+                            'AVIF - Newest format, even smaller than WebP',
+                            'JPG - Best for photos, lossy compression',
+                            'PNG - Best for graphics/transparency, lossless',
+                            'TIFF - Professional/print, very large files',
+                            'GIF - Animations, limited colors'
+                        ]
+                    }
+                ],
+                tips: [
+                    'WebP and AVIF offer best compression for web',
+                    'Use PNG for images with transparency',
+                    'AVIF may not be supported in all browsers yet',
+                    'Progressive JPGs load gradually (better for web)'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Processing image...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const validFormats = ['jpg', 'jpeg', 'png', 'webp', 'avif', 'tiff', 'gif'];
+            if (!validFormats.includes(options.format)) {
+                spinner.fail(chalk.red(`Invalid format. Supported: ${validFormats.join(', ')}`));
+                process.exit(1);
+            }
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}.${options.format}`);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                console.log(chalk.dim(`  Format: ${options.format}`));
+                console.log(chalk.dim(`  Quality: ${options.quality || 90}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would convert image:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Format: ${options.format}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            let pipeline = createSharpInstance(input);
+            // Apply format-specific options
+            if (options.format === 'jpg' || options.format === 'jpeg') {
+                pipeline.jpeg({ quality: options.quality || 90, progressive: options.progressive || false });
+            }
+            else if (options.format === 'png') {
+                pipeline.png({ quality: options.quality || 90, compressionLevel: options.compression || 9, progressive: options.progressive || false });
+            }
+            else if (options.format === 'webp') {
+                pipeline.webp({ quality: options.quality || 90 });
+            }
+            else if (options.format === 'avif') {
+                pipeline.avif({ quality: options.quality || 90 });
+            }
+            else if (options.format === 'tiff') {
+                pipeline.tiff({ quality: options.quality || 90 });
+            }
+            else if (options.format === 'gif') {
+                pipeline.gif();
+            }
+            await pipeline.toFile(outputPath);
+            const inputStats = fs.statSync(input);
+            const outputStats = fs.statSync(outputPath);
+            const sizeDiff = ((outputStats.size - inputStats.size) / inputStats.size * 100).toFixed(2);
+            spinner.succeed(chalk.green('✓ Image converted successfully!'));
+            console.log(chalk.dim(`  Input: ${input} (${metadata.format?.toUpperCase()})`));
+            console.log(chalk.dim(`  Output: ${outputPath} (${options.format.toUpperCase()})`));
+            console.log(chalk.dim(`  Size: ${metadata.width}x${metadata.height}`));
+            console.log(chalk.dim(`  File size: ${(inputStats.size / 1024).toFixed(2)}KB → ${(outputStats.size / 1024).toFixed(2)}KB (${sizeDiff > '0' ? '+' : ''}${sizeDiff}%)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to convert image'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=convert.js.map

package/dist/commands/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/commands/convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,QAAQ;SACL,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,EAAE,MAAM,CAAC;SACzF,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,MAAM,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,CAAC;SAClE,MAAM,CAAC,uBAAuB,EAAE,6BAA6B,EAAE,QAAQ,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,eAAe,EAAE,mCAAmC,CAAC;SAC5D,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA+B,EAAE,EAAE;QAC/D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,kBAAkB,CAAC;gBACjB,WAAW,EAAE,SAAS;gBACtB,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,0HAA0H;gBACvI,KAAK,EAAE,CAAC,6BAA6B,EAAE,yCAAyC,EAAE,+BAA+B,CAAC;gBAClH,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,gEAAgE,EAAE;oBAChH,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,8CAA8C,EAAE;oBAC5F,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,oCAAoC,EAAE;oBACtF,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,wCAAwC,EAAE;oBACxF,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,mCAAmC,EAAE;oBAC3E,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,mCAAmC,EAAE;oBACvE,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE;iBAC/D;gBACD,QAAQ,EAAE;oBACR,EAAE,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBAC9F,EAAE,OAAO,EAAE,iCAAiC,EAAE,WAAW,EAAE,iCAAiC,EAAE;oBAC9F,EAAE,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBAC/E,EAAE,OAAO,EAAE,0CAA0C,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBAC3G,EAAE,OAAO,EAAE,wCAAwC,EAAE,WAAW,EAAE,4BAA4B,EAAE;iBACjG;gBACD,kBAAkB,EAAE;oBAClB;wBACE,KAAK,EAAE,cAAc;wBACrB,KAAK,EAAE;4BACL,mDAAmD;4BACnD,8CAA8C;4BAC9C,0CAA0C;4BAC1C,gDAAgD;4BAChD,6CAA6C;4BAC7C,kCAAkC;yBACnC;qBACF;iBACF;gBACD,IAAI,EAAE;oBACJ,8CAA8C;oBAC9C,sCAAsC;oBACtC,+CAA+C;oBAC/C,kDAAkD;iBACnD;aACF,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC,KAAK,EAAE,CAAC;QAEnD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3E,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAErG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC9D,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACjC,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC,CAAC;gBACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,IAAI,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAE1C,gCAAgC;YAChC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC;YAC/F,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC;YAC1I,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACpC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;YAED,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAElC,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAE3F,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,KAAK,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC;QAEzK,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACnD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/convolve.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function convolveCommand(imageCmd: Command): void;
+//# sourceMappingURL=convolve.d.ts.map

package/dist/commands/convolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convolve.d.ts","sourceRoot":"","sources":["../../src/commands/convolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA+JvD"}

package/dist/commands/convolve.js

@@ -0,0 +1,171 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import fs from 'fs';
+import { createSharpInstance } from '../utils/sharp.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+// Predefined kernels
+const KERNELS = {
+    sharpen: [[0, -1, 0], [-1, 5, -1], [0, -1, 0]],
+    emboss: [[-2, -1, 0], [-1, 1, 1], [0, 1, 2]],
+    'edge-detect': [[-1, -1, -1], [-1, 8, -1], [-1, -1, -1]],
+    'box-blur': [[1 / 9, 1 / 9, 1 / 9], [1 / 9, 1 / 9, 1 / 9], [1 / 9, 1 / 9, 1 / 9]],
+    'gaussian-blur': [[1 / 16, 2 / 16, 1 / 16], [2 / 16, 4 / 16, 2 / 16], [1 / 16, 2 / 16, 1 / 16]],
+    laplacian: [[0, 1, 0], [1, -4, 1], [0, 1, 0]],
+    'high-pass': [[-1, -1, -1], [-1, 8, -1], [-1, -1, -1]]
+};
+export function convolveCommand(imageCmd) {
+    imageCmd
+        .command('convolve <input>')
+        .description('Apply custom convolution kernel (advanced filtering)')
+        .option('-k, --kernel <preset>', `Predefined kernel: ${Object.keys(KERNELS).join(', ')}`)
+        .option('--custom <matrix>', 'Custom kernel as JSON array: "[[1,2,1],[2,4,2],[1,2,1]]"')
+        .option('--scale <value>', 'Kernel scale factor', parseFloat, 1)
+        .option('--offset <value>', 'Kernel offset', parseFloat, 0)
+        .option('-o, --output <path>', 'Output file path')
+        .option('--dry-run', 'Show what would be done without executing')
+        .option('-v, --verbose', 'Verbose output')
+        .option('--help', 'Display help for convolve command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'convolve',
+                emoji: '🔬',
+                description: 'Apply custom convolution kernels for advanced image filtering. Create edge detection, embossing, custom blurs, and more.',
+                usage: ['convolve <input> --kernel sharpen', 'convolve <input> --kernel emboss', 'convolve <input> --custom "[[1,2,1],[2,4,2],[1,2,1]]"'],
+                options: [
+                    { flag: '-k, --kernel <preset>', description: 'Predefined: sharpen, emboss, edge-detect, box-blur, gaussian-blur, laplacian, high-pass' },
+                    { flag: '--custom <matrix>', description: 'Custom kernel as JSON array' },
+                    { flag: '--scale <value>', description: 'Kernel scale factor (default: 1)' },
+                    { flag: '--offset <value>', description: 'Kernel offset value (default: 0)' },
+                    { flag: '-o, --output <path>', description: 'Output file path' },
+                    { flag: '--dry-run', description: 'Preview changes without executing' },
+                    { flag: '-v, --verbose', description: 'Show detailed output' }
+                ],
+                examples: [
+                    { command: 'convolve image.jpg --kernel emboss', description: 'Apply emboss effect' },
+                    { command: 'convolve photo.png --kernel edge-detect', description: 'Detect edges' },
+                    { command: 'convolve pic.jpg --kernel gaussian-blur', description: 'Apply Gaussian blur' },
+                    { command: 'convolve image.jpg --custom "[[0,-1,0],[-1,5,-1],[0,-1,0]]"', description: 'Custom sharpening kernel' },
+                    { command: 'convolve photo.jpg --kernel laplacian --scale 2', description: 'Enhanced Laplacian with scale' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Predefined Kernels',
+                        items: [
+                            'sharpen - Enhance edges and details',
+                            'emboss - Create 3D raised effect',
+                            'edge-detect - Highlight edges',
+                            'box-blur - Simple average blur',
+                            'gaussian-blur - Smooth weighted blur',
+                            'laplacian - Edge detection (2nd derivative)',
+                            'high-pass - Emphasize high frequencies'
+                        ]
+                    },
+                    {
+                        title: 'Custom Kernels',
+                        items: [
+                            'Must be 3x3 or 5x5 matrix',
+                            'Format: JSON array of arrays',
+                            'Values typically sum to 1 (or use scale)',
+                            'Negative values create special effects',
+                            'Center value is key reference point'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Start with predefined kernels',
+                    'Use scale to normalize custom kernels',
+                    'Emboss works great on textures',
+                    'Edge detection useful for analysis'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Applying convolution...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            let kernel;
+            let kernelName;
+            // Determine kernel to use
+            if (options.kernel) {
+                const kernelStr = String(options.kernel);
+                if (!(kernelStr in KERNELS)) {
+                    spinner.fail(chalk.red(`Invalid kernel. Available: ${Object.keys(KERNELS).join(', ')}`));
+                    process.exit(1);
+                }
+                kernel = KERNELS[kernelStr];
+                kernelName = kernelStr;
+            }
+            else if (options.custom) {
+                try {
+                    kernel = JSON.parse(options.custom);
+                    kernelName = 'custom';
+                }
+                catch (e) {
+                    spinner.fail(chalk.red('Invalid custom kernel JSON format'));
+                    process.exit(1);
+                }
+            }
+            else {
+                spinner.fail(chalk.red('Please specify --kernel or --custom'));
+                process.exit(1);
+            }
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(inputPath.dir, `${inputPath.name}-${kernelName}${inputPath.ext}`);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                console.log(chalk.dim(`  Kernel: ${kernelName}`));
+                console.log(chalk.dim(`  Matrix: ${JSON.stringify(kernel)}`));
+                if (options.scale !== 1)
+                    console.log(chalk.dim(`  Scale: ${options.scale}`));
+                if (options.offset !== 0)
+                    console.log(chalk.dim(`  Offset: ${options.offset}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply convolution:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Kernel: ${kernelName}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            // Flatten kernel for Sharp (expects 1D array)
+            const flatKernel = kernel.flat();
+            const kernelSize = Math.sqrt(flatKernel.length);
+            await createSharpInstance(input)
+                .convolve({
+                width: kernelSize,
+                height: kernelSize,
+                kernel: flatKernel,
+                scale: options.scale,
+                offset: options.offset
+            })
+                .toFile(outputPath);
+            const outputStats = fs.statSync(outputPath);
+            spinner.succeed(chalk.green('✓ Convolution applied successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Size: ${metadata.width}x${metadata.height}`));
+            console.log(chalk.dim(`  Kernel: ${kernelName} (${kernelSize}x${kernelSize})`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply convolution'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=convolve.js.map

package/dist/commands/convolve.js.map

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

package/dist/commands/crop.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function cropCommand(imageCmd: Command): void;
+//# sourceMappingURL=crop.d.ts.map

package/dist/commands/crop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crop.d.ts","sourceRoot":"","sources":["../../src/commands/crop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAyHnD"}

package/dist/commands/crop.js

@@ -0,0 +1,120 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import fs from 'fs';
+import { createSharpInstance } from '../utils/sharp.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+export function cropCommand(imageCmd) {
+    imageCmd
+        .command('crop <input>')
+        .description('Crop image to specified dimensions and position')
+        .option('-x, --x <x>', 'X position (left offset in pixels)', parseInt, 0)
+        .option('-y, --y <y>', 'Y position (top offset in pixels)', parseInt, 0)
+        .option('-w, --width <width>', 'Crop width in pixels', parseInt)
+        .option('-h, --height <height>', 'Crop height in pixels', parseInt)
+        .option('-o, --output <path>', 'Output file path')
+        .option('-q, --quality <quality>', 'Quality (1-100)', parseInt, 90)
+        .option('--dry-run', 'Show what would be done without executing')
+        .option('-v, --verbose', 'Verbose output')
+        .option('--help', 'Display help for crop command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'crop',
+                emoji: '✂️',
+                description: 'Crop images to specific dimensions and position. Extract a rectangular region from your image with pixel-perfect precision.',
+                usage: ['crop <input> -w <width> -h <height>', 'crop <input> -x <x> -y <y> -w <width> -h <height>'],
+                options: [
+                    { flag: '-x, --x <x>', description: 'X position - left offset in pixels (default: 0)' },
+                    { flag: '-y, --y <y>', description: 'Y position - top offset in pixels (default: 0)' },
+                    { flag: '-w, --width <width>', description: 'Crop width in pixels (required)' },
+                    { flag: '-h, --height <height>', description: 'Crop height in pixels (required)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-cropped.<ext>)' },
+                    { flag: '-q, --quality <quality>', description: 'Output quality 1-100 (default: 90)' },
+                    { flag: '--dry-run', description: 'Preview changes without executing' },
+                    { flag: '-v, --verbose', description: 'Show detailed output' }
+                ],
+                examples: [
+                    { command: 'crop photo.jpg -w 800 -h 600', description: 'Crop 800x600 from top-left corner' },
+                    { command: 'crop image.png -x 100 -y 100 -w 500 -h 500', description: 'Crop square from specific position' },
+                    { command: 'crop pic.jpg -w 1920 -h 1080 -o thumbnail.jpg', description: 'Crop to Full HD dimensions' }
+                ],
+                tips: ['Use --dry-run to verify crop dimensions', 'Crop dimensions must fit within source image']
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Processing image...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            if (!options.width || !options.height) {
+                spinner.fail(chalk.red('Both width and height are required for cropping'));
+                process.exit(1);
+            }
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-cropped${inputPath.ext}`);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                console.log(chalk.dim(`  Position: (${options.x || 0}, ${options.y || 0})`));
+                console.log(chalk.dim(`  Size: ${options.width}x${options.height}`));
+                spinner.start('Processing...');
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            if ((options.x || 0) + options.width > (metadata.width || 0)) {
+                spinner.fail(chalk.red(`Crop width exceeds image bounds`));
+                process.exit(1);
+            }
+            if ((options.y || 0) + options.height > (metadata.height || 0)) {
+                spinner.fail(chalk.red(`Crop height exceeds image bounds`));
+                process.exit(1);
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would crop image:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Position: (${options.x || 0}, ${options.y || 0})`));
+                console.log(chalk.dim(`  Size: ${options.width}x${options.height}`));
+                return;
+            }
+            const pipeline = createSharpInstance(input).extract({
+                left: options.x || 0,
+                top: options.y || 0,
+                width: options.width,
+                height: options.height
+            });
+            const outputExt = path.extname(outputPath).toLowerCase();
+            if (outputExt === '.jpg' || outputExt === '.jpeg') {
+                pipeline.jpeg({ quality: options.quality || 90 });
+            }
+            else if (outputExt === '.png') {
+                pipeline.png({ quality: options.quality || 90 });
+            }
+            else if (outputExt === '.webp') {
+                pipeline.webp({ quality: options.quality || 90 });
+            }
+            await pipeline.toFile(outputPath);
+            spinner.succeed(chalk.green('✓ Image cropped successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Original size: ${metadata.width}x${metadata.height}`));
+            console.log(chalk.dim(`  Cropped size: ${options.width}x${options.height}`));
+            console.log(chalk.dim(`  Position: (${options.x || 0}, ${options.y || 0})`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to crop image'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=crop.js.map

package/dist/commands/crop.js.map

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

package/dist/commands/dominant-color.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function dominantColorCommand(imageCmd: Command): void;
+//# sourceMappingURL=dominant-color.d.ts.map

package/dist/commands/dominant-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dominant-color.d.ts","sourceRoot":"","sources":["../../src/commands/dominant-color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA4L5D"}