@bicharts/chart-host 0.6.117 → 0.6.118

package/dist/adapters.mjs

@@ -3,7 +3,7 @@ import {
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-EFKGSDFF.mjs";
+} from "./chunk-4AJYIAAJ.mjs";
 import {
   clickWasDrag,
   collectD3GlyphCenters,
@@ -12,13 +12,13 @@ import {
   markKeyOf,
   rowIdxsFromMark,
   selectionRuleOf
-} from "./chunk-RLOIA7QK.mjs";
+} from "./chunk-HEXJGF42.mjs";
 import {
   AXIS_FILTER_CLASS,
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/adapters/types.ts

package/dist/category-colours.mjs

@@ -5,14 +5,14 @@ import {
   deltaE2000,
   hexToLab,
   rgbToLab
-} from "./chunk-JTZTTJJK.mjs";
+} from "./chunk-CMZCRLIX.mjs";
 import {
   CATEGORY_DELTA_E_FLOOR,
   DIM_OPACITY_DEFAULT,
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/categoryColours.ts

package/dist/{chunk-EFKGSDFF.mjs → chunk-4AJYIAAJ.mjs}

@@ -4,7 +4,7 @@ import {
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/hitTargets.ts
 var SVG_NS = "http://www.w3.org/2000/svg";

package/dist/{chunk-JTZTTJJK.mjs → chunk-CMZCRLIX.mjs}

@@ -2,7 +2,7 @@
 import {
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/deltaE.ts
 function linearise(c) {

package/dist/{chunk-IW6BKFF5.mjs → chunk-DM74ZXKA.mjs}

@@ -1,7 +1,7 @@
 /*! @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 {
   SNAPSHOT_SVG_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/snapshot.ts
 var DEFAULT_TIMEOUT_MS = 2e3;

package/dist/{chunk-RLOIA7QK.mjs → chunk-HEXJGF42.mjs}

@@ -8,7 +8,7 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   XFILTER_REFRESH_EVENT
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/selection.ts
 function rowIdxsFromMark(el) {

package/dist/{chunk-TUZCM7SX.mjs → chunk-HW3WK7SL.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-RLOIA7QK.mjs";
+} from "./chunk-HEXJGF42.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;

package/dist/{chunk-VGJH63LZ.mjs → chunk-NEICPMG7.mjs}

@@ -1,7 +1,7 @@
 /*! @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 {
   LASSO_KNOB_KEY
-} from "./chunk-TUZCM7SX.mjs";
+} from "./chunk-HW3WK7SL.mjs";
 
 // src/controls.ts
 var isKnob = (key) => key !== LASSO_KNOB_KEY;

package/dist/{chunk-GZSYTDFN.mjs → chunk-TNFUHR2L.mjs}

@@ -4,11 +4,11 @@ import {
   claimParkedLasso,
   installLasso,
   lassoEffect
-} from "./chunk-TUZCM7SX.mjs";
+} from "./chunk-HW3WK7SL.mjs";
 import {
   censusHitBands,
   ensureCrossfilterHitTargets
-} from "./chunk-EFKGSDFF.mjs";
+} from "./chunk-4AJYIAAJ.mjs";
 import {
   clearPress,
   clearSelectionGlyphs,
@@ -24,7 +24,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-RLOIA7QK.mjs";
+} from "./chunk-HEXJGF42.mjs";
 import {
   clipWindowOf,
   fitRenderedChart,
@@ -32,7 +32,7 @@ import {
   restoreInnerScroll,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-63IUMWY2.mjs";
+} from "./chunk-XFPHTQ7P.mjs";
 import {
   geoFromCache
 } from "./chunk-LXTW6YII.mjs";
@@ -51,7 +51,7 @@ import {
   deltaE2000,
   hexToLab,
   labToHex
-} from "./chunk-JTZTTJJK.mjs";
+} from "./chunk-CMZCRLIX.mjs";
 import {
   ACTIVE_TICK_CLASS,
   ANIM_LOOP_DELAY_DEFAULT,
@@ -96,7 +96,7 @@ import {
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/labelContrast.ts
 function parseRGBA(c) {

package/dist/{chunk-QG5TENI3.mjs → chunk-WK5PLWHT.mjs}

@@ -1,7 +1,7 @@
 /*! @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. */
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.24.0";
+var HOST_CONTRACT_VERSION = "1.25.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";

package/dist/{chunk-63IUMWY2.mjs → chunk-XFPHTQ7P.mjs}

@@ -3,7 +3,7 @@ import {
   CONTAINER_SLOT_SCROLL,
   SNAPSHOT_SVG_ATTR,
   TABLE_SCROLLER_CLASS
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 
 // src/fit.ts
 var SCROLL_SLACK_PX = 8;

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-IW6BKFF5.mjs";
+} from "./chunk-DM74ZXKA.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -131,7 +131,7 @@ import {
   toSourceRows,
   trackFocus,
   valuePlacementFlag
-} from "./chunk-GZSYTDFN.mjs";
+} from "./chunk-TNFUHR2L.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -158,13 +158,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-TUZCM7SX.mjs";
+} from "./chunk-HW3WK7SL.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-EFKGSDFF.mjs";
+} from "./chunk-4AJYIAAJ.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -189,7 +189,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-RLOIA7QK.mjs";
+} from "./chunk-HEXJGF42.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -219,7 +219,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-63IUMWY2.mjs";
+} from "./chunk-XFPHTQ7P.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -239,7 +239,7 @@ import {
   censusColourSpread,
   colourSpreadFlag,
   deltaEHex
-} from "./chunk-JTZTTJJK.mjs";
+} from "./chunk-CMZCRLIX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -298,7 +298,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-IW6BKFF5.mjs";
+} from "./chunk-DM74ZXKA.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-63IUMWY2.mjs";
-import "./chunk-QG5TENI3.mjs";
+} from "./chunk-XFPHTQ7P.mjs";
+import "./chunk-WK5PLWHT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -6,10 +6,10 @@ import {
   noteBadges,
   notesFor,
   readControls
-} from "./chunk-VGJH63LZ.mjs";
-import "./chunk-TUZCM7SX.mjs";
-import "./chunk-RLOIA7QK.mjs";
-import "./chunk-QG5TENI3.mjs";
+} from "./chunk-NEICPMG7.mjs";
+import "./chunk-HW3WK7SL.mjs";
+import "./chunk-HEXJGF42.mjs";
+import "./chunk-WK5PLWHT.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -5,26 +5,26 @@ import {
   createControls,
   noteBadges,
   notesFor
-} from "./chunk-VGJH63LZ.mjs";
+} from "./chunk-NEICPMG7.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-GZSYTDFN.mjs";
-import "./chunk-TUZCM7SX.mjs";
-import "./chunk-EFKGSDFF.mjs";
-import "./chunk-RLOIA7QK.mjs";
-import "./chunk-63IUMWY2.mjs";
+} from "./chunk-TNFUHR2L.mjs";
+import "./chunk-HW3WK7SL.mjs";
+import "./chunk-4AJYIAAJ.mjs";
+import "./chunk-HEXJGF42.mjs";
+import "./chunk-XFPHTQ7P.mjs";
 import {
   geoFromCache,
   loadGeo
 } from "./chunk-LXTW6YII.mjs";
 import "./chunk-K2TH7D5V.mjs";
-import "./chunk-JTZTTJJK.mjs";
+import "./chunk-CMZCRLIX.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-QG5TENI3.mjs";
+import "./chunk-WK5PLWHT.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-QG5TENI3.mjs";
+} from "./chunk-WK5PLWHT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/contract.d.ts

@@ -1,5 +1,5 @@
 import type { ExportFormat, ExportTableService, SaveFileService } from "./exportTable";
-export declare const HOST_CONTRACT_VERSION = "1.24.0";
+export declare const HOST_CONTRACT_VERSION = "1.25.0";
 export type GeoPointPrecision = "latlon" | "city" | "zip3" | "state" | "country";
 /** Every valid tier, ordered most precise → coarsest. Runtime form of GeoPointPrecision. */
 export declare const GEO_POINT_PRECISIONS: readonly GeoPointPrecision[];

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

@@ -156,6 +156,14 @@ export interface ViewStateService {
     viewing: ViewStateProvider;
     /** Survives close and reopen (a report file, a workbook). Absent or null: this host cannot. */
     durable?: ViewStateProvider | null;
+    /**
+     * The reader's OWN copy, kept for this person only (a browser store on their machine, an app's
+     * per-user record). It is written with the durable store's rules (lifetime, `durableWhen`, the size
+     * cap), and on a fresh viewing it is read BEFORE the durable store: the person sees their own view, and
+     * anyone without one sees the shared one. "Reset view" needs nothing of its own: the chart's cleared
+     * bag is written to every store. Absent or null: this host keeps no per-person view.
+     */
+    personal?: ViewStateProvider | null;
     /** The keys the HOST writes or scopes, by name. */
     policy: Readonly<Record<string, ViewStateKeyPolicy>>;
     /**

package/dist/types/viewState.d.ts

@@ -12,6 +12,11 @@ export declare function noopViewStateService(): ViewStateService;
  * a host cannot claim it without a durable store to back the claim.
  */
 export declare function viewStateIsDurable(service: ViewStateService | null | undefined): boolean;
+/**
+ * Whether this host keeps a view for each person apart from the shared one. Derived from the service,
+ * like `viewStateIsDurable`: a host has a personal view exactly when it supplies a personal store.
+ */
+export declare function viewStateIsPersonal(service: ViewStateService | null | undefined): boolean;
 /**
  * The rule for a key the chart's own code writes, when a service names no other. The chart keeps it:
  * it reaches the durable store, and it survives a new version of the chart and a fresh viewing.
@@ -38,8 +43,8 @@ export interface ResolveViewStateOptions {
 export interface ResolvedViewState {
     /** The bag to hand the chart as `options.uiState`. The caller's own copy: nothing in a store aliases it. */
     bag: Record<string, unknown>;
-    /** Where the bag was read from. `"none"`: neither store held anything. */
-    source: "viewing" | "durable" | "none";
+    /** Where the bag was read from. `"none"`: no store held anything. */
+    source: "viewing" | "personal" | "durable" | "none";
     /** Every key a rule took out, in the order the rules ran, so a host can log what it did. */
     dropped: ViewStateDrop[];
 }
@@ -47,10 +52,11 @@ export interface ResolvedViewState {
  * BUILD THE BAG A CHART IS HANDED.
  *
  * Read order: the viewing store when it holds anything (or when the viewing has already written, see
- * `freshViewing`), otherwise the durable store, otherwise nothing. The viewing store is the newer of
- * the two within a viewing: a durable store can lag its own writes by a round trip, and a redraw in
- * that window must see the write, not the state before it. A key whose lifetime is `"viewing"` is
- * never believed from the durable store.
+ * `freshViewing`), otherwise the personal store, otherwise the durable store, otherwise nothing. The
+ * viewing store is the newest within a viewing: a stored copy can lag its own writes by a round trip,
+ * and a redraw in that window must see the write, not the state before it. The personal store comes
+ * before the durable one because it is this reader's own view, and the durable one is everyone's. A key
+ * whose lifetime is `"viewing"` is never believed from either stored copy.
  *
  * Then two rules run, in this order, each over the keys a service's policy names (and, for the keys
  * it doesn't, over `chartKeys`):
@@ -88,13 +94,15 @@ export interface CommitViewStateResult {
     viewingSaved: boolean;
     /** The durable store's `save` ran without throwing. False too when the service has no durable store. */
     durableSaved: boolean;
-    /** Keys kept out of the durable store because their `durableWhen` preference is off, in policy order. */
+    /** The personal store's `save` ran without throwing. False too when the service has no personal store. */
+    personalSaved: boolean;
+    /** Keys kept out of the stored copies (durable and personal) because their `durableWhen` preference is off, in policy order. */
     withheld: string[];
-    /** Characters of JSON in the durable payload, measured only when the service sets a limit. */
+    /** Characters of JSON in the stored payload (durable and personal), measured only when the service sets a limit. */
     durableChars: number | null;
-    /** A store that threw. The other store is still written, and the write never throws out of the chart. */
+    /** A store that threw. The other stores are still written, and the write never throws out of the chart. */
     errors: Array<{
-        store: "viewing" | "durable";
+        store: "viewing" | "durable" | "personal";
         error: unknown;
     }>;
 }
@@ -120,6 +128,10 @@ export interface ViewStatePreferences {
  * session the new pose. The one case where neither store is written is a refusal: a durable payload
  * over `durableMaxChars` is dropped whole, so the next read sees the state before it.
  *
- * Never throws. A store that throws is reported in `errors` and the other store is still written.
+ * A personal store gets exactly what the durable store gets, and is written after it: a reader's own
+ * copy and the shared copy hold the same thing after every write, so "Reset view" (the chart writing
+ * its cleared bag) clears both, and the size cap covers both.
+ *
+ * Never throws. A store that throws is reported in `errors` and the other stores are still written.
  */
 export declare function commitViewState(next: unknown, service: ViewStateService, prefs?: ViewStatePreferences | null): CommitViewStateResult;

package/dist/view-state.mjs

@@ -10,6 +10,9 @@ function noopViewStateService() {
 function viewStateIsDurable(service) {
   return !!service && !!service.durable;
 }
+function viewStateIsPersonal(service) {
+  return !!service && !!service.personal;
+}
 var CHART_OWNED_KEY_POLICY = Object.freeze({
   lifetime: "durable",
   dropOnNewVersion: false,
@@ -54,8 +57,9 @@ function resolveViewState(service, options = {}) {
     source = "viewing";
     raw = holds(viewed) ? viewed : {};
   } else {
-    const stored = loadOrEmpty(service.durable);
-    source = holds(stored) ? "durable" : "none";
+    const mine = loadOrEmpty(service.personal);
+    const stored = holds(mine) ? mine : loadOrEmpty(service.durable);
+    source = holds(mine) ? "personal" : holds(stored) ? "durable" : "none";
     raw = holds(stored) ? stored : {};
     if (isBag(raw)) {
       const believed = {};
@@ -113,6 +117,7 @@ function commitViewState(next, service, prefs) {
     outcome: "saved",
     viewingSaved: false,
     durableSaved: false,
+    personalSaved: false,
     withheld: [],
     durableChars: null,
     errors: []
@@ -120,8 +125,10 @@ function commitViewState(next, service, prefs) {
   if (next == null || typeof next !== "object") return { ...result, outcome: "ignored" };
   const bag = next;
   const durable = service.durable || null;
+  const personal = service.personal || null;
+  const kept = !!(durable || personal);
   let forFile = bag;
-  if (durable && isBag(bag)) {
+  if (kept && isBag(bag)) {
     let trimmed = null;
     const withheld = /* @__PURE__ */ new Set();
     for (const key of Object.keys(bag)) {
@@ -136,11 +143,11 @@ function commitViewState(next, service, prefs) {
     const declared = Object.keys(service.policy || {});
     result.withheld = [...declared.filter((k) => withheld.has(k)), ...[...withheld].filter((k) => !declared.includes(k))];
   }
-  if (durable && service.durableMaxChars) {
+  if (kept && service.durableMaxChars) {
     try {
       result.durableChars = JSON.stringify(forFile).length;
     } catch (error) {
-      result.errors.push({ store: "durable", error });
+      result.errors.push({ store: durable ? "durable" : "personal", error });
       return { ...result, outcome: "ignored" };
     }
     if (result.durableChars > service.durableMaxChars) return { ...result, outcome: "too-large" };
@@ -159,6 +166,14 @@ function commitViewState(next, service, prefs) {
       result.errors.push({ store: "durable", error });
     }
   }
+  if (personal) {
+    try {
+      personal.save(forFile);
+      result.personalSaved = true;
+    } catch (error) {
+      result.errors.push({ store: "personal", error });
+    }
+  }
   return result;
 }
 export {
@@ -167,5 +182,6 @@ export {
   noopViewStateService,
   resolveViewState,
   viewStateAfterSwap,
-  viewStateIsDurable
+  viewStateIsDurable,
+  viewStateIsPersonal
 };

package/package.json

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