inital migration to a sqlite wasm

Author: willwade

README.md

@@ -30,6 +30,20 @@ const texts = await snap.extractTexts('board.sps');
 Browser-safe entry that avoids Node-only dependencies. It expects `Buffer`,
 `Uint8Array`, or `ArrayBuffer` inputs rather than file paths.
 
+SQLite-backed formats (Snap `.sps/.spb` and TouchChat `.ce`) require a WASM
+SQLite engine. Configure `sql.js` in your bundler before loading those formats:
+
+```ts
+import { configureSqlJs, SnapProcessor } from '@willwade/aac-processors/browser';
+
+configureSqlJs({
+  locateFile: (file) => new URL(`./${file}`, import.meta.url).toString(),
+});
+
+const snap = new SnapProcessor();
+const tree = await snap.loadIntoTree(snapUint8Array);
+```
+
 ```ts
 import { GridsetProcessor } from '@willwade/aac-processors/browser';
 

examples/vitedemo/README.md

@@ -5,7 +5,7 @@ A real browser demo that uses Vite to bundle AACProcessors for browser use.
 ## Features
 
 - ✅ **Real file processing** - Upload and process actual AAC files
-- ✅ **All browser-compatible processors** - Tests Dot, OPML, OBF/OBZ, Gridset, ApplePanels, AstericsGrid
+- ✅ **All browser-compatible processors** - Tests Dot, OPML, OBF/OBZ, Gridset, Snap, TouchChat, ApplePanels, AstericsGrid
 - ✅ **Interactive UI** - Drag & drop files, view pages and buttons
 - ✅ **Text-to-speech** - Click SPEAK buttons to hear messages (browser speech API)
 - ✅ **Navigation** - Click NAVIGATE buttons to jump between pages
@@ -43,7 +43,7 @@ If you need a no-build browser check, use the browser test page served by:
 1. **Upload a file**
    - Drag & drop an AAC file onto the upload area
    - Or click to open file picker
-   - Supported formats: .dot, .opml, .obf, .obz, .gridset, .plist, .grd
+   - Supported formats: .dot, .opml, .obf, .obz, .gridset, .sps, .spb, .ce, .plist, .grd
 
 2. **Process the file**
    - Click "Process File" button
@@ -57,7 +57,7 @@ If you need a no-build browser check, use the browser test page served by:
 4. **Run compatibility tests**
    - Click "Run Compatibility Tests"
    - See test results in the left panel
-   - Tests all 6 browser-compatible processors
+   - Tests all browser-compatible processors
 
 ## Supported File Types
 
@@ -67,6 +67,8 @@ If you need a no-build browser check, use the browser test page served by:
 | OPML     | .opml           | OpmlProcessor           |
 | OBF/OBZ  | .obf, .obz      | ObfProcessor            |
 | Gridset  | .gridset        | GridsetProcessor        |
+| Snap     | .sps, .spb      | SnapProcessor           |
+| TouchChat| .ce             | TouchChatProcessor      |
 | Apple    | .plist          | ApplePanelsProcessor    |
 | Asterics | .grd            | AstericsGridProcessor   |
 
@@ -102,10 +104,15 @@ export default defineConfig({
 
 This allows direct TypeScript import without pre-building.
 
-### Import Example
+### Import Example (with SQLite WASM)
 
 ```typescript
-import { getProcessor } from 'aac-processors';
+import { configureSqlJs, getProcessor } from 'aac-processors';
+import sqlWasmUrl from 'sql.js/dist/sql-wasm.wasm?url';
+
+configureSqlJs({
+  locateFile: () => sqlWasmUrl
+});
 
 // Get processor for file type
 const processor = getProcessor('.obf');

examples/vitedemo/index.html

@@ -423,11 +423,11 @@ <h1>🎯 AAC Processors Browser Demo</h1>
                     <div class="upload-icon">📤</div>
                     <p><strong>Drop file here</strong> or click to upload</p>
                     <p style="font-size: 12px; color: #999; margin-top: 5px;">
-                        Supports: .dot, .opml, .obf, .obz, .gridset, .plist, .grd
+                        Supports: .dot, .opml, .obf, .obz, .gridset, .sps, .spb, .ce, .plist, .grd
                     </p>
                 </div>
 
-                <input type="file" id="fileInput" accept=".dot,.opml,.obf,.obz,.gridset,.plist,.grd">
+                <input type="file" id="fileInput" accept=".dot,.opml,.obf,.obz,.gridset,.sps,.spb,.ce,.plist,.grd">
 
                 <div id="fileInfo" style="display: none;">
                     <div class="processor-info">

examples/vitedemo/package-lock.json

@@ -16,6 +16,7 @@
     "@willwade/aac-processors": "file:../..",
     "events": "^3.3.0",
     "jszip": "^3.10.1",
+    "sql.js": "^1.13.0",
     "stream-browserify": "^3.0.0",
     "timers-browserify": "^2.0.12",
     "util": "^0.12.5"

examples/vitedemo/package.json

@@ -66,19 +66,28 @@ if (typeof (window as any).Buffer === 'undefined') {
 }
 
 import {
+  configureSqlJs,
   getProcessor,
   getSupportedExtensions,
   DotProcessor,
   OpmlProcessor,
   ObfProcessor,
   GridsetProcessor,
+  SnapProcessor,
+  TouchChatProcessor,
   ApplePanelsProcessor,
   AstericsGridProcessor,
   AACTree,
   AACPage,
   AACButton
 } from 'aac-processors';
 
+import sqlWasmUrl from 'sql.js/dist/sql-wasm.wasm?url';
+
+configureSqlJs({
+  locateFile: () => sqlWasmUrl
+});
+
 // UI Elements
 const dropArea = document.getElementById('dropArea') as HTMLElement;
 const fileInput = document.getElementById('fileInput') as HTMLInputElement;
@@ -717,19 +726,34 @@ runTestsBtn.addEventListener('click', async () => {
         const opmlProc = getProcessor('.opml');
         const obfProc = getProcessor('.obf');
         const gridsetProc = getProcessor('.gridset');
+        const snapProc = getProcessor('.sps');
+        const touchChatProc = getProcessor('.ce');
         return (
           dotProc instanceof DotProcessor &&
           opmlProc instanceof OpmlProcessor &&
           obfProc instanceof ObfProcessor &&
-          gridsetProc instanceof GridsetProcessor
+          gridsetProc instanceof GridsetProcessor &&
+          snapProc instanceof SnapProcessor &&
+          touchChatProc instanceof TouchChatProcessor
         );
       }
     },
     {
       name: 'getSupportedExtensions() returns all extensions',
       fn: async () => {
         const extensions = getSupportedExtensions();
-        const expected = ['.dot', '.opml', '.obf', '.obz', '.gridset', '.plist', '.grd'];
+        const expected = [
+          '.dot',
+          '.opml',
+          '.obf',
+          '.obz',
+          '.gridset',
+          '.spb',
+          '.sps',
+          '.ce',
+          '.plist',
+          '.grd'
+        ];
         return expected.every((ext) => extensions.includes(ext));
       }
     },
@@ -777,6 +801,28 @@ runTestsBtn.addEventListener('click', async () => {
         }
       }
     },
+    {
+      name: 'SnapProcessor instantiation',
+      fn: async () => {
+        try {
+          new SnapProcessor();
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    },
+    {
+      name: 'TouchChatProcessor instantiation',
+      fn: async () => {
+        try {
+          new TouchChatProcessor();
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    },
     {
       name: 'ApplePanelsProcessor instantiation',
       fn: async () => {

examples/vitedemo/src/main.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

examples/vitedemo/src/vite-env.d.ts

@@ -151,6 +151,7 @@
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.24",
     "@types/plist": "^3.0.5",
+    "@types/sql.js": "^1.4.9",
     "@typescript-eslint/eslint-plugin": "^7.1.0",
     "@typescript-eslint/parser": "^7.1.0",
     "eslint": "^8.56.0",
@@ -174,6 +175,7 @@
     "fast-xml-parser": "^5.2.0",
     "jszip": "^3.10.1",
     "plist": "^3.1.0",
+    "sql.js": "^1.13.0",
     "xml2js": "^0.6.2",
     "yauzl": "^3.2.0"
   },