@teamflojo/floimg 0.2.0 → 0.3.0

package/QUICK_START.md

@@ -0,0 +1,199 @@
+# Quick Start Guide
+
+Get started with floimg in seconds using `npx` - no installation required.
+
+## Try It Now
+
+```bash
+# Generate a QR code
+npx @teamflojo/floimg qr "https://floimg.com" -o qr.png
+
+# Create a chart
+npx @teamflojo/floimg chart bar --labels "Q1,Q2,Q3" --values "10,20,30" -o chart.png
+
+# Resize an image
+npx @teamflojo/floimg resize photo.jpg 800x600 -o thumbnail.jpg
+
+# Convert format (PNG to WebP)
+npx @teamflojo/floimg convert image.png -o image.webp
+```
+
+## How Plugin Auto-Install Works
+
+floimg is modular. The core package is lightweight, and plugins are installed on-demand.
+
+When you run a command that requires a plugin (like `qr` or `chart`), floimg will:
+
+1. Check if the required plugin is installed
+2. If not, prompt you to install it
+3. Install and run your command
+
+```
+$ npx @teamflojo/floimg qr "https://example.com"
+
+🔍 The 'qr' command requires @teamflojo/floimg-qr
+   QR Code Generator
+
+Install it now? (y/n): y
+📦 Installing @teamflojo/floimg-qr...
+✅ Installed!
+
+✅ QR code saved to: qr.png
+```
+
+**After the first run**, the plugin is cached and subsequent runs are fast.
+
+## Interactive Mode
+
+Run floimg with no arguments to see an interactive menu:
+
+```bash
+npx @teamflojo/floimg
+```
+
+This shows all available commands and examples.
+
+## Command Reference
+
+### QR Code
+
+```bash
+floimg qr <text> [options]
+
+Options:
+  -o, --out <path>           Output file (default: qr.png)
+  -s, --size <pixels>        Size in pixels (default: 300)
+  -f, --format <format>      png or svg (default: png)
+  -e, --error-correction     L, M, Q, or H (default: M)
+  --dark <color>             Dark color hex (default: #000000)
+  --light <color>            Light color hex (default: #ffffff)
+
+Examples:
+  floimg qr "https://floimg.com" -o qr.png
+  floimg qr "Hello World" --size 400 --format svg -o hello.svg
+  floimg qr "https://example.com" --error-correction H --dark "#1a1a2e"
+```
+
+### Chart
+
+```bash
+floimg chart <type> [options]
+
+Types: bar, line, pie, doughnut, radar, polarArea, scatter
+
+Options:
+  -o, --out <path>           Output file (default: chart.png)
+  -l, --labels <items>       Comma-separated labels
+  -v, --values <items>       Comma-separated values
+  -d, --data <file>          JSON file with Chart.js config
+  --title <text>             Chart title
+  -w, --width <pixels>       Width (default: 500)
+  -h, --height <pixels>      Height (default: 300)
+  -f, --format <format>      png, svg, or webp (default: png)
+
+Examples:
+  floimg chart bar --labels "A,B,C" --values "10,20,30" -o chart.png
+  floimg chart pie --labels "Yes,No" --values "70,30" --title "Survey Results"
+  floimg chart line --data sales.json -o sales-chart.png
+```
+
+### Resize
+
+```bash
+floimg resize <input> <size> [options]
+
+Size formats: WIDTHxHEIGHT (e.g., 800x600) or WIDTH (e.g., 800)
+
+Options:
+  -o, --out <path>           Output file (default: input-resized.ext)
+  --fit <mode>               cover, contain, fill, inside, outside
+  --position <pos>           center, top, bottom, left, right, etc.
+  --background <color>       Background color for contain mode
+
+Examples:
+  floimg resize photo.jpg 800x600 -o thumbnail.jpg
+  floimg resize hero.png 1200 -o hero-resized.png
+  floimg resize logo.png 200x200 --fit contain --background "#ffffff"
+```
+
+### Convert
+
+```bash
+floimg convert <input> [options]
+
+Options:
+  -o, --out <path>           Output file (format inferred from extension)
+  -t, --to <format>          Target format: png, jpg, webp, avif, svg
+  -q, --quality <number>     Quality for lossy formats (1-100)
+
+Examples:
+  floimg convert photo.png -o photo.webp
+  floimg convert image.jpg --to avif -o optimized.avif
+  floimg convert screenshot.png -o screenshot.jpg --quality 85
+```
+
+## Performance Tips
+
+### First Run
+
+The first run with npx will:
+- Download the @teamflojo/floimg package
+- Compile native dependencies (sharp, canvas)
+- This takes ~10-15 seconds
+
+### Subsequent Runs
+
+After the first run:
+- npx caches the package in `~/.npm/_npx/`
+- Runs take ~2-3 seconds
+- This is normal and matches tools like prettier, eslint
+
+### For Frequent Use
+
+If you use floimg often, install it globally for faster startup:
+
+```bash
+npm install -g @teamflojo/floimg
+```
+
+Then just run `floimg` directly (no npx needed).
+
+## Troubleshooting
+
+### "Cannot find module" errors
+
+This usually means native dependencies failed to compile. Try:
+
+```bash
+# Clear npx cache and retry
+rm -rf ~/.npm/_npx
+npx @teamflojo/floimg doctor
+```
+
+### Plugin not installing
+
+If auto-install fails in CI/scripts (non-interactive mode):
+
+```bash
+# Pre-install plugins explicitly
+npm install @teamflojo/floimg-qr @teamflojo/floimg-quickchart
+
+# Then run commands
+npx @teamflojo/floimg qr "text" --no-auto-install
+```
+
+### Permission errors
+
+If you get EACCES errors:
+
+```bash
+# Fix npm permissions
+sudo chown -R $(whoami) ~/.npm
+```
+
+## Next Steps
+
+- **[Full CLI Reference](https://floimg.com/docs/cli)** - All commands and options
+- **[Library API](https://floimg.com/docs/api)** - Use floimg in your code
+- **[MCP Integration](https://floimg.com/docs/mcp)** - Use with Claude/AI agents
+- **[Plugin Development](https://floimg.com/docs/plugins)** - Create custom generators

package/dist/cli/commands/chart.d.ts

@@ -0,0 +1,20 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for generating charts
+ *
+ * This command auto-installs @teamflojo/floimg-quickchart if not present.
+ *
+ * @example
+ * ```bash
+ * # Bar chart with inline data
+ * floimg chart bar --labels "Q1,Q2,Q3,Q4" --values "10,20,30,40" -o chart.png
+ *
+ * # Chart from JSON file
+ * floimg chart line --data sales.json -o sales-chart.png
+ *
+ * # Pie chart with title
+ * floimg chart pie --labels "A,B,C" --values "30,50,20" --title "Distribution"
+ * ```
+ */
+export declare const chartCommand: Command;
+//# sourceMappingURL=chart.d.ts.map

package/dist/cli/commands/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/chart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,SAqHrB,CAAC"}

package/dist/cli/commands/chart.js

@@ -0,0 +1,126 @@
+import { readFile, writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+import { loadPlugin, showNpxTip } from "../utils/plugin-loader.js";
+/**
+ * Shorthand command for generating charts
+ *
+ * This command auto-installs @teamflojo/floimg-quickchart if not present.
+ *
+ * @example
+ * ```bash
+ * # Bar chart with inline data
+ * floimg chart bar --labels "Q1,Q2,Q3,Q4" --values "10,20,30,40" -o chart.png
+ *
+ * # Chart from JSON file
+ * floimg chart line --data sales.json -o sales-chart.png
+ *
+ * # Pie chart with title
+ * floimg chart pie --labels "A,B,C" --values "30,50,20" --title "Distribution"
+ * ```
+ */
+export const chartCommand = new Command("chart")
+    .description("Generate a chart (auto-installs @teamflojo/floimg-quickchart if needed)")
+    .argument("<type>", "Chart type: bar, line, pie, doughnut, radar, polarArea, scatter")
+    .option("-o, --out <path>", "Output file path (default: chart.png)", "chart.png")
+    .option("-d, --data <file>", "JSON file with Chart.js data configuration")
+    .option("-l, --labels <items>", "Comma-separated labels (e.g., 'Q1,Q2,Q3,Q4')")
+    .option("-v, --values <items>", "Comma-separated values (e.g., '10,20,30,40')")
+    .option("--title <text>", "Chart title")
+    .option("-w, --width <pixels>", "Width in pixels", "500")
+    .option("-h, --height <pixels>", "Height in pixels", "300")
+    .option("--background <color>", "Background color", "transparent")
+    .option("-f, --format <format>", "Output format: png, svg, webp", "png")
+    .option("--no-auto-install", "Don't prompt to install missing plugins")
+    .option("--config <path>", "Path to config file")
+    .action(async (type, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Load the QuickChart plugin (auto-installs if needed)
+        const quickchartPlugin = await loadPlugin("quickchart", options.autoInstall !== false);
+        if (!quickchartPlugin) {
+            process.exit(1);
+        }
+        client.registerGenerator(quickchartPlugin.default());
+        // Build chart data
+        let chartData;
+        if (options.data) {
+            // Load from JSON file
+            const fileContent = await readFile(options.data, "utf-8");
+            chartData = JSON.parse(fileContent);
+        }
+        else if (options.labels && options.values) {
+            // Build from command line options
+            const labels = options.labels.split(",").map((s) => s.trim());
+            const values = options.values.split(",").map((s) => parseFloat(s.trim()));
+            chartData = {
+                labels,
+                datasets: [
+                    {
+                        label: options.title || "Data",
+                        data: values,
+                    },
+                ],
+            };
+        }
+        else {
+            console.error("Error: Provide --data <file> or both --labels and --values");
+            console.error("");
+            console.error("Examples:");
+            console.error('  floimg chart bar --labels "A,B,C" --values "10,20,30" -o chart.png');
+            console.error("  floimg chart line --data sales.json -o chart.png");
+            process.exit(1);
+        }
+        // Build chart options
+        const chartOptions = {};
+        if (options.title) {
+            chartOptions.plugins = {
+                title: {
+                    display: true,
+                    text: options.title,
+                },
+            };
+        }
+        const blob = await client.generate({
+            generator: "quickchart",
+            params: {
+                type,
+                data: chartData,
+                options: chartOptions,
+                width: parseInt(options.width, 10),
+                height: parseInt(options.height, 10),
+                backgroundColor: options.background,
+                format: options.format,
+            },
+        });
+        // Determine output path with correct extension
+        let outPath = options.out;
+        const extMap = {
+            png: ".png",
+            svg: ".svg",
+            webp: ".webp",
+        };
+        if (outPath === "chart.png" && options.format !== "png") {
+            outPath = `chart${extMap[options.format] || ".png"}`;
+        }
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const result = await client.save(blob, outPath);
+            console.log(`✅ Chart saved to: ${result.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, blob.bytes);
+            console.log(`✅ Chart saved to: ${outPath}`);
+        }
+        // Show tip for npx users
+        showNpxTip();
+    }
+    catch (error) {
+        console.error("Error generating chart:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=chart.js.map

package/dist/cli/commands/chart.js.map

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

package/dist/cli/commands/convert.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for converting image formats
+ *
+ * @example
+ * ```bash
+ * # Convert to WebP (format inferred from output extension)
+ * floimg convert input.png -o output.webp
+ *
+ * # Explicit format specification
+ * floimg convert input.png --to webp -o output.webp
+ *
+ * # With quality setting
+ * floimg convert input.png -o output.jpg --quality 85
+ * ```
+ */
+export declare const convertCommand: Command;
+//# sourceMappingURL=convert.d.ts.map

package/dist/cli/commands/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/convert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,SA2FvB,CAAC"}

package/dist/cli/commands/convert.js

@@ -0,0 +1,122 @@
+import { readFile, writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+/**
+ * Detect MIME type from file extension
+ */
+function detectMime(filepath) {
+    const ext = filepath.split(".").pop()?.toLowerCase();
+    const mimeMap = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        webp: "image/webp",
+        avif: "image/avif",
+        svg: "image/svg+xml",
+    };
+    return mimeMap[ext || ""] || "image/png";
+}
+/**
+ * Get format from output path extension
+ */
+function getFormatFromPath(filepath) {
+    return detectMime(filepath);
+}
+/**
+ * Shorthand command for converting image formats
+ *
+ * @example
+ * ```bash
+ * # Convert to WebP (format inferred from output extension)
+ * floimg convert input.png -o output.webp
+ *
+ * # Explicit format specification
+ * floimg convert input.png --to webp -o output.webp
+ *
+ * # With quality setting
+ * floimg convert input.png -o output.jpg --quality 85
+ * ```
+ */
+export const convertCommand = new Command("convert")
+    .description("Convert image format (shorthand for transform --op convert)")
+    .argument("<input>", "Input image file")
+    .option("-o, --out <path>", "Output file path (format inferred from extension)")
+    .option("-t, --to <format>", "Target format: png, jpg, jpeg, webp, avif, svg")
+    .option("-q, --quality <number>", "Quality for lossy formats (1-100)", "80")
+    .option("--config <path>", "Path to config file")
+    .action(async (input, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Read input file
+        const inputBytes = await readFile(input);
+        const inputMime = detectMime(input);
+        const inputBlob = {
+            bytes: inputBytes,
+            mime: inputMime,
+        };
+        // Determine target format
+        let targetFormat;
+        if (options.to) {
+            // Explicit format specified
+            const formatMap = {
+                png: "image/png",
+                jpg: "image/jpeg",
+                jpeg: "image/jpeg",
+                webp: "image/webp",
+                avif: "image/avif",
+                svg: "image/svg+xml",
+            };
+            targetFormat = formatMap[options.to.toLowerCase()] || "image/png";
+        }
+        else if (options.out) {
+            // Infer from output extension
+            const inferred = getFormatFromPath(options.out);
+            if (!inferred) {
+                console.error("Error: Could not infer format from output path.");
+                console.error("Use --to to specify format explicitly.");
+                process.exit(1);
+            }
+            targetFormat = inferred;
+        }
+        else {
+            console.error("Error: Must specify --out or --to.");
+            process.exit(1);
+        }
+        const result = await client.transform({
+            blob: inputBlob,
+            op: "convert",
+            to: targetFormat,
+            params: {
+                quality: parseInt(options.quality, 10),
+            },
+        });
+        // Determine output path
+        const extMap = {
+            "image/png": "png",
+            "image/jpeg": "jpg",
+            "image/webp": "webp",
+            "image/avif": "avif",
+            "image/svg+xml": "svg",
+        };
+        const newExt = extMap[targetFormat] || "png";
+        const outPath = options.out || input.replace(/\.[^.]+$/, `.${newExt}`);
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const saveResult = await client.save(result, outPath);
+            console.log(`Converted image saved to: ${saveResult.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, result.bytes);
+            console.log(`Converted image saved to: ${outPath}`);
+        }
+        console.log(`Format: ${inputMime} → ${result.mime}`);
+    }
+    catch (error) {
+        console.error("Error converting image:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=convert.js.map

package/dist/cli/commands/convert.js.map

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

package/dist/cli/commands/qr.d.ts

@@ -0,0 +1,20 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for generating QR codes
+ *
+ * This command auto-installs @teamflojo/floimg-qr if not present.
+ *
+ * @example
+ * ```bash
+ * # Basic usage - text as first argument
+ * floimg qr "https://floimg.com" -o qr.png
+ *
+ * # With options
+ * floimg qr "https://floimg.com" --size 400 --format svg -o qr.svg
+ *
+ * # High error correction
+ * floimg qr "https://floimg.com" --error-correction H
+ * ```
+ */
+export declare const qrCommand: Command;
+//# sourceMappingURL=qr.d.ts.map

package/dist/cli/commands/qr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/qr.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,SAqElB,CAAC"}

package/dist/cli/commands/qr.js

@@ -0,0 +1,82 @@
+import { writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+import { loadPlugin, showNpxTip } from "../utils/plugin-loader.js";
+/**
+ * Shorthand command for generating QR codes
+ *
+ * This command auto-installs @teamflojo/floimg-qr if not present.
+ *
+ * @example
+ * ```bash
+ * # Basic usage - text as first argument
+ * floimg qr "https://floimg.com" -o qr.png
+ *
+ * # With options
+ * floimg qr "https://floimg.com" --size 400 --format svg -o qr.svg
+ *
+ * # High error correction
+ * floimg qr "https://floimg.com" --error-correction H
+ * ```
+ */
+export const qrCommand = new Command("qr")
+    .description("Generate a QR code (auto-installs @teamflojo/floimg-qr if needed)")
+    .argument("<text>", "Text or URL to encode in the QR code")
+    .option("-o, --out <path>", "Output file path (default: qr.png)", "qr.png")
+    .option("-s, --size <pixels>", "Size in pixels", "300")
+    .option("-f, --format <format>", "Output format: png, svg", "png")
+    .option("-e, --error-correction <level>", "Error correction: L, M, Q, H", "M")
+    .option("-m, --margin <modules>", "Quiet zone margin", "4")
+    .option("--dark <color>", "Dark color (hex)", "#000000")
+    .option("--light <color>", "Light color (hex)", "#ffffff")
+    .option("--no-auto-install", "Don't prompt to install missing plugins")
+    .option("--config <path>", "Path to config file")
+    .action(async (text, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Load the QR plugin (auto-installs if needed)
+        const qrPlugin = await loadPlugin("qr", options.autoInstall !== false);
+        if (!qrPlugin) {
+            process.exit(1);
+        }
+        client.registerGenerator(qrPlugin.default());
+        const blob = await client.generate({
+            generator: "qr",
+            params: {
+                text,
+                width: parseInt(options.size, 10),
+                format: options.format,
+                errorCorrectionLevel: options.errorCorrection,
+                margin: parseInt(options.margin, 10),
+                color: {
+                    dark: options.dark,
+                    light: options.light,
+                },
+            },
+        });
+        // Determine output path with correct extension
+        let outPath = options.out;
+        if (outPath === "qr.png" && options.format === "svg") {
+            outPath = "qr.svg";
+        }
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const result = await client.save(blob, outPath);
+            console.log(`✅ QR code saved to: ${result.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, blob.bytes);
+            console.log(`✅ QR code saved to: ${outPath}`);
+        }
+        // Show tip for npx users
+        showNpxTip();
+    }
+    catch (error) {
+        console.error("Error generating QR code:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=qr.js.map

package/dist/cli/commands/qr.js.map

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

package/dist/cli/commands/resize.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for resizing images
+ *
+ * @example
+ * ```bash
+ * # Resize to specific dimensions
+ * floimg resize input.jpg 800x600 -o output.jpg
+ *
+ * # Resize width only (maintain aspect ratio)
+ * floimg resize input.jpg 800 -o output.jpg
+ *
+ * # Fit within bounds
+ * floimg resize input.jpg 800x600 --fit contain -o output.jpg
+ * ```
+ */
+export declare const resizeCommand: Command;
+//# sourceMappingURL=resize.d.ts.map

package/dist/cli/commands/resize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/resize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,SAqEtB,CAAC"}

package/dist/cli/commands/resize.js

@@ -0,0 +1,100 @@
+import { readFile, writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+/**
+ * Parse size argument in format "WIDTHxHEIGHT" or just "WIDTH"
+ */
+function parseSize(size) {
+    if (size.includes("x")) {
+        const [w, h] = size.split("x").map((s) => parseInt(s, 10));
+        return { width: w, height: h };
+    }
+    // Single number = width, maintain aspect ratio
+    return { width: parseInt(size, 10) };
+}
+/**
+ * Detect MIME type from file extension
+ */
+function detectMime(filepath) {
+    const ext = filepath.split(".").pop()?.toLowerCase();
+    const mimeMap = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        webp: "image/webp",
+        avif: "image/avif",
+        svg: "image/svg+xml",
+    };
+    return mimeMap[ext || ""] || "image/png";
+}
+/**
+ * Shorthand command for resizing images
+ *
+ * @example
+ * ```bash
+ * # Resize to specific dimensions
+ * floimg resize input.jpg 800x600 -o output.jpg
+ *
+ * # Resize width only (maintain aspect ratio)
+ * floimg resize input.jpg 800 -o output.jpg
+ *
+ * # Fit within bounds
+ * floimg resize input.jpg 800x600 --fit contain -o output.jpg
+ * ```
+ */
+export const resizeCommand = new Command("resize")
+    .description("Resize an image (shorthand for transform --op resize)")
+    .argument("<input>", "Input image file")
+    .argument("<size>", "Target size: WIDTHxHEIGHT or WIDTH (e.g., 800x600 or 800)")
+    .option("-o, --out <path>", "Output file path")
+    .option("--fit <mode>", "Fit mode: cover, contain, fill, inside, outside", "cover")
+    .option("--position <pos>", "Position when cropping: center, top, bottom, left, right, etc.", "center")
+    .option("--background <color>", "Background color for contain mode", "#ffffff")
+    .option("--config <path>", "Path to config file")
+    .action(async (input, size, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Read input file
+        const inputBytes = await readFile(input);
+        const mime = detectMime(input);
+        const inputBlob = {
+            bytes: inputBytes,
+            mime,
+        };
+        // Parse size
+        const { width, height } = parseSize(size);
+        const result = await client.transform({
+            blob: inputBlob,
+            op: "resize",
+            params: {
+                width,
+                height,
+                fit: options.fit,
+                position: options.position,
+                background: options.background,
+            },
+        });
+        // Determine output path
+        const outPath = options.out || input.replace(/(\.[^.]+)$/, "-resized$1");
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const saveResult = await client.save(result, outPath);
+            console.log(`Resized image saved to: ${saveResult.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, result.bytes);
+            console.log(`Resized image saved to: ${outPath}`);
+        }
+        if (result.width && result.height) {
+            console.log(`New size: ${result.width}x${result.height}`);
+        }
+    }
+    catch (error) {
+        console.error("Error resizing image:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=resize.js.map

package/dist/cli/commands/resize.js.map

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

package/dist/cli/index.js

@@ -9,6 +9,13 @@ import { pluginsCommand } from "./commands/plugins.js";
 import { mcpCommand } from "./commands/mcp.js";
 import { filterCommand, presetCommand } from "./commands/filter.js";
 import { textCommand } from "./commands/text.js";
+// Shorthand commands for common operations
+import { qrCommand } from "./commands/qr.js";
+import { resizeCommand } from "./commands/resize.js";
+import { convertCommand } from "./commands/convert.js";
+import { chartCommand } from "./commands/chart.js";
+// Interactive mode
+import { showInteractiveMenu, shouldShowInteractiveMenu } from "./interactive.js";
 import { readFile } from "fs/promises";
 import { fileURLToPath } from "url";
 import { dirname, join, resolve } from "path";
@@ -30,6 +37,7 @@ program
     .name("floimg")
     .description("Universal image workflow engine for developers and AI agents")
     .version(version);
+// Core commands (full API)
 program.addCommand(generateCommand);
 program.addCommand(transformCommand);
 program.addCommand(saveCommand);
@@ -40,6 +48,11 @@ program.addCommand(mcpCommand);
 program.addCommand(filterCommand);
 program.addCommand(presetCommand);
 program.addCommand(textCommand);
+// Shorthand commands (convenience wrappers)
+program.addCommand(qrCommand);
+program.addCommand(resizeCommand);
+program.addCommand(convertCommand);
+program.addCommand(chartCommand);
 // Enhanced doctor command
 program
     .command("doctor")
@@ -135,5 +148,11 @@ program
     console.log("  floimg mcp install       # Set up MCP for Claude Code");
     console.log("  floimg generate --generator shapes --params '{\"type\":\"gradient\"}' --out test.svg");
 });
-program.parse();
+// Check if we should show interactive menu (no args provided)
+if (shouldShowInteractiveMenu(process.argv)) {
+    showInteractiveMenu().catch(console.error);
+}
+else {
+    program.parse();
+}
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/interactive.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Display the interactive menu and handle user selection
+ */
+export declare function showInteractiveMenu(): Promise<void>;
+/**
+ * Check if we should show the interactive menu
+ * (called when floimg is run with no arguments)
+ */
+export declare function shouldShowInteractiveMenu(args: string[]): boolean;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/cli/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiEzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAKjE"}

package/dist/cli/interactive.js

@@ -0,0 +1,115 @@
+import { createInterface } from "readline";
+const MENU_OPTIONS = [
+    {
+        key: "1",
+        label: "Generate QR Code",
+        description: "Create a QR code from text or URL",
+        command: "floimg qr",
+        example: 'floimg qr "https://floimg.com" -o qr.png',
+    },
+    {
+        key: "2",
+        label: "Create Chart",
+        description: "Generate bar, line, pie charts and more",
+        command: "floimg chart",
+        example: 'floimg chart bar --labels "A,B,C" --values "10,20,30"',
+    },
+    {
+        key: "3",
+        label: "Resize Image",
+        description: "Resize an image to new dimensions",
+        command: "floimg resize",
+        example: "floimg resize input.jpg 800x600 -o output.jpg",
+    },
+    {
+        key: "4",
+        label: "Convert Format",
+        description: "Convert between image formats (PNG, WebP, JPEG, etc.)",
+        command: "floimg convert",
+        example: "floimg convert input.png -o output.webp",
+    },
+    {
+        key: "5",
+        label: "Run Workflow",
+        description: "Execute a YAML workflow file",
+        command: "floimg run",
+        example: "floimg run workflow.yaml",
+    },
+    {
+        key: "6",
+        label: "See All Commands",
+        description: "View help for all available commands",
+        command: "floimg --help",
+        example: "floimg --help",
+    },
+];
+/**
+ * Display the interactive menu and handle user selection
+ */
+export async function showInteractiveMenu() {
+    console.log("");
+    console.log("╭─────────────────────────────────────────────────────────╮");
+    console.log("│                                                         │");
+    console.log("│   \x1b[1m\x1b[36mfloimg\x1b[0m - Universal Image Workflow Engine             │");
+    console.log("│                                                         │");
+    console.log("╰─────────────────────────────────────────────────────────╯");
+    console.log("");
+    console.log("\x1b[1mWhat would you like to do?\x1b[0m");
+    console.log("");
+    for (const option of MENU_OPTIONS) {
+        console.log(`  \x1b[36m${option.key})\x1b[0m ${option.label}`);
+        console.log(`     \x1b[2m${option.description}\x1b[0m`);
+    }
+    console.log("");
+    console.log("  \x1b[36mq)\x1b[0m Quit");
+    console.log("");
+    // Check if we're in a TTY
+    if (!process.stdin.isTTY) {
+        console.log("Run with a command, e.g.:");
+        console.log('  floimg qr "https://example.com" -o qr.png');
+        console.log("");
+        console.log("Or see all options with: floimg --help");
+        return;
+    }
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question("Enter choice (1-6, or q): ", resolve);
+    });
+    rl.close();
+    const choice = answer.trim().toLowerCase();
+    if (choice === "q" || choice === "quit" || choice === "exit") {
+        console.log("\nGoodbye!");
+        return;
+    }
+    const selected = MENU_OPTIONS.find((o) => o.key === choice);
+    if (!selected) {
+        console.log("\nInvalid choice. Run floimg --help for all options.");
+        return;
+    }
+    console.log("");
+    console.log(`\x1b[1m${selected.label}\x1b[0m`);
+    console.log("");
+    console.log("Usage:");
+    console.log(`  ${selected.command} [options]`);
+    console.log("");
+    console.log("Example:");
+    console.log(`  ${selected.example}`);
+    console.log("");
+    console.log("For more options, run:");
+    console.log(`  ${selected.command} --help`);
+    console.log("");
+}
+/**
+ * Check if we should show the interactive menu
+ * (called when floimg is run with no arguments)
+ */
+export function shouldShowInteractiveMenu(args) {
+    // Show interactive menu if no command is provided
+    // args[0] is 'node', args[1] is the script path
+    // If there's a third argument, it's a command
+    return args.length <= 2;
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/interactive.js.map

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

package/dist/cli/utils/plugin-loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Plugin metadata for auto-installation
+ */
+export interface PluginInfo {
+    /** npm package name */
+    package: string;
+    /** Human-readable name for display */
+    displayName: string;
+    /** The generator name it provides */
+    generatorName: string;
+}
+/**
+ * Registry of known plugins and their packages
+ */
+export declare const PLUGIN_REGISTRY: Record<string, PluginInfo>;
+/**
+ * Try to load a plugin, with auto-install if not found
+ *
+ * @param pluginKey - Key from PLUGIN_REGISTRY (e.g., "qr", "quickchart")
+ * @param autoInstall - Whether to prompt for auto-install (default: true)
+ * @returns The loaded plugin module, or null if not available
+ */
+export declare function loadPlugin<T = unknown>(pluginKey: string, autoInstall?: boolean): Promise<T | null>;
+/**
+ * Check if running via npx
+ */
+export declare function isRunningViaNpx(): boolean;
+/**
+ * Show a helpful tip for npx users after first successful run
+ */
+export declare function showNpxTip(): void;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/cli/utils/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/plugin-loader.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA0BtD,CAAC;AA2DF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,SAAS,EAAE,MAAM,EACjB,WAAW,UAAO,GACjB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAsDnB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAMjC"}

package/dist/cli/utils/plugin-loader.js

@@ -0,0 +1,150 @@
+import { execSync } from "child_process";
+import { createInterface } from "readline";
+/**
+ * Registry of known plugins and their packages
+ */
+export const PLUGIN_REGISTRY = {
+    qr: {
+        package: "@teamflojo/floimg-qr",
+        displayName: "QR Code Generator",
+        generatorName: "qr",
+    },
+    quickchart: {
+        package: "@teamflojo/floimg-quickchart",
+        displayName: "QuickChart Generator",
+        generatorName: "quickchart",
+    },
+    mermaid: {
+        package: "@teamflojo/floimg-mermaid",
+        displayName: "Mermaid Diagram Generator",
+        generatorName: "mermaid",
+    },
+    d3: {
+        package: "@teamflojo/floimg-d3",
+        displayName: "D3 Visualization Generator",
+        generatorName: "d3",
+    },
+    screenshot: {
+        package: "@teamflojo/floimg-screenshot",
+        displayName: "Screenshot Generator",
+        generatorName: "screenshot",
+    },
+};
+/**
+ * Prompt user for confirmation (works in TTY)
+ */
+async function promptConfirm(message) {
+    // Check if we're in an interactive terminal
+    if (!process.stdin.isTTY) {
+        return false;
+    }
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`${message} (y/n): `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+        });
+    });
+}
+/**
+ * Detect the package manager being used
+ */
+function detectPackageManager() {
+    // Check for common environment variables
+    if (process.env.npm_config_user_agent?.includes("pnpm")) {
+        return "pnpm";
+    }
+    if (process.env.npm_config_user_agent?.includes("yarn")) {
+        return "yarn";
+    }
+    if (process.env.npm_config_user_agent?.includes("bun")) {
+        return "bun";
+    }
+    return "npm";
+}
+/**
+ * Install a package using the detected package manager
+ */
+function installPackage(packageName) {
+    const pm = detectPackageManager();
+    const commands = {
+        npm: `npm install ${packageName}`,
+        pnpm: `pnpm add ${packageName}`,
+        yarn: `yarn add ${packageName}`,
+        bun: `bun add ${packageName}`,
+    };
+    console.log(`\n📦 Installing ${packageName}...`);
+    execSync(commands[pm], { stdio: "inherit" });
+    console.log(`✅ Installed ${packageName}\n`);
+}
+/**
+ * Try to load a plugin, with auto-install if not found
+ *
+ * @param pluginKey - Key from PLUGIN_REGISTRY (e.g., "qr", "quickchart")
+ * @param autoInstall - Whether to prompt for auto-install (default: true)
+ * @returns The loaded plugin module, or null if not available
+ */
+export async function loadPlugin(pluginKey, autoInstall = true) {
+    const info = PLUGIN_REGISTRY[pluginKey];
+    if (!info) {
+        console.error(`Unknown plugin: ${pluginKey}`);
+        return null;
+    }
+    // Try to import the plugin
+    try {
+        const module = await import(info.package);
+        return module;
+    }
+    catch {
+        // Plugin not installed
+    }
+    // Plugin not found - offer to install
+    console.log(`\n🔍 The '${pluginKey}' command requires ${info.package}`);
+    console.log(`   ${info.displayName}\n`);
+    if (!autoInstall) {
+        console.log(`Install it with: npm install ${info.package}`);
+        return null;
+    }
+    // Check if we can prompt
+    if (!process.stdin.isTTY) {
+        console.log(`Install it with: npm install ${info.package}`);
+        console.log(`(Auto-install disabled in non-interactive mode)`);
+        return null;
+    }
+    const shouldInstall = await promptConfirm("Install it now?");
+    if (!shouldInstall) {
+        console.log(`\nYou can install it later with: npm install ${info.package}`);
+        return null;
+    }
+    // Install the package
+    try {
+        installPackage(info.package);
+        // Try to import again
+        const module = await import(info.package);
+        return module;
+    }
+    catch (error) {
+        console.error(`\n❌ Failed to install ${info.package}:`, error instanceof Error ? error.message : error);
+        console.log(`Try installing manually: npm install ${info.package}`);
+        return null;
+    }
+}
+/**
+ * Check if running via npx
+ */
+export function isRunningViaNpx() {
+    // npx sets this environment variable
+    return Boolean(process.env.npm_execpath?.includes("npx"));
+}
+/**
+ * Show a helpful tip for npx users after first successful run
+ */
+export function showNpxTip() {
+    if (isRunningViaNpx()) {
+        console.log("\n💡 Tip: For faster runs, install globally: npm i -g @teamflojo/floimg");
+    }
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/cli/utils/plugin-loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamflojo/floimg",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Universal image workflow engine for developers and AI agents",
   "type": "module",
   "main": "./dist/index.js",