@bicharts/chart-host 0.5.122 → 0.6.0

package/dist/{chunk-7RLI3VOM.mjs → chunk-DTAYO46G.mjs}

@@ -142,15 +142,15 @@ var require_papaparse_min = __commonJS({
           return "greedy" === m4.skipEmptyLines ? "" === e2.join("").trim() : 1 === e2.length && 0 === e2[0].length;
         }
         function g4() {
-          if (p4 && a5 && (k3("Delimiter", "UndetectableDelimiter", "Unable to auto-detect delimiting character; defaulted to '" + v2.DefaultDelimiter + "'"), a5 = false), m4.skipEmptyLines && (p4.data = p4.data.filter(function(e4) {
+          if (p4 && a5 && (k2("Delimiter", "UndetectableDelimiter", "Unable to auto-detect delimiting character; defaulted to '" + v2.DefaultDelimiter + "'"), a5 = false), m4.skipEmptyLines && (p4.data = p4.data.filter(function(e4) {
             return !y6(e4);
-          })), _4()) {
+          })), _3()) {
             let t4 = function(e4, t5) {
               e4 = P2(e4), q4(m4.transformHeader) && (e4 = m4.transformHeader(e4, t5)), c4.push(e4);
             };
             var t2 = t4;
             if (p4) if (Array.isArray(p4.data[0])) {
-              for (var e2 = 0; _4() && e2 < p4.data.length; e2++) p4.data[e2].forEach(t4);
+              for (var e2 = 0; _3() && e2 < p4.data.length; e2++) p4.data[e2].forEach(t4);
               p4.data.splice(0, 1);
             } else p4.data.forEach(t4);
           }
@@ -164,26 +164,26 @@ var require_papaparse_min = __commonJS({
               })(t5) ? parseFloat(t5) : d3.test(t5) ? new Date(t5) : "" === t5 ? null : t5) : t5)(n4 = m4.header ? r5 >= c4.length ? "__parsed_extra" : c4[r5] : n4, s4 = m4.transform ? m4.transform(s4, n4) : s4);
               "__parsed_extra" === n4 ? (i5[n4] = i5[n4] || [], i5[n4].push(s4)) : i5[n4] = s4;
             }
-            return m4.header && (r5 > c4.length ? k3("FieldMismatch", "TooManyFields", "Too many fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4) : r5 < c4.length && k3("FieldMismatch", "TooFewFields", "Too few fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4)), i5;
+            return m4.header && (r5 > c4.length ? k2("FieldMismatch", "TooManyFields", "Too many fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4) : r5 < c4.length && k2("FieldMismatch", "TooFewFields", "Too few fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4)), i5;
           }
           var r4;
           p4 && (m4.header || m4.dynamicTyping || m4.transform) && (r4 = 1, !p4.data.length || Array.isArray(p4.data[0]) ? (p4.data = p4.data.map(i4), r4 = p4.data.length) : p4.data = i4(p4.data, 0), m4.header && p4.meta && (p4.meta.fields = c4), f5 += r4);
         }
-        function _4() {
+        function _3() {
           return m4.header && 0 === c4.length;
         }
-        function k3(e2, t2, i4, r4) {
+        function k2(e2, t2, i4, r4) {
           e2 = { type: e2, code: t2, message: i4 };
           void 0 !== r4 && (e2.row = r4), p4.errors.push(e2);
         }
         q4(m4.step) && (t = m4.step, m4.step = function(e2) {
-          p4 = e2, _4() ? g4() : (g4(), 0 !== p4.data.length && (r2 += e2.data.length, m4.preview && r2 > m4.preview ? s2.abort() : (p4.data = p4.data[0], t(p4, i2))));
+          p4 = e2, _3() ? g4() : (g4(), 0 !== p4.data.length && (r2 += e2.data.length, m4.preview && r2 > m4.preview ? s2.abort() : (p4.data = p4.data[0], t(p4, i2))));
         }), this.parse = function(e2, t2, i4) {
           var r4 = m4.quoteChar || '"', r4 = (m4.newline || (m4.newline = this.guessLineEndings(e2, r4)), a5 = false, m4.delimiter ? q4(m4.delimiter) && (m4.delimiter = m4.delimiter(e2), p4.meta.delimiter = m4.delimiter) : ((r4 = ((e4, t4, i5, r5, n4) => {
             var s4, a6, o4, h5;
             n4 = n4 || [",", "	", "|", ";", v2.RECORD_SEP, v2.UNIT_SEP];
             for (var u5 = 0; u5 < n4.length; u5++) {
-              for (var d4, f6 = n4[u5], l3 = 0, c5 = 0, p5 = 0, g5 = (o4 = void 0, new E4({ comments: r5, delimiter: f6, newline: t4, preview: 10 }).parse(e4)), _5 = 0; _5 < g5.data.length; _5++) i5 && y6(g5.data[_5]) ? p5++ : (d4 = g5.data[_5].length, c5 += d4, void 0 === o4 ? o4 = d4 : 0 < d4 && (l3 += Math.abs(d4 - o4), o4 = d4));
+              for (var d4, f6 = n4[u5], l3 = 0, c5 = 0, p5 = 0, g5 = (o4 = void 0, new E4({ comments: r5, delimiter: f6, newline: t4, preview: 10 }).parse(e4)), _4 = 0; _4 < g5.data.length; _4++) i5 && y6(g5.data[_4]) ? p5++ : (d4 = g5.data[_4].length, c5 += d4, void 0 === o4 ? o4 = d4 : 0 < d4 && (l3 += Math.abs(d4 - o4), o4 = d4));
               0 < g5.data.length && (c5 /= g5.data.length - p5), (void 0 === a6 || l3 <= a6) && (void 0 === h5 || h5 < c5) && 1.99 < c5 && (a6 = l3, s4 = f6, h5 = c5);
             }
             return { successful: !!(m4.delimiter = s4), bestDelimiter: s4 };
@@ -211,42 +211,42 @@ var require_papaparse_min = __commonJS({
         return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       }
       function E4(C) {
-        var S = (C = C || {}).delimiter, O3 = C.newline, x4 = C.comments, I2 = C.step, A2 = C.preview, T3 = C.fastMode, D3 = null, L2 = false, F3 = null == C.quoteChar ? '"' : C.quoteChar, j3 = F3;
-        if (void 0 !== C.escapeChar && (j3 = C.escapeChar), ("string" != typeof S || -1 < v2.BAD_DELIMITERS.indexOf(S)) && (S = ","), x4 === S) throw new Error("Comment character same as delimiter");
+        var S2 = (C = C || {}).delimiter, O3 = C.newline, x4 = C.comments, I2 = C.step, A = C.preview, T3 = C.fastMode, D4 = null, L2 = false, F4 = null == C.quoteChar ? '"' : C.quoteChar, j3 = F4;
+        if (void 0 !== C.escapeChar && (j3 = C.escapeChar), ("string" != typeof S2 || -1 < v2.BAD_DELIMITERS.indexOf(S2)) && (S2 = ","), x4 === S2) throw new Error("Comment character same as delimiter");
         true === x4 ? x4 = "#" : ("string" != typeof x4 || -1 < v2.BAD_DELIMITERS.indexOf(x4)) && (x4 = false), "\n" !== O3 && "\r" !== O3 && "\r\n" !== O3 && (O3 = "\n");
         var z3 = 0, M2 = false;
         this.parse = function(i2, t, r2) {
           if ("string" != typeof i2) throw new Error("Input must be a string");
-          var n2 = i2.length, e = S.length, s2 = O3.length, a5 = x4.length, o2 = q4(I2), h4 = [], u4 = [], d3 = [], f5 = z3 = 0;
+          var n2 = i2.length, e = S2.length, s2 = O3.length, a5 = x4.length, o2 = q4(I2), h4 = [], u4 = [], d3 = [], f5 = z3 = 0;
           if (!i2) return w2();
-          if (T3 || false !== T3 && -1 === i2.indexOf(F3)) {
+          if (T3 || false !== T3 && -1 === i2.indexOf(F4)) {
             for (var l2 = i2.split(O3), c4 = 0; c4 < l2.length; c4++) {
               if (d3 = l2[c4], z3 += d3.length, c4 !== l2.length - 1) z3 += O3.length;
               else if (r2) return w2();
               if (!x4 || d3.substring(0, a5) !== x4) {
                 if (o2) {
-                  if (h4 = [], k3(d3.split(S)), R2(), M2) return w2();
-                } else k3(d3.split(S));
-                if (A2 && A2 <= c4) return h4 = h4.slice(0, A2), w2(true);
+                  if (h4 = [], k2(d3.split(S2)), R2(), M2) return w2();
+                } else k2(d3.split(S2));
+                if (A && A <= c4) return h4 = h4.slice(0, A), w2(true);
               }
             }
             return w2();
           }
-          for (var p4 = i2.indexOf(S, z3), g4 = i2.indexOf(O3, z3), _4 = new RegExp(U2(j3) + U2(F3), "g"), m4 = i2.indexOf(F3, z3); ; ) if (i2[z3] === F3) for (m4 = z3, z3++; ; ) {
-            if (-1 === (m4 = i2.indexOf(F3, m4 + 1))) return r2 || u4.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h4.length, index: z3 }), E5();
-            if (m4 === n2 - 1) return E5(i2.substring(z3, m4).replace(_4, F3));
-            if (F3 === j3 && i2[m4 + 1] === j3) m4++;
-            else if (F3 === j3 || 0 === m4 || i2[m4 - 1] !== j3) {
-              -1 !== p4 && p4 < m4 + 1 && (p4 = i2.indexOf(S, m4 + 1));
+          for (var p4 = i2.indexOf(S2, z3), g4 = i2.indexOf(O3, z3), _3 = new RegExp(U2(j3) + U2(F4), "g"), m4 = i2.indexOf(F4, z3); ; ) if (i2[z3] === F4) for (m4 = z3, z3++; ; ) {
+            if (-1 === (m4 = i2.indexOf(F4, m4 + 1))) return r2 || u4.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h4.length, index: z3 }), E5();
+            if (m4 === n2 - 1) return E5(i2.substring(z3, m4).replace(_3, F4));
+            if (F4 === j3 && i2[m4 + 1] === j3) m4++;
+            else if (F4 === j3 || 0 === m4 || i2[m4 - 1] !== j3) {
+              -1 !== p4 && p4 < m4 + 1 && (p4 = i2.indexOf(S2, m4 + 1));
               var y6 = v3(-1 === (g4 = -1 !== g4 && g4 < m4 + 1 ? i2.indexOf(O3, m4 + 1) : g4) ? p4 : Math.min(p4, g4));
-              if (i2.substr(m4 + 1 + y6, e) === S) {
-                d3.push(i2.substring(z3, m4).replace(_4, F3)), i2[z3 = m4 + 1 + y6 + e] !== F3 && (m4 = i2.indexOf(F3, z3)), p4 = i2.indexOf(S, z3), g4 = i2.indexOf(O3, z3);
+              if (i2.substr(m4 + 1 + y6, e) === S2) {
+                d3.push(i2.substring(z3, m4).replace(_3, F4)), i2[z3 = m4 + 1 + y6 + e] !== F4 && (m4 = i2.indexOf(F4, z3)), p4 = i2.indexOf(S2, z3), g4 = i2.indexOf(O3, z3);
                 break;
               }
               y6 = v3(g4);
               if (i2.substring(m4 + 1 + y6, m4 + 1 + y6 + s2) === O3) {
-                if (d3.push(i2.substring(z3, m4).replace(_4, F3)), b5(m4 + 1 + y6 + s2), p4 = i2.indexOf(S, z3), m4 = i2.indexOf(F3, z3), o2 && (R2(), M2)) return w2();
-                if (A2 && h4.length >= A2) return w2(true);
+                if (d3.push(i2.substring(z3, m4).replace(_3, F4)), b5(m4 + 1 + y6 + s2), p4 = i2.indexOf(S2, z3), m4 = i2.indexOf(F4, z3), o2 && (R2(), M2)) return w2();
+                if (A && h4.length >= A) return w2(true);
                 break;
               }
               u4.push({ type: "Quotes", code: "InvalidQuotes", message: "Trailing quote on quoted field is malformed", row: h4.length, index: z3 }), m4++;
@@ -254,15 +254,15 @@ var require_papaparse_min = __commonJS({
           }
           else if (x4 && 0 === d3.length && i2.substring(z3, z3 + a5) === x4) {
             if (-1 === g4) return w2();
-            z3 = g4 + s2, g4 = i2.indexOf(O3, z3), p4 = i2.indexOf(S, z3);
-          } else if (-1 !== p4 && (p4 < g4 || -1 === g4)) d3.push(i2.substring(z3, p4)), z3 = p4 + e, p4 = i2.indexOf(S, z3);
+            z3 = g4 + s2, g4 = i2.indexOf(O3, z3), p4 = i2.indexOf(S2, z3);
+          } else if (-1 !== p4 && (p4 < g4 || -1 === g4)) d3.push(i2.substring(z3, p4)), z3 = p4 + e, p4 = i2.indexOf(S2, z3);
           else {
             if (-1 === g4) break;
             if (d3.push(i2.substring(z3, g4)), b5(g4 + s2), o2 && (R2(), M2)) return w2();
-            if (A2 && h4.length >= A2) return w2(true);
+            if (A && h4.length >= A) return w2(true);
           }
           return E5();
-          function k3(e2) {
+          function k2(e2) {
             h4.push(e2), f5 = z3;
           }
           function v3(e2) {
@@ -270,10 +270,10 @@ var require_papaparse_min = __commonJS({
             return t2 = -1 !== e2 && (e2 = i2.substring(m4 + 1, e2)) && "" === e2.trim() ? e2.length : t2;
           }
           function E5(e2) {
-            return r2 || (void 0 === e2 && (e2 = i2.substring(z3)), d3.push(e2), z3 = n2, k3(d3), o2 && R2()), w2();
+            return r2 || (void 0 === e2 && (e2 = i2.substring(z3)), d3.push(e2), z3 = n2, k2(d3), o2 && R2()), w2();
           }
           function b5(e2) {
-            z3 = e2, k3(d3), d3 = [], g4 = i2.indexOf(O3, z3);
+            z3 = e2, k2(d3), d3 = [], g4 = i2.indexOf(O3, z3);
           }
           function w2(e2) {
             if (C.header && !t && h4.length && !L2) {
@@ -284,13 +284,13 @@ var require_papaparse_min = __commonJS({
                 if (a6[i4 = q4(C.transformHeader) ? C.transformHeader(i4, r4) : i4]) {
                   let e4, t2 = a6[i4];
                   for (; e4 = i4 + "_" + t2, t2++, o4.has(e4); ) ;
-                  o4.add(e4), s4[r4] = e4, a6[i4]++, n4 = true, (D3 = null === D3 ? {} : D3)[e4] = i4;
+                  o4.add(e4), s4[r4] = e4, a6[i4]++, n4 = true, (D4 = null === D4 ? {} : D4)[e4] = i4;
                 } else a6[i4] = 1, s4[r4] = i4;
                 o4.add(i4);
               }
               n4 && console.warn("Duplicate headers found and renamed."), L2 = true;
             }
-            return { data: h4, errors: u4, meta: { delimiter: S, linebreak: O3, aborted: M2, truncated: !!e2, cursor: f5 + (t || 0), renamedHeaders: D3 } };
+            return { data: h4, errors: u4, meta: { delimiter: S2, linebreak: O3, aborted: M2, truncated: !!e2, cursor: f5 + (t || 0), renamedHeaders: D4 } };
           }
           function R2() {
             I2(w2()), h4 = [], u4 = [];
@@ -306,16 +306,16 @@ var require_papaparse_min = __commonJS({
         if (t.error) i2.userError(t.error, t.file);
         else if (t.results && t.results.data) {
           var n2 = { abort: function() {
-            r2 = true, _3(t.workerId, { data: [], errors: [], meta: { aborted: true } });
+            r2 = true, _2(t.workerId, { data: [], errors: [], meta: { aborted: true } });
           }, pause: m2, resume: m2 };
           if (q4(i2.userStep)) {
             for (var s2 = 0; s2 < t.results.data.length && (i2.userStep({ data: t.results.data[s2], errors: t.results.errors, meta: t.results.meta }, n2), !r2); s2++) ;
             delete t.results;
           } else q4(i2.userChunk) && (i2.userChunk(t.results, n2, t.file), delete t.results);
         }
-        t.finished && !r2 && _3(t.workerId, t.results);
+        t.finished && !r2 && _2(t.workerId, t.results);
       }
-      function _3(e, t) {
+      function _2(e, t) {
         var i2 = o[e];
         q4(i2.userComplete) && i2.userComplete(t), i2.terminate(), delete o[e];
       }
@@ -348,11 +348,11 @@ var require_papaparse_min = __commonJS({
           })(), (e2 = new n.Worker(e2)).onmessage = g3, e2.id = h3++, o[e2.id] = e2);
         })()).userStep = t.step, i2.userChunk = t.chunk, i2.userComplete = t.complete, i2.userError = t.error, t.step = q4(t.step), t.chunk = q4(t.chunk), t.complete = q4(t.complete), t.error = q4(t.error), delete t.worker, i2.postMessage({ input: e, config: t, workerId: i2.id });
       }, v2.unparse = function(e, t) {
-        var s2 = false, _4 = true, m4 = ",", y6 = "\r\n", a5 = '"', o2 = a5 + a5, i2 = false, r2 = null, h4 = false, u4 = ((() => {
+        var s2 = false, _3 = true, m4 = ",", y6 = "\r\n", a5 = '"', o2 = a5 + a5, i2 = false, r2 = null, h4 = false, u4 = ((() => {
           if ("object" == typeof t) {
             if ("string" != typeof t.delimiter || v2.BAD_DELIMITERS.filter(function(e2) {
               return -1 !== t.delimiter.indexOf(e2);
-            }).length || (m4 = t.delimiter), "boolean" != typeof t.quotes && "function" != typeof t.quotes && !Array.isArray(t.quotes) || (s2 = t.quotes), "boolean" != typeof t.skipEmptyLines && "string" != typeof t.skipEmptyLines || (i2 = t.skipEmptyLines), "string" == typeof t.newline && (y6 = t.newline), "string" == typeof t.quoteChar && (a5 = t.quoteChar, o2 = a5 + a5), "boolean" == typeof t.header && (_4 = t.header), Array.isArray(t.columns)) {
+            }).length || (m4 = t.delimiter), "boolean" != typeof t.quotes && "function" != typeof t.quotes && !Array.isArray(t.quotes) || (s2 = t.quotes), "boolean" != typeof t.skipEmptyLines && "string" != typeof t.skipEmptyLines || (i2 = t.skipEmptyLines), "string" == typeof t.newline && (y6 = t.newline), "string" == typeof t.quoteChar && (a5 = t.quoteChar, o2 = a5 + a5), "boolean" == typeof t.header && (_3 = t.header), Array.isArray(t.columns)) {
               if (0 === t.columns.length) throw new Error("Option columns is empty");
               r2 = t.columns;
             }
@@ -367,8 +367,8 @@ var require_papaparse_min = __commonJS({
         throw new Error("Unable to serialize unrecognized input");
         function n2(e2, t2, i4) {
           var r4 = "", n4 = ("string" == typeof e2 && (e2 = JSON.parse(e2)), "string" == typeof t2 && (t2 = JSON.parse(t2)), Array.isArray(e2) && 0 < e2.length), s4 = !Array.isArray(t2[0]);
-          if (n4 && _4) {
-            for (var a6 = 0; a6 < e2.length; a6++) 0 < a6 && (r4 += m4), r4 += k3(e2[a6], a6);
+          if (n4 && _3) {
+            for (var a6 = 0; a6 < e2.length; a6++) 0 < a6 && (r4 += m4), r4 += k2(e2[a6], a6);
             0 < t2.length && (r4 += y6);
           }
           for (var o4 = 0; o4 < t2.length; o4++) {
@@ -384,14 +384,14 @@ var require_papaparse_min = __commonJS({
               for (var p4 = 0; p4 < h5; p4++) {
                 0 < p4 && !d3 && (r4 += m4);
                 var g4 = n4 && s4 ? e2[p4] : p4;
-                r4 += k3(t2[o4][g4], p4);
+                r4 += k2(t2[o4][g4], p4);
               }
               o4 < t2.length - 1 && (!i4 || 0 < h5 && !d3) && (r4 += y6);
             }
           }
           return r4;
         }
-        function k3(e2, t2) {
+        function k2(e2, t2) {
           var i4, r4, n4;
           return null == e2 ? "" : e2.constructor === Date ? JSON.stringify(e2).slice(1, 25) : (n4 = false, h4 && "string" == typeof e2 && h4.test(e2) && (e2 = "'" + e2, n4 = true), r4 = (i4 = e2.toString()).replace(u4, o2), (n4 = n4 || true === s2 || "function" == typeof s2 && s2(e2, t2) || Array.isArray(s2) && s2[t2] || ((e4, t4) => {
             for (var i5 = 0; i5 < t4.length; i5++) if (-1 < e4.indexOf(t4[i5])) return true;
@@ -450,9 +450,9 @@ var CONTAINER_SLOT_UI_STATE = "__lchUiState";
 var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
 function withoutViewOnlyKeys(bag) {
   if (!bag || typeof bag !== "object") return bag;
-  if (!VIEW_ONLY_UI_STATE_KEYS.some((k3) => Object.prototype.hasOwnProperty.call(bag, k3))) return bag;
+  if (!VIEW_ONLY_UI_STATE_KEYS.some((k2) => Object.prototype.hasOwnProperty.call(bag, k2))) return bag;
   const out = { ...bag };
-  for (const k3 of VIEW_ONLY_UI_STATE_KEYS) delete out[k3];
+  for (const k2 of VIEW_ONLY_UI_STATE_KEYS) delete out[k2];
   return out;
 }
 var HOST_CONTAINER_CLASS = "bic-chart-host";
@@ -665,10 +665,10 @@ function censusColourSpread(container, doc) {
     for (const { rgb } of counted) {
       marks++;
       distinct.add(rgb.join(","));
-      const k3 = cellKey(rgb);
-      const cur = cells.get(k3);
+      const k2 = cellKey(rgb);
+      const cur = cells.get(k2);
       if (cur) cur.n++;
-      else cells.set(k3, { rgb, n: 1 });
+      else cells.set(k2, { rgb, n: 1 });
     }
     if (marks < MIN_MARKS || distinct.size < MIN_RAMP_FILLS) return EMPTY;
     const top = [...cells.values()].sort((a4, b4) => b4.n - a4.n).slice(0, MAX_CELLS);
@@ -747,8 +747,8 @@ function autoRampMinStep(low, high, canvas, classes = AUTO_RAMP_CLASSES, opacity
   const bg = normHex(canvas);
   if (!lo || !hi || !bg || classes < 2) return NaN;
   let prev = null, min = Infinity;
-  for (let k3 = 0; k3 < classes; k3++) {
-    const painted = paintedOver(labToHex(mixLab(lo, hi, k3 / (classes - 1))), bg, opacity);
+  for (let k2 = 0; k2 < classes; k2++) {
+    const painted = paintedOver(labToHex(mixLab(lo, hi, k2 / (classes - 1))), bg, opacity);
     if (prev) min = Math.min(min, deltaE2000(prev, painted));
     prev = painted;
   }
@@ -772,15 +772,15 @@ function resolveAutoColorScale(p2) {
   };
   const candidates = p2.isHighContrast ? [normHex(p2.themeAccent), normHex(p2.themeFg)] : [...palette.map(normHex), normHex(p2.themeAccent), normHex(p2.themeFg)];
   const accent = candidates.find(usable) ?? FALLBACK_ACCENT;
-  const A2 = hexToLab(accent);
+  const A = hexToLab(accent);
   let t = 0.1;
-  let low = mixLab(bg, A2, t);
+  let low = mixLab(bg, A, t);
   while (t < 0.6 && deltaE2000(paintedOver(labToHex(low), canvas, AUTO_RAMP_DRAWN_OPACITY), bg) < SAME_SHADE_DELTA_E) {
     t += 0.02;
-    low = mixLab(bg, A2, t);
+    low = mixLab(bg, A, t);
   }
   const lowHex = labToHex(low);
-  let high = { ...A2 };
+  let high = { ...A };
   let highHex = labToHex(high);
   for (let step = 0; step < 80 && autoRampMinStep(lowHex, highHex, canvas) < AUTO_RAMP_MIN_STEP_DELTA_E; step++) {
     const L2 = Math.max(4, Math.min(98, high.L + (darkCanvas ? 1 : -1)));
@@ -952,12 +952,12 @@ var byAsset = /* @__PURE__ */ new Map();
 var _na;
 function geoAssetFor(geoKind) {
   if (!geoKind) return null;
-  const k3 = geoKind.toLowerCase();
-  if (/^country/.test(k3)) return "world";
-  if (k3 === "north-america") return "world";
-  if (k3 === "world") return "world";
-  if (k3 === "us-state-code" || k3 === "us-state-name") return "us-states";
-  if (k3 === "us-zip5") return "us-zip3";
+  const k2 = geoKind.toLowerCase();
+  if (/^country/.test(k2)) return "world";
+  if (k2 === "north-america") return "world";
+  if (k2 === "world") return "world";
+  if (k2 === "us-state-code" || k2 === "us-state-name") return "us-states";
+  if (k2 === "us-zip5") return "us-zip3";
   return null;
 }
 var _worldBase;
@@ -1237,20 +1237,20 @@ function A3(n) {
   if (r && i && c3(r) !== i && (r = null), n.city !== void 0 && n.city !== null) {
     let a4 = u(String(n.city)), s = O(a4), f4 = s ? F(s, n.mapKind) : null;
     if (f4 && f4.length) {
-      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R2 = d2 ? u(d2) : "", g3 = d2 ? Y(d2) : null, S = [], m2 = -1;
+      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R2 = d2 ? u(d2) : "", g3 = d2 ? Y(d2) : null, S2 = [], m2 = -1;
       for (let c2 of f4) {
-        let l = c2.row, A2 = 0;
-        if (d2 && l.a1 !== "") if (g3 && l.a1 === g3 || u(l.a1) === R2) A2++;
+        let l = c2.row, A = 0;
+        if (d2 && l.a1 !== "") if (g3 && l.a1 === g3 || u(l.a1) === R2) A++;
         else continue;
-        if (i) if (T(l.cc) === i) A2++;
+        if (i) if (T(l.cc) === i) A++;
         else continue;
-        A2 > m2 ? (m2 = A2, S = [c2]) : A2 === m2 && S.push(c2);
+        A > m2 ? (m2 = A, S2 = [c2]) : A === m2 && S2.push(c2);
       }
-      S.some((c2) => c2.primary) && (S = S.filter((c2) => c2.primary));
+      S2.some((c2) => c2.primary) && (S2 = S2.filter((c2) => c2.primary));
       let p2 = /* @__PURE__ */ new Map();
-      for (let c2 of S) p2.set(c2.row.lon.toFixed(2) + "," + c2.row.lat.toFixed(2), c2.row);
+      for (let c2 of S2) p2.set(c2.row.lon.toFixed(2) + "," + c2.row.lat.toFixed(2), c2.row);
       if (p2.size === 1) {
-        let c2 = S[0].row;
+        let c2 = S2[0].row;
         return { lat: c2.lat, lon: c2.lon, precision: "city" };
       }
       if (p2.size > 1) return { ambiguous: true, matches: p2.size };
@@ -1273,26 +1273,26 @@ function A3(n) {
 var G = { latlon: 0, city: 1, zip3: 2, state: 3, country: 4 };
 var x = 8;
 function y3(n, e) {
-  let t = new Array(n.length), o = new Array(n.length), i = new Array(n.length), r = /* @__PURE__ */ new Set(), a4 = [], s = /* @__PURE__ */ new Set(), f4 = [], d2 = /* @__PURE__ */ new Set(), R2 = [], g3 = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, S = 0, m2 = 0, p2 = null;
+  let t = new Array(n.length), o = new Array(n.length), i = new Array(n.length), r = /* @__PURE__ */ new Set(), a4 = [], s = /* @__PURE__ */ new Set(), f4 = [], d2 = /* @__PURE__ */ new Set(), R2 = [], g3 = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, S2 = 0, m2 = 0, p2 = null;
   for (let l = 0; l < n.length; ++l) {
-    let A2 = n[l], C = A3({ ...A2, mapKind: e });
+    let A = n[l], C = A3({ ...A, mapKind: e });
     if (S3(C)) {
       t[l] = null, o[l] = null, i[l] = null, m2++;
-      let M2 = K(A2);
+      let M2 = K(A);
       M2 && !d2.has(M2.toLowerCase()) && (d2.add(M2.toLowerCase()), R2.length < x && R2.push(M2));
     } else if (C) {
-      if (t[l] = C.lat, o[l] = C.lon, i[l] = C.precision, S++, g3[C.precision]++, (p2 === null || G[C.precision] > G[p2]) && (p2 = C.precision), G[C.precision] > G.city) {
-        let M2 = K(A2);
+      if (t[l] = C.lat, o[l] = C.lon, i[l] = C.precision, S2++, g3[C.precision]++, (p2 === null || G[C.precision] > G[p2]) && (p2 = C.precision), G[C.precision] > G.city) {
+        let M2 = K(A);
         M2 && !s.has(M2.toLowerCase()) && (s.add(M2.toLowerCase()), f4.length < x && f4.push(M2));
       }
     } else {
       t[l] = null, o[l] = null, i[l] = null;
-      let M2 = K(A2);
+      let M2 = K(A);
       M2 && !r.has(M2.toLowerCase()) && (r.add(M2.toLowerCase()), a4.push(M2));
     }
   }
   let c2 = !n3() && n.some((l) => l.city !== null && l.city !== void 0 && String(l.city).trim() !== "");
-  return { lat: t, lon: o, precisions: i, precision: p2, precisionCounts: g3, coarseExamples: f4, unmatched: a4, ambiguousRows: m2, ambiguousExamples: R2, matchedRows: S, totalRows: n.length, ...c2 ? { cityTableMissing: true } : {} };
+  return { lat: t, lon: o, precisions: i, precision: p2, precisionCounts: g3, coarseExamples: f4, unmatched: a4, ambiguousRows: m2, ambiguousExamples: R2, matchedRows: S2, totalRows: n.length, ...c2 ? { cityTableMissing: true } : {} };
 }
 function K(n) {
   let e = [n.city, n.state, n.zip, n.country].filter((t) => t != null && String(t).trim() !== "").map((t) => String(t).trim()).join(", ");
@@ -1558,12 +1558,12 @@ var ct2 = new RegExp([String.raw`\bisMeasure\b`, String.raw`\bdataType\b`, Strin
 
 // ../shape-core/dist/index.mjs
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
-var G2 = 2;
+var F3 = 2;
 var q3 = 400;
-function O2(i) {
+function E2(i) {
   return !!E(i);
 }
-function A(i) {
+function S(i) {
   let n = /* @__PURE__ */ new Set();
   for (let t of i) {
     if (t == null) continue;
@@ -1573,9 +1573,9 @@ function A(i) {
   return Array.from(n);
 }
 function x3(i) {
-  let n = A(i);
-  if (n.length === 0 || E2(i) < 95) return false;
-  let t = n.filter((c2) => O2(c2) && !Y(c2)).length, r = n.filter((c2) => !O2(c2) && !!Y(c2)).length;
+  let n = S(i);
+  if (n.length === 0 || O2(i) < 95) return false;
+  let t = n.filter((c2) => E2(c2) && !Y(c2)).length, r = n.filter((c2) => !E2(c2) && !!Y(c2)).length;
   return t >= 1 && t >= r;
 }
 function W2(i, n) {
@@ -1583,15 +1583,15 @@ function W2(i, n) {
   let t = E(i);
   return t ? n === "world" ? true : s3.has(t) : false;
 }
-function E2(i) {
-  let n = A(i);
+function O2(i) {
+  let n = S(i);
   if (n.length === 0) return 0;
   let t = 0;
-  for (let r of n) O2(r) && t++;
+  for (let r of n) E2(r) && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
-function _2(i) {
-  let n = A(i);
+function D3(i) {
+  let n = S(i);
   if (n.length === 0) return 0;
   let t = 0;
   for (let r of n) Y(r) && t++;
@@ -1617,15 +1617,15 @@ function j2(i, n) {
   return y2(n, rt) ? true : $2(i).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
 }
 function yt2(i, n) {
-  let t = A(i);
+  let t = S(i);
   if (t.length === 0) return 0;
   let r = 0;
   for (let c2 of t) p3(c2, n) && r++;
   return Math.round(r / t.length * 1e3) / 10;
 }
-function k2(i, n) {
+function G2(i, n) {
   let t = 0;
-  for (let r of A(i)) n(r) && t++;
+  for (let r of S(i)) n(r) && t++;
   return t;
 }
 function Ct(i, n) {
@@ -1651,26 +1651,26 @@ function ht(i, n, t, r, c2) {
   }
   let p2 = t?.state;
   if (p2 && h3.has(p2)) {
-    let e = f4(p2), s = A(e);
-    s.length > 0 && s.every((u2) => W2(u2, r)) ? a4.push(`state=${p2} (every value is "CA", which is both Canada and California)`) : x3(e) ? (a4.push(`state=${p2} (every value is a country, not a state)`), o.country || (o.country = p2)) : _2(e) < 95 ? a4.push(`state=${p2} (only ${_2(e)}% of values are states/provinces)`) : o.state = p2;
+    let e = f4(p2), s = S(e);
+    s.length > 0 && s.every((u2) => W2(u2, r)) ? a4.push(`state=${p2} (every value is "CA", which is both Canada and California)`) : x3(e) ? (a4.push(`state=${p2} (every value is a country, not a state)`), o.country || (o.country = p2)) : D3(e) < 95 ? a4.push(`state=${p2} (only ${D3(e)}% of values are states/provinces)`) : o.state = p2;
   }
-  let y5 = new Set(Object.values(o).filter(Boolean)), S = i.filter((e) => !y5.has(e) && !e.startsWith("__"));
+  let y5 = new Set(Object.values(o).filter(Boolean)), A = i.filter((e) => !y5.has(e) && !e.startsWith("__"));
   if (!o.state) {
     let e = null;
-    for (let s of S) {
+    for (let s of A) {
       let u2 = f4(s);
       if (x3(u2)) continue;
-      let m2 = _2(u2);
+      let m2 = D3(u2);
       if (m2 < 95) continue;
-      let w2 = k2(u2, (T3) => !!Y(T3)), Q3 = k2(u2, (T3) => !!Y(T3) && !W2(T3, r));
-      w2 < G2 && Q3 < 1 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
+      let w2 = G2(u2, (T3) => !!Y(T3)), Q3 = G2(u2, (T3) => !!Y(T3) && !W2(T3, r));
+      w2 < F3 && Q3 < 1 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
     }
     e && (o.state = e.name, y5.add(e.name), l.push(`state=${e.name} (${e.pct}% states/provinces)`));
   }
-  if (!o.zip) for (let e of S) {
+  if (!o.zip) for (let e of A) {
     if (y5.has(e)) continue;
     let s = f4(e), u2 = z2(s);
-    if (!(u2 < 95) && j2(s, e) && !(Ct(s, (m2) => Z(m2).length > 0) < G2)) {
+    if (!(u2 < 95) && j2(s, e) && !(Ct(s, (m2) => Z(m2).length > 0) < F3)) {
       o.zip = e, y5.add(e), l.push(`zip=${e} (${u2}% ZIP codes)`);
       break;
     }
@@ -1678,27 +1678,27 @@ function ht(i, n, t, r, c2) {
   let P2 = o.country;
   if (!P2 || !x3(f4(P2))) {
     let e = null;
-    for (let s of S) {
+    for (let s of A) {
       if (y5.has(s) || !x3(f4(s))) continue;
-      let u2 = E2(f4(s));
+      let u2 = O2(f4(s));
       (!e || u2 > e.pct) && (e = { name: s, pct: u2 });
     }
-    e && (P2 && (a4.push(`country=${P2} (only ${E2(f4(P2))}% of values are country identifiers; using ${e.name} instead)`), R2.country = P2), o.country = e.name, y5.add(e.name), l.push(`country=${e.name}`));
+    e && (P2 && (a4.push(`country=${P2} (only ${O2(f4(P2))}% of values are country identifiers; using ${e.name} instead)`), R2.country = P2), o.country = e.name, y5.add(e.name), l.push(`country=${e.name}`));
   }
   if (!o.city) {
     let e = null;
-    for (let s of S) {
+    for (let s of A) {
       if (y5.has(s)) continue;
       let u2 = f4(s), m2 = yt2(u2, r);
-      m2 < m3 || k2(u2, (w2) => p3(w2, r)) < G2 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
+      m2 < m3 || G2(u2, (w2) => p3(w2, r)) < F3 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
     }
     e && (o.city = e.name, l.push(`city=${e.name} (${e.pct}% known cities)`));
   }
-  let B2 = o.country ? f4(o.country) : [], D3 = !!o.country && x3(B2), J2 = D3 ? new Set(B2.map((e) => E(e == null ? null : String(e))).filter(Boolean)).size : 0, H2 = D3 && J2 >= 2, L2 = !!(o.lat && o.lon) && n.some((e) => {
+  let B2 = o.country ? f4(o.country) : [], _2 = !!o.country && x3(B2), J2 = _2 ? new Set(B2.map((e) => E(e == null ? null : String(e))).filter(Boolean)).size : 0, H2 = _2 && J2 >= 2, L2 = !!(o.lat && o.lon) && n.some((e) => {
     let s = +String(e[o.lat] ?? "").trim(), u2 = +String(e[o.lon] ?? "").trim();
     return isFinite(s) && isFinite(u2) && s >= -90 && s <= 90 && u2 >= -180 && u2 <= 180 && String(e[o.lat] ?? "").trim() !== "" && String(e[o.lon] ?? "").trim() !== "";
   });
-  return o.lat && o.lon && !L2 && a4.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`), o.country && !H2 && !(o.city || o.state || o.zip || L2) && a4.push(D3 ? `country=${o.country} (every row resolves to the same country - nothing to place apart)` : `country=${o.country} (values are not country identifiers)`), { bind: !!(o.city || o.state || o.zip || H2 || L2) ? o : null, backfilled: l, refused: a4, ...Object.keys(R2).length ? { labelFallback: R2 } : {} };
+  return o.lat && o.lon && !L2 && a4.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`), o.country && !H2 && !(o.city || o.state || o.zip || L2) && a4.push(_2 ? `country=${o.country} (every row resolves to the same country - nothing to place apart)` : `country=${o.country} (values are not country identifiers)`), { bind: !!(o.city || o.state || o.zip || H2 || L2) ? o : null, backfilled: l, refused: a4, ...Object.keys(R2).length ? { labelFallback: R2 } : {} };
 }
 
 // src/payload.ts
@@ -1808,20 +1808,20 @@ function buildRenderPayload(cols, rowObjs, geo, point, destination, opts) {
         a4[c2] = v2 ?? null;
       }
     }
-    let k3 = cols.length;
-    a4[k3++] = r;
-    if (geoIso) a4[k3++] = geoIso[r];
+    let k2 = cols.length;
+    a4[k2++] = r;
+    if (geoIso) a4[k2++] = geoIso[r];
     if (pLat && pLon) {
-      a4[k3++] = pLat[r];
-      a4[k3++] = pLon[r];
-      a4[k3++] = pPrec ? pPrec[r] : null;
+      a4[k2++] = pLat[r];
+      a4[k2++] = pLon[r];
+      a4[k2++] = pPrec ? pPrec[r] : null;
     }
     if (dLat && dLon) {
-      a4[k3++] = dLat[r];
-      a4[k3++] = dLon[r];
-      a4[k3++] = dPrec ? dPrec[r] : null;
+      a4[k2++] = dLat[r];
+      a4[k2++] = dLon[r];
+      a4[k2++] = dPrec ? dPrec[r] : null;
     }
-    for (const ac of aliasCols) a4[k3++] = a4[ac.from];
+    for (const ac of aliasCols) a4[k2++] = a4[ac.from];
     out[r] = a4;
   }
   const colsOut = [...cols, { name: "__rowIdx__", dataType: "Integer", isMeasure: false, modelDesc: "" }];
@@ -2408,10 +2408,10 @@ function censusValuePlacement(container, data) {
         for (const axis of ["x", "y"]) {
           const keep = [];
           const v2 = [], pos = [];
-          dots.forEach((d2, k3) => {
-            if (!Number.isFinite(vals[k3])) return;
-            keep.push(k3);
-            v2.push(log ? Math.log10(vals[k3]) : vals[k3]);
+          dots.forEach((d2, k2) => {
+            if (!Number.isFinite(vals[k2])) return;
+            keep.push(k2);
+            v2.push(log ? Math.log10(vals[k2]) : vals[k2]);
             pos.push(axis === "x" ? d2.x : d2.y);
           });
           const line = robustLine(v2, pos);
@@ -2420,8 +2420,8 @@ function censusValuePlacement(container, data) {
           if (hi - lo < MIN_AXIS_SPAN_PX) continue;
           const mean = pos.reduce((s, p2) => s + p2, 0) / pos.length;
           let ssRes = 0, ssTot = 0;
-          const res = pos.map((p2, k3) => {
-            const e = p2 - (line.a + line.b * v2[k3]);
+          const res = pos.map((p2, k2) => {
+            const e = p2 - (line.a + line.b * v2[k2]);
             ssRes += e * e;
             ssTot += (p2 - mean) ** 2;
             return e;
@@ -2430,8 +2430,8 @@ function censusValuePlacement(container, data) {
           const fit = 1 - ssRes / ssTot;
           if (fit >= VALUE_AXIS_MIN_FIT && (!best || fit > best.fit)) {
             const full = new Array(dots.length).fill(NaN);
-            keep.forEach((k3, j3) => {
-              full[k3] = res[j3];
+            keep.forEach((k2, j3) => {
+              full[k2] = res[j3];
             });
             best = { col: c2, axis, fit, res: full, log };
           }
@@ -2441,8 +2441,8 @@ function censusValuePlacement(container, data) {
     if (!best) return EMPTY4;
     let off = 0, measured = 0;
     const radii = [];
-    dots.forEach((d2, k3) => {
-      const e = best.res[k3];
+    dots.forEach((d2, k2) => {
+      const e = best.res[k2];
       if (!Number.isFinite(e)) return;
       measured++;
       const inRadii = Math.abs(e) / Math.max(d2.r, 1);
@@ -3017,8 +3017,8 @@ var NAMED = {
 };
 function toRGBA(c2) {
   if (typeof c2 !== "string") return null;
-  const k3 = c2.trim().toLowerCase();
-  if (k3 in NAMED) return NAMED[k3];
+  const k2 = c2.trim().toLowerCase();
+  if (k2 in NAMED) return NAMED[k2];
   return parseRGBA(c2);
 }
 function compositeOver(fg, bg) {
@@ -3068,12 +3068,12 @@ var GLYPH_SAMPLE_N = 3;
 function glyphSampleGrid(box, n = GLYPH_SAMPLE_N) {
   const out = [];
   if (!box || !(box.width > 0) || !(box.height > 0) || !(n >= 1)) return out;
-  const k3 = Math.floor(n);
-  for (let i = 0; i < k3; i++) {
-    for (let j3 = 0; j3 < k3; j3++) {
+  const k2 = Math.floor(n);
+  for (let i = 0; i < k2; i++) {
+    for (let j3 = 0; j3 < k2; j3++) {
       out.push({
-        x: box.left + box.width * (i + 0.5) / k3,
-        y: box.top + box.height * (j3 + 0.5) / k3
+        x: box.left + box.width * (i + 0.5) / k2,
+        y: box.top + box.height * (j3 + 0.5) / k2
       });
     }
   }
@@ -3288,7 +3288,7 @@ function sessionViewStateProvider(container) {
     load: () => store,
     save: (next) => {
       if (!next || typeof next !== "object") return;
-      for (const k3 of Object.keys(store)) delete store[k3];
+      for (const k2 of Object.keys(store)) delete store[k2];
       Object.assign(store, next);
     }
   };

package/dist/geo.mjs

@@ -7,12 +7,12 @@ import {
 import {
   WORLD_110M
 } from "./chunk-ABGDJ3NJ.mjs";
-import {
-  US_STATES
-} from "./chunk-75ZJSYIF.mjs";
 import {
   US_ZIP3
 } from "./chunk-D3N3JUMK.mjs";
+import {
+  US_STATES
+} from "./chunk-75ZJSYIF.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/geo.ts

package/dist/index.mjs

@@ -133,7 +133,7 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-7RLI3VOM.mjs";
+} from "./chunk-DTAYO46G.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-7RLI3VOM.mjs";
+} from "./chunk-DTAYO46G.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/testing.mjs

@@ -0,0 +1,67 @@
+/*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
+import "./chunk-GHODWOAL.mjs";
+
+// src/testing/index.ts
+var ConformanceError = class extends Error {
+  contract;
+  failures;
+  constructor(contract, failures) {
+    super(`${contract} conformance failed:
+ - ${failures.join("\n - ")}`);
+    this.name = "ConformanceError";
+    this.contract = contract;
+    this.failures = failures;
+  }
+};
+function describeThrow(e) {
+  return e instanceof Error ? `${e.name}: ${e.message}` : String(e);
+}
+var PROBE_A = "__bicharts_conformance_marker_a__";
+var PROBE_B = "__bicharts_conformance_marker_b__";
+async function assertMarkerStoreConformance(store) {
+  const failures = [];
+  const done = () => {
+    if (failures.length) throw new ConformanceError("MarkerStore", failures);
+  };
+  if (!store || typeof store.read !== "function" || typeof store.write !== "function" || typeof store.clear !== "function") {
+    failures.push("the store is missing read(), write() or clear()");
+    done();
+  }
+  try {
+    store.clear(PROBE_A);
+    store.clear(PROBE_B);
+    const absent = store.read(PROBE_A);
+    if (absent !== null) {
+      failures.push(`read() of a key never written returned ${JSON.stringify(absent)}, not null`);
+    }
+    const v1 = '{"at":1,"corr":"probe-1"}';
+    await store.write(PROBE_A, v1);
+    const r1 = store.read(PROBE_A);
+    if (r1 !== v1) failures.push(`read() after write() returned ${JSON.stringify(r1)}, not the value written`);
+    const other = store.read(PROBE_B);
+    if (other !== null) failures.push(`writing one key changed another: it reads ${JSON.stringify(other)}`);
+    const v2 = '{"at":2,"corr":"probe-2"}';
+    await store.write(PROBE_A, v2);
+    const r2 = store.read(PROBE_A);
+    if (r2 !== v2) failures.push(`a second write() did not replace the first: read ${JSON.stringify(r2)}`);
+    await store.write(PROBE_B, v1);
+    store.clear(PROBE_A);
+    const cleared = store.read(PROBE_A);
+    if (cleared !== null) failures.push(`read() after clear() returned ${JSON.stringify(cleared)}, not null`);
+    const kept = store.read(PROBE_B);
+    if (kept !== v1) failures.push(`clear() of one key disturbed another: it reads ${JSON.stringify(kept)}`);
+  } catch (e) {
+    failures.push(`the store threw during an ordinary read, write or clear: ${describeThrow(e)}`);
+  } finally {
+    try {
+      store.clear(PROBE_A);
+      store.clear(PROBE_B);
+    } catch {
+    }
+  }
+  done();
+}
+export {
+  ConformanceError,
+  assertMarkerStoreConformance
+};

package/dist/types/host/services.d.ts

@@ -0,0 +1,144 @@
+import type { RenderOptions } from "../contract";
+/** Signs an encoded request body. See @bicharts/shape-core's host/services.ts. */
+export interface WireSigner {
+    sign(encodedBody: string): string;
+}
+/** The response half of a transport. See @bicharts/shape-core's host/services.ts. */
+export interface WireResponse {
+    status: number;
+    contentType: string | null;
+    body: ReadableStream<Uint8Array> | null;
+    text(): Promise<string>;
+}
+/** Posts an encoded body. See @bicharts/shape-core's host/services.ts. */
+export interface WireTransport {
+    post(url: string, encodedBody: string, headers: Record<string, string>, opts: {
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<WireResponse>;
+}
+/** The licence triple as the wire carries it. */
+export interface CredentialTriple {
+    licensee: string;
+    licenseKey: string;
+    secretKey: string;
+}
+/** What a request is entitled by. See @bicharts/shape-core's host/services.ts. */
+export interface CredentialSource {
+    triple(): CredentialTriple;
+    linkNonce?: (() => string | null) | null;
+    freemiumKey?: (() => string | null) | null;
+    instanceKey?: (() => string | null) | null;
+}
+/** The drawing area a request should be sized for, in CSS pixels. */
+export interface ViewportSource {
+    measure(): {
+        width: number;
+        height: number;
+    };
+}
+/** Milliseconds since the epoch. */
+export interface Clock {
+    now(): number;
+}
+/** One diagnostics breadcrumb. */
+export interface DiagnosticEntry {
+    event: string;
+    detail?: unknown;
+}
+/** Where diagnostics breadcrumbs go. `record` never throws. */
+export interface DiagnosticsSink {
+    record(entry: DiagnosticEntry): void;
+}
+/** A chart renderer a host can execute. */
+export type RendererId = "D3" | "PLOTLY" | "VEGA" | "PYTHON";
+/**
+ * Small string values that must outlive the page: the pending-generate marker is the first.
+ * The visual keeps them in the report, the add-in in the workbook. The MCP server holds a
+ * generate only for the length of one call and passes none; a demo page has nothing to
+ * recover and passes none.
+ *
+ * `read` returns null - not undefined, not "" - for a key never written or cleared. `write`
+ * replaces; it may complete asynchronously, and a caller that needs the value durable awaits
+ * it. `clear` removes the key.
+ */
+export interface MarkerStore {
+    read(key: string): string | null;
+    write(key: string, value: string): void | Promise<void>;
+    clear(key: string): void;
+}
+/**
+ * The reader's saved settings, read one key at a time. The visual reads its format pane, the
+ * add-in its task-pane preferences, a web page whatever its caller configured. The MCP server
+ * takes its options as arguments and passes none.
+ *
+ * Keyed on RenderOptions until the shared options vocabulary lands; `undefined` means the
+ * reader has not set the key and the shared default applies.
+ */
+export interface PreferenceSource<Vocab extends object = RenderOptions> {
+    get<K extends keyof Vocab & string>(key: K): Vocab[K] | undefined;
+}
+/** The surface a chart sits on, as colours a chart can use directly. */
+export interface HostTheme {
+    /** Canvas colour, as a CSS colour string. */
+    background: string;
+    /** Default text colour, as a CSS colour string. */
+    foreground: string;
+    /** True when the host is in a forced high-contrast mode. */
+    isHighContrast: boolean;
+    /** The host's own categorical colours, when it has any (a report theme; a workbook's accents). */
+    palette?: readonly string[];
+}
+/**
+ * Reads the host's current theme. The visual reads the report theme, the add-in the Office
+ * theme. The MCP preview is not a product surface and passes none; a demo page that reads the
+ * browser's colour scheme passes one.
+ */
+export interface ThemeSource {
+    read(): HostTheme;
+}
+/**
+ * Whether a rendered chart may be captured as a thumbnail. `consented` is the reader's (or
+ * their administrator's) answer; `forced` is a host rule that captures regardless (a
+ * first-render capture a licence requires). The visual and the add-in provide it; the MCP
+ * server has no DOM and a demo page no credentials, so both pass none.
+ */
+export interface ThumbnailConsent {
+    consented(): boolean;
+    forced(): boolean;
+}
+/** The rendered chart's root <svg>, or null when the chart drew none (a canvas, a table). */
+export interface SnapshotTarget {
+    svg(): SVGSVGElement | null;
+}
+/**
+ * The whole services object a host constructs and passes to shared logic.
+ *
+ * Required members are the ones every host that sends requests provides today, so their
+ * absence is a compile error. An optional member that is absent - or null, which means the
+ * same - is the host declaring it cannot do that thing. What a host can do is derived from
+ * this object, never declared beside it, so a capability cannot be claimed without the service
+ * that backs it.
+ *
+ * Each optional member's host coverage today:
+ * - viewport: visual, add-in, web page; not the MCP server (sizes are arguments).
+ * - markers: visual, add-in; not the MCP server (in-call only) or a demo page.
+ * - prefs: visual, add-in, web page; not the MCP server (options are arguments).
+ * - theme: visual, add-in; a web page when it reads the browser's scheme; not the MCP server.
+ * - thumbnails and snapshot: visual, add-in; not the MCP server (no DOM) or a demo page.
+ * - diagnostics: visual, add-in; not the MCP server (stdio) or a demo page.
+ */
+export interface HostServices {
+    signer: WireSigner;
+    transport: WireTransport;
+    credentials: CredentialSource;
+    clock: Clock;
+    renderers: ReadonlySet<RendererId>;
+    viewport?: ViewportSource | null;
+    markers?: MarkerStore | null;
+    prefs?: PreferenceSource | null;
+    theme?: ThemeSource | null;
+    thumbnails?: ThumbnailConsent | null;
+    snapshot?: SnapshotTarget | null;
+    diagnostics?: DiagnosticsSink | null;
+}

package/dist/types/index.d.ts

@@ -38,3 +38,4 @@ export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_
 export { stripJsComments } from "./codeComments";
 export { reconcileChartPick, type ChartPickReconciliation } from "./chartPick";
 export { stableFingerprintOptions, fingerprintComponentDigest, type ClientIdSource } from "./clientIdentity";
+export type { HostServices, MarkerStore, PreferenceSource, HostTheme, ThemeSource, ThumbnailConsent, SnapshotTarget, WireSigner, WireTransport, WireResponse, CredentialTriple, CredentialSource, ViewportSource, Clock, DiagnosticEntry, DiagnosticsSink, RendererId, } from "./host/services";

package/dist/types/testing/index.d.ts

@@ -0,0 +1,14 @@
+import type { MarkerStore } from "../host/services";
+/** Thrown by every conformance check. `failures` names each property the adapter broke. */
+export declare class ConformanceError extends Error {
+    readonly contract: string;
+    readonly failures: readonly string[];
+    constructor(contract: string, failures: readonly string[]);
+}
+/**
+ * A MarkerStore reads null for a key it does not hold, returns exactly what was written,
+ * replaces on a second write, keeps keys independent, and reads null again after a clear.
+ * Awaits every write, since a store may complete one asynchronously. Clears both probe keys
+ * before returning, whether or not the check passed.
+ */
+export declare function assertMarkerStoreConformance(store: MarkerStore): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.5.122",
+  "version": "0.6.0",
   "description": "Run a BIC-generated D3 chart in any web host: compiles the generated render() function, applies the shared option defaults, resolves mark clicks (through tooltip overlays), owns the selection affordance, and translates row indices between cross-filtered charts. The same contract the BIC Power BI visual implements, minus Power BI. React bindings at @bicharts/chart-host/react.",
   "license": "Apache-2.0",
   "type": "module",
@@ -39,6 +39,11 @@
       "import": "./dist/geo-us-zip3.mjs",
       "default": "./dist/geo-us-zip3.mjs"
     },
+    "./testing": {
+      "types": "./dist/types/testing/index.d.ts",
+      "import": "./dist/testing.mjs",
+      "default": "./dist/testing.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [