appshot-cli 0.1.0 → 0.2.0

package/dist/core/gradient-presets.js

@@ -0,0 +1,222 @@
+/**
+ * Preset gradients for App Store screenshots
+ */
+export const gradientPresets = [
+    // Warm Gradients
+    {
+        id: 'sunset',
+        name: 'Sunset',
+        description: 'Warm orange to pink sunset',
+        colors: ['#FF5733', '#FFC300'],
+        direction: 'top-bottom',
+        category: 'warm'
+    },
+    {
+        id: 'sunrise',
+        name: 'Sunrise',
+        description: 'Golden morning glow',
+        colors: ['#F37335', '#FDC830'],
+        direction: 'diagonal',
+        category: 'warm'
+    },
+    {
+        id: 'autumn',
+        name: 'Autumn',
+        description: 'Fall foliage colors',
+        colors: ['#D38312', '#A83279'],
+        direction: 'top-bottom',
+        category: 'warm'
+    },
+    {
+        id: 'peach',
+        name: 'Peach',
+        description: 'Soft peach to coral',
+        colors: ['#FFCCCC', '#FF6B6B'],
+        direction: 'top-bottom',
+        category: 'warm'
+    },
+    // Cool Gradients
+    {
+        id: 'ocean',
+        name: 'Ocean',
+        description: 'Deep blue ocean waves',
+        colors: ['#0077BE', '#33CCCC'],
+        direction: 'top-bottom',
+        category: 'cool'
+    },
+    {
+        id: 'arctic',
+        name: 'Arctic',
+        description: 'Cool ice blue',
+        colors: ['#72EDF2', '#5151E5'],
+        direction: 'diagonal',
+        category: 'cool'
+    },
+    {
+        id: 'mint',
+        name: 'Mint',
+        description: 'Fresh mint green',
+        colors: ['#00B09B', '#96C93D'],
+        direction: 'left-right',
+        category: 'cool'
+    },
+    {
+        id: 'lavender',
+        name: 'Lavender',
+        description: 'Soft purple hues',
+        colors: ['#9796F0', '#FBC7D4'],
+        direction: 'top-bottom',
+        category: 'cool'
+    },
+    // Vibrant Gradients
+    {
+        id: 'rainbow',
+        name: 'Rainbow',
+        description: 'Vibrant rainbow spectrum',
+        colors: ['#FF0080', '#FF8C00', '#40E0D0'],
+        direction: 'left-right',
+        category: 'vibrant'
+    },
+    {
+        id: 'neon',
+        name: 'Neon',
+        description: 'Electric neon glow',
+        colors: ['#FF006E', '#8338EC', '#3A86FF'],
+        direction: 'diagonal',
+        category: 'vibrant'
+    },
+    {
+        id: 'tropical',
+        name: 'Tropical',
+        description: 'Tropical paradise',
+        colors: ['#FA709A', '#FEE140'],
+        direction: 'top-bottom',
+        category: 'vibrant'
+    },
+    {
+        id: 'candy',
+        name: 'Candy',
+        description: 'Sweet candy colors',
+        colors: ['#FF61D2', '#FE9090', '#FFCC5C'],
+        direction: 'left-right',
+        category: 'vibrant'
+    },
+    // Subtle Gradients
+    {
+        id: 'pastel',
+        name: 'Pastel',
+        description: 'Soft pastel blend',
+        colors: ['#E8D8F5', '#D6E6FF'],
+        direction: 'top-bottom',
+        category: 'subtle'
+    },
+    {
+        id: 'mist',
+        name: 'Mist',
+        description: 'Morning mist',
+        colors: ['#E0EAFC', '#CFDEF3'],
+        direction: 'top-bottom',
+        category: 'subtle'
+    },
+    {
+        id: 'pearl',
+        name: 'Pearl',
+        description: 'Pearlescent shine',
+        colors: ['#F5F5F5', '#E8E8E8', '#F0F0F0'],
+        direction: 'diagonal',
+        category: 'subtle'
+    },
+    {
+        id: 'cloud',
+        name: 'Cloud',
+        description: 'Soft cloud white',
+        colors: ['#FFFFFF', '#F0F0F0'],
+        direction: 'top-bottom',
+        category: 'subtle'
+    },
+    // Monochrome Gradients
+    {
+        id: 'noir',
+        name: 'Noir',
+        description: 'Deep black fade',
+        colors: ['#000000', '#434343'],
+        direction: 'top-bottom',
+        category: 'monochrome'
+    },
+    {
+        id: 'graphite',
+        name: 'Graphite',
+        description: 'Professional gray',
+        colors: ['#283048', '#859398'],
+        direction: 'diagonal',
+        category: 'monochrome'
+    },
+    {
+        id: 'charcoal',
+        name: 'Charcoal',
+        description: 'Dark charcoal gradient',
+        colors: ['#1C1C1C', '#494949'],
+        direction: 'top-bottom',
+        category: 'monochrome'
+    },
+    {
+        id: 'silver',
+        name: 'Silver',
+        description: 'Metallic silver',
+        colors: ['#B8B8B8', '#E8E8E8'],
+        direction: 'diagonal',
+        category: 'monochrome'
+    },
+    // Brand-Inspired Gradients
+    {
+        id: 'instagram',
+        name: 'Instagram',
+        description: 'Instagram brand colors',
+        colors: ['#833AB4', '#FD1D1D', '#FCB045'],
+        direction: 'diagonal',
+        category: 'brand'
+    },
+    {
+        id: 'twitter',
+        name: 'Twitter Blue',
+        description: 'Twitter brand blue',
+        colors: ['#1DA1F2', '#14171A'],
+        direction: 'top-bottom',
+        category: 'brand'
+    },
+    {
+        id: 'spotify',
+        name: 'Spotify',
+        description: 'Spotify green to black',
+        colors: ['#1DB954', '#191414'],
+        direction: 'diagonal',
+        category: 'brand'
+    },
+    {
+        id: 'apple',
+        name: 'Apple',
+        description: 'Apple-inspired gradient',
+        colors: ['#A1C4FD', '#C2E9FB'],
+        direction: 'diagonal',
+        category: 'brand'
+    }
+];
+/**
+ * Get gradient preset by ID
+ */
+export function getGradientPreset(id) {
+    return gradientPresets.find(g => g.id === id);
+}
+/**
+ * Get gradients by category
+ */
+export function getGradientsByCategory(category) {
+    return gradientPresets.filter(g => g.category === category);
+}
+/**
+ * Get all gradient categories
+ */
+export function getGradientCategories() {
+    return [...new Set(gradientPresets.map(g => g.category))];
+}
+//# sourceMappingURL=gradient-presets.js.map

package/dist/core/gradient-presets.js.map

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

package/dist/core/text-utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Text utilities for caption rendering
+ */
+/**
+ * Estimate text width in pixels for SVG rendering
+ * This is an approximation based on average character widths
+ */
+export declare function estimateTextWidth(text: string, fontSize: number): number;
+/**
+ * Calculate how many characters fit in a given width
+ */
+export declare function calculateCharsPerLine(width: number, fontSize: number, padding?: number): number;
+/**
+ * Smart word wrapping algorithm
+ * Wraps text to fit within specified width, returning array of lines
+ */
+export declare function wrapText(text: string, maxWidth: number, fontSize: number, maxLines?: number): string[];
+/**
+ * Calculate optimal caption height based on content and constraints
+ */
+export declare function calculateCaptionHeight(text: string, fontSize: number, canvasWidth: number, options?: {
+    lineHeight?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    maxLines?: number;
+}): {
+    height: number;
+    lines: string[];
+};
+/**
+ * Calculate dynamic caption height based on device position
+ */
+export declare function calculateAdaptiveCaptionHeight(text: string, fontSize: number, canvasWidth: number, canvasHeight: number, deviceTop: number, deviceHeight: number, framePosition: string | number | undefined): {
+    height: number;
+    lines: string[];
+};
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/core/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../src/core/text-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAwB,GAAG,MAAM,CAShH;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAiDV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAwBrC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACzC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BrC"}

package/dist/core/text-utils.js

@@ -0,0 +1,137 @@
+/**
+ * Text utilities for caption rendering
+ */
+// Character width factors for text estimation
+const CHAR_WIDTH_FACTOR_NORMAL = 0.65; // Average character width relative to font size
+const CHAR_WIDTH_FACTOR_NARROW = 0.5; // Character width for narrow displays (watch)
+// Width thresholds
+const NARROW_WIDTH_THRESHOLD = 500; // Width below which to use narrow character factor
+// Padding values
+const PADDING_NARROW = 30; // Padding for narrow displays
+const PADDING_DEFAULT = 40; // Default padding
+/**
+ * Estimate text width in pixels for SVG rendering
+ * This is an approximation based on average character widths
+ */
+export function estimateTextWidth(text, fontSize) {
+    // Average character width is roughly 0.65 of font size for most fonts
+    // Adjust for bold text (slightly wider)
+    const avgCharWidth = fontSize * CHAR_WIDTH_FACTOR_NORMAL;
+    return text.length * avgCharWidth;
+}
+/**
+ * Calculate how many characters fit in a given width
+ */
+export function calculateCharsPerLine(width, fontSize, padding = PADDING_DEFAULT) {
+    // For very narrow widths (watch), use moderate padding
+    const actualPadding = width < NARROW_WIDTH_THRESHOLD ? PADDING_NARROW : padding;
+    const availableWidth = width - (actualPadding * 2);
+    // For watch (narrow width), use smaller character width factor since font is smaller
+    const avgCharWidth = width < NARROW_WIDTH_THRESHOLD
+        ? fontSize * CHAR_WIDTH_FACTOR_NARROW
+        : fontSize * CHAR_WIDTH_FACTOR_NORMAL;
+    return Math.floor(availableWidth / avgCharWidth);
+}
+/**
+ * Smart word wrapping algorithm
+ * Wraps text to fit within specified width, returning array of lines
+ */
+export function wrapText(text, maxWidth, fontSize, maxLines) {
+    if (!text)
+        return [];
+    const words = text.split(' ');
+    const lines = [];
+    let currentLine = '';
+    const charsPerLine = calculateCharsPerLine(maxWidth, fontSize);
+    for (const word of words) {
+        const testLine = currentLine ? `${currentLine} ${word}` : word;
+        if (testLine.length <= charsPerLine) {
+            currentLine = testLine;
+        }
+        else {
+            if (currentLine) {
+                lines.push(currentLine);
+                currentLine = word;
+                // Check if we've reached max lines
+                if (maxLines && lines.length >= maxLines - 1) {
+                    // Add remaining text with ellipsis if needed
+                    const wordIndex = words.indexOf(word);
+                    const remainingWords = words.slice(wordIndex);
+                    const remainingText = remainingWords.join(' ');
+                    if (remainingText.length > charsPerLine) {
+                        const truncated = remainingText.substring(0, charsPerLine - 3) + '...';
+                        lines.push(truncated);
+                    }
+                    else {
+                        lines.push(remainingText);
+                    }
+                    return lines; // Return immediately
+                }
+            }
+            else {
+                // Single word is too long, truncate it
+                const truncated = word.substring(0, charsPerLine - 3) + '...';
+                lines.push(truncated);
+                currentLine = '';
+            }
+        }
+    }
+    // Add any remaining text
+    if (currentLine && (!maxLines || lines.length < maxLines)) {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Calculate optimal caption height based on content and constraints
+ */
+export function calculateCaptionHeight(text, fontSize, canvasWidth, options = {}) {
+    const { lineHeight = 1.4, paddingTop = 40, paddingBottom = 40, minHeight = 100, maxHeight = 500, maxLines = 3 } = options;
+    // Wrap text to get actual lines needed
+    const lines = wrapText(text, canvasWidth, fontSize, maxLines);
+    // Calculate height based on number of lines
+    const textHeight = lines.length * fontSize * lineHeight;
+    const totalHeight = paddingTop + textHeight + paddingBottom;
+    // Apply constraints
+    const constrainedHeight = Math.max(minHeight, Math.min(maxHeight, totalHeight));
+    return {
+        height: Math.ceil(constrainedHeight),
+        lines
+    };
+}
+/**
+ * Calculate dynamic caption height based on device position
+ */
+export function calculateAdaptiveCaptionHeight(text, fontSize, canvasWidth, canvasHeight, deviceTop, deviceHeight, framePosition) {
+    // Calculate available space based on device position
+    let availableSpace;
+    if (framePosition === 'top' || framePosition === 0) {
+        // Device at top, limited caption space
+        availableSpace = canvasHeight * 0.15;
+    }
+    else if (framePosition === 'bottom' || framePosition === 100) {
+        // Device at bottom, maximum caption space
+        availableSpace = Math.max(deviceTop - 20, canvasHeight * 0.5); // Use significant space
+    }
+    else if (typeof framePosition === 'number') {
+        // Custom position, calculate available space
+        availableSpace = deviceTop - 20;
+    }
+    else {
+        // Default centered or unspecified
+        // Use space above device or default calculation
+        if (deviceTop > canvasHeight * 0.3) {
+            availableSpace = deviceTop - 20;
+        }
+        else {
+            availableSpace = canvasHeight * 0.25;
+        }
+    }
+    // Calculate with constraints
+    return calculateCaptionHeight(text, fontSize, canvasWidth, {
+        maxHeight: availableSpace,
+        minHeight: fontSize * 2,
+        maxLines: Math.floor(availableSpace / (fontSize * 1.4))
+    });
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/core/text-utils.js.map

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

package/dist/types.d.ts

@@ -2,6 +2,13 @@ export interface GradientConfig {
     colors: string[];
     direction: 'top-bottom' | 'bottom-top' | 'left-right' | 'right-left' | 'diagonal';
 }
+export interface CaptionBoxConfig {
+    autoSize?: boolean;
+    maxLines?: number;
+    lineHeight?: number;
+    minHeight?: number;
+    maxHeight?: number;
+}
 export interface CaptionConfig {
     font: string;
     fontsize: number;
@@ -12,8 +19,16 @@ export interface CaptionConfig {
     paddingLeft?: number;
     paddingRight?: number;
     position?: 'overlay' | 'above';
+    box?: CaptionBoxConfig;
+}
+export interface DeviceStyleConfig {
+    framePosition?: 'top' | 'center' | 'bottom' | number;
+    frameScale?: number;
+    captionSize?: number;
+    captionPosition?: 'above' | 'overlay';
+    captionBox?: CaptionBoxConfig;
 }
-export interface DeviceConfig {
+export interface DeviceConfig extends DeviceStyleConfig {
     input: string;
     resolution: string;
     frame?: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;CACnF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;CACnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC/B,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appshot-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Generate App Store–ready screenshots with frames, gradients, and captions.",
   "bin": {
     "appshot": "bin/appshot.js"