@snowcone-app/canvas 0.1.0

package/dist/workers/export-protocol.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Message Protocol for Export Worker Communication
+ * Defines types for messages sent between main thread and worker
+ */
+export interface ExportRequestMessage {
+    type: 'export';
+    requestId: string;
+    artboardData: {
+        id: string;
+        name: string;
+        width: number;
+        height: number;
+        backgroundColor: string;
+        exportBackground: boolean;
+        x: number;
+        y: number;
+        /** Artboard-level distress texture config */
+        distressTexture?: {
+            enabled: boolean;
+            textureUrl: string;
+            intensity: number;
+        };
+        /** Artboard-level image mask config */
+        imageMask?: {
+            enabled: boolean;
+            imageUrl: string;
+            opacity: number;
+            maskType?: 'clip' | 'alpha' | 'luma';
+            inverted?: boolean;
+        };
+    };
+    elements: any[];
+    fonts?: string[];
+    scale?: number;
+    format?: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    /** Return format - 'dataUrl' for base64 string, 'blob' for transferable Blob */
+    returnFormat?: 'dataUrl' | 'blob';
+}
+/**
+ * Register an ImageBitmap with the worker's cache
+ * Sent before export when a new image needs to be cached
+ */
+export interface RegisterBitmapMessage {
+    type: 'register-bitmap';
+    /** Cache key in format "{elementId}:{srcHash}" */
+    cacheKey: string;
+    /** The bitmap to cache - will be transferred (not copied) */
+    bitmap: ImageBitmap;
+}
+/**
+ * Clear a specific bitmap from the worker's cache
+ * Use when an image element is removed or its source changes
+ */
+export interface ClearBitmapMessage {
+    type: 'clear-bitmap';
+    /** Element ID to clear (clears all cache entries for this element) */
+    elementId: string;
+}
+/**
+ * Clear all bitmaps from the worker's cache
+ * Use when exiting editor mode or resetting
+ */
+export interface ClearAllBitmapsMessage {
+    type: 'clear-all-bitmaps';
+}
+export interface WorkerInitMessage {
+    type: 'init';
+}
+export interface WorkerTerminateMessage {
+    type: 'terminate';
+}
+export type WorkerRequest = ExportRequestMessage | RegisterBitmapMessage | ClearBitmapMessage | ClearAllBitmapsMessage | WorkerInitMessage | WorkerTerminateMessage;
+export interface ExportSuccessResponse {
+    type: 'exportComplete';
+    requestId: string;
+    artboardId: string;
+    artboardName: string;
+    dataUrl: string;
+    renderTime: number;
+    totalTime: number;
+}
+export interface ExportBlobSuccessResponse {
+    type: 'exportBlobComplete';
+    requestId: string;
+    artboardId: string;
+    artboardName: string;
+    /** ArrayBuffer containing the blob data (transferable) */
+    blobData: ArrayBuffer;
+    /** MIME type of the blob */
+    mimeType: string;
+    renderTime: number;
+    totalTime: number;
+}
+export interface ExportErrorResponse {
+    type: 'exportError';
+    requestId: string;
+    artboardId: string;
+    error: string;
+    stack?: string;
+}
+export interface ExportProgressResponse {
+    type: 'exportProgress';
+    requestId: string;
+    progress: number;
+    message: string;
+}
+export interface WorkerReadyResponse {
+    type: 'ready';
+    timestamp: number;
+}
+export type WorkerResponse = ExportSuccessResponse | ExportBlobSuccessResponse | ExportErrorResponse | ExportProgressResponse | WorkerReadyResponse;
+export interface ExportConfig {
+    scale?: number;
+    format?: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    /** Return format - 'dataUrl' for base64 string, 'blob' for Blob object */
+    returnFormat?: 'dataUrl' | 'blob';
+}