@mediaproc/image 1.0.0 → 1.1.0

package/dist/commands/linear.js

@@ -0,0 +1,133 @@
+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 linearCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('linear <input>')
+        .description('Apply linear formula: output = (a * input) + b')
+        .option('-a, --a <value>', 'Multiplier (default: 1)', parseFloat, 1)
+        .option('-b, --b <value>', 'Offset (default: 0)', parseFloat, 0)
+        .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');
+    cmd.addHelpText('after', () => {
+        return '\n' +
+            createStandardHelp({
+                commandName: 'linear',
+                emoji: '📐',
+                description: 'Apply linear transformation to pixel values. Formula: output = (a * input) + b. Control brightness and contrast precisely.',
+                usage: ['linear <input> -a 1.5 -b 10', 'linear <input> -a 0.5 -b 50'],
+                options: [
+                    { flag: '-a, --a <value>', description: 'Multiplier (default: 1, contrast control)' },
+                    { flag: '-b, --b <value>', description: 'Offset (default: 0, brightness control)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-linear.<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: 'linear image.jpg -a 1.5 -b 0', description: 'Increase contrast by 50%' },
+                    { command: 'linear photo.jpg -a 1 -b 50', description: 'Increase brightness by 50' },
+                    { command: 'linear pic.jpg -a 0.8 -b 20', description: 'Reduce contrast, add brightness' },
+                    { command: 'linear dark.jpg -a 2 -b 0', description: 'Double pixel values (brighten)' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Parameters',
+                        items: [
+                            'a = 1, b = 0: No change (identity)',
+                            'a > 1: Increase contrast',
+                            'a < 1: Decrease contrast',
+                            'b > 0: Increase brightness',
+                            'b < 0: Decrease brightness'
+                        ]
+                    },
+                    {
+                        title: 'Common Operations',
+                        items: [
+                            'Brighten: a=1, b=50',
+                            'Darken: a=1, b=-50',
+                            'More contrast: a=1.5, b=0',
+                            'Less contrast: a=0.5, b=0',
+                            'Invert: a=-1, b=255',
+                            'High key: a=0.5, b=128'
+                        ]
+                    },
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Precise brightness/contrast control',
+                            'Color grading with exact values',
+                            'Exposure correction',
+                            'Scientific image processing',
+                            'Batch processing with consistent values'
+                        ]
+                    }
+                ],
+                tips: [
+                    'More precise than modulate command',
+                    'Values can be negative',
+                    'Results clamped to 0-255',
+                    'Use for reproducible adjustments'
+                ]
+            });
+    });
+    cmd.action(async (input, options) => {
+        const spinner = ora('Processing image...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const a = options.a ?? 1;
+            const b = options.b ?? 0;
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-linear${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(`  Formula: (${a} * input) + ${b}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply linear transformation:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Formula: (${a} * input) + ${b}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).linear(a, b);
+            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('✓ Linear transformation applied successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Formula: (${a} * input) + ${b}`));
+            console.log(chalk.dim(`  Size: ${metadata.width}x${metadata.height}`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply linear transformation'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=linear.js.map

package/dist/commands/linear.js.map

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

package/dist/commands/recomb.d.ts

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

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

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

package/dist/commands/recomb.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';
+const spinner = ora();
+export function recombCommand(imageCmd) {
+    imageCmd
+        .command('recomb <input>')
+        .description('Recombine RGB channels using matrix')
+        .option('--matrix <values>', 'Recombination matrix (3x3) as JSON', '[[1,0,0],[0,1,0],[0,0,1]]')
+        .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 recomb command')
+        .action(async (input, options) => {
+        if (options.help) {
+            createStandardHelp({
+                commandName: 'recomb',
+                emoji: '🌈',
+                description: 'Recombine image channels using a transformation matrix. Create custom color effects by mixing R, G, B channels.',
+                usage: [
+                    'recomb <input> --matrix "[[1,0,0],[0,1,0],[0,0,1]]"',
+                    'recomb <input> --matrix "[[0,0,1],[0,1,0],[1,0,0]]" (swap R/B)'
+                ],
+                options: [
+                    { flag: '--matrix <values>', description: '3x3 matrix as JSON array (default: identity)' },
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-recomb.<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: 'recomb image.jpg --matrix "[[0,0,1],[0,1,0],[1,0,0]]"', description: 'Swap red and blue channels' },
+                    { command: 'recomb photo.jpg --matrix "[[0.5,0.5,0],[0.5,0.5,0],[0,0,1]]"', description: 'Average red/green, keep blue' },
+                    { command: 'recomb pic.jpg --matrix "[[1,0,0],[1,0,0],[1,0,0]]"', description: 'Use red channel for all' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'Matrix Format',
+                        items: [
+                            '3x3 matrix: [[R],[G],[B]]',
+                            'Each row defines output channel',
+                            'Each column represents input channel (R, G, B)',
+                            'Identity [[1,0,0],[0,1,0],[0,0,1]] = no change'
+                        ]
+                    },
+                    {
+                        title: 'Common Operations',
+                        items: [
+                            'Swap R/B: [[0,0,1],[0,1,0],[1,0,0]]',
+                            'Swap R/G: [[0,1,0],[1,0,0],[0,0,1]]',
+                            'Grayscale: [[0.33,0.33,0.33],...] (all rows same)',
+                            'Red only: [[1,0,0],[0,0,0],[0,0,0]]',
+                            'Remove red: [[0,0,0],[0,1,0],[0,0,1]]'
+                        ]
+                    },
+                    {
+                        title: 'Creative Effects',
+                        items: [
+                            'Channel shifting creates false color effects',
+                            'Mixing channels creates unique tones',
+                            'Can simulate color blindness',
+                            'Create infrared-like effects'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Identity matrix produces no change',
+                    'Values typically 0 to 1',
+                    'Can use negative values for inversions',
+                    'Useful for color correction and artistic effects'
+                ]
+            });
+            return;
+        }
+        if (!fs.existsSync(input)) {
+            spinner.fail(chalk.red(`Input file not found: ${input}`));
+            process.exit(1);
+        }
+        // Parse matrix
+        const matrixStr = options.matrix || '[[1,0,0],[0,1,0],[0,0,1]]';
+        let matrix;
+        try {
+            matrix = JSON.parse(matrixStr);
+            if (!Array.isArray(matrix) || matrix.length !== 3) {
+                throw new Error('Matrix must be 3x3');
+            }
+            for (const row of matrix) {
+                if (!Array.isArray(row) || row.length !== 3) {
+                    throw new Error('Each row must have 3 values');
+                }
+            }
+        }
+        catch (e) {
+            spinner.fail(chalk.red('Invalid matrix format. Use 3x3 JSON array like [[1,0,0],[0,1,0],[0,0,1]]'));
+            process.exit(1);
+        }
+        const inputPath = path.parse(input);
+        const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-recomb${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(`  Matrix: ${JSON.stringify(matrix)}`));
+            spinner.start('Processing...');
+        }
+        if (options.dryRun) {
+            spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+            console.log(chalk.green('✓ Would recombine channels:'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Matrix: ${JSON.stringify(matrix)}`));
+            return;
+        }
+        try {
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).recomb(matrix);
+            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('✓ Channels recombined 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(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to recombine channels'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=recomb.js.map

package/dist/commands/recomb.js.map

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

package/dist/commands/threshold.d.ts

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

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

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

package/dist/commands/threshold.js

@@ -0,0 +1,126 @@
+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 thresholdCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('threshold <input>')
+        .description('Apply threshold to image (convert to binary black/white)')
+        .option('-t, --threshold <value>', 'Threshold value 0-255 (default: 128)', parseInt, 128)
+        .option('--grayscale', 'Convert to grayscale first (recommended)', true)
+        .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');
+    cmd.addHelpText('after', () => {
+        return '\n' + createStandardHelp({
+            commandName: 'threshold',
+            emoji: '⚫⚪',
+            description: 'Convert image to pure black and white using threshold value. Pixels above threshold become white, below become black.',
+            usage: ['threshold <input>', 'threshold <input> -t 100'],
+            options: [
+                { flag: '-t, --threshold <value>', description: 'Threshold value 0-255 (default: 128)' },
+                { flag: '--grayscale', description: 'Convert to grayscale first (default: true)' },
+                { flag: '-o, --output <path>', description: 'Output file path (default: <input>-threshold.<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: 'threshold document.jpg', description: 'Binary threshold at 128' },
+                { command: 'threshold scan.jpg -t 180', description: 'Higher threshold (more white)' },
+                { command: 'threshold image.jpg -t 80', description: 'Lower threshold (more black)' },
+                { command: 'threshold photo.jpg -t 128 -o bw.png', description: 'Save as PNG' }
+            ],
+            additionalSections: [
+                {
+                    title: 'Threshold Guide',
+                    items: [
+                        '0: All pixels become white',
+                        '128: Middle threshold (default)',
+                        '255: All pixels become black',
+                        'Lower value = more white pixels',
+                        'Higher value = more black pixels'
+                    ]
+                },
+                {
+                    title: 'Use Cases',
+                    items: [
+                        'Document scanning - clean text',
+                        'OCR preprocessing',
+                        'Binary image masks',
+                        'Edge detection prep',
+                        'QR code/barcode cleanup'
+                    ]
+                }
+            ],
+            tips: [
+                'Use 128 for balanced results',
+                'Try 180-200 for dark text on light background',
+                'Try 60-80 for light text on dark background',
+                'Combine with scan-enhance for best document results'
+            ]
+        });
+    });
+    cmd.action(async (input, options) => {
+        const spinner = ora('Processing image...').start();
+        try {
+            if (!fs.existsSync(input)) {
+                spinner.fail(chalk.red(`Input file not found: ${input}`));
+                process.exit(1);
+            }
+            const thresholdValue = Math.max(0, Math.min(255, options.threshold || 128));
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-threshold${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: ${thresholdValue}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply threshold:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Threshold: ${thresholdValue}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            let pipeline = createSharpInstance(input);
+            if (options.grayscale !== false) {
+                pipeline = pipeline.grayscale();
+            }
+            pipeline = pipeline.threshold(thresholdValue);
+            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 inputStats = fs.statSync(input);
+            const outputStats = fs.statSync(outputPath);
+            const sizeDiff = ((outputStats.size - inputStats.size) / inputStats.size * 100).toFixed(2);
+            spinner.succeed(chalk.green('✓ Threshold applied successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Threshold: ${thresholdValue}`));
+            console.log(chalk.dim(`  Size: ${metadata.width}x${metadata.height}`));
+            console.log(chalk.dim(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB (${sizeDiff}%)`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply threshold'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=threshold.js.map

package/dist/commands/threshold.js.map

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

package/dist/commands/unflatten.d.ts

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

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

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

package/dist/commands/unflatten.js

@@ -0,0 +1,105 @@
+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 unflattenCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('unflatten <input>')
+        .description('Add alpha channel to RGB image (inverse of flatten)')
+        .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');
+    cmd.addHelpText('after', () => {
+        return '\n' + createStandardHelp({
+            commandName: 'unflatten',
+            emoji: '🔓',
+            description: 'Add alpha channel to image (convert RGB to RGBA). Opposite of flatten command.',
+            usage: ['unflatten <input>', 'unflatten <input> -o transparent.png'],
+            options: [
+                { flag: '-o, --output <path>', description: 'Output file path (default: <input>-unflat.png)' },
+                { 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: 'unflatten image.jpg', description: 'Add alpha channel' },
+                { command: 'unflatten photo.jpg -o with-alpha.png', description: 'Convert JPG to PNG with alpha' }
+            ],
+            additionalSections: [
+                {
+                    title: 'Use Cases',
+                    items: [
+                        'Prepare image for compositing operations',
+                        'Convert JPEG to PNG with transparency support',
+                        'Add alpha channel before applying transparency',
+                        'Prepare for further alpha manipulations'
+                    ]
+                }
+            ],
+            tips: [
+                'All pixels will be fully opaque after unflatten',
+                'Use PNG format to preserve alpha channel',
+                'Required before some compositing operations',
+                'Increases file size (adds alpha data)'
+            ]
+        });
+    });
+    cmd.action(async (input, options) => {
+        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}-unflat.png`);
+            if (options.verbose) {
+                spinner.info(chalk.blue('Configuration:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would unflatten image:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).unflatten();
+            // Unflatten typically outputs PNG to preserve alpha
+            const outputExt = path.extname(outputPath).toLowerCase();
+            if (outputExt === '.png') {
+                pipeline.png({ quality: options.quality || 90 });
+            }
+            else if (outputExt === '.webp') {
+                pipeline.webp({ quality: options.quality || 90 });
+            }
+            else {
+                // Force PNG if no extension or unsupported format
+                pipeline.png({ quality: options.quality || 90 });
+            }
+            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 unflattened 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(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB (${sizeDiff}%)`));
+            console.log(chalk.cyan('ℹ  Alpha channel added (all pixels fully opaque)'));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to unflatten image'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=unflatten.js.map

package/dist/commands/unflatten.js.map

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

package/dist/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCzC,eAAO,MAAM,IAAI,qBAAqB,CAAC;AACvC,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D/C"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmDzC,eAAO,MAAM,IAAI,qBAAqB,CAAC;AACvC,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuE/C"}