@umituz/web-canvas 1.2.0 → 1.2.2

package/src/application/services/ReportService.ts

@@ -1,14 +1,9 @@
-/**
- * Report Service
- * PDF export and report generation service
- */
 
 import type { ReportData } from '../../domain/types/report.types';
 import type { PDFExportOptions, ExcelExportOptions } from '../../domain/types/report.types';
 import { writeXlsxBlob } from '../../infrastructure/services/minimalXlsx';
 import type { XlsxSheet } from '../../infrastructure/services/minimalXlsx';
 
-/** Flat records → header + value rows, matching json_to_sheet's shape. */
 function recordsToSheet(
   name: string,
   records: Record<string, string | number | boolean | null | undefined>[]
@@ -30,9 +25,6 @@ export class ReportService {
     return ReportService.instance;
   }
 
-  /**
-   * Export DOM element to PDF
-   */
   async exportToPDF(
     elementId: string,
     options: PDFExportOptions = {}
@@ -60,9 +52,6 @@ export class ReportService {
     pdf.save(options.filename || 'report.pdf');
   }
 
-  /**
-   * Export canvas to PDF
-   */
   async exportCanvasToPDF(
     canvas: HTMLCanvasElement,
     options: PDFExportOptions = {}
@@ -78,16 +67,12 @@ export class ReportService {
     pdf.save(options.filename || 'canvas-export.pdf');
   }
 
-  /**
-   * Export data to Excel
-   */
   async exportToExcel(
     data: ReportData,
     options: ExcelExportOptions = {}
   ): Promise<void> {
     const JSZip = (await import('jszip')).default;
 
-    // Group items by type
     const apps = data.items
       .filter((i) => i.type === 'app')
       .map((i) => ({ Name: i.name, ...i.metrics, ...i.details }));
@@ -109,7 +94,6 @@ export class ReportService {
       sheets.push(recordsToSheet('Posts', posts));
     }
 
-    // Summary sheet
     if (options.includeSummary !== false) {
       const summary = [
         { Metric: 'Total Reach', Value: data.summary.totalReach },
@@ -142,9 +126,6 @@ export class ReportService {
     URL.revokeObjectURL(url);
   }
 
-  /**
-   * Export data to CSV
-   */
   exportToCSV(
     data: ReportData,
     filename: string = 'report.csv',
@@ -170,9 +151,6 @@ export class ReportService {
     URL.revokeObjectURL(url);
   }
 
-  /**
-   * Export multiple elements to PDF
-   */
   async exportMultipleToPDF(
     elementIds: string[],
     options: PDFExportOptions = {}

package/src/application/services/ScreenshotStudioService.ts

@@ -1,7 +1,3 @@
-/**
- * Screenshot Studio Service
- * High-level screenshot generation service
- */
 
 import type {
   ScreenshotContent,
@@ -28,9 +24,6 @@ export class ScreenshotStudioService {
     this.renderer = new ScreenshotRenderer();
   }
 
-  /**
-   * Generate screenshot
-   */
   public async generateScreenshot(
     options: ScreenshotGenerationOptions
   ): Promise<ScreenshotMetadata> {
@@ -73,14 +66,10 @@ export class ScreenshotStudioService {
     };
   }
 
-  /**
-   * Generate batch screenshots
-   */
   public async generateBatchScreenshots(
     deviceTypes: DeviceType[]
   ): Promise<ScreenshotMetadata[]> {
-    // Process in parallel with concurrency control for better performance
-    const BATCH_SIZE = 3; // Process 3 screenshots at a time to avoid memory issues
+    const BATCH_SIZE = 3;
 
     const results: ScreenshotMetadata[] = [];
 
@@ -96,9 +85,6 @@ export class ScreenshotStudioService {
     return results;
   }
 
-  /**
-   * Generate designed screenshot
-   */
   public async generateDesignedScreenshot(
     content: ScreenshotContent,
     design: ScreenshotDesign
@@ -119,9 +105,6 @@ export class ScreenshotStudioService {
     };
   }
 
-  /**
-   * Export project as ZIP
-   */
   public async exportProjectAsZip(
     project: ScreenshotProject
   ): Promise<Blob> {
@@ -133,7 +116,6 @@ export class ScreenshotStudioService {
       throw new Error('Failed to create folder in ZIP');
     }
 
-    // Add metadata if enabled
     if (this.config.export?.includeMetadata) {
       const metadataText = `APP NAME: ${project.appMetadata.appName}
 SUBTITLE: ${project.appMetadata.subtitle}
@@ -147,7 +129,6 @@ ${project.appMetadata.whatsNew}`;
       folder.file('aso_metadata.txt', metadataText);
     }
 
-    // Generate screenshots in parallel for better performance
     const screenshotPromises = project.screens.map((screen, index) =>
       this.generateDesignedScreenshot(screen, project.design)
         .then(screenshot => ({ screenshot, index }))
@@ -155,7 +136,6 @@ ${project.appMetadata.whatsNew}`;
 
     const screenshots = await Promise.all(screenshotPromises);
 
-    // Add all screenshots to ZIP
     screenshots.forEach(({ screenshot, index }) => {
       const base64Data = screenshot.url.split(',')[1];
       folder.file(
@@ -168,9 +148,6 @@ ${project.appMetadata.whatsNew}`;
     return await zip.generateAsync({ type: 'blob' });
   }
 
-  /**
-   * Create project
-   */
   public createProject(name: string): ScreenshotProject {
     return {
       id: this.generateId(),
@@ -193,9 +170,6 @@ ${project.appMetadata.whatsNew}`;
     };
   }
 
-  /**
-   * Get default design
-   */
   private getDefaultDesign(): ScreenshotDesign {
     return {
       backgroundColor: '#6366f1',
@@ -232,9 +206,6 @@ ${project.appMetadata.whatsNew}`;
     };
   }
 
-  /**
-   * Get default screen
-   */
   private getDefaultScreen(): ScreenshotContent {
     return {
       id: '1',
@@ -251,16 +222,11 @@ ${project.appMetadata.whatsNew}`;
     };
   }
 
-  /**
-   * Generate unique ID - optimized version
-   */
   private generateId(): string {
-    // Use more efficient ID generation with crypto if available
     if (typeof crypto !== 'undefined' && crypto.randomUUID) {
       return crypto.randomUUID();
     }
 
-    // Fallback to timestamp + random for better uniqueness
     return `${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 9)}`;
   }
 }

package/src/domain/config/CanvasConfig.ts

@@ -1,31 +1,15 @@
-/**
- * Canvas Configuration
- * Canvas operation configuration
- */
 
 import type { CanvasFormat, CanvasQuality } from '../types/canvas.types';
 
-/**
- * Canvas configuration
- */
 export interface CanvasConfig {
-  /** Default export format */
   defaultFormat?: CanvasFormat;
-  /** Default quality (0.0 - 1.0) */
   defaultQuality?: CanvasQuality;
-  /** Maximum dimension (width or height) */
   maxDimension?: number;
-  /** Scale factor for high-resolution exports */
   scale?: number;
-  /** Default background color */
   backgroundColor?: string;
-  /** Enable CORS for cross-origin images */
   useCORS?: boolean;
 }
 
-/**
- * Default canvas configuration
- */
 export const DEFAULT_CANVAS_CONFIG: CanvasConfig = {
   defaultFormat: 'png',
   defaultQuality: 0.9,

package/src/domain/config/DeviceConfig.ts

@@ -1,29 +1,14 @@
-/**
- * Device Configuration
- * Device frame configuration
- */
 
 import type { DeviceType } from '../types/screenshot.types';
 
-/**
- * Device configuration
- */
 export interface DeviceConfigOption {
-  /** Available device types */
   devices: DeviceType[];
-  /** Default device type */
   defaultDevice?: DeviceType;
-  /** Show device frame */
   showFrame?: boolean;
-  /** Frame color */
   frameColor?: string;
-  /** Frame thickness in pixels */
   frameThickness?: number;
 }
 
-/**
- * Device dimensions presets
- */
 export const DEVICE_DIMENSIONS: Record<DeviceType, { width: number; height: number }> = {
   'iphone-15-pro': { width: 1290, height: 2796 },
   'iphone-15': { width: 1179, height: 2556 },
@@ -35,9 +20,6 @@ export const DEVICE_DIMENSIONS: Record<DeviceType, { width: number; height: numb
   'desktop': { width: 1920, height: 1080 },
 };
 
-/**
- * Default device configuration
- */
 export const DEFAULT_DEVICE_CONFIG: DeviceConfigOption = {
   devices: Object.keys(DEVICE_DIMENSIONS) as DeviceType[],
   defaultDevice: 'iphone-15-pro',

package/src/domain/config/ScreenshotStudioConfig.ts

@@ -1,59 +1,30 @@
-/**
- * Screenshot Studio Configuration
- * Complete screenshot studio configuration
- */
 
 import type { CanvasConfig } from './CanvasConfig';
 import type { DeviceConfigOption } from './DeviceConfig';
 import type { ScreenshotFormat, Language } from '../types/screenshot.types';
 
-/**
- * Export configuration
- */
 export interface ExportConfig {
-  /** Include ASO metadata in export */
   includeMetadata?: boolean;
-  /** ZIP filename template */
   zipFilename?: string;
-  /** Folder structure */
   folderStructure?: 'flat' | 'by-language' | 'by-device';
-  /** Default export format */
   defaultFormat?: ScreenshotFormat;
 }
 
-/**
- * AI configuration
- */
 export interface AIConfig {
-  /** Enable AI features */
   enabled?: boolean;
-  /** AI provider */
   provider?: 'gemini' | 'openai' | 'anthropic';
-  /** API key (if needed) */
   apiKey?: string;
 }
 
-/**
- * Screenshot studio configuration
- */
 export interface ScreenshotStudioConfig {
-  /** Canvas configuration */
   canvas?: CanvasConfig;
-  /** Device configuration */
   device?: DeviceConfigOption;
-  /** Export configuration */
   export?: ExportConfig;
-  /** AI configuration */
   ai?: AIConfig;
-  /** Supported languages */
   languages?: Language[];
-  /** Default language */
   defaultLanguage?: Language;
 }
 
-/**
- * Default screenshot studio configuration
- */
 export const DEFAULT_SCREENSHOT_STUDIO_CONFIG: ScreenshotStudioConfig = {
   canvas: {
     defaultFormat: 'png' as any,

package/src/domain/config/index.ts

@@ -1,7 +1,3 @@
-/**
- * Domain Config Index
- * Export all configuration interfaces and defaults
- */
 
 export * from './CanvasConfig';
 export * from './DeviceConfig';

package/src/domain/index.ts

@@ -1,7 +1,3 @@
-/**
- * Domain Layer Index
- * Export all domain types and configurations
- */
 
 export * from './types';
 export * from './config';

package/src/domain/types/canvas.types.ts

@@ -1,47 +1,22 @@
-/**
- * Canvas Types
- * Core canvas operation types
- */
 
-/**
- * Canvas format options
- */
 export type CanvasFormat = 'png' | 'jpeg' | 'webp';
 
-/**
- * Canvas render quality
- */
-export type CanvasQuality = number; // 0.0 to 1.0
+export type CanvasQuality = number;
 
-/**
- * Canvas dimensions
- */
 export interface CanvasDimensions {
   width: number;
   height: number;
 }
 
-/**
- * Canvas position
- */
 export interface CanvasPosition {
   x: number;
   y: number;
 }
 
-/**
- * Canvas rectangle
- */
 export interface CanvasRect extends CanvasPosition, CanvasDimensions {}
 
-/**
- * Canvas color
- */
 export type CanvasColor = string;
 
-/**
- * Canvas context configuration
- */
 export interface CanvasContextConfig {
   fillStyle?: CanvasColor;
   strokeStyle?: CanvasColor;
@@ -54,9 +29,6 @@ export interface CanvasContextConfig {
   textBaseline?: CanvasTextBaseline;
 }
 
-/**
- * Canvas export options
- */
 export interface CanvasExportOptions {
   format?: CanvasFormat;
   quality?: CanvasQuality;
@@ -65,9 +37,6 @@ export interface CanvasExportOptions {
   useCORS?: boolean;
 }
 
-/**
- * Canvas result
- */
 export interface CanvasResult {
   blob: Blob;
   url: string;
@@ -76,9 +45,6 @@ export interface CanvasResult {
   size: number;
 }
 
-/**
- * Canvas operation callback
- */
 export type CanvasOperation<T> = (
   ctx: CanvasRenderingContext2D,
   dimensions: CanvasDimensions

package/src/domain/types/freehand.types.ts

@@ -1,42 +1,21 @@
-/**
- * Freehand Types
- * Types for pointer-based freehand drawing on a canvas
- */
-
-/**
- * A single sampled point along a stroke, in CSS pixels relative to the canvas
- */
 export interface FreehandPoint {
   x: number;
   y: number;
-  /** Normalized stylus pressure (0–1). ~0.5 for mouse/touch when unsupported. */
   pressure: number;
 }
 
-/**
- * A completed (or in-progress) freehand stroke
- */
 export interface FreehandStroke {
-  /** Base brush size in CSS pixels. */
   size: number;
-  /** CSS color of the stroke. */
   color: string;
-  /** True when the stroke should vary width with per-point pressure. */
   dynamic: boolean;
-  /** Ordered points from pointer-down to pointer-up. */
   points: FreehandPoint[];
 }
 
-/**
- * Options for the useFreehandCanvas hook
- */
 export interface UseFreehandCanvasOptions {
-  /** Base brush size in CSS pixels. Default: 3 */
   brushSize?: number;
-  /** Stroke color. Default: '#1a1a1a' */
   color?: string;
-  /** Vary stroke width with stylus pressure (mouse/touch stay constant). Default: true */
   pressureEnabled?: boolean;
-  /** Called after each completed stroke (pointer-up). */
+  keyboard?: boolean;
+  keyboardStep?: number;
   onStrokeEnd?: (stroke: FreehandStroke) => void;
 }

package/src/domain/types/index.ts

@@ -1,7 +1,3 @@
-/**
- * Domain Types Index
- * Export all domain types
- */
 
 export * from './canvas.types';
 export * from './screenshot.types';

package/src/domain/types/report.types.ts

@@ -1,16 +1,6 @@
-/**
- * Report Types
- * PDF export and report generation types
- */
 
-/**
- * Report item type
- */
 export type ReportItemType = 'app' | 'campaign' | 'post';
 
-/**
- * Report item
- */
 export interface ReportItem {
   name: string;
   type: ReportItemType;
@@ -18,18 +8,12 @@ export interface ReportItem {
   details: Record<string, string | number | boolean | null | undefined>;
 }
 
-/**
- * Report summary
- */
 export interface ReportSummary {
   totalReach: number;
   totalEngagement: number;
   averageScore: number;
 }
 
-/**
- * Report data
- */
 export interface ReportData {
   title: string;
   dateRange: string;
@@ -37,14 +21,8 @@ export interface ReportData {
   summary: ReportSummary;
 }
 
-/**
- * Export format
- */
 export type ExportFormat = 'pdf' | 'excel' | 'csv';
 
-/**
- * PDF export options
- */
 export interface PDFExportOptions {
   filename?: string;
   scale?: number;
@@ -53,27 +31,18 @@ export interface PDFExportOptions {
   format?: 'a4' | 'letter' | 'legal';
 }
 
-/**
- * Excel export options
- */
 export interface ExcelExportOptions {
   filename?: string;
   sheetName?: string;
   includeSummary?: boolean;
 }
 
-/**
- * CSV export options
- */
 export interface CSVExportOptions {
   filename?: string;
   delimiter?: ',' | ';';
   includeHeaders?: boolean;
 }
 
-/**
- * Report export result
- */
 export interface ReportExportResult {
   format: ExportFormat;
   filename: string;