@bicharts/chart-host 0.6.84 → 0.6.86

package/dist/types/legendFit/pass.d.ts

@@ -0,0 +1,29 @@
+import { type LegendReconcileResult } from "./legendReconcileDom";
+import { type FrameFitOutcome } from "./frameFitDom";
+/** "smart" acts on smaller overlaps with larger moves; "narrow" only on large, unambiguous ones. */
+export type LegendFitStrictness = "smart" | "narrow";
+export interface LegendFitPassOptions {
+    /** Run the legend reconcile (legend slide, colorbar, axis and label-row thinning, bottom-text push, content fit). Default true. */
+    legend?: boolean | LegendFitStrictness;
+    /** Run the frame fit (viewBox growth for text just past the frame, then shrink-and-cut of the labels it deferred). Default true. */
+    frameFit?: boolean;
+    /** What each run did. Counts and reasons only; the host decides what to log. */
+    onReport?: (report: LegendFitReport) => void;
+}
+export interface LegendFitReport {
+    legend: LegendReconcileResult | {
+        skipped: "off" | "no-svg";
+    } | {
+        error: string;
+    };
+    frame: FrameFitOutcome | {
+        skipped: "off" | "table-lane" | "nothing-to-measure";
+    } | {
+        error: string;
+    };
+}
+/**
+ * Build the pass once (module scope, or a memo) and hand it to createChartHost as `layoutPass`: a new function
+ * on every render is a new host config. Each run never throws; a pass that fails reports `{ error }`.
+ */
+export declare function createLegendFitPass(opts?: LegendFitPassOptions): (container: HTMLElement) => void;

package/dist/types/react.d.ts

@@ -41,6 +41,13 @@ export interface BicChartProps {
     labelContrast?: ChartHostConfig["labelContrast"];
     /** What the label-contrast pass did after each render - counts, for a page that logs. */
     onLabelContrast?: ChartHostConfig["onLabelContrast"];
+    /**
+     * A LAYOUT PASS run after every render, after label contrast and before the fit - e.g.
+     * `createLegendFitPass()` from "@bicharts/chart-host/legend-fit", which slides a legend clear of
+     * the plot and fits text to the frame. Absent by default. Build it ONCE (module scope or useMemo):
+     * a new function each render rebuilds the host. See createChartHost's `layoutPass`.
+     */
+    layoutPass?: ChartHostConfig["layoutPass"];
     /**
      * THE CHART STOPPED BECAUSE THE DATA LACKS A COLUMN IT IS BUILT ON. Supplied: the chart's
      * container is left empty and this is called with the chart's reason, instead of the throw

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.6.84",
+  "version": "0.6.86",
   "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",
@@ -59,6 +59,11 @@
       "import": "./dist/adapters.mjs",
       "default": "./dist/adapters.mjs"
     },
+    "./legend-fit": {
+      "types": "./dist/types/legendFit/index.d.ts",
+      "import": "./dist/legend-fit.mjs",
+      "default": "./dist/legend-fit.mjs"
+    },
     "./dax": {
       "types": "./dist/types/dax.d.ts",
       "import": "./dist/dax.mjs",