@bicharts/chart-host 0.6.24 → 0.6.25

package/dist/index.mjs

@@ -2427,6 +2427,12 @@ function updateRowHighWater(prevRows, prevSchemaHash, currentRows, currentSchema
   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 };
@@ -2680,6 +2686,7 @@ export {
   scrollFitFor,
   servedCorrelationProves,
   sessionViewStateProvider,
+  shouldCaptureThumbnail,
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
   shouldRestoreVersionAfterLicenseSave,

package/dist/types/index.d.ts

@@ -41,5 +41,6 @@ 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.24",
+  "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",