@mediaproc/image 1.0.0

package/dist/commands/thumbnail.js

@@ -0,0 +1,131 @@
+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 thumbnailCommand(imageCmd) {
+    imageCmd
+        .command('thumbnail <input>')
+        .description('Generate thumbnail from image')
+        .option('-s, --size <size>', 'Thumbnail size in pixels (default: 150)', parseInt, 150)
+        .option('-o, --output <path>', 'Output file path')
+        .option('-q, --quality <quality>', 'Quality (1-100)', parseInt, 85)
+        .option('--fit <fit>', 'Fit mode: cover, contain, fill, inside, outside', 'cover')
+        .option('--dry-run', 'Show what would be done without executing')
+        .option('-v, --verbose', 'Verbose output')
+        .option('--help', 'Display help for thumbnail command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'thumbnail',
+                emoji: '🖼️',
+                description: 'Generate thumbnails from images. Perfect for creating preview images, avatar sizes, or gallery thumbnails.',
+                usage: ['thumbnail <input>', 'thumbnail <input> -s <size>', 'thumbnail <input> -s 200 --fit contain'],
+                options: [
+                    { flag: '-s, --size <size>', description: 'Thumbnail size in pixels (default: 150, creates 150x150)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-thumb.<ext>)' },
+                    { flag: '-q, --quality <quality>', description: 'Output quality 1-100 (default: 85)' },
+                    { flag: '--fit <fit>', description: 'Fit mode: cover, contain, fill, inside, outside (default: cover)' },
+                    { flag: '--dry-run', description: 'Preview changes without executing' },
+                    { flag: '-v, --verbose', description: 'Show detailed output' }
+                ],
+                examples: [
+                    { command: 'thumbnail photo.jpg', description: 'Generate 150x150 thumbnail (default)' },
+                    { command: 'thumbnail image.png -s 200', description: 'Generate 200x200 thumbnail' },
+                    { command: 'thumbnail pic.jpg -s 100 --fit contain', description: '100x100 thumbnail with padding' },
+                    { command: 'thumbnail photo.jpg -s 300 -q 90', description: '300x300 high-quality thumbnail' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Common Sizes',
+                        items: [
+                            '64x64 - Favicon, small icons',
+                            '150x150 - Default thumbnail size',
+                            '200x200 - Medium thumbnails',
+                            '300x300 - Large thumbnails',
+                            '512x512 - App icons, large previews'
+                        ]
+                    },
+                    {
+                        title: 'Fit Modes',
+                        items: [
+                            'cover - Fill entire area, crop if needed (default)',
+                            'contain - Fit inside with padding',
+                            'fill - Stretch to fill (may distort)',
+                            'inside - Shrink if larger, no enlargement',
+                            'outside - Enlarge to cover, crop if needed'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Cover mode works best for profile pictures and avatars',
+                    'Contain mode preserves full image with padding',
+                    'Quality 85 is optimal for thumbnails',
+                    'Use WebP format for smaller file sizes'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Generating thumbnail...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-thumb${inputPath.ext}`);
+            const size = options.size || 150;
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                console.log(chalk.dim(`  Size: ${size}x${size}`));
+                console.log(chalk.dim(`  Fit: ${options.fit || 'cover'}`));
+                console.log(chalk.dim(`  Quality: ${options.quality || 85}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would generate thumbnail:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Size: ${size}x${size}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input)
+                .resize(size, size, {
+                fit: options.fit || 'cover',
+                position: 'center'
+            });
+            const outputExt = path.extname(outputPath).toLowerCase();
+            if (outputExt === '.jpg' || outputExt === '.jpeg') {
+                pipeline.jpeg({ quality: options.quality || 85 });
+            }
+            else if (outputExt === '.png') {
+                pipeline.png({ quality: options.quality || 85 });
+            }
+            else if (outputExt === '.webp') {
+                pipeline.webp({ quality: options.quality || 85 });
+            }
+            await pipeline.toFile(outputPath);
+            const outputStats = fs.statSync(outputPath);
+            spinner.succeed(chalk.green('✓ Thumbnail generated successfully!'));
+            console.log(chalk.dim(`  Input: ${input} (${metadata.width}x${metadata.height})`));
+            console.log(chalk.dim(`  Output: ${outputPath} (${size}x${size})`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to generate thumbnail'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=thumbnail.js.map

package/dist/commands/thumbnail.js.map

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

package/dist/commands/tint.d.ts

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

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

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

package/dist/commands/tint.js

@@ -0,0 +1,123 @@
+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 tintCommand(imageCmd) {
+    imageCmd
+        .command('tint <input>')
+        .description('Apply color tint to image')
+        .option('-c, --color <color>', 'Tint color (hex, rgb, or name, default: #0000ff)', '#0000ff')
+        .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 tint command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'tint',
+                emoji: '🎨',
+                description: 'Apply color tint overlay to images. Great for creating artistic effects, mood adjustments, or brand color filters.',
+                usage: ['tint <input>', 'tint <input> -c <color>', 'tint <input> -c "#ff6600"'],
+                options: [
+                    { flag: '-c, --color <color>', description: 'Tint color as hex (#ff0000), rgb (rgb(255,0,0)), or name (red)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-tinted.<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: 'tint photo.jpg -c blue', description: 'Apply blue tint' },
+                    { command: 'tint image.png -c "#ff6600"', description: 'Apply orange tint (hex color)' },
+                    { command: 'tint pic.jpg -c "rgb(255, 0, 128)"', description: 'Apply pink tint (RGB)' },
+                    { command: 'tint photo.jpg -c red', description: 'Apply red tint' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Color Formats',
+                        items: [
+                            'Hex: #ff0000 or #f00 (red)',
+                            'RGB: rgb(255, 0, 0) (red)',
+                            'Names: red, blue, green, yellow, etc.',
+                            'Popular: sepia (#704214), cyan (#00ffff)'
+                        ]
+                    },
+                    {
+                        title: 'Common Tints',
+                        items: [
+                            'Sepia: #704214 - Vintage/warm look',
+                            'Blue: #0066cc - Cool/cold mood',
+                            'Orange: #ff6600 - Warm/sunset effect',
+                            'Purple: #9933cc - Creative/artistic',
+                            'Green: #00cc66 - Nature/fresh feel'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Subtle tints work better than strong colors',
+                    'Use sepia (#704214) for vintage effects',
+                    'Blue tints create cool, calm atmospheres',
+                    'Orange/red tints add warmth to photos'
+                ]
+            });
+            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 inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-tinted${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(`  Color: ${options.color || '#0000ff'}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply tint:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Color: ${options.color || '#0000ff'}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).tint(options.color || '#0000ff');
+            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);
+            const outputStats = fs.statSync(outputPath);
+            spinner.succeed(chalk.green('✓ Tint 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(`  Color: ${options.color || '#0000ff'}`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply tint'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=tint.js.map

package/dist/commands/tint.js.map

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

package/dist/commands/trim.d.ts

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

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

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

package/dist/commands/trim.js

@@ -0,0 +1,123 @@
+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 trimCommand(imageCmd) {
+    imageCmd
+        .command('trim <input>')
+        .description('Trim/remove border edges from image')
+        .option('-t, --threshold <value>', 'Threshold for edge detection (1-100, default: 10)', parseInt, 10)
+        .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 trim command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'trim',
+                emoji: '✂️',
+                description: 'Automatically trim/remove boring border edges from images. Perfect for removing whitespace, borders, or uniform backgrounds.',
+                usage: ['trim <input>', 'trim <input> -t <threshold>', 'trim <input> -t 20'],
+                options: [
+                    { flag: '-t, --threshold <value>', description: 'Edge detection threshold 1-100 (default: 10, higher = more aggressive)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-trimmed.<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: 'trim photo.jpg', description: 'Auto-trim with default threshold (10)' },
+                    { command: 'trim image.png -t 5', description: 'Gentle trim (sensitive)' },
+                    { command: 'trim pic.jpg -t 20', description: 'Aggressive trim' },
+                    { command: 'trim screenshot.png', description: 'Remove screenshot borders' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Threshold Guide',
+                        items: [
+                            '1-5 - Very sensitive (removes slight differences)',
+                            '10 - Default (balanced)',
+                            '15-25 - Aggressive (removes more)',
+                            '25+ - Very aggressive (may over-trim)'
+                        ]
+                    },
+                    {
+                        title: 'Best For',
+                        items: [
+                            'Scanned documents with borders',
+                            'Screenshots with padding',
+                            'Images with solid color borders',
+                            'Product photos on white backgrounds',
+                            'Auto-cropping uniform edges'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Start with default threshold (10)',
+                    'Lower threshold for subtle edges',
+                    'Higher threshold for obvious borders',
+                    'Perfect for batch processing scans'
+                ]
+            });
+            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 inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-trimmed${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(`  Threshold: ${options.threshold || 10}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would trim image:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Threshold: ${options.threshold || 10}`));
+                return;
+            }
+            const originalMetadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).trim({ threshold: options.threshold || 10 });
+            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);
+            const outputMetadata = await createSharpInstance(outputPath).metadata();
+            const outputStats = fs.statSync(outputPath);
+            spinner.succeed(chalk.green('✓ Image trimmed successfully!'));
+            console.log(chalk.dim(`  Input: ${input} (${originalMetadata.width}x${originalMetadata.height})`));
+            console.log(chalk.dim(`  Output: ${outputPath} (${outputMetadata.width}x${outputMetadata.height})`));
+            console.log(chalk.dim(`  Threshold: ${options.threshold || 10}`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to trim image'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=trim.js.map

package/dist/commands/trim.js.map

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

package/dist/commands/vignette.d.ts

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

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

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

package/dist/commands/vignette.js

@@ -0,0 +1,139 @@
+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 vignetteCommand(imageCmd) {
+    imageCmd
+        .command('vignette <input>')
+        .description('Add vignette effect (darkened edges)')
+        .option('-s, --strength <value>', 'Vignette strength 0-100 (default: 50)', parseFloat, 50)
+        .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 vignette command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'vignette',
+                emoji: '🌓',
+                description: 'Add vignette effect by darkening or lightening the edges of an image. Creates focus on the center and adds artistic mood.',
+                usage: ['vignette <input>', 'vignette <input> -s 70', 'vignette <input> -o artistic.jpg'],
+                options: [
+                    { flag: '-s, --strength <value>', description: 'Vignette strength 0-100 (default: 50)' },
+                    { 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: 'vignette photo.jpg', description: 'Apply default vignette' },
+                    { command: 'vignette portrait.png -s 80', description: 'Strong vignette effect' },
+                    { command: 'vignette landscape.jpg -s 30', description: 'Subtle edge darkening' },
+                    { command: 'vignette image.jpg -o artistic.jpg', description: 'Save with vignette' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Strength Guide',
+                        items: [
+                            '0-20 - Very subtle, barely noticeable',
+                            '30-50 - Moderate, natural look (recommended)',
+                            '60-80 - Strong, dramatic effect',
+                            '90-100 - Very intense, artistic'
+                        ]
+                    },
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Portrait photography - focus on subject',
+                            'Vintage/retro effects',
+                            'Artistic mood creation',
+                            'Direct viewer attention to center',
+                            'Wedding and event photography',
+                            'Social media posts'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Start with 50 and adjust to taste',
+                    'Works great with portraits',
+                    'Combine with sepia for vintage look',
+                    'Lower strength for natural results'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Adding vignette...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const strength = Math.max(0, Math.min(100, options.strength || 50)) / 100;
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(inputPath.dir, `${inputPath.name}-vignette${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(`  Strength: ${(strength * 100).toFixed(0)}%`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would add vignette:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Strength: ${(strength * 100).toFixed(0)}%`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const width = metadata.width;
+            const height = metadata.height;
+            // Create radial gradient for vignette
+            const centerX = width / 2;
+            const centerY = height / 2;
+            const maxRadius = Math.sqrt(centerX * centerX + centerY * centerY);
+            if (options.verbose) {
+                console.log(chalk.dim(`  Center: (${centerX}, ${centerY})`));
+                console.log(chalk.dim(`  Max radius: ${maxRadius.toFixed(2)}px`));
+                console.log(chalk.dim(`  Strength: ${strength}`));
+            }
+            // Create vignette overlay using SVG
+            const vignetteOverlay = Buffer.from(`
+          <svg width="${width}" height="${height}">
+            <defs>
+              <radialGradient id="vignette" cx="50%" cy="50%" r="70%">
+                <stop offset="40%" style="stop-color:white;stop-opacity:0" />
+                <stop offset="100%" style="stop-color:black;stop-opacity:${strength}" />
+              </radialGradient>
+            </defs>
+            <rect width="${width}" height="${height}" fill="url(#vignette)" />
+          </svg>
+        `);
+            await createSharpInstance(input)
+                .composite([{
+                    input: vignetteOverlay,
+                    blend: 'multiply'
+                }])
+                .toFile(outputPath);
+            const outputStats = fs.statSync(outputPath);
+            spinner.succeed(chalk.green('✓ Vignette added successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Size: ${width}x${height}`));
+            console.log(chalk.dim(`  Strength: ${(strength * 100).toFixed(0)}%`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to add vignette'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=vignette.js.map

package/dist/commands/vignette.js.map

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

package/dist/commands/watermark.d.ts

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

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

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