@mediaproc/image 1.0.0 → 1.1.0

package/dist/commands/dilate.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 dilateCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('dilate <input>')
+        .description('Dilate image (expand bright regions)')
+        .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', () => {
+        createStandardHelp({
+            commandName: 'dilate',
+            emoji: '⚪',
+            description: 'Apply morphological dilation to expand bright regions and fill gaps. Useful for closing holes and connecting nearby objects.',
+            usage: ['dilate <input>', 'dilate <input> -o dilated.png'],
+            options: [
+                { flag: '-o, --output <path>', description: 'Output file path (default: <input>-dilated.<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: 'dilate mask.png', description: 'Expand white regions in mask' },
+                { command: 'dilate document.jpg -o filled.jpg', description: 'Fill small gaps' },
+                { command: 'dilate binary.png --verbose', description: 'Connect nearby objects' }
+            ],
+            additionalSections: [
+                {
+                    title: 'What is Dilation?',
+                    items: [
+                        'Morphological operation from image processing',
+                        'Expands bright (high-value) regions',
+                        'Shrinks dark (low-value) regions',
+                        'Opposite of erosion',
+                        'Uses 3x3 kernel by default'
+                    ]
+                },
+                {
+                    title: 'Use Cases',
+                    items: [
+                        'Fill small holes/gaps in objects',
+                        'Connect nearby components',
+                        'Expand boundaries of objects',
+                        'Remove small dark noise',
+                        'Strengthen weak edges'
+                    ]
+                },
+                {
+                    title: 'Common Workflows',
+                    items: [
+                        'Hole filling: dilate → erode (closing)',
+                        'Edge detection: subtract original from dilated',
+                        'Object joining: multiple dilations',
+                        'Mask expansion for compositing',
+                        'Feature enhancement in binary images'
+                    ]
+                },
+                {
+                    title: 'Tips',
+                    items: [
+                        'Works best on binary or high-contrast images',
+                        'Multiple dilations = stronger effect',
+                        'Combine with erode for morphological closing',
+                        'Useful before filling/connecting operations'
+                    ]
+                }
+            ],
+            tips: [
+                'Opposite effect of erode command',
+                'Use on binary/grayscale images',
+                'Apply multiple times for stronger effect',
+                'Useful for connecting nearby objects'
+            ]
+        });
+        return '';
+    });
+    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}-dilated${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(`  Operation: Morphological dilation (3x3 kernel)`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply dilation:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            // Create a 3x3 dilation kernel (all ones)
+            const dilationKernel = {
+                width: 3,
+                height: 3,
+                kernel: [1, 1, 1, 1, 1, 1, 1, 1, 1]
+            };
+            const pipeline = createSharpInstance(input).convolve(dilationKernel);
+            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('✓ Dilation 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(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply dilation'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=dilate.js.map

package/dist/commands/dilate.js.map

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

package/dist/commands/erode.d.ts

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

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

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

package/dist/commands/erode.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 erodeCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('erode <input>')
+        .description('Erode image (expand dark regions)')
+        .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: 'erode',
+                emoji: '⚫',
+                description: 'Apply morphological erosion to expand dark regions and shrink bright areas. Useful for removing noise and separating objects.',
+                usage: ['erode <input>', 'erode <input> -o eroded.png'],
+                options: [
+                    { flag: '-o, --output <path>', description: 'Output file path (default: <input>-eroded.<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: 'erode mask.png', description: 'Erode binary mask' },
+                    { command: 'erode document.jpg -o clean.jpg', description: 'Remove small bright spots' },
+                    { command: 'erode text.png --verbose', description: 'Thin text with details' }
+                ],
+                additionalSections: [
+                    {
+                        title: 'What is Erosion?',
+                        items: [
+                            'Morphological operation from image processing',
+                            'Expands dark (low-value) regions',
+                            'Shrinks bright (high-value) regions',
+                            'Opposite of dilation',
+                            'Uses 3x3 kernel by default'
+                        ]
+                    },
+                    {
+                        title: 'Use Cases',
+                        items: [
+                            'Remove small bright noise/spots',
+                            'Separate touching objects',
+                            'Thin bright features (text, lines)',
+                            'Create borders around objects',
+                            'Clean up binary masks'
+                        ]
+                    },
+                    {
+                        title: 'Common Workflows',
+                        items: [
+                            'Noise removal: erode → dilate (opening)',
+                            'Edge detection: subtract eroded from original',
+                            'Object separation: multiple erosions',
+                            'Text processing: thin characters',
+                            'Mask refinement in image segmentation'
+                        ]
+                    },
+                    {
+                        title: 'Tips',
+                        items: [
+                            'Works best on binary or high-contrast images',
+                            'Multiple erosions = stronger effect',
+                            'Combine with dilate for morphological opening',
+                            'Useful before object counting/separation'
+                        ]
+                    }
+                ],
+                tips: [
+                    'Opposite effect of dilate command',
+                    'Use on binary/grayscale images',
+                    'Apply multiple times for stronger effect',
+                    'Useful for separating connected objects'
+                ]
+            });
+    });
+    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}-eroded${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(`  Operation: Morphological erosion (3x3 kernel)`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would apply erosion:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Output: ${outputPath}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            // Erosion kernel (3x3 matrix with all values set to -1 for erosion effect)
+            const erodeKernel = {
+                width: 3,
+                height: 3,
+                kernel: [-1, -1, -1, -1, 8, -1, -1, -1, -1]
+            };
+            const pipeline = createSharpInstance(input).convolve(erodeKernel);
+            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('✓ Erosion 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(`  File size: ${(outputStats.size / 1024).toFixed(2)} KB`));
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to apply erosion'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=erode.js.map

package/dist/commands/erode.js.map

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

package/dist/commands/flatten.d.ts

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

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

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

package/dist/commands/flatten.js

@@ -0,0 +1,130 @@
+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 flattenCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('flatten <input>')
+        .description('Flatten alpha transparency onto background color')
+        .option('--background <color>', 'Background color as hex (default: #ffffff)', '#ffffff')
+        .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: 'flatten',
+            emoji: '🎨',
+            description: 'Remove alpha channel by merging transparency onto a solid background color. Essential for converting PNGs with transparency to JPEGs.',
+            usage: ['flatten <input>', 'flatten <input> --background #ff0000'],
+            options: [
+                { flag: '--background <color>', description: 'Background color as hex (default: #ffffff white)' },
+                { flag: '-o, --output <path>', description: 'Output file path (default: <input>-flat.<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: 'flatten logo.png', description: 'Flatten onto white background' },
+                { command: 'flatten image.png --background #000000', description: 'Flatten onto black' },
+                { command: 'flatten graphic.png --background #ff0000 -o red-bg.jpg', description: 'Flatten onto red and save as JPG' }
+            ],
+            additionalSections: [
+                {
+                    title: 'Use Cases',
+                    items: [
+                        'Convert PNG with transparency to JPEG',
+                        'Prepare images for platforms that don\'t support transparency',
+                        'Composite transparent images onto colored backgrounds',
+                        'Remove alpha channel to reduce file size'
+                    ]
+                },
+                {
+                    title: 'Color Formats',
+                    items: [
+                        '#ffffff - White (default)',
+                        '#000000 - Black',
+                        '#ff0000 - Red',
+                        '#00ff00 - Green',
+                        '#0000ff - Blue',
+                        'Use 6-digit hex format'
+                    ]
+                }
+            ],
+            tips: [
+                'Required when converting PNG to JPEG',
+                'White background is default',
+                'Choose background color that matches your design',
+                'Flattened images have smaller file sizes'
+            ]
+        });
+    });
+    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);
+            }
+            // Parse background color
+            const bgColor = options.background || '#ffffff';
+            const bgHex = bgColor.replace('#', '');
+            if (!/^[0-9A-Fa-f]{6}$/.test(bgHex)) {
+                spinner.fail(chalk.red('Invalid background color format. Use 6-digit hex like #ffffff'));
+                process.exit(1);
+            }
+            const r = parseInt(bgHex.substring(0, 2), 16);
+            const g = parseInt(bgHex.substring(2, 4), 16);
+            const b = parseInt(bgHex.substring(4, 6), 16);
+            const inputPath = path.parse(input);
+            const outputPath = options.output || path.join(process.cwd(), `${inputPath.name}-flat${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(`  Background: ${bgColor} (R:${r}, G:${g}, B:${b})`));
+                spinner.start('Processing...');
+            }
+            if (options.dryRun) {
+                spinner.info(chalk.yellow('Dry run mode - no changes will be made'));
+                console.log(chalk.green('✓ Would flatten image:'));
+                console.log(chalk.dim(`  Input: ${input}`));
+                console.log(chalk.dim(`  Background: ${bgColor}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).flatten({
+                background: { r, g, 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 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 flattened successfully!'));
+            console.log(chalk.dim(`  Input: ${input}`));
+            console.log(chalk.dim(`  Output: ${outputPath}`));
+            console.log(chalk.dim(`  Background: ${bgColor}`));
+            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 flatten image'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=flatten.js.map

package/dist/commands/flatten.js.map

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

package/dist/commands/flop.d.ts

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

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

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

package/dist/commands/flop.js

@@ -0,0 +1,87 @@
+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 flopCommand(imageCmd) {
+    const cmd = imageCmd
+        .command('flop <input>')
+        .description('Flip image horizontally (mirror left-right)')
+        .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: 'flop',
+            emoji: '🔄',
+            description: 'Flip image horizontally (mirror left-right). Standalone horizontal flip operation from Sharp.',
+            usage: ['flop <input>', 'flop <input> -o output.jpg'],
+            options: [
+                { flag: '-o, --output <path>', description: 'Output file path (default: <input>-flopped.<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: 'flop photo.jpg', description: 'Flip image horizontally' },
+                { command: 'flop selfie.jpg -o corrected.jpg', description: 'Correct selfie mirror effect' }
+            ],
+            tips: [
+                'Use flip command for vertical flipping',
+                'Combine with other transforms in batch operations'
+            ]
+        });
+    });
+    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}-flopped${inputPath.ext}`);
+            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 flop image:'));
+                console.log(chalk.dim(`  From: ${input}`));
+                console.log(chalk.dim(`  To: ${outputPath}`));
+                return;
+            }
+            const metadata = await createSharpInstance(input).metadata();
+            const pipeline = createSharpInstance(input).flop();
+            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('✓ Image flopped 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 flop image'));
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(errorMessage));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=flop.js.map

package/dist/commands/flop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flop.js","sourceRoot":"","sources":["../../src/commands/flop.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;AAI/D,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,MAAM,GAAG,GAAG,QAAQ;SACjB,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,MAAM,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,CAAC;SAClE,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAE7C,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE;QAC5B,OAAO,IAAI,GAAG,kBAAkB,CAAC;YAC3B,WAAW,EAAE,MAAM;YACnB,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,+FAA+F;YAC5G,KAAK,EAAE,CAAC,cAAc,EAAE,4BAA4B,CAAC;YACrD,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,mDAAmD,EAAE;gBACjG,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,oCAAoC,EAAE;gBACtF,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBACvE,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE;aAC/D;YACD,QAAQ,EAAE;gBACR,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,yBAAyB,EAAE;gBACrE,EAAE,OAAO,EAAE,kCAAkC,EAAE,WAAW,EAAE,8BAA8B,EAAE;aAC7F;YACD,IAAI,EAAE;gBACJ,wCAAwC;gBACxC,mDAAmD;aACpD;SACF,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAAoB,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC,KAAK,EAAE,CAAC;QAEnD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,WAAW,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YAE3G,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC,CAAC;gBAClD,OAAO,CAAC,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,qBAAqB,CAAC,CAAC,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;YACzD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAElC,MAAM,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE5C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/linear.d.ts

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

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

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