@bicharts/chart-host 0.6.29 → 0.6.31

package/dist/{chunk-NOJ2COB2.mjs → chunk-KONJ3DXV.mjs}

@@ -211,7 +211,7 @@ var require_papaparse_min = __commonJS({
         return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       }
       function E4(C2) {
-        var S = (C2 = C2 || {}).delimiter, O3 = C2.newline, x2 = C2.comments, I4 = C2.step, A2 = C2.preview, T3 = C2.fastMode, D3 = null, L2 = false, F4 = null == C2.quoteChar ? '"' : C2.quoteChar, j3 = F4;
+        var S = (C2 = C2 || {}).delimiter, O3 = C2.newline, x2 = C2.comments, I4 = C2.step, A2 = C2.preview, T4 = C2.fastMode, D3 = null, L2 = false, F3 = null == C2.quoteChar ? '"' : C2.quoteChar, j3 = F3;
         if (void 0 !== C2.escapeChar && (j3 = C2.escapeChar), ("string" != typeof S || -1 < v4.BAD_DELIMITERS.indexOf(S)) && (S = ","), x2 === S) throw new Error("Comment character same as delimiter");
         true === x2 ? x2 = "#" : ("string" != typeof x2 || -1 < v4.BAD_DELIMITERS.indexOf(x2)) && (x2 = false), "\n" !== O3 && "\r" !== O3 && "\r\n" !== O3 && (O3 = "\n");
         var z4 = 0, M = false;
@@ -219,7 +219,7 @@ var require_papaparse_min = __commonJS({
           if ("string" != typeof i2) throw new Error("Input must be a string");
           var n2 = i2.length, e = S.length, s2 = O3.length, a5 = x2.length, o2 = q3(I4), h4 = [], u4 = [], d3 = [], f5 = z4 = 0;
           if (!i2) return w3();
-          if (T3 || false !== T3 && -1 === i2.indexOf(F4)) {
+          if (T4 || false !== T4 && -1 === i2.indexOf(F3)) {
             for (var l2 = i2.split(O3), c4 = 0; c4 < l2.length; c4++) {
               if (d3 = l2[c4], z4 += d3.length, c4 !== l2.length - 1) z4 += O3.length;
               else if (r2) return w3();
@@ -232,20 +232,20 @@ var require_papaparse_min = __commonJS({
             }
             return w3();
           }
-          for (var p4 = i2.indexOf(S, z4), g4 = i2.indexOf(O3, z4), _3 = new RegExp(U4(j3) + U4(F4), "g"), m2 = i2.indexOf(F4, z4); ; ) if (i2[z4] === F4) for (m2 = z4, z4++; ; ) {
-            if (-1 === (m2 = i2.indexOf(F4, m2 + 1))) return r2 || u4.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h4.length, index: z4 }), E5();
-            if (m2 === n2 - 1) return E5(i2.substring(z4, m2).replace(_3, F4));
-            if (F4 === j3 && i2[m2 + 1] === j3) m2++;
-            else if (F4 === j3 || 0 === m2 || i2[m2 - 1] !== j3) {
+          for (var p4 = i2.indexOf(S, z4), g4 = i2.indexOf(O3, z4), _3 = new RegExp(U4(j3) + U4(F3), "g"), m2 = i2.indexOf(F3, z4); ; ) if (i2[z4] === F3) for (m2 = z4, z4++; ; ) {
+            if (-1 === (m2 = i2.indexOf(F3, m2 + 1))) return r2 || u4.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h4.length, index: z4 }), E5();
+            if (m2 === n2 - 1) return E5(i2.substring(z4, m2).replace(_3, F3));
+            if (F3 === j3 && i2[m2 + 1] === j3) m2++;
+            else if (F3 === j3 || 0 === m2 || i2[m2 - 1] !== j3) {
               -1 !== p4 && p4 < m2 + 1 && (p4 = i2.indexOf(S, m2 + 1));
               var y6 = v5(-1 === (g4 = -1 !== g4 && g4 < m2 + 1 ? i2.indexOf(O3, m2 + 1) : g4) ? p4 : Math.min(p4, g4));
               if (i2.substr(m2 + 1 + y6, e) === S) {
-                d3.push(i2.substring(z4, m2).replace(_3, F4)), i2[z4 = m2 + 1 + y6 + e] !== F4 && (m2 = i2.indexOf(F4, z4)), p4 = i2.indexOf(S, z4), g4 = i2.indexOf(O3, z4);
+                d3.push(i2.substring(z4, m2).replace(_3, F3)), i2[z4 = m2 + 1 + y6 + e] !== F3 && (m2 = i2.indexOf(F3, z4)), p4 = i2.indexOf(S, z4), g4 = i2.indexOf(O3, z4);
                 break;
               }
               y6 = v5(g4);
               if (i2.substring(m2 + 1 + y6, m2 + 1 + y6 + s2) === O3) {
-                if (d3.push(i2.substring(z4, m2).replace(_3, F4)), b5(m2 + 1 + y6 + s2), p4 = i2.indexOf(S, z4), m2 = i2.indexOf(F4, z4), o2 && (R2(), M)) return w3();
+                if (d3.push(i2.substring(z4, m2).replace(_3, F3)), b5(m2 + 1 + y6 + s2), p4 = i2.indexOf(S, z4), m2 = i2.indexOf(F3, z4), o2 && (R2(), M)) return w3();
                 if (A2 && h4.length >= A2) return w3(true);
                 break;
               }
@@ -549,7 +549,7 @@ function deltaE2000(c1, c2) {
   else if (Math.abs(h1p - h2p) <= 180) hbarp = (h1p + h2p) / 2;
   else if (h1p + h2p < 360) hbarp = (h1p + h2p + 360) / 2;
   else hbarp = (h1p + h2p - 360) / 2;
-  const T3 = 1 - 0.17 * Math.cos((hbarp - 30) * RAD) + 0.24 * Math.cos(2 * hbarp * RAD) + 0.32 * Math.cos((3 * hbarp + 6) * RAD) - 0.2 * Math.cos((4 * hbarp - 63) * RAD);
+  const T4 = 1 - 0.17 * Math.cos((hbarp - 30) * RAD) + 0.24 * Math.cos(2 * hbarp * RAD) + 0.32 * Math.cos((3 * hbarp + 6) * RAD) - 0.2 * Math.cos((4 * hbarp - 63) * RAD);
   const dTheta = 30 * Math.exp(-Math.pow((hbarp - 275) / 25, 2));
   const Cbarp7 = Math.pow(Cbarp, 7);
   const RC = 2 * Math.sqrt(Cbarp7 / (Cbarp7 + Math.pow(25, 7)));
@@ -557,7 +557,7 @@ function deltaE2000(c1, c2) {
   const Lm50 = Math.pow(Lbarp - 50, 2);
   const SL = 1 + 0.015 * Lm50 / Math.sqrt(20 + Lm50);
   const SC = 1 + 0.045 * Cbarp;
-  const SH = 1 + 0.015 * Cbarp * T3;
+  const SH = 1 + 0.015 * Cbarp * T4;
   const tL = dLp / SL, tC = dCp / SC, tH = dHp / SH;
   return Math.sqrt(tL * tL + tC * tC + tH * tH + RT * tC * tH);
 }
@@ -1587,7 +1587,7 @@ var J4 = 400;
 function B3(e) {
   return !!E(e);
 }
-function F3(e) {
+function T3(e) {
   let n = /* @__PURE__ */ new Set();
   for (let t of e) {
     if (t == null) continue;
@@ -1597,7 +1597,7 @@ function F3(e) {
   return Array.from(n);
 }
 function v3(e) {
-  let n = F3(e);
+  let n = T3(e);
   if (n.length === 0 || W2(e) < 95) return false;
   let t = n.filter((u2) => B3(u2) && !Y(u2)).length, o = n.filter((u2) => !B3(u2) && !!Y(u2)).length;
   return t >= 1 && t >= o;
@@ -1608,20 +1608,20 @@ function Y3(e, n) {
   return t ? n === "world" ? true : s3.has(t) : false;
 }
 function W2(e) {
-  let n = F3(e);
+  let n = T3(e);
   if (n.length === 0) return 0;
   let t = 0;
   for (let o of n) B3(o) && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
 function k3(e) {
-  let n = F3(e);
+  let n = T3(e);
   if (n.length === 0) return 0;
   let t = 0;
   for (let o of n) Y(o) && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
-function U3(e) {
+function $2(e) {
   let n = /* @__PURE__ */ new Set();
   for (let t of e) {
     if (t == null) continue;
@@ -1630,18 +1630,18 @@ function U3(e) {
   }
   return Array.from(n);
 }
-function $2(e) {
-  let n = U3(e);
+function U3(e) {
+  let n = $2(e);
   if (n.length === 0) return 0;
   let t = 0;
   for (let o of n) Z(o).length > 0 && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
 function Z3(e, n) {
-  return y4(n, rt) ? true : U3(e).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
+  return y4(n, rt) ? true : $2(e).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
 }
 function ot(e, n) {
-  let t = F3(e);
+  let t = T3(e);
   if (t.length === 0) return 0;
   let o = 0;
   for (let u2 of t) p3(u2, n) && o++;
@@ -1649,12 +1649,12 @@ function ot(e, n) {
 }
 function z3(e, n) {
   let t = 0;
-  for (let o of F3(e)) n(o) && t++;
+  for (let o of T3(e)) n(o) && t++;
   return t;
 }
 function it2(e, n) {
   let t = 0;
-  for (let o of U3(e)) n(o) && t++;
+  for (let o of $2(e)) n(o) && t++;
   return t;
 }
 function st(e, n, t, o, u2) {
@@ -1670,18 +1670,18 @@ function st(e, n, t, o, u2) {
   }
   let C2 = t?.zip;
   if (C2 && R2.has(C2)) {
-    let r = f4(C2), l = $2(r);
+    let r = f4(C2), l = U3(r);
     l < 95 ? s.push(`zip=${C2} (only ${l}% of values read as ZIPs)`) : Z3(r, C2) ? i.zip = C2 : s.push(`zip=${C2} (all values are 3-4 digits with nothing to say they are postal)`);
   }
   let g3 = t?.state;
   if (g3 && R2.has(g3)) {
-    let r = f4(g3), l = F3(r);
+    let r = f4(g3), l = T3(r);
     l.length > 0 && l.every((d2) => Y3(d2, o)) ? s.push(`state=${g3} (every value is "CA", which is both Canada and California)`) : v3(r) ? (s.push(`state=${g3} (every value is a country, not a state)`), i.country || (i.country = g3)) : k3(r) < 95 ? s.push(`state=${g3} (only ${k3(r)}% of values are states/provinces)`) : i.state = g3;
   }
-  let b4 = new Set(Object.values(i).filter(Boolean)), T3 = e.filter((r) => !b4.has(r) && !r.startsWith("__"));
+  let b4 = new Set(Object.values(i).filter(Boolean)), M = e.filter((r) => !b4.has(r) && !r.startsWith("__"));
   if (!i.state) {
     let r = null;
-    for (let l of T3) {
+    for (let l of M) {
       let d2 = f4(l);
       if (v3(d2)) continue;
       let p2 = k3(d2);
@@ -1691,9 +1691,9 @@ function st(e, n, t, o, u2) {
     }
     r && (i.state = r.name, b4.add(r.name), a4.push(`state=${r.name} (${r.pct}% states/provinces)`));
   }
-  if (!i.zip) for (let r of T3) {
+  if (!i.zip) for (let r of M) {
     if (b4.has(r)) continue;
-    let l = f4(r), d2 = $2(l);
+    let l = f4(r), d2 = U3(l);
     if (!(d2 < 95) && Z3(l, r) && !(it2(l, (p2) => Z(p2).length > 0) < K3)) {
       i.zip = r, b4.add(r), a4.push(`zip=${r} (${d2}% ZIP codes)`);
       break;
@@ -1702,7 +1702,7 @@ function st(e, n, t, o, u2) {
   let P4 = i.country;
   if (!P4 || !v3(f4(P4))) {
     let r = null;
-    for (let l of T3) {
+    for (let l of M) {
       if (b4.has(l) || !v3(f4(l))) continue;
       let d2 = W2(f4(l));
       (!r || d2 > r.pct) && (r = { name: l, pct: d2 });
@@ -1711,7 +1711,7 @@ function st(e, n, t, o, u2) {
   }
   if (!i.city) {
     let r = null;
-    for (let l of T3) {
+    for (let l of M) {
       if (b4.has(l)) continue;
       let d2 = f4(l), p2 = ot(d2, o);
       p2 < m3 || z3(d2, (_2) => p3(_2, o)) < K3 || (!r || p2 > r.pct) && (r = { name: l, pct: p2 });

package/dist/index.mjs

@@ -140,10 +140,64 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-NOJ2COB2.mjs";
+} from "./chunk-KONJ3DXV.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
+// src/optionsVocabulary.ts
+var MAX_MAP_POINTS_MIN = 10;
+var MAX_MAP_POINTS_MAX = 1e5;
+var LIMIT_COUNT_MAX = 1e4;
+var entry = (e2) => Object.freeze({ ...e2, ...e2.values ? { values: Object.freeze([...e2.values]) } : {} });
+var OPTIONS_VOCABULARY = Object.freeze({
+  // ---- drawn from on every render, and stated on the request so the model reasons about them ----
+  aggregation: entry({ timing: "live-and-next-generate", default: "", values: ["", "sum", "average", "median", "min", "max", "count", "distinct"], wire: "request" }),
+  colorScaleLow: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  colorScaleHigh: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  /** Blank: the host's own colours when it offers them, else the engine's. */
+  palette: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  /** A HARD offer gate on the server as well as a live cap on what a point map plots. */
+  maxMapPoints: entry({ timing: "live-and-next-generate", default: MAX_MAP_POINTS_DEFAULT, min: MAX_MAP_POINTS_MIN, max: MAX_MAP_POINTS_MAX, wire: "clientHints" }),
+  // ---- live only ----
+  /** 0 means no paging. */
+  pageSize: entry({ timing: "live", default: 0, min: 0 }),
+  valueAxisBaseline: entry({ timing: "live", default: VALUE_AXIS_BASELINE_DEFAULT, values: ["fit", "zero", "auto"] }),
+  seasonalMarkers: entry({ timing: "live", default: SEASONAL_MARKERS_DEFAULT, values: ["auto", "always", "never"] }),
+  animAutoPlay: entry({ timing: "live", default: false }),
+  animPlaySpeedMs: entry({ timing: "live", default: ANIM_PLAY_SPEED_DEFAULT, min: ANIM_PLAY_SPEED_MIN, max: ANIM_PLAY_SPEED_MAX }),
+  /** 0 restarts at once; no upper bound, so a very large value plays once per viewing. */
+  animLoopDelaySec: entry({ timing: "live", default: ANIM_LOOP_DELAY_DEFAULT, min: ANIM_LOOP_DELAY_MIN }),
+  animStopAtEnd: entry({ timing: "live", default: false }),
+  animMaxIdealFrames: entry({ timing: "live", default: ANIM_MAX_IDEAL_FRAMES_DEFAULT, min: ANIM_MAX_IDEAL_FRAMES_MIN, max: ANIM_MAX_IDEAL_FRAMES_MAX }),
+  /** "" chooses by the number of periods. */
+  animTimelineStyle: entry({ timing: "live", default: "", values: ["", "line", "boxes"] }),
+  filtersDuringPlay: entry({ timing: "live", default: false }),
+  // ---- the next generated chart ----
+  levelOfDetail: entry({ timing: "next-generate", default: "", values: ["", "High", "Medium", "Low"], wire: "clientHints" }),
+  favorLimitTo: entry({ timing: "next-generate", default: "", values: ["", "latest", "top / greatest", "bottom / smallest", "most common", "outliers"], wire: "clientHints" }),
+  /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */
+  favorLimitCount: entry({ timing: "next-generate", default: 0, min: 0, max: LIMIT_COUNT_MAX, wire: "clientHints" }),
+  /** "1" asks for a title, "0" for none, "" leaves it to the engine. */
+  favorTitle: entry({ timing: "next-generate", default: "", values: ["", "1", "0"], wire: "clientHints" }),
+  /** Data labels on the marks: "1", "0", or "" for the engine's choice. */
+  favorDPValues: entry({ timing: "next-generate", default: "", values: ["", "1", "0"], wire: "clientHints" }),
+  legendPlacement: entry({ timing: "next-generate", default: "", values: ["", "outside", "inside", "none"], wire: "clientHints" }),
+  /** Free text: the industry the data belongs to. */
+  industryContext: entry({ timing: "next-generate", default: "", wire: "clientHints" }),
+  /** Free text: a font family for the chart's own text. */
+  suggestFontFamily: entry({ timing: "next-generate", default: "", wire: "clientHints" }),
+  // ---- after a chart is drawn ----
+  visionReview: entry({ timing: "after-render", default: false }),
+  saveThumbnails: entry({ timing: "after-render", default: false })
+});
+var LIVE_OPTION_KEYS = Object.freeze(
+  Object.keys(OPTIONS_VOCABULARY).filter((k2) => OPTIONS_VOCABULARY[k2].timing === "live" || OPTIONS_VOCABULARY[k2].timing === "live-and-next-generate")
+);
+function wireLimitCount(count) {
+  const n2 = typeof count === "number" ? count : count == null || count === "" ? NaN : Number(count);
+  return Number.isFinite(n2) && n2 > 0 ? n2 : null;
+}
+
 // src/dateCells.ts
 var LOCAL_DATE_METHOD = /\.(?:getFullYear|getMonth|getDate|getDay|getHours|getMinutes|setFullYear|setMonth|setDate|setHours|setMinutes|setSeconds|setMilliseconds)\s*\(/;
 var D3_LOCAL_TIME = /\bd3\s*\.\s*(?:scaleTime|time[A-Z]\w*)\b/;
@@ -2542,14 +2596,19 @@ export {
   LEGIBLE_LIGHTNESS,
   LIFT_SELECTED_CLASS,
   LIGHT_TEXT,
+  LIMIT_COUNT_MAX,
+  LIVE_OPTION_KEYS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
   MAX_MAP_POINTS_DEFAULT,
+  MAX_MAP_POINTS_MAX,
+  MAX_MAP_POINTS_MIN,
   MIN_CONTRAST,
   MIN_DELTA_E,
   MIN_HIT_BAND_PX,
   MIN_RAMP_FILLS,
+  OPTIONS_VOCABULARY,
   PAGE_MATCH_TOLERANCE,
   PENDING_RECOVERY_FAST_PHASE_MS,
   PENDING_RECOVERY_FIRST_POLL_MS,
@@ -2732,5 +2791,6 @@ export {
   updateRowHighWater,
   valuePlacementFlag,
   vegaSpecReadsDatesInLocalTime,
+  wireLimitCount,
   withoutViewOnlyKeys
 };

package/dist/react.mjs

@@ -7,7 +7,7 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-NOJ2COB2.mjs";
+} from "./chunk-KONJ3DXV.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
+export { OPTIONS_VOCABULARY, LIVE_OPTION_KEYS, MAX_MAP_POINTS_MIN, MAX_MAP_POINTS_MAX, LIMIT_COUNT_MAX, wireLimitCount, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 /** REPLACE the bundled city gazetteer with another packed table. Rarely needed — see the
  *  note above registerCityTable in shape-core's geoPoint.ts before using it. */

package/dist/types/optionsVocabulary.d.ts

@@ -0,0 +1,77 @@
+/**
+ * When a change to an option takes effect.
+ * - `live`: the chart on screen repaints with it; no request, no new chart.
+ * - `next-generate`: it steers what the engine makes, so it applies to the next generated chart.
+ * - `live-and-next-generate`: both - the chart on screen repaints, and the request carries it too.
+ * - `after-render`: it governs what happens after a chart is drawn (a review, a thumbnail).
+ */
+export type OptionTiming = "live" | "next-generate" | "live-and-next-generate" | "after-render";
+/** Where an option travels on a generate request: the request itself, or its client hints. */
+export type OptionWire = "request" | "clientHints";
+/** The shared facts about one option. */
+export interface OptionVocabularyEntry {
+    readonly timing: OptionTiming;
+    /** What "not set" means. A host that stores blank or 0 for "the default" resolves to this. */
+    readonly default: string | number | boolean;
+    /** The least value a reader may set, for a number. */
+    readonly min?: number;
+    /** The greatest value a reader may set, for a number. Absent: no upper bound. */
+    readonly max?: number;
+    /** The values a choice accepts, "" being "leave it to the engine" where offered. */
+    readonly values?: readonly string[];
+    /** Where it travels on a generate request; absent when it never travels. */
+    readonly wire?: OptionWire;
+}
+/** Max Map Points: the fewest and the most points a reader may allow a point map. */
+export declare const MAX_MAP_POINTS_MIN = 10;
+export declare const MAX_MAP_POINTS_MAX = 100000;
+/** Favor Limit Count: the most groups a reader may ask a chart to keep. 0 asks for no limit. */
+export declare const LIMIT_COUNT_MAX = 10000;
+/** The options the hosts share, keyed by wire / render-option name. */
+export declare const OPTIONS_VOCABULARY: Readonly<{
+    aggregation: OptionVocabularyEntry;
+    colorScaleLow: OptionVocabularyEntry;
+    colorScaleHigh: OptionVocabularyEntry;
+    /** Blank: the host's own colours when it offers them, else the engine's. */
+    palette: OptionVocabularyEntry;
+    /** A HARD offer gate on the server as well as a live cap on what a point map plots. */
+    maxMapPoints: OptionVocabularyEntry;
+    /** 0 means no paging. */
+    pageSize: OptionVocabularyEntry;
+    valueAxisBaseline: OptionVocabularyEntry;
+    seasonalMarkers: OptionVocabularyEntry;
+    animAutoPlay: OptionVocabularyEntry;
+    animPlaySpeedMs: OptionVocabularyEntry;
+    /** 0 restarts at once; no upper bound, so a very large value plays once per viewing. */
+    animLoopDelaySec: OptionVocabularyEntry;
+    animStopAtEnd: OptionVocabularyEntry;
+    animMaxIdealFrames: OptionVocabularyEntry;
+    /** "" chooses by the number of periods. */
+    animTimelineStyle: OptionVocabularyEntry;
+    filtersDuringPlay: OptionVocabularyEntry;
+    levelOfDetail: OptionVocabularyEntry;
+    favorLimitTo: OptionVocabularyEntry;
+    /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */
+    favorLimitCount: OptionVocabularyEntry;
+    /** "1" asks for a title, "0" for none, "" leaves it to the engine. */
+    favorTitle: OptionVocabularyEntry;
+    /** Data labels on the marks: "1", "0", or "" for the engine's choice. */
+    favorDPValues: OptionVocabularyEntry;
+    legendPlacement: OptionVocabularyEntry;
+    /** Free text: the industry the data belongs to. */
+    industryContext: OptionVocabularyEntry;
+    /** Free text: a font family for the chart's own text. */
+    suggestFontFamily: OptionVocabularyEntry;
+    visionReview: OptionVocabularyEntry;
+    saveThumbnails: OptionVocabularyEntry;
+}>;
+/** A shared option's key. */
+export type OptionKey = keyof typeof OPTIONS_VOCABULARY;
+/** The keys whose change repaints the chart on screen, in table order. */
+export declare const LIVE_OPTION_KEYS: readonly OptionKey[];
+/**
+ * THE LIMIT COUNT A REQUEST CARRIES: a positive count, or null - never 0. The server reads any value it
+ * receives as the reader's own limit (and 0 as a limit of zero), so "no limit" must arrive as no value.
+ * A host places null where it always has; one that omits blank fields maps it to absent.
+ */
+export declare function wireLimitCount(count: unknown): number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.6.29",
+  "version": "0.6.31",
   "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",