Update prototype and tests with v0.8

Author: Jaifroid

tests/prototype/libzim-asm.dev.js

@@ -16,11 +16,23 @@ var Module = typeof Module != 'undefined' ? Module : {};
 
 // --pre-jses are emitted after the Module integration code, so that they can
 // refer to Module (if they choose; they can also define Module)
+/**
+ * Web Worker API for libzim JavaScript bindings
+ * 
+ * This file provides the pre-JS portion of the web worker that handles ZIM file operations.
+ * It is concatenated with postjs_file_api.js during the Emscripten build process (see Makefile)
+ * to create a complete web worker script that can be used with WebAssembly or asm.js builds.
+ * 
+ * Supported actions: getEntryByPath, search, suggest, getArticleCount, init
+ */
+
 self.addEventListener('message', function(e) {
     var action = e.data.action;
     var path = e.data.path;
     var outgoingMessagePort = e.ports[0];
     console.debug('WebWorker called with action=' + action);
+    
+    // Retrieve content from ZIM archive by path
     if (action === 'getEntryByPath') {
         var follow = e.data.follow;
         var entry = Module[action](path);
@@ -43,7 +55,8 @@ self.addEventListener('message', function(e) {
         else {
             outgoingMessagePort.postMessage({ content: new Uint8Array(), mimetype: 'unknown', isRedirect: false});
         }
-    }
+    } 
+    // Full-text search across ZIM archive content
     else if (action === 'search') {
         var text = e.data.text;
         var numResults = e.data.numResults || 50;
@@ -55,11 +68,26 @@ self.addEventListener('message', function(e) {
             serializedEntries.push({path: entry.getPath()});
         }
         outgoingMessagePort.postMessage({ entries: serializedEntries });
-    }
+    } 
+    // Title-based suggestions for autocomplete (faster than full-text search)
+    else if (action === 'suggest') {
+        var text = e.data.text;
+        var numResults = e.data.numResults || 10;
+        var suggestions = Module[action](text, numResults);
+        console.debug('Found nb suggestions = ' + suggestions.size(), suggestions);
+        var serializedSuggestions = [];
+        for (var i=0; i<suggestions.size(); i++) {
+            var entry = suggestions.get(i);
+            serializedSuggestions.push({path: entry.getPath(), title: entry.getTitle()});
+        }
+        outgoingMessagePort.postMessage({ suggestions: serializedSuggestions });
+    } 
+    // Get total number of articles in the ZIM archive
     else if (action === 'getArticleCount') {
         var articleCount = Module[action]();
         outgoingMessagePort.postMessage(articleCount);
-    }
+    } 
+    // Initialize the ZIM archive with file system mounting
     else if (action === 'init') {
         var files = e.data.files;
         var assemblerType = e.data.assemblerType || 'runtime';
@@ -75,6 +103,7 @@ self.addEventListener('message', function(e) {
         for (let i = 0; i < files.length; i++) {
               Module['arguments'].push('/work/' + files[i].name);
         }
+        // Mount file system for ZIM file access (Electron vs browser environments)
         Module['preRun'] = function() {
             FS.mkdir('/work');
             if (files[0].readMode === 'electron') {
@@ -91,6 +120,9 @@ self.addEventListener('message', function(e) {
         console.debug('baseZimFileName = ' + baseZimFileName);
         console.debug("Module['arguments'] = " + Module['arguments']);
 
+        // File continues in postjs_file_api.js - handles invalid actions and closes the event listener
+        // Between prejs and postjs: Emscripten injects the compiled WebAssembly/asm.js Module code and bindings
+
 
 // Sometimes an existing Module object exists with properties
 // meant to overwrite the default module functionality. Here
@@ -7445,21 +7477,21 @@ function invoke_viii(index,a1,a2,a3) {
   }
 }
 
-function invoke_ii(index,a1) {
+function invoke_v(index) {
   var sp = stackSave();
   try {
-    return getWasmTableEntry(index)(a1);
+    getWasmTableEntry(index)();
   } catch(e) {
     stackRestore(sp);
     if (!(e instanceof EmscriptenEH)) throw e;
     _setThrew(1, 0);
   }
 }
 
-function invoke_v(index) {
+function invoke_ii(index,a1) {
   var sp = stackSave();
   try {
-    getWasmTableEntry(index)();
+    return getWasmTableEntry(index)(a1);
   } catch(e) {
     stackRestore(sp);
     if (!(e instanceof EmscriptenEH)) throw e;
@@ -8611,12 +8643,10 @@ run();
 
 // end include: postamble.js
 // include: /src/postjs_file_api.js
-    }
-    else {
+    } else {
         console.error('Invalid action: ' + action);
         outgoingMessagePort.postMessage('invalid action');
     }
-},false);
-
+}, false);
 
 // end include: /src/postjs_file_api.js