sqlmath 2026.7.30 → 2026.9.29

package/test.mjs

@@ -20,11 +20,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 
-/*
- * example usage:
-npm_config_mode_test_save2=1 npm test
- */
-
 /*jslint beta, node*/
 import moduleChildProcess from "child_process";
 import modulePath from "path";
@@ -140,9 +135,9 @@ jstestDescribe((
                     moduleChildProcess.execFile
                 )(
                     (
-                        process.cwd()
-                        + modulePath.sep
-                        + SQLMATH_EXE
+                        process.cwd() +
+                        modulePath.sep +
+                        SQLMATH_EXE
                     ),
                     [
                         ":memory:",
@@ -208,10 +203,10 @@ jstestDescribe((
                         valExpect, valExpect, 0
                     ],
                     (
-                        "SELECT 0;"
-                        + " SELECT ? AS c1, ? AS c2, ? AS c3, ? AS c4"
-                        + " UNION ALL SELECT ?1, ?2, ?3, ?4"
-                        + " UNION ALL SELECT ?1, ?2, ?3, ?4"
+                        "SELECT 0;" +
+                        " SELECT ? AS c1, ? AS c2, ? AS c3, ? AS c4" +
+                        " UNION ALL SELECT ?1, ?2, ?3, ?4" +
+                        " UNION ALL SELECT ?1, ?2, ?3, ?4"
                     )
                 ],
                 [
@@ -221,10 +216,10 @@ jstestDescribe((
                         k3: 0
                     },
                     (
-                        "SELECT 0;"
-                        + " SELECT $k1 AS c1, $k2 AS c2, $k3 AS c3, $k4 AS c4"
-                        + " UNION ALL SELECT :k1, :k2, :k3, :k4"
-                        + " UNION ALL SELECT @k1, @k2, @k3, @k4"
+                        "SELECT 0;" +
+                        " SELECT $k1 AS c1, $k2 AS c2, $k3 AS c3, $k4 AS c4" +
+                        " UNION ALL SELECT :k1, :k2, :k3, :k4" +
+                        " UNION ALL SELECT @k1, @k2, @k3, @k4"
                     )
                 ]
             ].map(async function ([
@@ -314,8 +309,8 @@ jstestDescribe((
                     break;
                 }
                 if (
-                    valIn?.constructor === ArrayBuffer
-                    || ArrayBuffer.isView(valIn)
+                    valIn?.constructor === ArrayBuffer ||
+                    ArrayBuffer.isView(valIn)
                 ) {
                     bufExpect = new TextDecoder().decode(valIn);
                     break;
@@ -703,7 +698,7 @@ SELECT 401 AS c401, 402 AS c402, 403 AS c403
 UNION ALL
 VALUES
     (501, 502.0123, 5030123456789),
-    (601, '602', '603_\"\x01\x08\x09\x0a\x0b\x0c\x0d\x0e'),
+    (601, '602', '603_"\u0001\u0008\u0009\u000a\u000b\u000c\u000d\u000e'),
     (?1, ?2, ?3),
     (CAST(?1 AS TEXT), CAST(?2 AS TEXT), CAST(?3 AS TEXT)),
     (
@@ -1434,8 +1429,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                     return arg - (arg % 1_00);
                 }
                 if (
-                    (/^IDATEYMDFROM|'ITEXTYMD'/).test(sqlFunc)
-                    || ((/_YMD$/).test(sqlFunc) && !(/IDATEFROM/).test(sqlFunc))
+                    (/^IDATEYMDFROM|'ITEXTYMD'/).test(sqlFunc) ||
+                    ((/_YMD$/).test(sqlFunc) && !(/IDATEFROM/).test(sqlFunc))
                 ) {
                     return idateArgYmdTruncate(arg);
                 }
@@ -1845,8 +1840,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "",
                 "COPYBLOB": "",
                 "SHA256": (
-                    "E3B0C44298FC1C149AFBF4C8996FB924"
-                    + "27AE41E4649B934CA495991B7852B855"
+                    "E3B0C44298FC1C149AFBF4C8996FB924" +
+                    "27AE41E4649B934CA495991B7852B855"
                 )
             },
             "'-0.5'": {
@@ -1855,8 +1850,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "-0.5",
                 "COPYBLOB": "-0.5",
                 "SHA256": (
-                    "1B07B0CFFA0B3F596B5E048B01151688"
-                    + "86CC5183DD518655B5515EE5DDDAC6D1"
+                    "1B07B0CFFA0B3F596B5E048B01151688" +
+                    "86CC5183DD518655B5515EE5DDDAC6D1"
                 )
             },
             "'-1'": {
@@ -1867,8 +1862,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": -0.642092615934331,
                 "COTH": -1.31303528549933,
                 "SHA256": (
-                    "1BAD6B8CF97131FCEAB8543E81F77571"
-                    + "95FBB1D36B376EE994AD1CF17699C464"
+                    "1BAD6B8CF97131FCEAB8543E81F77571" +
+                    "95FBB1D36B376EE994AD1CF17699C464"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": -1
@@ -1881,8 +1876,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": null,
                 "COTH": null,
                 "SHA256": (
-                    "5FECEB66FFC86F38D952786C6D696C79"
-                    + "C2DBC239DD4E91B46729D73A27FB57E9"
+                    "5FECEB66FFC86F38D952786C6D696C79" +
+                    "C2DBC239DD4E91B46729D73A27FB57E9"
                 ),
                 "SIGN": 0,
                 "SQRTWITHSIGN": 0
@@ -1893,8 +1888,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "0.5",
                 "COPYBLOB": "0.5",
                 "SHA256": (
-                    "D2CBAD71FF333DE67D07EC676E352AB7"
-                    + "F38248EB69C942950157220607C55E84"
+                    "D2CBAD71FF333DE67D07EC676E352AB7" +
+                    "F38248EB69C942950157220607C55E84"
                 )
             },
             "'1'": {
@@ -1905,8 +1900,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": 0.642092615934331,
                 "COTH": 1.31303528549933,
                 "SHA256": (
-                    "6B86B273FF34FCE19D6B804EFF5A3F57"
-                    + "47ADA4EAA22F1D49C01E52DDB7875B4B"
+                    "6B86B273FF34FCE19D6B804EFF5A3F57" +
+                    "47ADA4EAA22F1D49C01E52DDB7875B4B"
                 ),
                 "SIGN": 1,
                 "SQRTWITHSIGN": 1
@@ -1917,20 +1912,20 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "aa",
                 "COPYBLOB": "aa",
                 "SHA256": (
-                    "961B6DD3EDE3CB8ECBAACBD68DE040CD"
-                    + "78EB2ED5889130CCEB4C49268EA4D506"
+                    "961B6DD3EDE3CB8ECBAACBD68DE040CD" +
+                    "78EB2ED5889130CCEB4C49268EA4D506"
                 )
             },
             "'abc'": {
                 "SHA256": (
-                    "BA7816BF8F01CFEA414140DE5DAE2223"
-                    + "B00361A396177A9CB410FF61F20015AD"
+                    "BA7816BF8F01CFEA414140DE5DAE2223" +
+                    "B00361A396177A9CB410FF61F20015AD"
                 )
             },
             "'abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq'": {
                 "SHA256": (
-                    "248D6A61D20638B8E5C026930C3E6039"
-                    + "A33CE45964FF2167F6ECEDD419DB06C1"
+                    "248D6A61D20638B8E5C026930C3E6039" +
+                    "A33CE45964FF2167F6ECEDD419DB06C1"
                 )
             },
             "'hello'": {
@@ -1939,8 +1934,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "hello",
                 "COPYBLOB": "hello",
                 "SHA256": (
-                    "2CF24DBA5FB0A30E26E83B2AC5B9E29E"
-                    + "1B161E5C1FA7425E73043362938B9824"
+                    "2CF24DBA5FB0A30E26E83B2AC5B9E29E" +
+                    "1B161E5C1FA7425E73043362938B9824"
                 )
             },
             "-0.5": {
@@ -1949,16 +1944,16 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "-0.5",
                 "COPYBLOB": -0.5,
                 "SHA256": (
-                    "1B07B0CFFA0B3F596B5E048B01151688"
-                    + "86CC5183DD518655B5515EE5DDDAC6D1"
+                    "1B07B0CFFA0B3F596B5E048B01151688" +
+                    "86CC5183DD518655B5515EE5DDDAC6D1"
                 )
             },
             "-0x7fffffffffffffff": {
                 "COT": -0.0118008981305845,
                 "COTH": -1,
                 "SHA256": ( // '-9223372036854775807'
-                    "B7AE81320053F61245ED2D36E72E1D05"
-                    + "AD4235D8C784E60285F1EB1F06DA7845"
+                    "B7AE81320053F61245ED2D36E72E1D05" +
+                    "AD4235D8C784E60285F1EB1F06DA7845"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": -3037000499.97605
@@ -1971,8 +1966,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": -0.642092615934331,
                 "COTH": -1.31303528549933,
                 "SHA256": (
-                    "1BAD6B8CF97131FCEAB8543E81F77571"
-                    + "95FBB1D36B376EE994AD1CF17699C464"
+                    "1BAD6B8CF97131FCEAB8543E81F77571" +
+                    "95FBB1D36B376EE994AD1CF17699C464"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": -1
@@ -1981,8 +1976,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": null,
                 "COTH": -1,
                 "SHA256": ( // '-Inf'
-                    "8C1FB05600CEB1FF74474E66DDD603F5"
-                    + "FE8C839B03598A124E2AACB6A08C8837"
+                    "8C1FB05600CEB1FF74474E66DDD603F5" +
+                    "FE8C839B03598A124E2AACB6A08C8837"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": null
@@ -1995,8 +1990,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": null,
                 "COTH": null,
                 "SHA256": (
-                    "5FECEB66FFC86F38D952786C6D696C79"
-                    + "C2DBC239DD4E91B46729D73A27FB57E9"
+                    "5FECEB66FFC86F38D952786C6D696C79" +
+                    "C2DBC239DD4E91B46729D73A27FB57E9"
                 ),
                 "SIGN": 0,
                 "SQRTWITHSIGN": 0
@@ -2007,8 +2002,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "0.5",
                 "COPYBLOB": 0.5,
                 "SHA256": (
-                    "D2CBAD71FF333DE67D07EC676E352AB7"
-                    + "F38248EB69C942950157220607C55E84"
+                    "D2CBAD71FF333DE67D07EC676E352AB7" +
+                    "F38248EB69C942950157220607C55E84"
                 )
             },
             "0.5, 0.5": {
@@ -2024,8 +2019,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": 0.0118008981305845,
                 "COTH": 1,
                 "SHA256": ( // '9223372036854775807'
-                    "B34A1C30A715F6BF8B7243AFA7FAB883"
-                    + "CE3612B7231716BDCBBDC1982E1AED29"
+                    "B34A1C30A715F6BF8B7243AFA7FAB883" +
+                    "CE3612B7231716BDCBBDC1982E1AED29"
                 ),
                 "SIGN": 1,
                 "SQRTWITHSIGN": 3037000499.97605
@@ -2034,8 +2029,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": -0.0118008981305845,
                 "COTH": -1,
                 "SHA256": ( // '-9223372036854775808'
-                    "85386477F3AF47E4A0B308EE3B3A688D"
-                    + "F16E8B2228105DD7D4DCD42A9807CB78"
+                    "85386477F3AF47E4A0B308EE3B3A688D" +
+                    "F16E8B2228105DD7D4DCD42A9807CB78"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": -3037000499.97605
@@ -2044,8 +2039,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": -0.642092615934331,
                 "COTH": -1.31303528549933,
                 "SHA256": ( // '-1'
-                    "1BAD6B8CF97131FCEAB8543E81F77571"
-                    + "95FBB1D36B376EE994AD1CF17699C464"
+                    "1BAD6B8CF97131FCEAB8543E81F77571" +
+                    "95FBB1D36B376EE994AD1CF17699C464"
                 ),
                 "SIGN": -1,
                 "SQRTWITHSIGN": -1
@@ -2058,8 +2053,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": 0.642092615934331,
                 "COTH": 1.31303528549933,
                 "SHA256": (
-                    "6B86B273FF34FCE19D6B804EFF5A3F57"
-                    + "47ADA4EAA22F1D49C01E52DDB7875B4B"
+                    "6B86B273FF34FCE19D6B804EFF5A3F57" +
+                    "47ADA4EAA22F1D49C01E52DDB7875B4B"
                 ),
                 "SIGN": 1,
                 "SQRTWITHSIGN": 1
@@ -2070,8 +2065,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "COT": null,
                 "COTH": 1,
                 "SHA256": ( // 'Inf'
-                    "1DAEC9C71EE2A842CDEE6977AD8C562E"
-                    + "D4AA4FB1338BECD25D79A104B473D9D8"
+                    "1DAEC9C71EE2A842CDEE6977AD8C562E" +
+                    "D4AA4FB1338BECD25D79A104B473D9D8"
                 ),
                 "SIGN": 1,
                 "SQRTWITHSIGN": null
@@ -2102,8 +2097,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "",
                 "COPYBLOB": null,
                 "SHA256": (
-                    "E3B0C44298FC1C149AFBF4C8996FB924"
-                    + "27AE41E4649B934CA495991B7852B855"
+                    "E3B0C44298FC1C149AFBF4C8996FB924" +
+                    "27AE41E4649B934CA495991B7852B855"
                 )
             },
             "ZEROBLOB(1)": {
@@ -2112,8 +2107,8 @@ SELECT DOUBLEARRAY_JSONTO(DOUBLEARRAY_JSONFROM($valIn)) AS result;
                 "CASTTEXTOREMPTY": "",
                 "COPYBLOB": null,
                 "SHA256": (
-                    "6E340B9CFFB37A989CA544E6BB780A2C"
-                    + "78901D3FB33738768511A30617AFA01D"
+                    "6E340B9CFFB37A989CA544E6BB780A2C" +
+                    "78901D3FB33738768511A30617AFA01D"
                 )
             }
         }).forEach(function ([
@@ -2155,15 +2150,13 @@ DROP TABLE IF EXISTS __tmp1;
 CREATE TEMP TABLE __tmp1 (val REAL);
 SELECT
         1 AS id,
-        MEDIAN2(val) AS mdn,
-        QUANTILE(val, 0.5) AS qnt,
         STDEV(val) AS std
     FROM __tmp1;
                 `)
             });
             assertJsonEqual(
                 valActual,
-                [{id: 1, mdn: null, qnt: null, std: null}]
+                [{id: 1, std: null}]
             );
         }());
         await Promise.all([
@@ -2226,20 +2219,12 @@ SELECT
         ]) {
             let avg = 0;
             let data2;
-            let valExpectMdn;
             let valExpectStd = 0;
             data2 = data.map(function (elem) {
                 return Number(elem);
             }).filter(function (elem) {
                 return Number.isFinite(elem);
             }).sort();
-            valExpectMdn = (
-                data2.length % 2 === 0
-                ? 0.5 * (
-                    data2[0.5 * data2.length - 1] + data2[0.5 * data2.length]
-                )
-                : data2[0.5 * (data2.length - 1)]
-            );
             data2.forEach(function (elem) {
                 avg += elem;
             });
@@ -2267,12 +2252,8 @@ SELECT
                     },
                     db,
                     sql: (`
--- test null-case handling-behavior
-SELECT QUANTILE(value, ${qq}) AS qnt FROM JSON_EACH($tmp1) WHERE 0;
 -- test last-row handling-behavior
 SELECT
-        MEDIAN2(value) AS mdn,
-        QUANTILE(value, ${qq}) AS qnt,
         ROUND(stdev(value), 8) AS std
     FROM JSON_EACH($tmp1);
                     `)
@@ -2280,8 +2261,6 @@ SELECT
                 assertJsonEqual(
                     valActual,
                     {
-                        mdn: valExpectMdn,
-                        qnt: valExpect ?? null,
                         std: valExpectStd
                     },
                     {
@@ -2289,7 +2268,6 @@ SELECT
                         qq,
                         valActual,
                         valExpect,
-                        valExpectMdn,
                         valExpectStd
                     }
                 );
@@ -2474,6 +2452,201 @@ SELECT DOUBLEARRAY_JSONTO(WIN_AVG2(1, 2, 3)) FROM __tmp1;
             })
         ]);
     });
+    jstestIt((
+        "test sqlite-extension-win_coinflip2 handling-behavior"
+    ), async function test_sqlite_extension_win_coinflip2() {
+// win_coinflip2 reads ONE value per column, and key biasba50 needs a
+// second bit per row - was the flip called correctly - so it reads the
+// 4-state code SIGN(outcome) * (1 + hit) documented at struct
+// WinCoinflip, sqlmath_base.c:
+//     +2 head-hit  +1 head-miss  0 excluded  -1 tail-miss  -2 tail-hit
+// Sign is the OUTCOME class, so nhead and ntail are the two denominators
+// balanced-accuracy divides by, and biashead reads the CLASS BALANCE
+// under this code, not the hit-rate.
+        let db = await dbOpenAsync({});
+        async function test_coinflip_extract({
+            sqlBetween,
+            valExpect,
+            valIn
+        }) {
+            let valActual = await dbExecAndReturnLastRow({
+                bindList: {
+                    valIn: JSON.stringify(valIn)
+                },
+                db,
+                sql: (`
+SELECT
+        COINFLIP_EXTRACT(__wcf, 0, 'nflip') AS nflip,
+        COINFLIP_EXTRACT(__wcf, 0, 'nhead') AS nhead,
+        COINFLIP_EXTRACT(__wcf, 0, 'nhithead') AS nhithead,
+        COINFLIP_EXTRACT(__wcf, 0, 'nhittail') AS nhittail,
+        COINFLIP_EXTRACT(__wcf, 0, 'ntail') AS ntail,
+        ROUND(COINFLIP_EXTRACT(__wcf, 0, 'biasba50'), 6) AS biasba50,
+        ROUND(COINFLIP_EXTRACT(__wcf, 0, 'biashead'), 6) AS biashead
+    FROM (
+        SELECT
+            WIN_COINFLIP2(value) OVER (
+                ORDER BY key ASC
+                ${sqlBetween}
+            ) AS __wcf
+        FROM JSON_EACH($valIn)
+    );
+                `)
+            });
+            assertJsonEqual(valActual, valExpect);
+        }
+        await Promise.all([
+            // test biasba50-unbalanced-panel handling-behavior
+            // 8 up-days with 7 called right, 2 down-days with 0 called
+            // right - a 70% RAW hit-rate that balanced-accuracy scores
+            // BELOW chance, which is the whole reason for the key.
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: -0.0625,
+                    biashead: 0.3,
+                    nflip: 10,
+                    nhead: 8,
+                    nhithead: 7,
+                    nhittail: 0,
+                    ntail: 2
+                },
+                valIn: [2, 2, 2, 2, 2, 2, 2, 1, -1, -1]
+            }),
+            // test biasba50-parrot-null handling-behavior
+            // an always-up caller hits every up-day and misses every
+            // down-day, and MUST score exactly 0.
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: 0,
+                    biashead: 0.2,
+                    nflip: 10,
+                    nhead: 7,
+                    nhithead: 7,
+                    nhittail: 0,
+                    ntail: 3
+                },
+                valIn: [2, 2, 2, 2, 2, 2, 2, -1, -1, -1]
+            }),
+            // test biasba50-range handling-behavior
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: 0.5,
+                    biashead: 0.1,
+                    nflip: 5,
+                    nhead: 3,
+                    nhithead: 3,
+                    nhittail: 2,
+                    ntail: 2
+                },
+                valIn: [2, 2, 2, -2, -2]
+            }),
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: -0.5,
+                    biashead: 0.1,
+                    nflip: 5,
+                    nhead: 3,
+                    nhithead: 0,
+                    nhittail: 0,
+                    ntail: 2
+                },
+                valIn: [1, 1, 1, -1, -1]
+            }),
+            // test biasba50-one-sided-panel handling-behavior
+            // no down-days means no balanced-accuracy - 0.0/0.0 is NaN,
+            // which sqlite3_result_double_or_null maps to NULL.
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: null,
+                    biashead: 0.5,
+                    nflip: 3,
+                    nhead: 3,
+                    nhithead: 2,
+                    nhittail: 0,
+                    ntail: 0
+                },
+                valIn: [2, 2, 1]
+            }),
+            // test biasba50-legacy-column handling-behavior
+            // a plain 0/1 column carries no hit-bit, so the pre-existing
+            // keys are unchanged and the two hit-counters stay 0.
+            test_coinflip_extract({
+                sqlBetween: "",
+                valExpect: {
+                    biasba50: null,
+                    biashead: 0.166667,
+                    nflip: 6,
+                    nhead: 4,
+                    nhithead: 0,
+                    nhittail: 0,
+                    ntail: 0
+                },
+                valIn: [1, 1, 0, 1, 0, 1]
+            }),
+            // test biasba50-sliding-window handling-behavior
+            // a bounded frame forces xInverse - the 6 leading rows are
+            // all HITS, so an inverse that failed to decrement the two
+            // hit-counters would inflate biasba50 here.
+            test_coinflip_extract({
+                sqlBetween: "ROWS BETWEEN 3 PRECEDING AND CURRENT ROW",
+                valExpect: {
+                    biasba50: 0.25,
+                    biashead: 0,
+                    nflip: 4,
+                    nhead: 2,
+                    nhithead: 2,
+                    nhittail: 1,
+                    ntail: 2
+                },
+                valIn: [2, 2, 2, -2, -2, -2, 2, -1, -2, 2]
+            })
+        ]);
+        // test win_coinflip2-multi-column handling-behavior
+        assertJsonEqual(await dbExecAndReturnLastRow({
+            db,
+            sql: (`
+SELECT
+        COINFLIP_EXTRACT(__wcf, 0, 'biasba50') AS aa,
+        COINFLIP_EXTRACT(__wcf, 1, 'biasba50') AS bb,
+        COINFLIP_EXTRACT(__wcf, 1, 'nstreak') AS cc
+    FROM (
+        SELECT
+            WIN_COINFLIP2(aa, bb) OVER (ORDER BY id ASC) AS __wcf
+        FROM (
+            SELECT 1 AS id, 2 AS aa, 1 AS bb
+            UNION ALL SELECT 2, 2, -1
+            UNION ALL SELECT 3, -2, -1
+            UNION ALL SELECT 4, -1, -1
+        )
+    );
+            `)
+        }), {
+            aa: 0.25,
+            bb: -0.5,
+            cc: -3
+        });
+        // test coinflip_extract-error handling-behavior
+        await assertErrorThrownAsync(
+            dbExecAsync.bind(undefined, {
+                db,
+                sql: (`
+SELECT
+        COINFLIP_EXTRACT(__wcf, 0, 'biasba49')
+    FROM (
+        SELECT
+            WIN_COINFLIP2(value) OVER (ORDER BY key ASC) AS __wcf
+        FROM JSON_EACH('[2,-2]')
+    );
+                `)
+            }),
+            "invalid key"
+        );
+    });
     jstestIt((
         "test sqlite-extension-win_emax handling-behavior"
     ), async function test_sqlite_extension_win_emax() {
@@ -3269,7 +3442,7 @@ SELECT
                 "id2": 3,
                 "laa": -4.5,
                 "lbb": 2.5,
-                "lee": 0.40824829,
+                "lee": 0.70710678,
                 "lxy": 0.94491118,
                 "lyy": 3,
                 "mee": 1.52752523,
@@ -3289,7 +3462,7 @@ SELECT
                 "id2": 4,
                 "laa": -3,
                 "lbb": 1.81818182,
-                "lee": 0.47673129,
+                "lee": 0.67419986,
                 "lxy": 0.95346259,
                 "lyy": 4.27272727,
                 "mee": 1.82574186,
@@ -3309,7 +3482,7 @@ SELECT
                 "id2": 5,
                 "laa": -2.29411765,
                 "lbb": 1.52941176,
-                "lee": 0.50874702,
+                "lee": 0.65678958,
                 "lxy": 0.96164474,
                 "lyy": 5.35294118,
                 "mee": 2.07364414,
@@ -3329,7 +3502,7 @@ SELECT
                 "id2": 6,
                 "laa": -2.54385965,
                 "lbb": 1.63157895,
-                "lee": 0.50725727,
+                "lee": 0.62126074,
                 "lxy": 0.97080629,
                 "lyy": 5.61403509,
                 "mee": 2.31660671,
@@ -3349,7 +3522,7 @@ SELECT
                 "id2": 7,
                 "laa": -2.65,
                 "lbb": 1.675,
-                "lee": 0.48550416,
+                "lee": 0.57445626,
                 "lxy": 0.9752227,
                 "lyy": 5.725,
                 "mee": 2.37045304,
@@ -3369,7 +3542,7 @@ SELECT
                 "id2": 8,
                 "laa": -2.5,
                 "lbb": 1.625,
-                "lee": 0.46770717,
+                "lee": 0.54006172,
                 "lxy": 0.97991187,
                 "lyy": 7.25,
                 "mee": 2.50713268,
@@ -3389,7 +3562,7 @@ SELECT
                 "id2": 9,
                 "laa": 0.75,
                 "lbb": 0.85,
-                "lee": 0.94207218,
+                "lee": 1.08781126,
                 "lxy": 0.89597867,
                 "lyy": 9.25,
                 "mee": 2.26778684,
@@ -3409,7 +3582,7 @@ SELECT
                 "id2": 10,
                 "laa": 2.75,
                 "lbb": 0.55,
-                "lee": 0.8587782,
+                "lee": 0.99163165,
                 "lxy": 0.81989159,
                 "lyy": 3.85,
                 "mee": 1.60356745,
@@ -3451,6 +3624,15 @@ SELECT WIN_SINEFIT2(1, 2, 3) FROM (SELECT 1);
                         `)
                     });
                 }, "wrong number of arguments");
+                // test win_sinefit2-modeSnr-bitmask-overflow handling-behavior
+                await assertErrorThrownAsync(function () {
+                    return dbExecAsync({
+                        db,
+                        sql: (`
+SELECT WIN_SINEFIT2(1, 2${", 3, 4".repeat(31)}) FROM (SELECT 1);
+                        `)
+                    });
+                }, "too many columns");
                 // test win_sinefit2-null-case handling-behavior
                 valActual = await dbExecAndReturnLastTable({
                     db,
@@ -3465,6 +3647,323 @@ SELECT DOUBLEARRAY_JSONTO(WIN_SINEFIT2(1, 2, 3, 4)) FROM __tmp1;
                 });
                 assertJsonEqual(valActual, [null]);
             }()),
+            (async function () {
+                let valActual;
+                let valSine = JSON.stringify(Array.from({
+                    length: 64
+                }, function (ignore, ii) {
+                    return [ii + 1, Math.sin(0.5 * (ii + 1)) + 0.1 * ii];
+                }));
+                // test win_sinefit2-modeSnr-bitmask handling-behavior
+                // Mask 0b110 is inverted on purpose - column 0 must NOT be
+                // sine-fit. A build that re-hardcodes column 0, or that
+                // treats modeSnr as an all-or-nothing flag, fails here.
+                valActual = await dbExecAndReturnLastTable({
+                    bindList: {
+                        valSine
+                    },
+                    db,
+                    sql: (`
+SELECT
+        SINEFIT_EXTRACT(__wsf, 0, 'sww', 0) = 0 AS sww0_off,
+        SINEFIT_EXTRACT(__wsf, 1, 'sww', 0) > 0 AS sww1_on,
+        SINEFIT_EXTRACT(__wsf, 2, 'sww', 0) > 0 AS sww2_on,
+        SINEFIT_EXTRACT(__wsf, 0, 'rrb', 0) IS NOT NULL AS lnr0_on
+    FROM (
+        SELECT
+            key,
+            WIN_SINEFIT2(
+                6, NULL,
+                value->>0, value->>1,
+                value->>0, value->>1,
+                value->>0, value->>1
+            ) OVER (
+                ORDER BY key ASC
+                ROWS BETWEEN 31 PRECEDING AND 0 FOLLOWING
+            ) AS __wsf
+        FROM JSON_EACH($valSine)
+    )
+    WHERE key = 63;
+                    `)
+                });
+                valActual = valActual.map(function (elem) {
+                    return [
+                        elem.sww0_off,
+                        elem.sww1_on,
+                        elem.sww2_on,
+                        elem.lnr0_on
+                    ];
+                });
+                assertJsonEqual(valActual, [[1, 1, 1, 1]]);
+            }()),
+            (async function () {
+                let valActual;
+                let valSine = JSON.stringify(Array.from({
+                    length: 64
+                }, function (ignore, ii) {
+                    return [ii + 1, Math.sin(0.5 * (ii + 1)) + 0.1 * ii];
+                }));
+                // test sinefit_extract-dof handling-behavior
+                // lee divides by nnn-2 (laa, lbb) and see by nnn-5 (those
+                // plus saa, spp, sww). Pin the divisors by comparing a
+                // 32-row window against an 8-row one - the ratio of the
+                // two is free of the unknown residual sum-of-squares only
+                // if we instead check the small-window NULL boundaries,
+                // which is what this does: lee goes NULL at nnn <= 2 and
+                // see at nnn <= 5, and both are finite one row later.
+                valActual = await dbExecAndReturnLastTable({
+                    bindList: {
+                        valSine
+                    },
+                    db,
+                    sql: (`
+SELECT
+        SINEFIT_EXTRACT(__wsf02, 0, 'lee', 0) IS NULL AS lee_null_at_2,
+        SINEFIT_EXTRACT(__wsf03, 0, 'lee', 0) > 0    AS lee_ok_at_3,
+        SINEFIT_EXTRACT(__wsf05, 0, 'see', 0) IS NULL AS see_null_at_5,
+        SINEFIT_EXTRACT(__wsf06, 0, 'see', 0) >= 0   AS see_ok_at_6
+    FROM (
+        SELECT
+            key,
+            WIN_SINEFIT2(1, NULL, value->>0, value->>1) OVER (
+                ORDER BY key ASC ROWS BETWEEN 1 PRECEDING AND 0 FOLLOWING
+            ) AS __wsf02,
+            WIN_SINEFIT2(1, NULL, value->>0, value->>1) OVER (
+                ORDER BY key ASC ROWS BETWEEN 2 PRECEDING AND 0 FOLLOWING
+            ) AS __wsf03,
+            WIN_SINEFIT2(1, NULL, value->>0, value->>1) OVER (
+                ORDER BY key ASC ROWS BETWEEN 4 PRECEDING AND 0 FOLLOWING
+            ) AS __wsf05,
+            WIN_SINEFIT2(1, NULL, value->>0, value->>1) OVER (
+                ORDER BY key ASC ROWS BETWEEN 5 PRECEDING AND 0 FOLLOWING
+            ) AS __wsf06
+        FROM JSON_EACH($valSine)
+    )
+    WHERE key = 63;
+                    `)
+                });
+                valActual = valActual.map(function (elem) {
+                    return [
+                        elem.lee_null_at_2,
+                        elem.lee_ok_at_3,
+                        elem.see_null_at_5,
+                        elem.see_ok_at_6
+                    ];
+                });
+                assertJsonEqual(valActual, [[1, 1, 1, 1]]);
+            }()),
+            // test win_sinefit2-empty-frame handling-behavior
+            (async function () {
+                // WIN_SINEFIT_N = 23 doubles = 184 bytes per column
+                const nhead = 23 * 8;
+// Frame "5 PRECEDING AND 3 PRECEDING" is empty for rows 1-3, so
+// sqlite calls xValue before the first xStep. Regression-test that
+// xValue does not allocate an aggregate-context with nhead=0, which
+// would pin nhead=0 for the life of the aggregate and alias
+// doublewinHead() onto doublewinBody(). ncol=2 additionally
+// overflows the 304-byte nhead=0 allocation, needing 2*184+48 = 416
+// bytes of head.
+                assertJsonEqual(
+                    noop(
+                        await dbExecAsync({
+                            db,
+                            sql: (`
+CREATE TABLE testWinSinefit2Emptyframe AS
+    SELECT 1 AS xx, 1 AS yy
+    --
+    UNION ALL VALUES
+        (2, 2),
+        (3, 3),
+        (4, 4),
+        (5, 5),
+        (6, 6),
+        (7, 7),
+        (8, 8);
+
+-- empty-window-frame
+SELECT
+        LENGTH(WIN_SINEFIT2(0, NULL, xx, yy) OVER (
+            ORDER BY xx
+            ROWS BETWEEN 5 PRECEDING AND 3 PRECEDING
+        )) AS nhead
+    FROM testWinSinefit2Emptyframe;
+
+-- empty-window-frame multi-column
+SELECT
+        LENGTH(WIN_SINEFIT2(0, NULL, xx, yy, xx, yy * 2) OVER (
+            ORDER BY xx
+            ROWS BETWEEN 5 PRECEDING AND 3 PRECEDING
+        )) AS nhead
+    FROM testWinSinefit2Emptyframe;
+-- non-empty-window-frame control
+SELECT
+        LENGTH(WIN_SINEFIT2(0, NULL, xx, yy) OVER (
+            ORDER BY xx
+            ROWS BETWEEN 5 PRECEDING AND CURRENT ROW
+        )) AS nhead
+    FROM testWinSinefit2Emptyframe;
+
+-- sinefit-object is well-formed
+-- row 8 frame = rows 3-5, so nnn = 3
+WITH tmp1 AS (
+        SELECT
+            xx,
+            win_sinefit2(0, NULL, xx, yy, xx, yy * 2) OVER (
+                ORDER BY xx
+                ROWS BETWEEN 5 PRECEDING AND 3 PRECEDING
+            ) AS wsf
+        FROM testWinSinefit2Emptyframe
+    )
+    SELECT
+        SINEFIT_EXTRACT(wsf, 0, 'nnn', 0) AS nnn0,
+        SINEFIT_EXTRACT(wsf, 1, 'nnn', 0) AS nnn1,
+        SINEFIT_EXTRACT(wsf, 0, 'lbb', 0) AS lbb0,
+        SINEFIT_EXTRACT(wsf, 1, 'lbb', 0) AS lbb1
+    FROM tmp1
+    WHERE xx = 8;
+    -- empty-table xFinal
+    SELECT LENGTH(WIN_SINEFIT2(0, NULL, xx, yy)) AS nhead
+    FROM testWinSinefit2Emptyframe
+    WHERE 0;
+                            `)
+                        })
+                    ),
+                    [
+                        [
+                            {nhead: 0},
+                            {nhead: 0},
+                            {nhead: 0},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead}
+                        ],
+                        [
+                            {nhead: 0},
+                            {nhead: 0},
+                            {nhead: 0},
+                            {nhead: 2 * nhead},
+                            {nhead: 2 * nhead},
+                            {nhead: 2 * nhead},
+                            {nhead: 2 * nhead},
+                            {nhead: 2 * nhead}
+                        ],
+                        [
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead},
+                            {nhead}
+                        ],
+                        [
+                            {lbb0: 1, lbb1: 2, nnn0: 3, nnn1: 3}
+                        ],
+                        [
+                            {nhead: 0}
+                        ]
+                    ]
+                );
+            }()),
+            // test sinefit_refitlast malformed-blob handling-behavior
+            (async function () {
+                // WinSinefit field-offsets, in bytes
+                let offsetNnn = 5 * 8;
+                let offsetWbb = 16 * 8;
+                function blobMalformed(nnn, wbb) {
+                    // ncol=1 header = WIN_SINEFIT_N * 8 = 184 bytes
+                    let buf = new ArrayBuffer(184);
+                    let dv = new DataView(buf);
+                    dv.setFloat64(offsetNnn, nnn, true);
+                    dv.setFloat64(offsetWbb, wbb, true);
+                    return new Uint8Array(buf);
+                }
+                // test malformed-nnn handling-behavior
+                await Promise.all([
+                    0 / 0,              // nan
+                    1 / 0,              // inf
+                    -1 / 0,             // -inf
+                    1e300,              // overflows (int)
+                    -1,                 // negative
+                    0,                  // empty
+                    1.5                 // non-integral
+                ].map(function (nnn) {
+                    return assertErrorThrownAsync(function () {
+                        return dbExecAsync({
+                            bindList: [blobMalformed(nnn, 0)],
+                            db,
+                            sql: "SELECT sinefit_refitlast(?1, 0, 0)"
+                        });
+                    }, "sinefit_refitlast");
+                }));
+                // test malformed-wbb handling-behavior
+                // nnn=1 implies nbody = 3, so any wbb but 0 is invalid.
+                await Promise.all([
+                    0 / 0, 1 / 0, 1e300, -1, 1, 2, 3, 1.5
+                ].map(function (wbb) {
+                    return assertErrorThrownAsync(function () {
+                        return dbExecAsync({
+                            bindList: [blobMalformed(1, wbb)],
+                            db,
+                            sql: "SELECT sinefit_refitlast(?1, 0, 0)"
+                        });
+                    }, "sinefit_refitlast");
+                }));
+                // test truncated-blob handling-behavior
+                await assertErrorThrownAsync(function () {
+                    return dbExecAsync({
+                        bindList: [new Uint8Array(100)],
+                        db,
+                        sql: "SELECT sinefit_refitlast(?1, 0, 0)"
+                    });
+                }, "sinefit_refitlast");
+                // test wrong-argc handling-behavior
+                await assertErrorThrownAsync(function () {
+                    return dbExecAsync({
+                        bindList: [blobMalformed(1, 0)],
+                        db,
+                        sql: "SELECT sinefit_refitlast(?1, 0)"
+                    });
+                }, "sinefit_refitlast");
+            }()),
+            // test sinefit_extract non-blob 1st-argument handling-behavior
+            (async function () {
+                await Promise.all([
+                    "'hello'",
+                    "123",
+                    "1.5",
+                    "NULL",
+                    "zeroblob(0)"
+                ].map(function (arg) {
+                    return assertErrorThrownAsync(function () {
+                        return dbExecAsync({
+                            db,
+                            sql: `SELECT sinefit_extract(${arg}, 0, 'nnn', 0)`
+                        });
+                    }, "sinefit_extract");
+                }));
+            }()),
+            // test win_sinefit2-aggregate-normal handling-behavior
+            (async function () {
+                // test non-blob 1st-argument handling-behavior
+                await Promise.all([
+                    "'hello'",
+                    "123",
+                    "1.5",
+                    "NULL",
+                    "zeroblob(0)"
+                ].map(function (arg) {
+                    return assertErrorThrownAsync(function () {
+                        return dbExecAsync({
+                            db,
+                            sql: `SELECT sinefit_extract(${arg}, 0, 'nnn', 0)`
+                        });
+                    }, "sinefit_extract");
+                }));
+            }()),
             // test win_sinefit2-aggregate-normal handling-behavior
             (async function () {
                 let valActual;
@@ -3494,7 +3993,7 @@ SELECT
                         "gyy": 0.19611614,
                         "laa": 0.77941176,
                         "lbb": 0.84558824,
-                        "lee": 1.40010504,
+                        "lee": 1.56536502,
                         "lxy": 0.81541829,
                         "lyy": 2.47058824,
                         "mee": 2.54950976,
@@ -3520,7 +4019,7 @@ SELECT
                     "gyy": -1.02062073,
                     "laa": -0.82025678,
                     "lbb": 0.14621969,
-                    "lee": 2.23885734,
+                    "lee": 2.74202904,
                     "lxy": 0.865665,
                     "lyy": 6.63694722,
                     "mee": 4.89897949,
@@ -3566,7 +4065,7 @@ SELECT
                     "id2": id3,
                     "laa": 5.25,
                     "lbb": -0.275,
-                    "lee": 2.49624718,
+                    "lee": 2.88241797,
                     "lxy": -0.23918696,
                     "lyy": 2.5,
                     "mee": 2.74837614,
@@ -3586,7 +4085,7 @@ SELECT
                     "id2": id4,
                     "laa": 7.25,
                     "lbb": -0.575,
-                    "lee": 1.95735791,
+                    "lee": 2.26016224,
                     "lxy": -0.5490214,
                     "lyy": 6.1,
                     "mee": 2.50356888,
@@ -3918,7 +4417,7 @@ SELECT
     FROM __sinefit_csv
     JOIN (
         SELECT
-            MEDIAN2(rr) AS rr_avg,
+            MEDIAN(rr) AS rr_avg,
             STDEV(rr) AS rr_err
         FROM __sinefit_csv
     )