@bicharts/chart-host 0.6.23 → 0.6.25

package/dist/index.mjs

@@ -2408,6 +2408,31 @@ function shouldRestoreVersionAfterLicenseSave(currentVersionValue, cachedVersion
   return (currentVersionValue ?? 0) === 0 && canShowLastChart(cachedVersionPersisted, cachedCodePersisted);
 }
 
+// src/filterNarrowing.ts
+function isNarrowedByFilter(s2) {
+  if (s2.highWaterSchemaHash === null || s2.highWaterSchemaHash !== s2.currentSchemaHash) return false;
+  if (!(s2.highWaterRows > 0)) return false;
+  if (!(s2.currentRows > 0)) return false;
+  return s2.currentRows < s2.highWaterRows;
+}
+function isEmptiedByFilter(s2) {
+  if (s2.highWaterSchemaHash === null || s2.highWaterSchemaHash !== s2.currentSchemaHash) return false;
+  if (!(s2.highWaterRows > 0)) return false;
+  return s2.currentRows <= 0;
+}
+function updateRowHighWater(prevRows, prevSchemaHash, currentRows, currentSchemaHash) {
+  if (prevSchemaHash !== currentSchemaHash) {
+    return { rows: currentRows, schemaHash: currentSchemaHash };
+  }
+  return { rows: Math.max(prevRows, currentRows), schemaHash: currentSchemaHash };
+}
+
+// src/thumbnailPolicy.ts
+function shouldCaptureThumbnail(g2) {
+  const capture = g2.forced || (g2.consented || g2.capturesByDefault) && g2.firstRenderAfterGenerate;
+  return { capture, consent: g2.consented };
+}
+
 // src/clientIdentity.ts
 function stableFingerprintOptions() {
   return { exclude: ["fonts", "system.useragent", "system.browser.version"], logging: false };
@@ -2594,10 +2619,12 @@ export {
   isBlankRender,
   isBlindMarker,
   isDuplicateGenerate,
+  isEmptiedByFilter,
   isExcelDateFormat,
   isHorizontalLabelRow,
   isInsideControl,
   isInvalidSentinelError,
+  isNarrowedByFilter,
   isPhantomBox,
   isPillBackdropAlpha,
   labelBand,
@@ -2659,6 +2686,7 @@ export {
   scrollFitFor,
   servedCorrelationProves,
   sessionViewStateProvider,
+  shouldCaptureThumbnail,
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
   shouldRestoreVersionAfterLicenseSave,
@@ -2674,6 +2702,7 @@ export {
   toSourceRows,
   transportFailureShouldRecover,
   unpinScrolledAxis,
+  updateRowHighWater,
   valuePlacementFlag,
   vegaSpecReadsDatesInLocalTime,
   withoutViewOnlyKeys

package/dist/types/filterNarrowing.d.ts

@@ -0,0 +1,38 @@
+export interface NarrowingState {
+    /** Row count of the dataset just delivered. */
+    currentRows: number;
+    /** Most rows ever seen for highWaterSchemaHash (0 = nothing recorded yet). */
+    highWaterRows: number;
+    /** Schema the high water was recorded against (null = nothing recorded yet). */
+    highWaterSchemaHash: number | null;
+    /** Schema of the dataset just delivered. */
+    currentSchemaHash: number;
+}
+/**
+ * True when the current dataset is a strict, non-empty subset of the largest one this schema has
+ * produced - a slicer or cross-filter is narrowing the data right now, and the chart is drawable but
+ * thin. Zero rows is a different state with its own predicate, `isEmptiedByFilter`, so neither caller
+ * has to re-check a row count to learn which question it got an answer to.
+ */
+export declare function isNarrowedByFilter(s: NarrowingState): boolean;
+/**
+ * True when the dataset has been filtered away to NOTHING - same schema, a positive high water, and
+ * zero rows now.
+ *
+ * Filtered-to-nothing is legitimately empty, but it is not indistinguishable from an empty dataset,
+ * and treating it as one cost a reader the connection between their own click and the chart that
+ * then read a flat "no data". The evidence needed is the SAME high-water signal: at zero rows, on an
+ * unchanged schema, a positive high water means this schema HAS delivered rows before and does not
+ * now. Only a filter does that. A changed schema resets the high water, so field drift reads a high
+ * water of 0 here and keeps the plain no-data wording.
+ */
+export declare function isEmptiedByFilter(s: NarrowingState): boolean;
+/**
+ * Roll the high-water mark forward for a completed load. Resets (rather than maxing) when the schema
+ * changes, so a field swap cannot leave a stale baseline from the previous schema making every later
+ * load look narrowed.
+ */
+export declare function updateRowHighWater(prevRows: number, prevSchemaHash: number | null, currentRows: number, currentSchemaHash: number): {
+    rows: number;
+    schemaHash: number;
+};

package/dist/types/index.d.ts

@@ -40,5 +40,7 @@ export { stripJsComments } from "./codeComments";
 export { reconcileChartPick, type ChartPickReconciliation } from "./chartPick";
 export { isDuplicateGenerate, armGenerateGuard, DUPLICATE_GENERATE_WINDOW_MS, type GenerateGuardKey, type GenerateGuardState, } from "./duplicateGenerateGuard";
 export { canShowLastChart, shouldRestoreVersionAfterLicenseSave } from "./lastChart";
+export { isNarrowedByFilter, isEmptiedByFilter, updateRowHighWater, type NarrowingState, } from "./filterNarrowing";
+export { shouldCaptureThumbnail, type ThumbnailGate, type ThumbnailDecision } from "./thumbnailPolicy";
 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/thumbnailPolicy.d.ts

@@ -0,0 +1,17 @@
+export interface ThumbnailGate {
+    /** The reader or their account opted in to saving thumbnails. The only input that is consent. */
+    consented: boolean;
+    /** The service asked for this account's renders to be captured for diagnosis. Not consent. */
+    forced: boolean;
+    /** The host's terms cover a capture without the setting (e.g. a free tier). Not consent. */
+    capturesByDefault: boolean;
+    /** This render is the first of a newly generated version - not a resize, reopen or filter. */
+    firstRenderAfterGenerate: boolean;
+}
+export interface ThumbnailDecision {
+    /** Capture an image of this render. */
+    capture: boolean;
+    /** The consent flag to send beside it: `consented`, never raised by a forced or default capture. */
+    consent: boolean;
+}
+export declare function shouldCaptureThumbnail(g: ThumbnailGate): ThumbnailDecision;

package/package.json

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