JS doc updates.

FossilOrigin-Name: 699295f84ef2c4da363f13126abde6af07697d0959896cd868b14513d4278964

diff --git a/ext/wasm/api/sqlite3-api-prologue.js b/ext/wasm/api/sqlite3-api-prologue.js
index 5e1c6ba54d0e1d44a557e1ab71567de857c715eb..e7b775fe51defc3e7d60d64dc866316f5a64ba2e 100644 (file)
--- a/ext/wasm/api/sqlite3-api-prologue.js
+++ b/ext/wasm/api/sqlite3-api-prologue.js
@@ -1955,7 +1955,7 @@ globalThis.sqlite3ApiBootstrap = async function sqlite3ApiBootstrap(
 
      Calls the given _synchronous_ callback function. If that function
      returns sqlite3.capi.SQLITE_BUSY _or_ throws an SQLite3Error
-     which a resultCode property of that value then it will suppress
+     with a resultCode property of that value then it will suppress
      that error and try again, up to the given maximum number of
      times. If the callback returns any other value than that,
      it is returned. If the maximum number of retries has been
@@ -1972,8 +1972,8 @@ globalThis.sqlite3ApiBootstrap = async function sqlite3ApiBootstrap(
      handled as described above. Its result value is ignored.
 
      To effectively retry "forever", pass a negative maxTimes value,
-     with the caveat that there is no recovery from that if the code
-     gets stuck in a deadlock situation.
+     with the caveat that there is no recovery from that unless the
+     beforeRetry() can figure out when to throw.
 
      TODO: an async variant of this.
   */
@@ -2088,13 +2088,15 @@ globalThis.sqlite3ApiBootstrap = async function sqlite3ApiBootstrap(
       return ff.isReady = p.catch(catcher);
     }.bind(sqlite3ApiBootstrap),
     /**
-       scriptInfo ideally gets injected into this object by the
-       infrastructure which assembles the JS/WASM module. It contains
-       state which must be collected before sqlite3ApiBootstrap() can
-       be declared. It is not necessarily available to any
-       sqlite3ApiBootstrap.initializers but "should" be in place (if
-       it's added at all) by the time that
-       sqlite3ApiBootstrap.initializersAsync is processed.
+       scriptInfo holds information about the currenty-loading script
+       so that we can locate the WASM file if it's somewhere other
+       than the build-time-defined directory. It ideally gets injected
+       into this object by the infrastructure which assembles the
+       JS/WASM module. It contains state which must be collected
+       before sqlite3ApiBootstrap() can be declared. It is not
+       necessarily available to any sqlite3ApiBootstrap.initializers
+       but "should" be in place (if it's added at all) by the time
+       that sqlite3ApiBootstrap.initializersAsync is processed.
 
        This state is not part of the public API, only intended for use
        with the sqlite3 API bootstrapping and wasm-loading process.
@@ -2138,10 +2140,10 @@ globalThis.sqlite3ApiBootstrap = async function sqlite3ApiBootstrap(
       loader, and if we lose that capability for some reason then
       we'll lose access to this metadata.
 
-      These data are interesting for exploring how the wasm/JS
-      pieces connect, e.g. for exploring exactly what Emscripten
-      imports into WASM from its JS glue, but it's not
-      SQLite-related.
+      These data are interesting for exploring how the wasm/JS pieces
+      connect, e.g. for exploring exactly what Emscripten imports into
+      WASM from its JS glue, but it's not SQLite-related and is not
+      required for the library to work.
     */
     const iw = sqlite3.scriptInfo?.instantiateWasm;
     if( iw ){

diff --git a/ext/wasm/tests/opfs/concurrency/worker.js b/ext/wasm/tests/opfs/concurrency/worker.js
index fb603cf795c4cad26fcb984f6b44d6a9d2126e3a..398e5b5a7f75bcd0e184a39e309908fbcd2903b8 100644 (file)
--- a/ext/wasm/tests/opfs/concurrency/worker.js
+++ b/ext/wasm/tests/opfs/concurrency/worker.js
@@ -10,7 +10,8 @@ const jsSqlite = urlArgs.get('sqlite3.dir')
       +options.workerName;
 importScripts(jsSqlite)/*Sigh - URL args are not propagated this way*/;
 //const sqlite3InitModule = (await import(jsSqlite)).default;
-globalThis.sqlite3InitModule.__isUnderTest = true;
+globalThis.sqlite3InitModule.__isUnderTest =
+  true /* causes sqlite3.opfs to be retained */;
 globalThis.sqlite3InitModule().then(async function(sqlite3){
   const wPost = (type,...payload)=>{
     postMessage({type, worker: options.workerName, payload});

diff --git a/manifest b/manifest
index 7d3c2bdd6d5c71508873ea7fc75d3e772d1499cb..3f24be31305cd48f03b5f6d794f7e6a1b788fef2 100644 (file)
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Increase\sthe\sversion\snumber\son\strunk\sto\s3.53.0
-D 2026-03-08T10:51:47.666
+C JS\sdoc\supdates.
+D 2026-03-08T12:42:34.028
 F .fossil-settings/binary-glob 61195414528fb3ea9693577e1980230d78a1f8b0a54c78cf1b9b24d0a409ed6a x
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
@@ -591,7 +591,7 @@ F ext/wasm/api/post-js-header.js f35d2dcf1ab7f22a93d565f8e0b622a2934fc4e743edf3b
 F ext/wasm/api/pre-js.c-pp.js 9234ea680a2f6a2a177e8dcd934bdc5811a9f8409165433a252b87f4c07bba6f
 F ext/wasm/api/sqlite3-api-glue.c-pp.js 7afb3da3510facafd94ce31133ec847d0d4db5b2b5e4325941803fd3bca07c16
 F ext/wasm/api/sqlite3-api-oo1.c-pp.js 45454631265d9ce82685f1a64e1650ee19c8e121c41db98a22b534c15e543cfa
-F ext/wasm/api/sqlite3-api-prologue.js db1ba33ca7092f12d5bb6cb615c78c457432be4a1d26785686993a8909950d72
+F ext/wasm/api/sqlite3-api-prologue.js 4336f02ac24ba58e68e355adb9da2804a1eef15a4aee961fa813c7d812a56b54
 F ext/wasm/api/sqlite3-api-worker1.c-pp.js 1041dd645e8e821c082b628cd8d9acf70c667430f9d45167569633ffc7567938
 F ext/wasm/api/sqlite3-license-version-header.js 98d90255a12d02214db634e041c8e7f2f133d9361a8ebf000ba9c9af4c6761cc
 F ext/wasm/api/sqlite3-opfs-async-proxy.c-pp.js c2236c9037ccac368be6eeed3e5f6ed3cefed0d20539c9092139f27a76aaf1ba
@@ -647,7 +647,7 @@ F ext/wasm/tester1.c-pp.html 52d88fe2c6f21a046030a36410b4839b632f4424028197a45a3
 F ext/wasm/tester1.c-pp.js e26e78fe450375b43a88a5da41946b8997612201a592770f19ec827b2bf96cc0
 F ext/wasm/tests/opfs/concurrency/index.html c8ac239f6fb45440adbdddb33a0fde2c61a20799189d60b8926be702a27dd226
 F ext/wasm/tests/opfs/concurrency/test.js 46c772bc18abb0fcbb058d57b5aaee9e7938f948ecdd802c6ca0850ad3519f92
-F ext/wasm/tests/opfs/concurrency/worker.js 4edeec8d88f14c9603c9d4e32ce379ce1d5394f3c5e820776e26a603d600b3e3
+F ext/wasm/tests/opfs/concurrency/worker.js 704d82c5e287e47f612349e027765943a58ad967dcf178fb5a1c3a8eaafb09af
 F ext/wasm/tests/opfs/sahpool/digest-worker.js b0ab6218588f1f0a6d15a363b493ceaf29bfb87804d9e0165915a9996377cf79
 F ext/wasm/tests/opfs/sahpool/digest.html 206d08a34dc8bd570b2581d3d9ab3ecad3201b516a598dd096dcf3cf8cd81df8
 F ext/wasm/tests/opfs/sahpool/index.html be736567fd92d3ecb9754c145755037cbbd2bca01385e2732294b53f4c842328
@@ -2192,8 +2192,8 @@ F tool/warnings-clang.sh bbf6a1e685e534c92ec2bfba5b1745f34fb6f0bc2a362850723a9ee
 F tool/warnings.sh d924598cf2f55a4ecbc2aeb055c10bd5f48114793e7ba25f9585435da29e7e98
 F tool/win/sqlite.vsix deb315d026cc8400325c5863eef847784a219a2f
 F tool/winmain.c 00c8fb88e365c9017db14c73d3c78af62194d9644feaf60e220ab0f411f3604c
-P bcaa876c6dafee0995d239f59b6ce7810b6f5faa219b9c392966211ae3dec17a
-R 5bb3db34ea0d888edcdd73b8c86f90de
-U drh
-Z 5075d03aea4dc83f8f3561051268639a
+P 0152b445ff0cdf560fc028938e1d43a56685d7c046fad84fa90166cd01d71279
+R c2a756d084a38515683f88a003d1705b
+U stephan
+Z d7173eb7134af12db84591911d0c0ce4
 # Remove this line to create a well-formed Fossil manifest.

diff --git a/manifest.uuid b/manifest.uuid
index 5ab5aaa27c909f93f2f7214cfa1b55abcbf7847e..6eb4e7d5766ce9c57ecf388d6200eecee2bd5a37 100644 (file)
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-0152b445ff0cdf560fc028938e1d43a56685d7c046fad84fa90166cd01d71279
+699295f84ef2c4da363f13126abde6af07697d0959896cd868b14513d4278964