appshot-cli 0.1.0

package/dist/core/compose.js

@@ -0,0 +1,420 @@
+import sharp from 'sharp';
+import { promises as fs } from 'fs';
+import { renderGradient } from './render.js';
+import { applyRoundedCorners } from './mask-generator.js';
+/**
+ * Compose a complete App Store screenshot with gradient, caption, and framed device
+ */
+export async function composeAppStoreScreenshot(options) {
+    const { screenshot, frame, frameMetadata, caption, captionConfig, gradientConfig, deviceConfig, outputWidth, outputHeight } = options;
+    // Determine caption position (default to 'above' for better App Store style)
+    const captionPosition = captionConfig.position || 'above';
+    const partialFrame = deviceConfig.partialFrame || false;
+    const frameOffset = deviceConfig.frameOffset || 25; // Default 25% cut off
+    // Calculate dimensions based on output
+    // Calculate caption height if positioned above
+    let captionHeight = 0;
+    if (captionPosition === 'above' && caption) {
+        // For watch devices, use top 1/3 of screen for text
+        const isWatch = outputWidth < 500;
+        if (isWatch) {
+            captionHeight = Math.floor(outputHeight / 3); // Use top 1/3 for watch captions
+        }
+        else {
+            captionHeight = captionConfig.paddingTop + captionConfig.fontsize * 2 + (captionConfig.paddingBottom || 60);
+        }
+    }
+    // Calculate total canvas dimensions (should be output dimensions)
+    const canvasWidth = outputWidth;
+    const canvasHeight = outputHeight;
+    // Create gradient background
+    const gradient = await renderGradient(canvasWidth, canvasHeight, gradientConfig);
+    // Start compositing
+    const composites = [];
+    // Add caption if positioned above
+    if (caption && captionPosition === 'above') {
+        try {
+            // Create simple SVG text
+            const isWatch = outputWidth < 500;
+            const fontSize = isWatch ? 36 : captionConfig.fontsize; // Smaller font for watch
+            let svgText;
+            if (isWatch) {
+                // Simple word wrapping for 2 lines ONLY for watch
+                const words = caption.split(' ');
+                const midPoint = Math.ceil(words.length / 2);
+                const line1 = words.slice(0, midPoint).join(' ');
+                const line2 = words.slice(midPoint).join(' ');
+                svgText = `<svg width="${canvasWidth}" height="${captionHeight}" xmlns="http://www.w3.org/2000/svg">
+          <text x="${canvasWidth / 2}" y="${captionHeight * 0.4}" 
+                font-family="Arial, sans-serif" 
+                font-size="${fontSize}" 
+                fill="${captionConfig.color}" 
+                text-anchor="middle"
+                font-weight="bold">${escapeXml(line1)}</text>
+          <text x="${canvasWidth / 2}" y="${captionHeight * 0.7}" 
+                font-family="Arial, sans-serif" 
+                font-size="${fontSize}" 
+                fill="${captionConfig.color}" 
+                text-anchor="middle"
+                font-weight="bold">${escapeXml(line2)}</text>
+        </svg>`;
+            }
+            else {
+                // Single line for all other devices (iPhone, iPad, etc.)
+                svgText = `<svg width="${canvasWidth}" height="${captionHeight}" xmlns="http://www.w3.org/2000/svg">
+          <text x="${canvasWidth / 2}" y="${captionHeight / 2}" 
+                font-family="Arial, sans-serif" 
+                font-size="${fontSize}" 
+                fill="${captionConfig.color}" 
+                text-anchor="middle"
+                dominant-baseline="middle"
+                font-weight="bold">${escapeXml(caption)}</text>
+        </svg>`;
+            }
+            const captionImage = await sharp(Buffer.from(svgText))
+                .png()
+                .toBuffer();
+            composites.push({
+                input: captionImage,
+                top: 0,
+                left: 0
+            });
+        }
+        catch {
+            // If text rendering fails, just add transparent area
+            console.log('[INFO] Text rendering failed, reserving space for caption');
+            const captionArea = await sharp({
+                create: {
+                    width: canvasWidth,
+                    height: captionHeight,
+                    channels: 4,
+                    background: { r: 0, g: 0, b: 0, alpha: 0 }
+                }
+            })
+                .png()
+                .toBuffer();
+            composites.push({
+                input: captionArea,
+                top: 0,
+                left: 0
+            });
+        }
+    }
+    if (frame && frameMetadata) {
+        // Validate that frame is actually a buffer
+        if (!Buffer.isBuffer(frame)) {
+            throw new Error(`Frame is not a valid buffer for ${frameMetadata.displayName || frameMetadata.name}`);
+        }
+        // Calculate scale factor if frame needs to be resized to fit output
+        const originalFrameWidth = frameMetadata.frameWidth;
+        const originalFrameHeight = frameMetadata.frameHeight;
+        // Calculate available space for the device (accounting for caption)
+        const availableWidth = outputWidth;
+        const availableHeight = Math.max(100, outputHeight - captionHeight); // Ensure minimum height
+        // Calculate scale to fit within available space while maintaining aspect ratio
+        const scaleX = availableWidth / originalFrameWidth;
+        const scaleY = availableHeight / originalFrameHeight;
+        // Different scaling for different device types
+        let scale;
+        if (frameMetadata.deviceType === 'watch') {
+            // For watch, make it larger since bottom will be cut off
+            scale = Math.min(scaleX, scaleY) * 1.3; // Use 130% scale for watch
+        }
+        else if (frameMetadata.deviceType === 'mac') {
+            // For Mac, make it larger to be more visible
+            scale = Math.min(scaleX, scaleY) * 0.95; // Use 95% scale for Mac
+        }
+        else {
+            scale = Math.min(scaleX, scaleY) * 0.9; // Use 90% for other devices
+        }
+        // Apply scaling to optimize canvas usage
+        let targetDeviceWidth = Math.min(Math.floor(originalFrameWidth * scale), outputWidth);
+        let targetDeviceHeight = Math.min(Math.floor(originalFrameHeight * scale), outputHeight);
+        // Scale screenshot to fit in frame's screen area
+        let resizedScreenshot;
+        try {
+            resizedScreenshot = await sharp(screenshot)
+                .resize(frameMetadata.screenRect.width, frameMetadata.screenRect.height, {
+                fit: 'fill'
+            })
+                .toBuffer();
+        }
+        catch (error) {
+            console.error('Failed to resize screenshot:', error);
+            throw error;
+        }
+        // If we have a mask, apply it to the screenshot to clip corners
+        let maskApplied = false;
+        if (frameMetadata.maskPath) {
+            try {
+                // Load the mask
+                const maskBuffer = await fs.readFile(frameMetadata.maskPath);
+                // Resize mask to match screenshot dimensions
+                const resizedMask = await sharp(maskBuffer)
+                    .resize(frameMetadata.screenRect.width, frameMetadata.screenRect.height, {
+                    fit: 'fill'
+                })
+                    .toBuffer();
+                // Extract RGB from screenshot and alpha from mask's red channel
+                const screenshotRgb = await sharp(resizedScreenshot)
+                    .removeAlpha()
+                    .toBuffer();
+                const maskAlpha = await sharp(resizedMask)
+                    .extractChannel('red') // Black=0 (transparent), White=255 (opaque)
+                    .toBuffer();
+                // Join screenshot RGB with mask as alpha channel
+                resizedScreenshot = await sharp(screenshotRgb)
+                    .joinChannel(maskAlpha)
+                    .png()
+                    .toBuffer();
+                maskApplied = true;
+            }
+            catch (error) {
+                console.warn(`Could not load mask file, will use programmatic masking: ${error}`);
+                // Fall through to programmatic masking
+            }
+        }
+        // If no mask was applied and this is an iPhone, use programmatic corner masking
+        if (!maskApplied && frameMetadata.deviceType === 'iphone') {
+            // No mask available, create a rounded corner mask for iPhone
+            // Different iPhone models have different corner radii
+            let cornerRadius;
+            const frameName = frameMetadata.displayName?.toLowerCase() || frameMetadata.name?.toLowerCase() || '';
+            if (frameName.includes('16 pro') || frameName.includes('15 pro') || frameName.includes('14 pro')) {
+                // Newer Pro models have larger corner radius (~12% of width)
+                cornerRadius = Math.floor(frameMetadata.screenRect.width * 0.12);
+            }
+            else if (frameName.includes('se') || frameName.includes('8')) {
+                // SE and iPhone 8 have no rounded corners on the screen
+                cornerRadius = 0;
+            }
+            else {
+                // Standard models and older Pro models (~10% of width)
+                cornerRadius = Math.floor(frameMetadata.screenRect.width * 0.10);
+            }
+            if (cornerRadius > 0) {
+                // Apply rounded corners using our custom mask generator
+                resizedScreenshot = await applyRoundedCorners(resizedScreenshot, frameMetadata.screenRect.width, frameMetadata.screenRect.height, cornerRadius);
+            }
+        }
+        // Create the device composite - screenshot UNDER frame
+        let deviceComposite;
+        try {
+            // First composite: screenshot on transparent background
+            const screenshotLayer = await sharp({
+                create: {
+                    width: originalFrameWidth,
+                    height: originalFrameHeight,
+                    channels: 4,
+                    background: { r: 0, g: 0, b: 0, alpha: 0 }
+                }
+            })
+                .composite([{
+                    input: resizedScreenshot,
+                    left: frameMetadata.screenRect.x,
+                    top: frameMetadata.screenRect.y
+                }])
+                .png()
+                .toBuffer();
+            // Second composite: add frame on top using 'over' blend (frame should cover screenshot edges)
+            deviceComposite = await sharp(screenshotLayer)
+                .composite([{
+                    input: frame,
+                    left: 0,
+                    top: 0,
+                    blend: 'over'
+                }])
+                .png() // CRITICAL: Convert to PNG format, not raw pixels!
+                .toBuffer();
+        }
+        catch (error) {
+            console.error('Failed to create device composite:', error);
+            throw error;
+        }
+        // If partial frame, crop the bottom
+        if (partialFrame) {
+            const cropHeight = Math.floor(originalFrameHeight * (1 - frameOffset / 100));
+            try {
+                deviceComposite = await sharp(deviceComposite)
+                    .extract({
+                    left: 0,
+                    top: 0,
+                    width: originalFrameWidth,
+                    height: cropHeight
+                })
+                    .png() // Ensure PNG format
+                    .toBuffer();
+                targetDeviceHeight = Math.floor(cropHeight * scale);
+            }
+            catch (error) {
+                console.error('Failed to crop:', error);
+                throw error;
+            }
+        }
+        // Scale the complete device if needed (now scales up or down)
+        if (scale !== 1) {
+            try {
+                deviceComposite = await sharp(deviceComposite)
+                    .resize(targetDeviceWidth, targetDeviceHeight, {
+                    fit: 'inside', // Preserve aspect ratio
+                    withoutEnlargement: false // Allow scaling up
+                })
+                    .png() // Ensure PNG format
+                    .toBuffer();
+            }
+            catch (error) {
+                console.error('Failed to scale:', error);
+                throw error;
+            }
+        }
+        // Calculate position for centered device
+        // For watch, position lower to cut off bottom band
+        let deviceTop;
+        if (frameMetadata.deviceType === 'watch') {
+            // Position watch so bottom 1/4 is cut off, raised 25px total
+            deviceTop = canvasHeight - Math.floor(targetDeviceHeight * 0.75) - 25;
+        }
+        else {
+            deviceTop = captionHeight;
+        }
+        const deviceLeft = Math.floor((canvasWidth - targetDeviceWidth) / 2);
+        // Add the complete device to composites
+        composites.push({
+            input: deviceComposite,
+            top: deviceTop,
+            left: Math.max(0, deviceLeft)
+        });
+    }
+    else {
+        // No frame, just use the screenshot
+        const deviceTop = captionHeight;
+        const deviceLeft = Math.floor((canvasWidth - outputWidth) / 2);
+        composites.push({
+            input: screenshot,
+            top: deviceTop,
+            left: Math.max(0, deviceLeft)
+        });
+    }
+    // Add overlay caption if specified (legacy support)
+    // Note: Caption rendering requires librsvg to be installed
+    if (caption && captionPosition === 'overlay') {
+        // Skip caption rendering for now - would require librsvg
+        // TODO: Implement pure bitmap text rendering in future version
+    }
+    // Composite everything onto the gradient
+    const result = await sharp(gradient)
+        .composite(composites)
+        .png() // IMPORTANT: Ensure the output is a valid PNG
+        .toBuffer();
+    return result;
+}
+/**
+ * Create SVG for caption text
+ */
+function _createCaptionSvg(text, config, width, height) {
+    const position = config.position || 'above';
+    // Calculate text position
+    let textY;
+    let textX;
+    let textAnchor;
+    if (position === 'above') {
+        // Position in the caption area
+        textY = config.paddingTop + config.fontsize;
+    }
+    else {
+        // Overlay position (legacy)
+        textY = config.paddingTop + config.fontsize;
+    }
+    // Handle text alignment
+    switch (config.align) {
+        case 'left':
+            textX = config.paddingLeft || 50;
+            textAnchor = 'start';
+            break;
+        case 'right':
+            textX = width - (config.paddingRight || 50);
+            textAnchor = 'end';
+            break;
+        case 'center':
+        default:
+            textX = width / 2;
+            textAnchor = 'middle';
+            break;
+    }
+    // Use a safe font stack that Sharp can render properly
+    // SF Pro is not available to Sharp's SVG renderer, so we use a fallback stack
+    const fontFamily = getFontStack(config.font);
+    // For watch devices, use smaller font if text is too long
+    const maxCharsPerLine = Math.floor(width / (config.fontsize * 0.6));
+    const needsWrapping = text.length > maxCharsPerLine;
+    if (needsWrapping) {
+        // Split text into multiple lines
+        const words = text.split(' ');
+        const lines = [];
+        let currentLine = '';
+        for (const word of words) {
+            const testLine = currentLine ? `${currentLine} ${word}` : word;
+            if (testLine.length <= maxCharsPerLine) {
+                currentLine = testLine;
+            }
+            else {
+                if (currentLine)
+                    lines.push(currentLine);
+                currentLine = word;
+            }
+        }
+        if (currentLine)
+            lines.push(currentLine);
+        // Create multiple text elements for each line
+        const lineHeight = config.fontsize * 1.2;
+        const textElements = lines.map((line, index) => `<text 
+        x="${textX}" 
+        y="${textY + (index * lineHeight)}" 
+        font-family="${fontFamily}" 
+        font-size="${config.fontsize}" 
+        fill="${config.color}" 
+        text-anchor="${textAnchor}" 
+        font-weight="600"
+      >${escapeXml(line)}</text>`).join('\n');
+        return `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      ${textElements}
+    </svg>`;
+    }
+    // Single line text
+    return `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+    <text 
+      x="${textX}" 
+      y="${textY}" 
+      font-family="${fontFamily}" 
+      font-size="${config.fontsize}" 
+      fill="${config.color}" 
+      text-anchor="${textAnchor}" 
+      font-weight="600"
+    >${escapeXml(text)}</text>
+  </svg>`;
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Get a safe font stack that Sharp's SVG renderer can use
+ */
+function getFontStack(requestedFont) {
+    // Map common macOS fonts to web-safe alternatives
+    // Note: Using single quotes inside to avoid XML attribute quote conflicts
+    const fontMap = {
+        'SF Pro': "system-ui, -apple-system, 'Helvetica Neue', Helvetica, Arial, sans-serif",
+        'SF Pro Display': "system-ui, -apple-system, 'Helvetica Neue', Helvetica, Arial, sans-serif",
+        'SF Pro Text': "system-ui, -apple-system, 'Helvetica Neue', Helvetica, Arial, sans-serif",
+        'San Francisco': "system-ui, -apple-system, 'Helvetica Neue', Helvetica, Arial, sans-serif",
+        'New York': "Georgia, 'Times New Roman', Times, serif"
+    };
+    // Return the mapped font stack or use the requested font with fallbacks
+    return fontMap[requestedFont] || `'${requestedFont}', system-ui, -apple-system, 'Helvetica Neue', Helvetica, Arial, sans-serif`;
+}
+//# sourceMappingURL=compose.js.map

package/dist/core/compose.js.map

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

package/dist/core/devices.d.ts

@@ -0,0 +1,50 @@
+export type Orientation = 'portrait' | 'landscape';
+export interface DeviceFrame {
+    name: string;
+    displayName: string;
+    orientation: Orientation;
+    frameWidth: number;
+    frameHeight: number;
+    screenRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    deviceType: 'iphone' | 'ipad' | 'mac' | 'watch';
+    originalName?: string;
+    maskPath?: string;
+}
+export declare let frameRegistry: DeviceFrame[];
+/**
+ * Detect orientation from image dimensions
+ */
+export declare function detectOrientation(width: number, height: number): Orientation;
+/**
+ * Get image dimensions from file
+ */
+export declare function getImageDimensions(imagePath: string): Promise<{
+    width: number;
+    height: number;
+    orientation: Orientation;
+}>;
+/**
+ * Find best matching frame for a screenshot
+ */
+export declare function findBestFrame(screenshotWidth: number, screenshotHeight: number, deviceType: 'iphone' | 'ipad' | 'mac' | 'watch', preferredFrame?: string): DeviceFrame | null;
+/**
+ * Initialize frame registry from Frames.json if available
+ */
+export declare function initializeFrameRegistry(framesDir: string): Promise<void>;
+/**
+ * Load frame image from disk
+ */
+export declare function loadFrame(framePath: string, frameName: string): Promise<Buffer | null>;
+/**
+ * Auto-detect and load appropriate frame for a screenshot
+ */
+export declare function autoSelectFrame(screenshotPath: string, framesDir: string, deviceType: 'iphone' | 'ipad' | 'mac' | 'watch', preferredFrame?: string): Promise<{
+    frame: Buffer | null;
+    metadata: DeviceFrame | null;
+}>;
+//# sourceMappingURL=devices.d.ts.map

package/dist/core/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/core/devices.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,IAAI,aAAa,EAAE,WAAW,EA6HpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,CAOhI;AAkED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,EAC/C,cAAc,CAAC,EAAE,MAAM,GACtB,WAAW,GAAG,IAAI,CA+GpB;AAaD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC9E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuC5F;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,EAC/C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAC,CAoBjE"}