@bicharts/chart-host 0.5.29 → 0.5.31

package/dist/index.mjs

@@ -543,6 +543,32 @@ function askApplyImprovements(container, reason, opts = {}) {
   });
 }
 
+// src/qualifyGroups.ts
+function newQualifyGroupState() {
+  return { preview: false, previewClosed: false, projected: false, notRecommended: false };
+}
+function qualifyGroupHeadingFor(row, state) {
+  const preview = row.isPreview === true;
+  if (preview && !state.preview && !state.notRecommended) {
+    state.preview = true;
+    return "preview";
+  }
+  if (state.preview && !state.previewClosed && !preview) {
+    state.previewClosed = true;
+    return "main";
+  }
+  const projected = typeof row.viaProjection === "string" && row.viaProjection !== "";
+  if (projected && !state.projected && !state.notRecommended) {
+    state.projected = true;
+    return "projected";
+  }
+  if (row.recommended === false && !state.notRecommended) {
+    state.notRecommended = true;
+    return "notRecommended";
+  }
+  return null;
+}
+
 // src/index.ts
 function registerCityTable(packed) {
   L3(packed);
@@ -590,7 +616,9 @@ export {
   geoAssetFor,
   geoFromCache,
   loadGeo,
+  newQualifyGroupState,
   planTrivialChart,
+  qualifyGroupHeadingFor,
   rasterizeSvgToPngDataUrl,
   registerCityTable,
   registerGeo,

package/dist/types/index.d.ts

@@ -11,3 +11,4 @@ export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialS
 export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, type SnapshotOptions } from "./snapshot";
 export { shouldReview, buildReviewWire, bareBase64, actionFor, type ReviewGate, type ReviewWire, type ReviewVerdict, type ReviewAction } from "./review";
 export { askApplyImprovements, type ReviewDialogOptions, type ReviewDialogText } from "./reviewDialog";
+export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, type QualifyGroupState, type QualifyGroupHeading, } from "./qualifyGroups";

package/dist/types/qualifyGroups.d.ts

@@ -0,0 +1,31 @@
+/** One row of a qualify result, in the only shape this logic cares about. */
+export interface QualifyGroupRow {
+    /** Newer type, deliberately unscorable. Server-stamped from the chart catalogue. */
+    isPreview?: boolean | null;
+    /** false = the ontology says a required channel cannot be satisfied by these fields. */
+    recommended?: boolean | null;
+    /** Non-empty when the type qualifies only against an AGGREGATED projection of the shape. */
+    viaProjection?: string | null;
+}
+/** Which heading to write BEFORE a row, if any. */
+export type QualifyGroupHeading = "preview" | "main" | "projected" | "notRecommended";
+/** Carried across the loop. Create one per render with `newQualifyGroupState()`. */
+export interface QualifyGroupState {
+    preview: boolean;
+    previewClosed: boolean;
+    projected: boolean;
+    notRecommended: boolean;
+}
+export declare function newQualifyGroupState(): QualifyGroupState;
+/**
+ * The heading (if any) that belongs immediately before `row`, MUTATING `state` so the caller's
+ * loop stays a plain for-of. At most one heading per row: the boundaries cannot coincide, since
+ * a row leaving the preview block is by definition not the row that opened it.
+ *
+ * ORDER OF THE CHECKS IS THE CONTRACT:
+ *  1. "preview" opens the block - but never once the not-recommended block has opened, because a
+ *     preview type the ontology ruled out is NOT floated and belongs where it landed.
+ *  2. "main" closes it, at the first row that is not preview. Emitted only if a block opened.
+ *  3. "projected" and 4. "notRecommended" are unchanged from the single-host original.
+ */
+export declare function qualifyGroupHeadingFor(row: QualifyGroupRow, state: QualifyGroupState): QualifyGroupHeading | null;

package/package.json

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