@willwade/aac-processors 0.1.17 → 0.1.18

package/dist/browser/processors/snap/helpers.js

@@ -4,6 +4,11 @@ import * as path from 'path';
 import Database from 'better-sqlite3';
 import { dotNetTicksToDate } from '../../utils/dotnetTicks';
 // Minimal Snap helpers (stubs) to align with processors/<engine>/helpers pattern
+// NOTE: Snap files can store different types of image data in PageSetData:
+// - PNG/JPEG binaries: Actual images that can be displayed
+// - Vector graphics: Custom format (d7 cd c6 9a) requiring rendering engine
+//
+// We extract PNG/JPEG images but skip vector graphics (requires renderer).
 // NOTE: Snap buttons currently do not populate resolvedImageEntry; these helpers
 // therefore return empty collections until image resolution is implemented.
 function collectFiles(root, matcher, maxDepth = 3) {
@@ -105,6 +110,9 @@ export function openImage(dbOrFile, entryPath) {
             .prepare('SELECT Id, Identifier, Data FROM PageSetData WHERE Identifier = ?')
             .get(entryPath);
         if (row && row.Data && row.Data.length > 0) {
+            // Snap files can store different types of image data:
+            // 1. PNG/JPEG binaries (actual images) - return as-is
+            // 2. Vector graphics (custom format d7 cd c6 9a) - return but may not be displayable
             return row.Data;
         }
         return null;

package/dist/browser/processors/snapProcessor.js

@@ -15,41 +15,6 @@ function mapSnapVisibility(visible) {
     }
     return visible === 0 ? 'Hidden' : 'Visible';
 }
-/**
- * Detect image MIME type from binary data using magic bytes
- * @param buffer Image data buffer
- * @returns MIME type string (defaults to 'image/png' if unknown)
- */
-function detectImageMimeType(buffer) {
-    if (!buffer || buffer.length < 8) {
-        return 'image/png';
-    }
-    // Check for PNG: 89 50 4E 47 0D 0A 1A 0A
-    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {
-        return 'image/png';
-    }
-    // Check for JPEG: FF D8 FF
-    if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
-        return 'image/jpeg';
-    }
-    // Check for GIF: 47 49 46 38 (GIF8)
-    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x38) {
-        return 'image/gif';
-    }
-    // Check for WebP: 52 49 46 46 ... 57 45 42 50 (RIFF...WEBP)
-    if (buffer[0] === 0x52 &&
-        buffer[1] === 0x49 &&
-        buffer[2] === 0x46 &&
-        buffer[3] === 0x46 &&
-        buffer[8] === 0x57 &&
-        buffer[9] === 0x45 &&
-        buffer[10] === 0x42 &&
-        buffer[11] === 0x50) {
-        return 'image/webp';
-    }
-    // Default to PNG
-    return 'image/png';
-}
 class SnapProcessor extends BaseProcessor {
     constructor(symbolResolver = null, options = {}) {
         super(options);
@@ -465,14 +430,30 @@ class SnapProcessor extends BaseProcessor {
                 `)
                                 .get(btnRow.PageSetImageId);
                             if (imageData && imageData.Data && imageData.Data.length > 0) {
-                                const mimeType = detectImageMimeType(imageData.Data);
-                                const base64 = imageData.Data.toString('base64');
-                                buttonImage = `data:${mimeType};base64,${base64}`;
-                                buttonParameters.image_id = imageData.Identifier;
-                                // NOTE: We don't include imageData in parameters because Buffers don't serialize
-                                // correctly across server/client boundaries (Next.js SSR, JSON, etc.)
-                                // The data URL in buttonImage is sufficient for display purposes.
-                                // For conversions, images can be reloaded from the source file/database.
+                                // Snap files can store different types of image data:
+                                // 1. PNG/JPEG binaries (actual images) - extract and display
+                                // 2. Vector graphics (custom format d7 cd c6 9a) - skip (requires renderer)
+                                const data = imageData.Data;
+                                // Check for PNG: 89 50 4E 47
+                                const isPng = data.length > 4 &&
+                                    data[0] === 0x89 &&
+                                    data[1] === 0x50 &&
+                                    data[2] === 0x4e &&
+                                    data[3] === 0x47;
+                                // Check for JPEG: FF D8 FF
+                                const isJpeg = data.length > 3 && data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff;
+                                if (isPng || isJpeg) {
+                                    // Actual PNG/JPEG image - can be displayed
+                                    const mimeType = isPng ? 'image/png' : 'image/jpeg';
+                                    const base64 = data.toString('base64');
+                                    buttonImage = `data:${mimeType};base64,${base64}`;
+                                    buttonParameters.image_id = imageData.Identifier;
+                                }
+                                else {
+                                    // Vector graphics or other format - skip rendering
+                                    // Store identifier but don't create image URL
+                                    buttonParameters.image_id = imageData.Identifier;
+                                }
                             }
                         }
                         catch (e) {

package/dist/processors/snap/helpers.js

@@ -43,6 +43,11 @@ const path = __importStar(require("path"));
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const dotnetTicks_1 = require("../../utils/dotnetTicks");
 // Minimal Snap helpers (stubs) to align with processors/<engine>/helpers pattern
+// NOTE: Snap files can store different types of image data in PageSetData:
+// - PNG/JPEG binaries: Actual images that can be displayed
+// - Vector graphics: Custom format (d7 cd c6 9a) requiring rendering engine
+//
+// We extract PNG/JPEG images but skip vector graphics (requires renderer).
 // NOTE: Snap buttons currently do not populate resolvedImageEntry; these helpers
 // therefore return empty collections until image resolution is implemented.
 function collectFiles(root, matcher, maxDepth = 3) {
@@ -144,6 +149,9 @@ function openImage(dbOrFile, entryPath) {
             .prepare('SELECT Id, Identifier, Data FROM PageSetData WHERE Identifier = ?')
             .get(entryPath);
         if (row && row.Data && row.Data.length > 0) {
+            // Snap files can store different types of image data:
+            // 1. PNG/JPEG binaries (actual images) - return as-is
+            // 2. Vector graphics (custom format d7 cd c6 9a) - return but may not be displayable
             return row.Data;
         }
         return null;

package/dist/processors/snapProcessor.js

@@ -18,41 +18,6 @@ function mapSnapVisibility(visible) {
     }
     return visible === 0 ? 'Hidden' : 'Visible';
 }
-/**
- * Detect image MIME type from binary data using magic bytes
- * @param buffer Image data buffer
- * @returns MIME type string (defaults to 'image/png' if unknown)
- */
-function detectImageMimeType(buffer) {
-    if (!buffer || buffer.length < 8) {
-        return 'image/png';
-    }
-    // Check for PNG: 89 50 4E 47 0D 0A 1A 0A
-    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {
-        return 'image/png';
-    }
-    // Check for JPEG: FF D8 FF
-    if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
-        return 'image/jpeg';
-    }
-    // Check for GIF: 47 49 46 38 (GIF8)
-    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x38) {
-        return 'image/gif';
-    }
-    // Check for WebP: 52 49 46 46 ... 57 45 42 50 (RIFF...WEBP)
-    if (buffer[0] === 0x52 &&
-        buffer[1] === 0x49 &&
-        buffer[2] === 0x46 &&
-        buffer[3] === 0x46 &&
-        buffer[8] === 0x57 &&
-        buffer[9] === 0x45 &&
-        buffer[10] === 0x42 &&
-        buffer[11] === 0x50) {
-        return 'image/webp';
-    }
-    // Default to PNG
-    return 'image/png';
-}
 class SnapProcessor extends baseProcessor_1.BaseProcessor {
     constructor(symbolResolver = null, options = {}) {
         super(options);
@@ -468,14 +433,30 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 `)
                                 .get(btnRow.PageSetImageId);
                             if (imageData && imageData.Data && imageData.Data.length > 0) {
-                                const mimeType = detectImageMimeType(imageData.Data);
-                                const base64 = imageData.Data.toString('base64');
-                                buttonImage = `data:${mimeType};base64,${base64}`;
-                                buttonParameters.image_id = imageData.Identifier;
-                                // NOTE: We don't include imageData in parameters because Buffers don't serialize
-                                // correctly across server/client boundaries (Next.js SSR, JSON, etc.)
-                                // The data URL in buttonImage is sufficient for display purposes.
-                                // For conversions, images can be reloaded from the source file/database.
+                                // Snap files can store different types of image data:
+                                // 1. PNG/JPEG binaries (actual images) - extract and display
+                                // 2. Vector graphics (custom format d7 cd c6 9a) - skip (requires renderer)
+                                const data = imageData.Data;
+                                // Check for PNG: 89 50 4E 47
+                                const isPng = data.length > 4 &&
+                                    data[0] === 0x89 &&
+                                    data[1] === 0x50 &&
+                                    data[2] === 0x4e &&
+                                    data[3] === 0x47;
+                                // Check for JPEG: FF D8 FF
+                                const isJpeg = data.length > 3 && data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff;
+                                if (isPng || isJpeg) {
+                                    // Actual PNG/JPEG image - can be displayed
+                                    const mimeType = isPng ? 'image/png' : 'image/jpeg';
+                                    const base64 = data.toString('base64');
+                                    buttonImage = `data:${mimeType};base64,${base64}`;
+                                    buttonParameters.image_id = imageData.Identifier;
+                                }
+                                else {
+                                    // Vector graphics or other format - skip rendering
+                                    // Store identifier but don't create image URL
+                                    buttonParameters.image_id = imageData.Identifier;
+                                }
                             }
                         }
                         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "browser": "dist/browser/index.browser.js",