@mediaproc/image 1.0.0

package/dist/commands/dominant-color.js

@@ -0,0 +1,175 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs';
+import { createSharpInstance } from '../utils/sharp.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+export function dominantColorCommand(imageCmd) {
+    imageCmd
+        .command('dominant-color <input>')
+        .description('Extract dominant colors from an image')
+        .option('-c, --count <number>', 'Number of dominant colors to extract (default: 5)', parseInt, 5)
+        .option('--export <path>', 'Export color palette to JSON file')
+        .option('-v, --verbose', 'Show detailed color information')
+        .option('--help', 'Display help for dominant-color command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'dominant-color',
+                emoji: '🎨',
+                description: 'Quickly extract the most dominant colors from an image. Perfect for color palette generation, theme creation, and color analysis.',
+                usage: ['dominant-color <input>', 'dominant-color <input> --count 3', 'dominant-color photo.jpg --export colors.json'],
+                options: [
+                    { flag: '-c, --count <number>', description: 'Number of dominant colors to extract (default: 5, max: 10)' },
+                    { flag: '--export <path>', description: 'Export color palette to JSON file' },
+                    { flag: '-v, --verbose', description: 'Show detailed RGB/HSL values' }
+                ],
+                examples: [
+                    { command: 'dominant-color photo.jpg', description: 'Extract top 5 dominant colors' },
+                    { command: 'dominant-color photo.jpg --count 3', description: 'Extract top 3 colors' },
+                    { command: 'dominant-color photo.jpg --export palette.json', description: 'Export colors to JSON' },
+                    { command: 'dominant-color logo.png -c 2 -v', description: 'Get 2 colors with details' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Generate color palettes for design',
+                            'Brand color extraction from logos',
+                            'Theme generation for websites',
+                            'Color scheme for UI/UX design',
+                            'Quick color analysis',
+                            'Match colors across images'
+                        ]
+                    },
+                    {
+                        title: 'Output Format',
+                        items: [
+                            'Hex color code (#RRGGBB)',
+                            'RGB values (r, g, b)',
+                            'Percentage of image coverage',
+                            'Optional HSL values with --verbose'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Use --count to control number of colors',
+                    'Export to JSON for use in design tools',
+                    'Smaller images process faster',
+                    'Works best with high-contrast images'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Analyzing colors...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const count = Math.min(Math.max(options.count || 5, 1), 10);
+            // Get image stats which includes dominant color
+            const sharpInstance = createSharpInstance(input);
+            const metadata = await sharpInstance.metadata();
+            // Resize for faster processing
+            const smallImage = await sharpInstance
+                .resize(100, 100, { fit: 'inside' })
+                .raw()
+                .toBuffer({ resolveWithObject: true });
+            const { data, info } = smallImage;
+            const pixels = info.width * info.height;
+            const channels = info.channels;
+            // Color histogram approach
+            const colorMap = new Map();
+            for (let i = 0; i < data.length; i += channels) {
+                const r = data[i];
+                const g = data[i + 1];
+                const b = data[i + 2];
+                // Bucket colors to reduce variations
+                const bucketSize = 16;
+                const bucketR = Math.floor(r / bucketSize) * bucketSize;
+                const bucketG = Math.floor(g / bucketSize) * bucketSize;
+                const bucketB = Math.floor(b / bucketSize) * bucketSize;
+                const key = `${bucketR},${bucketG},${bucketB}`;
+                colorMap.set(key, (colorMap.get(key) || 0) + 1);
+            }
+            // Sort by frequency
+            const sortedColors = Array.from(colorMap.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, count);
+            const dominantColors = sortedColors.map(([rgb, count]) => {
+                const [r, g, b] = rgb.split(',').map(Number);
+                const hex = `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
+                const percentage = ((count / pixels) * 100).toFixed(2);
+                // Calculate HSL
+                const rNorm = r / 255;
+                const gNorm = g / 255;
+                const bNorm = b / 255;
+                const max = Math.max(rNorm, gNorm, bNorm);
+                const min = Math.min(rNorm, gNorm, bNorm);
+                const l = (max + min) / 2;
+                let s = 0;
+                let h = 0;
+                if (max !== min) {
+                    const d = max - min;
+                    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+                    if (max === rNorm) {
+                        h = ((gNorm - bNorm) / d + (gNorm < bNorm ? 6 : 0)) / 6;
+                    }
+                    else if (max === gNorm) {
+                        h = ((bNorm - rNorm) / d + 2) / 6;
+                    }
+                    else {
+                        h = ((rNorm - gNorm) / d + 4) / 6;
+                    }
+                }
+                return {
+                    hex,
+                    rgb: { r, g, b },
+                    hsl: {
+                        h: Math.round(h * 360),
+                        s: Math.round(s * 100),
+                        l: Math.round(l * 100)
+                    },
+                    percentage: parseFloat(percentage)
+                };
+            });
+            spinner.succeed(chalk.green('✓ Color analysis complete!\n'));
+            console.log(chalk.bold.cyan(`🎨 Top ${dominantColors.length} Dominant Colors:\n`));
+            dominantColors.forEach((color, index) => {
+                const colorPreview = chalk.bgHex(color.hex)('    ');
+                console.log(colorPreview + ' ' + chalk.bold(color.hex) + chalk.dim(` (${color.percentage}%)`));
+                if (options.verbose) {
+                    console.log(chalk.dim(`   RGB: (${color.rgb.r}, ${color.rgb.g}, ${color.rgb.b})`));
+                    console.log(chalk.dim(`   HSL: (${color.hsl.h}°, ${color.hsl.s}%, ${color.hsl.l}%)`));
+                }
+                if (index < dominantColors.length - 1) {
+                    console.log('');
+                }
+            });
+            // Export to JSON
+            if (options.export) {
+                const exportData = {
+                    source: input,
+                    imageSize: {
+                        width: metadata.width,
+                        height: metadata.height
+                    },
+                    colors: dominantColors
+                };
+                fs.writeFileSync(options.export, JSON.stringify(exportData, null, 2));
+                console.log(chalk.dim(`\n✓ Palette exported to: ${options.export}`));
+            }
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to analyze colors'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=dominant-color.js.map

package/dist/commands/dominant-color.js.map

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

package/dist/commands/extend.d.ts

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

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

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

package/dist/commands/extend.js

@@ -0,0 +1,146 @@
+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 extendCommand(imageCmd) {
+    imageCmd
+        .command('extend <input>')
+        .description('Add padding/border around image')
+        .option('--top <pixels>', 'Top padding in pixels', parseInt, 0)
+        .option('--bottom <pixels>', 'Bottom padding in pixels', parseInt, 0)
+        .option('--left <pixels>', 'Left padding in pixels', parseInt, 0)
+        .option('--right <pixels>', 'Right padding in pixels', parseInt, 0)
+        .option('--all <pixels>', 'All sides padding in pixels', parseInt)
+        .option('--background <color>', 'Background color (default: white)', 'white')
+        .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 extend command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'extend',
+                emoji: '🖼️',
+                description: 'Add padding or borders around images. Perfect for creating frames, adding space, or preparing images for specific aspect ratios.',
+                usage: ['extend <input> --all <pixels>', 'extend <input> --top 50 --bottom 50', 'extend <input> --all 20 --background black'],
+                options: [
+                    { flag: '--all <pixels>', description: 'Padding on all sides (shortcut)' },
+                    { flag: '--top <pixels>', description: 'Top padding in pixels' },
+                    { flag: '--bottom <pixels>', description: 'Bottom padding in pixels' },
+                    { flag: '--left <pixels>', description: 'Left padding in pixels' },
+                    { flag: '--right <pixels>', description: 'Right padding in pixels' },
+                    { flag: '--background <color>', description: 'Background color (default: white, accepts hex/rgb/names)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-extended.<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: 'extend photo.jpg --all 50', description: 'Add 50px padding on all sides' },
+                    { command: 'extend image.png --all 20 --background black', description: 'Add black border' },
+                    { command: 'extend pic.jpg --top 100 --bottom 100', description: 'Add padding top/bottom only' },
+                    { command: 'extend photo.jpg --all 30 --background "#ff0000"', description: 'Add red border' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Adding borders/frames to images',
+                            'Creating letterbox/pillarbox effect',
+                            'Preparing images for specific dimensions',
+                            'Adding space for text overlay',
+                            'Social media post formatting'
+                        ]
+                    },
+                    {
+                        title: 'Color Options',
+                        items: [
+                            'white - Default white background',
+                            'black - Black border',
+                            'transparent - Transparent padding (PNG)',
+                            '#ff0000 - Hex colors',
+                            'rgb(255,0,0) - RGB colors'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Use --all for uniform padding',
+                    'Combine with watermark for branded images',
+                    'Use transparent background for PNGs',
+                    'Match background to image for seamless look'
+                ]
+            });
+            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}-extended${inputPath.ext}`);
+            // Handle --all shortcut
+            const top = options.all !== undefined ? options.all : (options.top || 0);
+            const bottom = options.all !== undefined ? options.all : (options.bottom || 0);
+            const left = options.all !== undefined ? options.all : (options.left || 0);
+            const right = options.all !== undefined ? options.all : (options.right || 0);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                console.log(chalk.dim(`  Padding: top=${top}, bottom=${bottom}, left=${left}, right=${right}`));
+                console.log(chalk.dim(`  Background: ${options.background || 'white'}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would extend image:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                console.log(chalk.dim(`  Padding: ${top}/${right}/${bottom}/${left} (top/right/bottom/left)`));
+                return;
+            }
+            const originalMetadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).extend({
+                top,
+                bottom,
+                left,
+                right,
+                background: options.background || 'white'
+            });
+            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 extended 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(`  Padding: top=${top}, bottom=${bottom}, left=${left}, right=${right}`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to extend image'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=extend.js.map

package/dist/commands/extend.js.map

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

package/dist/commands/extract.d.ts

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

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

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

package/dist/commands/extract.js

@@ -0,0 +1,169 @@
+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 extractCommand(imageCmd) {
+    imageCmd
+        .command('extract <input>')
+        .description('Extract color channels or specific regions from image')
+        .option('-c, --channel <channel>', 'Extract channel: red, green, blue, alpha')
+        .option('--left <pixels>', 'X position for region extraction', parseInt)
+        .option('--top <pixels>', 'Y position for region extraction', parseInt)
+        .option('-w, --width <pixels>', 'Width for region extraction', parseInt)
+        .option('-h, --height <pixels>', 'Height for region extraction', parseInt)
+        .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 extract command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'extract',
+                emoji: '✂️',
+                description: 'Extract specific color channels (R, G, B, alpha) or rectangular regions from images. Useful for analysis, masking, and advanced editing.',
+                usage: ['extract <input> --channel red', 'extract <input> --left 100 --top 100 --width 500 --height 500', 'extract <input> --channel alpha'],
+                options: [
+                    { flag: '-c, --channel <channel>', description: 'Extract color channel: red, green, blue, alpha' },
+                    { flag: '--left <pixels>', description: 'X position for region extraction' },
+                    { flag: '--top <pixels>', description: 'Y position for region extraction' },
+                    { flag: '-w, --width <pixels>', description: 'Width for region extraction' },
+                    { flag: '-h, --height <pixels>', description: 'Height for region extraction' },
+                    { 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: 'extract photo.jpg --channel red', description: 'Extract red channel only' },
+                    { command: 'extract image.png --channel alpha', description: 'Extract alpha/transparency channel' },
+                    { command: 'extract photo.jpg --left 100 --top 100 --width 500 --height 500', description: 'Extract 500x500 region' },
+                    { command: 'extract image.jpg --channel blue -o blue-channel.png', description: 'Save blue channel separately' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Channel Extraction',
+                        items: [
+                            'red - Extract red color channel',
+                            'green - Extract green color channel',
+                            'blue - Extract blue color channel',
+                            'alpha - Extract transparency/alpha channel'
+                        ]
+                    },
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Analyze color distribution in images',
+                            'Create custom masks from channels',
+                            'Extract transparency for processing',
+                            'Crop specific regions precisely',
+                            'Prepare channels for compositing'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Channel extraction produces grayscale images',
+                    'Use alpha extraction for transparency masks',
+                    'Region extraction preserves original colors',
+                    'Combine with other commands for advanced workflows'
+                ]
+            });
+            process.exit(0);
+        }
+        const spinner = ora('Extracting...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const inputPath = path.parse(input);
+            const suffix = options.channel ? `-${options.channel}` : '-extracted';
+            const outputPath = options.output || path.join(inputPath.dir, `${inputPath.name}${suffix}${inputPath.ext}`);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                if (options.channel) {
+                    console.log(chalk.dim(`  Channel: ${options.channel}`));
+                }
+                else {
+                    console.log(chalk.dim(`  Region: ${options.left},${options.top} ${options.width}x${options.height}`));
+                }
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would extract from image:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                if (options.channel) {
+                    console.log(chalk.dim(`  Channel: ${options.channel}`));
+                }
+                else {
+                    console.log(chalk.dim(`  Region: ${options.left},${options.top} ${options.width}x${options.height}`));
+                }
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            let pipeline = createSharpInstance(input);
+            if (options.channel) {
+                // Extract color channel
+                const channelMap = {
+                    red: 0,
+                    green: 1,
+                    blue: 2,
+                    alpha: 3
+                };
+                const channelIndex = channelMap[options.channel];
+                if (channelIndex === undefined) {
+                    spinner.fail(chalk.red('Invalid channel. Use: red, green, blue, or alpha'));
+                    process.exit(1);
+                }
+                // Extract specific channel
+                if (channelIndex === 3) {
+                    // Alpha channel
+                    pipeline = pipeline.ensureAlpha().extractChannel(channelIndex);
+                }
+                else {
+                    pipeline = pipeline.extractChannel(channelIndex);
+                }
+            }
+            else {
+                // Extract region
+                if (!options.left || !options.top || !options.width || !options.height) {
+                    spinner.fail(chalk.red('Region extraction requires --left, --top, --width, and --height'));
+                    process.exit(1);
+                }
+                pipeline = pipeline.extract({
+                    left: options.left,
+                    top: options.top,
+                    width: options.width,
+                    height: options.height
+                });
+            }
+            await pipeline.toFile(outputPath);
+            const outputStats = fs.statSync(outputPath);
+            const outputMetadata = await createSharpInstance(outputPath).metadata();
+            spinner.succeed(chalk.green('✓ Extraction completed successfully!'));
+            console.log(chalk.dim(`  Input: ${input} (${metadata.width}x${metadata.height})`));
+            console.log(chalk.dim(`  Output: ${outputPath} (${outputMetadata.width}x${outputMetadata.height})`));
+            if (options.channel) {
+                console.log(chalk.dim(`  Channel: ${options.channel}`));
+            }
+            else {
+                console.log(chalk.dim(`  Region: ${options.left},${options.top} → ${options.width}x${options.height}`));
+            }
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)}KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to extract'));
+            if (options.verbose) {
+                console.error(chalk.red('Error details:'), error);
+            }
+            else {
+                console.error(chalk.red(error.message));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=extract.js.map

package/dist/commands/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/commands/extract.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,uDAAuD,CAAC;SACpE,MAAM,CAAC,yBAAyB,EAAE,0CAA0C,CAAC;SAC7E,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,EAAE,QAAQ,CAAC;SACvE,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,EAAE,QAAQ,CAAC;SACtE,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,QAAQ,CAAC;SACvE,MAAM,CAAC,uBAAuB,EAAE,8BAA8B,EAAE,QAAQ,CAAC;SACzE,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,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,0IAA0I;gBACvJ,KAAK,EAAE,CAAC,+BAA+B,EAAE,+DAA+D,EAAE,iCAAiC,CAAC;gBAC5I,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,gDAAgD,EAAE;oBAClG,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC5E,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC3E,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,6BAA6B,EAAE;oBAC5E,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC9E,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE;oBAChE,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,iCAAiC,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBACvF,EAAE,OAAO,EAAE,mCAAmC,EAAE,WAAW,EAAE,oCAAoC,EAAE;oBACnG,EAAE,OAAO,EAAE,iEAAiE,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBACrH,EAAE,OAAO,EAAE,sDAAsD,EAAE,WAAW,EAAE,8BAA8B,EAAE;iBACjH;gBACD,kBAAkB,EAAE;oBAClB;wBACE,KAAK,EAAE,oBAAoB;wBAC3B,KAAK,EAAE;4BACL,iCAAiC;4BACjC,qCAAqC;4BACrC,mCAAmC;4BACnC,4CAA4C;yBAC7C;qBACF;oBACD;wBACE,KAAK,EAAE,WAAW;wBAClB,KAAK,EAAE;4BACL,sCAAsC;4BACtC,mCAAmC;4BACnC,qCAAqC;4BACrC,iCAAiC;4BACjC,kCAAkC;yBACnC;qBACF;iBACF;gBACD,IAAI,EAAE;oBACJ,8CAA8C;oBAC9C,6CAA6C;oBAC7C,6CAA6C;oBAC7C,oDAAoD;iBACrD;aACF,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC;QAE7C,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,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;YACtE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YAE5G,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,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACxG,CAAC;gBACD,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,6BAA6B,CAAC,CAAC,CAAC;gBACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACxG,CAAC;gBACD,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,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,wBAAwB;gBACxB,MAAM,UAAU,GAAG;oBACjB,GAAG,EAAE,CAAC;oBACN,KAAK,EAAE,CAAC;oBACR,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,CAAC;iBACT,CAAC;gBAEF,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,OAAkC,CAAC,CAAC;gBAE5E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;oBAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBAED,2BAA2B;gBAC3B,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;oBACvB,gBAAgB;oBAChB,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAC,YAA6B,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,iBAAiB;gBACjB,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACvE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC,CAAC;oBAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBAED,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;oBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAElC,MAAM,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;YAExE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,KAAK,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,UAAU,KAAK,cAAc,CAAC,KAAK,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC1G,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAC7C,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/flip.d.ts

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

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

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