@bicharts/chart-host 0.5.48 → 0.5.49

package/dist/index.mjs

@@ -580,6 +580,34 @@ function qualifyGroupHeadingFor(row, state) {
   }
   return null;
 }
+function newQualifyRefusalGroupState() {
+  return { poorFit: false, cannotDraw: false };
+}
+function refusalIsSelectable(row) {
+  return !!row && row.isVeto !== true;
+}
+function orderRefusalsForDisplay(rows) {
+  if (!Array.isArray(rows)) return [];
+  const named = rows.filter((r) => !!r && typeof r.name === "string" && r.name.trim() !== "");
+  return [...named.filter(refusalIsSelectable), ...named.filter((r) => !refusalIsSelectable(r))];
+}
+function qualifyRefusalHeadingFor(row, state) {
+  if (refusalIsSelectable(row)) {
+    if (!state.poorFit) {
+      state.poorFit = true;
+      return "poorFit";
+    }
+    return null;
+  }
+  if (!state.cannotDraw) {
+    state.cannotDraw = true;
+    return "cannotDraw";
+  }
+  return null;
+}
+function hasRefusalsToShow(rows) {
+  return orderRefusalsForDisplay(rows).length > 0;
+}
 
 // src/qualifyLaunch.ts
 var qualifyPick = (chartType) => ({ kind: "pick", chartType });
@@ -888,12 +916,15 @@ export {
   explainRenderFailure,
   geoAssetFor,
   geoFromCache,
+  hasRefusalsToShow,
   isBlankRender,
   launchFavorStyle,
   launchGenerates,
   loadGeo,
   newQualifyGroupState,
+  newQualifyRefusalGroupState,
   normaliseAggregation,
+  orderRefusalsForDisplay,
   periodTickSuppressesFeedback,
   planTrivialChart,
   qualifyAuto,
@@ -901,7 +932,9 @@ export {
   qualifyFailureFallsOpen,
   qualifyGroupHeadingFor,
   qualifyPick,
+  qualifyRefusalHeadingFor,
   rasterizeSvgToPngDataUrl,
+  refusalIsSelectable,
   registerCityTable,
   registerGeo,
   registerGeoAsset,

package/dist/types/index.d.ts

@@ -11,7 +11,7 @@ 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";
+export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, type QualifyGroupState, type QualifyGroupHeading, orderRefusalsForDisplay, refusalIsSelectable, hasRefusalsToShow, qualifyRefusalHeadingFor, newQualifyRefusalGroupState, type QualifyRefusalRow, type QualifyRefusalGroupState, type QualifyRefusalHeading, } from "./qualifyGroups";
 export { qualifyPick, qualifyAuto, qualifyCancel, launchGenerates, launchFavorStyle, chooserFitsViewport, shouldOpenChooserOnGenerate, shouldOpenInlineChooserOnGenerate, canConfirmLaunch, confirmLaunch, qualifyFailureFallsOpen, CHOOSER_MIN_WIDTH_PX, CHOOSER_MIN_HEIGHT_PX, type QualifyLaunchOutcome, type ChooserGateInput, } from "./qualifyLaunch";
 export { computeSelectionCard, normaliseAggregation, type SelectionCardModel, type SelectionCardLine, type SelectionCardOptions, } from "./selectionCard";
 export { ensureCrossfilterHitTargets, type HitTargetReport } from "./hitTargets";

package/dist/types/qualifyGroups.d.ts

@@ -29,3 +29,54 @@ export declare function newQualifyGroupState(): QualifyGroupState;
  *  3. "projected" and 4. "notRecommended" are unchanged from the single-host original.
  */
 export declare function qualifyGroupHeadingFor(row: QualifyGroupRow, state: QualifyGroupState): QualifyGroupHeading | null;
+/** One row of a qualify result's `refused` array, in the only shape this logic cares about. */
+export interface QualifyRefusalRow {
+    name?: string | null;
+    /** The gate's sentence. Absent is a real answer — the blocker rested on a runtime signal. */
+    reason?: string | null;
+    /** True = a required channel is ABSENT. Absent/false = a threshold we are willing to waive. */
+    isVeto?: boolean | null;
+}
+/** Which heading to write BEFORE a refused row, if any. */
+export type QualifyRefusalHeading = "poorFit" | "cannotDraw";
+/** Carried across the refusal loop. One per render. */
+export interface QualifyRefusalGroupState {
+    poorFit: boolean;
+    cannotDraw: boolean;
+}
+export declare function newQualifyRefusalGroupState(): QualifyRefusalGroupState;
+/**
+ * MAY THE READER PICK THIS ONE? The single place that answers it, in either host.
+ *
+ * DEFAULTS TO YES, and the asymmetry is deliberate. An older server sends no `isVeto` at all, so
+ * every row reads selectable and the reader is offered something that may be refused — one wasted
+ * click, and the refusal that follows names its own reason. The opposite default would hide charts
+ * from readers on exactly the servers that cannot tell us it is wrong to.
+ */
+export declare function refusalIsSelectable(row: QualifyRefusalRow | null | undefined): boolean;
+/**
+ * The refused rows in RENDER ORDER: everything pickable first, then the vetoes.
+ *
+ * A STABLE PARTITION, not a sort — within each block the server's alphabetical order survives, so
+ * two answers over the same shape stay diffable. Rows without a name are dropped: a control
+ * labelled with nothing cannot be chosen and a reason with no subject cannot be read.
+ *
+ * The two blocks are ordered pickable-first because the reader opened this section to DO something.
+ * Putting the inert half above the actionable half makes them scroll past every chart they cannot
+ * have to reach the ones they can.
+ */
+export declare function orderRefusalsForDisplay<T extends QualifyRefusalRow>(rows: readonly T[] | null | undefined): T[];
+/**
+ * The heading (if any) belonging immediately before `row`, MUTATING `state` — same shape as
+ * `qualifyGroupHeadingFor` so the two loops read alike.
+ *
+ * Assumes `rows` came through `orderRefusalsForDisplay`; fed an unpartitioned list it would write
+ * a heading at every alternation, which is why the ordering and the headings are one export pair
+ * rather than two independent helpers a host can half-adopt.
+ */
+export declare function qualifyRefusalHeadingFor(row: QualifyRefusalRow, state: QualifyRefusalGroupState): QualifyRefusalHeading | null;
+/**
+ * Is there anything behind "Show all chart types"? A checkbox that reveals nothing is worse than
+ * no checkbox: it reads as a broken control rather than an empty category.
+ */
+export declare function hasRefusalsToShow(rows: readonly QualifyRefusalRow[] | null | undefined): boolean;

package/package.json

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