@bicharts/chart-host 0.6.15 → 0.6.16

package/dist/index.mjs

@@ -2383,6 +2383,23 @@ function reconcileChartPick(pick, offered, autoLabel) {
   };
 }
 
+// src/duplicateGenerateGuard.ts
+var DUPLICATE_GENERATE_WINDOW_MS = 2500;
+function sameRequest(a2, b2) {
+  return a2.schemaHash === b2.schemaHash && a2.gennew === b2.gennew && a2.trycnt === b2.trycnt && a2.favorStyle === b2.favorStyle;
+}
+function isDuplicateGenerate(prev, next, now) {
+  if (!prev) return false;
+  if (!sameRequest(prev, next)) return false;
+  if (prev.inFlight) return true;
+  const elapsed = now - prev.startedAt;
+  if (elapsed < 0) return false;
+  return elapsed < DUPLICATE_GENERATE_WINDOW_MS;
+}
+function armGenerateGuard(next, now) {
+  return { ...next, startedAt: now, inFlight: true };
+}
+
 // src/clientIdentity.ts
 function stableFingerprintOptions() {
   return { exclude: ["fonts", "system.useragent", "system.browser.version"], logging: false };
@@ -2450,6 +2467,7 @@ export {
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
+  DUPLICATE_GENERATE_WINDOW_MS,
   FILTER_MIN_HEIGHT_PX,
   FILTER_MIN_TERM_CHARS,
   FILTER_MIN_WIDTH_PX,
@@ -2504,6 +2522,7 @@ export {
   XFILTER_REFRESH_EVENT,
   actionFor,
   applyLabelContrast,
+  armGenerateGuard,
   askApplyImprovements,
   assembleD3,
   autoRampCanvas,
@@ -2565,6 +2584,7 @@ export {
   invalidSentinelReason,
   isBlankRender,
   isBlindMarker,
+  isDuplicateGenerate,
   isExcelDateFormat,
   isHorizontalLabelRow,
   isInsideControl,

package/dist/types/duplicateGenerateGuard.d.ts

@@ -0,0 +1,33 @@
+/** What identifies one generate request for suppression purposes. */
+export interface GenerateGuardKey {
+    /** Field/column fingerprint. A field change moves this, and must not be suppressed. */
+    schemaHash: number;
+    /** A fresh generation vs a fetch/regeneration - different intents. */
+    gennew: boolean;
+    /** The explicit chart-type pick ("" when the picker is free to choose). */
+    favorStyle: string;
+    /** The retry counter. Differs on every retry, so a retry is never suppressed. */
+    trycnt: number;
+}
+/** The last generate a host started, plus whether it is still running. */
+export interface GenerateGuardState extends GenerateGuardKey {
+    /** The host's clock (performance.now()) when the call STARTED. */
+    startedAt: number;
+    /** True from the start of the generate until it settles. */
+    inFlight: boolean;
+}
+/** Two calls this close together, with everything else equal, are one user action. */
+export declare const DUPLICATE_GENERATE_WINDOW_MS = 2500;
+/**
+ * Should this generate be suppressed as a duplicate of the one before it?
+ *
+ * Suppress when the request is identical AND either the previous call is still running, or it
+ * started within the window. Anything else proceeds.
+ *
+ * @param prev  what the host last started, or null on its first generate
+ * @param next  the request about to be made
+ * @param now   the host's clock (performance.now()) at the moment of the call
+ */
+export declare function isDuplicateGenerate(prev: GenerateGuardState | null | undefined, next: GenerateGuardKey, now: number): boolean;
+/** The state to record when a generate is allowed to proceed. */
+export declare function armGenerateGuard(next: GenerateGuardKey, now: number): GenerateGuardState;

package/dist/types/index.d.ts

@@ -38,5 +38,6 @@ export { resolveAutoColorScale, autoRampMinStep, autoRampCanvas, AUTO_RAMP_CLASS
 export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_FIRST_POLL_MS, PENDING_RECOVERY_FAST_PHASE_MS, PENDING_RECOVERY_MID_POLL_MS, PENDING_RECOVERY_SLOW_PHASE_MS, PENDING_RECOVERY_SLOW_POLL_MS, pendingRecoveryNextDelayMs, encodePendingGenerate, parsePendingGenerate, markerArmedBlind, isBlindMarker, servedCorrelationProves, sameMarker, decidePendingRecovery, recoveryPollRunning, recoveryOwnsTheSentence, latePickupAction, latePickupKeepsMarker, pollGiveUpKeepsMarker, pendingRecoveryRemainingMs, transportFailureShouldRecover, TRANSPORT_LOST_CHECKING_MESSAGE, GENERATION_CANCELLED_MESSAGE, recoveryAnswerIsCancelled, generationCancelledMessage, type PendingGenerateMarker, type PendingRecoveryDecision, type LatePickupAction, } from "./pendingGenerate";
 export { stripJsComments } from "./codeComments";
 export { reconcileChartPick, type ChartPickReconciliation } from "./chartPick";
+export { isDuplicateGenerate, armGenerateGuard, DUPLICATE_GENERATE_WINDOW_MS, type GenerateGuardKey, type GenerateGuardState, } from "./duplicateGenerateGuard";
 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/package.json

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