@bicharts/chart-host 0.6.22 → 0.6.24

package/dist/index.mjs

@@ -2400,6 +2400,33 @@ function armGenerateGuard(next, now) {
   return { ...next, startedAt: now, inFlight: true };
 }
 
+// src/lastChart.ts
+function canShowLastChart(cachedVersionPersisted, cachedCodePersisted) {
+  return (cachedVersionPersisted ?? 0) > 0 && String(cachedCodePersisted ?? "").trim() !== "";
+}
+function shouldRestoreVersionAfterLicenseSave(currentVersionValue, cachedVersionPersisted, cachedCodePersisted) {
+  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/clientIdentity.ts
 function stableFingerprintOptions() {
   return { exclude: ["fonts", "system.useragent", "system.browser.version"], logging: false };
@@ -2537,6 +2564,7 @@ export {
   buildRenderPayload,
   buildReviewWire,
   canConfirmLaunch,
+  canShowLastChart,
   captureSvgSnapshot,
   cellSuppressesNormalize,
   censusColourSpread,
@@ -2585,10 +2613,12 @@ export {
   isBlankRender,
   isBlindMarker,
   isDuplicateGenerate,
+  isEmptiedByFilter,
   isExcelDateFormat,
   isHorizontalLabelRow,
   isInsideControl,
   isInvalidSentinelError,
+  isNarrowedByFilter,
   isPhantomBox,
   isPillBackdropAlpha,
   labelBand,
@@ -2652,6 +2682,7 @@ export {
   sessionViewStateProvider,
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
+  shouldRestoreVersionAfterLicenseSave,
   shouldReview,
   stableFingerprintOptions,
   stripEsmExports,
@@ -2664,6 +2695,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

@@ -39,5 +39,7 @@ export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_
 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 { 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/lastChart.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Should the "show last chart" way back be offered?
+ *
+ * @param cachedVersionPersisted the PERSISTED cached version (not live render state)
+ * @param cachedCodePersisted    the PERSISTED cached code (not live render state)
+ *
+ * True when a positive version is cached and its code is not blank.
+ */
+export declare function canShowLastChart(cachedVersionPersisted: number | null | undefined, cachedCodePersisted: string | null | undefined): boolean;
+/**
+ * After a licence is saved, should the host restore the cached version on its own?
+ *
+ * Only when the current version is 0 (missing reads as 0) - the reader was parked on the landing
+ * state - and there is a last chart to go back to (`canShowLastChart`).
+ */
+export declare function shouldRestoreVersionAfterLicenseSave(currentVersionValue: number | null | undefined, cachedVersionPersisted: number | null | undefined, cachedCodePersisted: string | null | undefined): boolean;

package/package.json

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