@bicharts/chart-host 0.6.47 → 0.6.49

package/dist/react.mjs

@@ -7,7 +7,7 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-XWVIYCMM.mjs";
+} from "./chunk-53OX7DYN.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/blankRender.d.ts

@@ -5,6 +5,8 @@ export interface MarkCensus {
     legendMarkCount: number;
     /** What the chart built. `html` is a first-class answer, not a failure — see below. */
     containerKind: "svg" | "html" | "empty";
+    /** The chart declared (NO_ROW_MARKS_ATTR) that it draws no per-row marks by design. */
+    declaresNoRowMarks: boolean;
 }
 /**
  * Count what the render actually left behind.
@@ -45,6 +47,13 @@ export interface BlankVerdictInput {
      * evidence-free and must not return a verdict.
      */
     contractUntagged?: boolean;
+    /**
+     * The chart declared that it draws no per-row marks by design (censusMarks reports it from
+     * NO_ROW_MARKS_ATTR). A what-if predictor draws one model, not a mark per row, so "no marks"
+     * is its correct picture. The declaration sits in the chart's working path, so a chart that
+     * bailed to its no-data branch never carries it and is still judged.
+     */
+    declaresNoRowMarks?: boolean;
 }
 /**
  * Did this render paint nothing, against data that had something to paint?

package/dist/types/chartPick.d.ts

@@ -1,24 +1,6 @@
-/**
- * A standing chart-type pick, checked against a FRESH qualify list.
- *
- * A reader's explicit pick can outlive the generate it was made for - a host that keeps it across a
- * refusal that spent nothing, or one whose pick is a standing control by design. Either way the fields
- * can change underneath it, and a pick the data no longer supports would otherwise cost a generate to
- * discover: the substitution warning arrives after the credit, not before it.
- *
- * ONLY AGAINST A FRESH LIST, and only against the server's own answer. The list is what the qualify
- * endpoint says fits the data as it is now; checking the pick against a client-side re-implementation of
- * the shape gates would be a second opinion quietly disagreeing with the engine.
- *
- * AN EMPTY LIST IS NOT EVIDENCE THE PICK DIED. It is the shape qualifying for nothing, which has its own
- * message and its own fix; dropping the pick there would add a second, misleading sentence.
- *
- * A DROP IS ALWAYS SAID. The message names the type and what the pick went back to, so a pick never
- * disappears silently. `offered` is every name the host would let the reader pick right now - a host whose
- * list also offers poor-fit types to pick anyway passes those too, because the pick is still choosable.
- */
 export interface ChartPickReconciliation {
-    /** The pick after reconciling: the original (trimmed) when still offered, else "" (no pick). */
+    /** The pick after reconciling: the original (trimmed) when still offered under its own spelling, the
+     *  OFFERED spelling when it is offered only under the loose key, else "" (no pick). */
     pick: string;
     /** True when a pick was dropped because the fresh list no longer offers it. */
     dropped: boolean;

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.12.0";
+export declare const HOST_CONTRACT_VERSION = "1.13.0";
 export type GeoPointPrecision = "latlon" | "city" | "zip3" | "state" | "country";
 /** Every valid tier, ordered most precise → coarsest. Runtime form of GeoPointPrecision. */
 export declare const GEO_POINT_PRECISIONS: readonly GeoPointPrecision[];
@@ -13,6 +13,8 @@ export declare const AXIS_FILTER_CLASS = "d3-axis-filter";
 export declare const LIFT_SELECTED_CLASS = "d3-lift-selected";
 export declare const CONTROL_CLASS = "lch-control";
 export declare const ROW_IDX_ATTR = "data-row-idx";
+export declare const NO_ROW_MARKS_ATTR = "data-lch-no-row-marks";
+export declare const SNAPSHOT_SVG_ATTR = "data-lch-snapshot";
 export declare const XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 export declare const CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
@@ -71,6 +73,10 @@ export declare const COLOR_SCALE_SELF_CLAMP_PCT_MAX = 100;
 export type TimelineStyle = "" | "line" | "boxes";
 export type FlipMode = "" | "single" | "all" | "both";
 export declare const FLIP_MODE_DEFAULT: FlipMode;
+export declare const FLIP_INTERVAL_MIN_MS = 500;
+export declare const FLIP_INTERVAL_MAX_MS = 120000;
+export type FlipDirection = "horizontal" | "vertical";
+export declare const FLIP_DIRECTION_DEFAULT: FlipDirection;
 export type ApproximatePositions = "mark" | "aggregate" | "skip";
 export declare const APPROXIMATE_POSITIONS_DEFAULT: ApproximatePositions;
 export type ValueAxisBaseline = "zero" | "fit" | "auto";
@@ -144,6 +150,7 @@ export interface RenderOptions {
     flipSync?: boolean;
     flipIntervalMs?: number;
     flipMode?: FlipMode;
+    flipDirection?: FlipDirection;
     cardBackgroundColor?: string;
     onSelect?: (rowIdxs: number[]) => void;
     /**

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
+export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, NO_ROW_MARKS_ATTR, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
 export { OPTIONS_VOCABULARY, LIVE_OPTION_KEYS, MAX_MAP_POINTS_MIN, MAX_MAP_POINTS_MAX, LIMIT_COUNT_MAX, wireLimitCount, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
@@ -11,19 +11,19 @@ export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, e
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
 export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
-export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, type SnapshotOptions } from "./snapshot";
+export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, tableHostOf, chartSvgOf, htmlToSvgDataUrl, htmlNaturalSize, 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 { mountProductFeedbackBox, normaliseProductFeedbackText, productFeedbackSendable, buildProductFeedbackPayload, PRODUCT_FEEDBACK_MAX_CHARS, PRODUCT_FEEDBACK_MIN_CHARS, type ProductFeedbackBox, type ProductFeedbackBoxOptions, type ProductFeedbackText, type ProductFeedbackSendResult, type ProductFeedbackPayload, type ProductFeedbackIdentity, type ProductFeedbackHost, } from "./productFeedback";
 export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, type QualifyGroupState, type QualifyGroupHeading, orderRefusalsForDisplay, refusalIsSelectable, hasRefusalsToShow, qualifyRefusalHeadingFor, newQualifyRefusalGroupState, qualifyRefusalReason, QUALIFY_REFUSAL_UNSPECIFIED, 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 { normalizeFilterTerm, filterQualifyRows, readQualifyChartRow, readQualifyRefusalRow, filterFitsChooser, listNeedsFilter, qualifyFilterGate, inlineFilterGate, FILTER_MIN_TERM_CHARS, FILTER_ROW_PX, FILTER_MIN_WIDTH_PX, FILTER_MIN_HEIGHT_PX, INLINE_FILTER_MIN_ROWS, computeQualifyFilterView, qualifyFilterCountText, type QualifyFilterTier, type QualifyFilterResult, type QualifyFilterRead, type QualifyFilterGateReason, type QualifyFilterGateInput, type QualifyFilterRow, type QualifyFilterGroup, type QualifyFilterView, type QualifyFilterNoteKind, } from "./qualifyFilter";
+export { normalizeFilterTerm, filterQualifyRows, readQualifyChartRow, readQualifyRefusalRow, DEFAULT_FILTER_MATCH_STYLE, filterMatchStyleOf, type FilterMatchStyle, filterFitsChooser, listNeedsFilter, qualifyFilterGate, inlineFilterGate, FILTER_MIN_TERM_CHARS, FILTER_ROW_PX, FILTER_MIN_WIDTH_PX, FILTER_MIN_HEIGHT_PX, INLINE_FILTER_MIN_ROWS, computeQualifyFilterView, qualifyFilterCountText, type QualifyFilterTier, type QualifyFilterResult, type QualifyFilterRead, type QualifyFilterGateReason, type QualifyFilterGateInput, type QualifyFilterRow, type QualifyFilterGroup, type QualifyFilterView, type QualifyFilterNoteKind, } from "./qualifyFilter";
 export { computeSelectionCard, normaliseAggregation, type SelectionCardModel, type SelectionCardLine, type SelectionCardOptions, } from "./selectionCard";
 export { formatSourceDate, formatSourceDateFor, isExcelDateFormat, type SourceFormats, type SourceFormatDialect, type SourceDateOptions, } from "./sourceDateFormat";
 export { composeSummaryText } from "./summaryText";
 export { ensureCrossfilterHitTargets, type HitTargetReport } from "./hitTargets";
-export { applyLabelContrast, LABEL_CONTRAST_DONE_ATTR, LABEL_CONTRAST_CAP, type LabelContrastOptions, type LabelContrastReport, } from "./labelContrastDom";
-export { decideLabelColor, toRGBA, compositeOver, relativeLuminance, contrastRatio, isPillBackdropAlpha, pillBacksGlyph, backingHoldsGlyph, cellSuppressesNormalize, glyphSampleGrid, DARK_TEXT, LIGHT_TEXT, MIN_CONTRAST, WHITE_TEXT_BG_LUM, PILL_MIN_ALPHA, PILL_OPAQUE_ALPHA, PILL_MIN_COVERAGE, PAGE_MATCH_TOLERANCE, BACKING_MAJORITY, GLYPH_SAMPLE_N, type LabelDecision, } from "./labelContrast";
+export { applyLabelContrast, LABEL_CONTRAST_DONE_ATTR, LABEL_CONTRAST_CAP, LABEL_PILL_CLASS, type LabelContrastOptions, type LabelContrastReport, } from "./labelContrastDom";
+export { decideLabelColor, toRGBA, compositeOver, relativeLuminance, contrastRatio, isPillBackdropAlpha, pillBacksGlyph, backingHoldsGlyph, cellSuppressesNormalize, glyphSampleGrid, DARK_TEXT, LIGHT_TEXT, MIN_CONTRAST, WHITE_TEXT_BG_LUM, PILL_MIN_ALPHA, PILL_OPAQUE_ALPHA, PILL_MIN_COVERAGE, PAGE_MATCH_TOLERANCE, BACKING_MAJORITY, GLYPH_SAMPLE_N, straddles, straddleSampleGrid, minContrastOver, pickColorOver, STRADDLE_COLS, STRADDLE_ROWS, STRADDLE_MIN_SHARE, STRADDLE_TARGET_CONTRAST, STRADDLE_PILL_ALPHA, type LabelDecision, } from "./labelContrast";
 export { censusMarks, isBlankRender, blankRenderFlag, type MarkCensus, type BlankVerdictInput } from "./blankRender";
 export { isInvalidSentinelError, invalidSentinelReason } from "./invalidSentinel";
 export { censusHitBands, hitBandFlag, MIN_HIT_BAND_PX, type HitBandCensus } from "./hitBands";

package/dist/types/labelContrast.d.ts

@@ -53,4 +53,41 @@ export declare function glyphSampleGrid(box: {
     x: number;
     y: number;
 }[];
+export declare const STRADDLE_COLS = 8;
+export declare const STRADDLE_ROWS = 2;
+/** The share of a label's samples a second surface must hold before the label straddles it. */
+export declare const STRADDLE_MIN_SHARE = 0.125;
+/** What a pill-backed label is held to over its whole box - WCAG AA for body text. */
+export declare const STRADDLE_TARGET_CONTRAST = 4.5;
+/** The pill's opacity: the boosted-pill value, so every backdrop this pass paints reads alike. */
+export declare const STRADDLE_PILL_ALPHA = 0.9;
+/** Sample points for the straddle test: STRADDLE_COLS x STRADDLE_ROWS cell centres over the box. */
+export declare function straddleSampleGrid(box: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}): {
+    x: number;
+    y: number;
+}[];
+/** Distinct surfaces among per-sample backgrounds (per-channel tolerance), largest first. */
+export declare function backgroundGroups(bgs: [number, number, number][], tol?: number): {
+    rgb: [number, number, number];
+    n: number;
+}[];
+/** True when at least two surfaces each hold STRADDLE_MIN_SHARE of a label's samples. */
+export declare function straddles(bgs: [number, number, number][]): boolean;
+/** The lowest contrast a text colour reaches over every sample background (0 when unparseable). */
+export declare function minContrastOver(textColor: string | null | undefined, bgs: [number, number, number][]): number;
+/**
+ * The one colour for a label over several backgrounds: the author's own when it reaches `target`
+ * over all of them (a colour that reads is never overruled), else whichever of DARK_TEXT and
+ * LIGHT_TEXT reads best over the worst of them.
+ */
+export declare function pickColorOver(textColor: string | null | undefined, bgs: [number, number, number][], target?: number): {
+    color: string;
+    contrast: number;
+    keep: boolean;
+};
 export {};

package/dist/types/labelContrastDom.d.ts

@@ -30,7 +30,17 @@ export interface LabelContrastReport {
     /** Labels with a painting shape over their box that was set aside because it is drawn ON TOP
      *  of them - an occluder, never a background. See drawnBeneath. */
     paintedOver: number;
+    /** Labels straddling a fill edge that got a page-coloured pill of their own instead of a
+     *  recolour - one colour cannot read on two surfaces with opposite needs. */
+    straddlePills: number;
+    /** Adopted pills grown to cover their label's whole box, so no glyph starts off the pill. */
+    pillsExtended: number;
+    /** Labels partly covered by a shape drawn after them in their own group, moved above it. */
+    raised: number;
     /** Why the pass did nothing, when it did nothing. */
     skipped?: "no-container" | "no-shapes" | "too-many-shapes" | "too-many-texts" | "error";
 }
+/** The class a pill this pass paints carries, so a reader of the DOM (or a test) can tell it from
+ *  the chart's own shapes. */
+export declare const LABEL_PILL_CLASS = "lch-label-pill";
 export declare function applyLabelContrast(container: HTMLElement | null | undefined, opts?: LabelContrastOptions): LabelContrastReport;

package/dist/types/optionsVocabulary.d.ts

@@ -49,6 +49,17 @@ export declare const OPTIONS_VOCABULARY: Readonly<{
     /** "" chooses by the number of periods. */
     animTimelineStyle: OptionVocabularyEntry;
     filtersDuringPlay: OptionVocabularyEntry;
+    /** Where a card deck's flip controls live: every card's own arrows, one strip for the deck, or both. */
+    flipMode: OptionVocabularyEntry;
+    /**
+     * BLANK - "the chart's own" - is the default, and it is not 0. A host that was never told a value
+     * sends none (resolveOptions keeps it absent) and the chart supplies its own: manual on the card
+     * deck, a 5 s dwell on a carousel. 0 is a reader's explicit "manual only". A non-zero value is
+     * clamped chart-side to FLIP_INTERVAL_MIN_MS..FLIP_INTERVAL_MAX_MS.
+     */
+    flipIntervalMs: OptionVocabularyEntry;
+    /** Which way a face turns, for any chart that turns between faces: side to side, or top to bottom. */
+    flipDirection: OptionVocabularyEntry;
     levelOfDetail: OptionVocabularyEntry;
     favorLimitTo: OptionVocabularyEntry;
     /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */

package/dist/types/qualifyFilter.d.ts

@@ -1,5 +1,27 @@
 /**
- * The comparison form of a term or a field.
+ * HOW A TERM MATCHES A NAME - a reader's setting on every host, and "loose" unless they choose
+ * otherwise.
+ *
+ * "loose" - the rule for every match against names we know: diacritic-neutral and case-,
+ *           whitespace- and punctuation-insensitive. "barchart", "bar-chart" and "Bar Chart" all
+ *           find `Bar chart`. The exact form is still asked first, so a row the exact form found at
+ *           a word start is found there still; the loose form only adds candidates. One consequence
+ *           to know: an added word-start hit takes the answer to the name tier, which hides
+ *           mid-word hits exactly as any word-start hit always has.
+ * "exact" - accents and case folded and runs of whitespace collapsed, and nothing else: "bar chart"
+ *           and "bar  chart" are the same query, but "barchart" and "bar-chart" are not. For a reader
+ *           who wants that: one who omits the space is asking for something we do not have a name
+ *           for, and a filter that succeeds there anyway can make its failures harder to explain.
+ */
+export type FilterMatchStyle = "loose" | "exact";
+/** The style a host uses when the reader has not chosen one. */
+export declare const DEFAULT_FILTER_MATCH_STYLE: FilterMatchStyle;
+/** Read a host's stored setting: "exact" only when it says exactly that, "loose" otherwise - so a
+ *  missing, empty or unrecognised value is the default, never an error. */
+export declare function filterMatchStyleOf(raw: unknown): FilterMatchStyle;
+/**
+ * The comparison form of a term or a field - the EXACT form, which every style asks first and
+ * which hosts show back to the reader (the `term` of a result).
  *
  * Accent folding is not decoration. The catalogue is English, but the reader's keyboard need not
  * be, and a "Sankey" typed through a dead key has to match the same row a plain one does. NFD
@@ -8,8 +30,8 @@
  * different chart names collide.
  *
  * Whitespace is collapsed rather than stripped: "bar chart" and "bar  chart" are the same query,
- * but "barchart" is deliberately NOT one. A reader who omits the space is asking for something we
- * do not have a name for, and silently succeeding there would make the failures inexplicable.
+ * and "barchart" is not the same FORM. Whether "barchart" still FINDS `Bar chart` is the match
+ * style's business (see FilterMatchStyle): under "loose" it does, through the loose form.
  */
 export declare function normalizeFilterTerm(raw: string | null | undefined): string;
 /**
@@ -65,8 +87,14 @@ export type QualifyFilterRead<T> = (row: T) => {
  *
  * A row with no name is dropped from every tier. It cannot be labelled, so it cannot be chosen,
  * and the hosts already drop it at render time.
+ *
+ * UNDER THE LOOSE STYLE (the default) each field is asked in its exact form first and its loose
+ * form only when the exact form does not contain the term, and a loose hit counts only where it
+ * starts a word: "barchart" starts a word in `Bar chart` and `Stacked bar chart`, so it answers in
+ * the name tier, while "terna" is not found inside "patTERN Across". The `term` returned is always
+ * the exact form - it is what a host shows back to the reader.
  */
-export declare function filterQualifyRows<T>(rows: readonly T[] | null | undefined, term: string | null | undefined, read: QualifyFilterRead<T>): QualifyFilterResult<T>;
+export declare function filterQualifyRows<T>(rows: readonly T[] | null | undefined, term: string | null | undefined, read: QualifyFilterRead<T>, style?: FilterMatchStyle): QualifyFilterResult<T>;
 /** Reads a fitting row (`charts[]`): `name` / `description`.
  *
  *  GENERIC, and it has to be. Written as a `const` with an explicit `QualifyFilterRead<{...}>`
@@ -274,7 +302,7 @@ export interface QualifyFilterView<E> {
  * ORDER IS UNTOUCHED, as everywhere else here - `show` and `hide` come out in the order the
  * groups were built, so a host writing them in sequence cannot reorder anything by accident.
  */
-export declare function computeQualifyFilterView<E>(groups: readonly QualifyFilterGroup<E>[], term: string | null | undefined): QualifyFilterView<E>;
+export declare function computeQualifyFilterView<E>(groups: readonly QualifyFilterGroup<E>[], term: string | null | undefined, style?: FilterMatchStyle): QualifyFilterView<E>;
 /**
  * The counter beside the box: "12 of 137" while filtering, the plain total otherwise - and
  * "0 of 19 (+1)" when the term also reached the refusal block.

package/dist/types/snapshot.d.ts

@@ -11,9 +11,45 @@ export interface SnapshotOptions {
 }
 /**
  * Serialize an SVG element to a `data:image/svg+xml;base64,` URL, with intrinsic
- * width/height inlined on a clone so a later Image() load knows its size.
+ * width/height inlined on a clone so a later Image() load knows its size, and the computed font
+ * of its text inlined so the picture is not drawn in a default serif.
  */
 export declare function svgToDataUrl(svg: SVGSVGElement): string;
+/**
+ * THE TABLE HOST a snapshot of `root` should capture, or null when the chart's picture is an SVG.
+ *
+ * A table lane draws HTML rows with a small <svg> in each cell, so its first <svg> is one cell.
+ * The host is the `.lch-table-frame` the table helper builds, else a <table> - and only when the
+ * first <svg> under `root` sits INSIDE it (or there is no svg at all): a chart whose first svg is
+ * outside any table is an SVG chart with a table beside it, and keeps its SVG snapshot.
+ *
+ * Exported because the same question decides what a host measures to fit a chart to its frame: on a
+ * table lane that is the frame, never a cell.
+ */
+export declare function tableHostOf(root: Element | null | undefined): HTMLElement | null;
+/**
+ * THE CHART'S OWN <svg> under `root`: the one stamped SNAPSHOT_SVG_ATTR, else the first.
+ *
+ * ONE PICKER for everything that acts on "the chart's svg" - the thumbnail here and the frame grow in
+ * fitDom - because a chart with several svgs (a carousel mounts its front face between two peeks) is
+ * otherwise read by whichever was appended first, and the two callers would each have to know that.
+ */
+export declare function chartSvgOf(root: Element | null | undefined): SVGSVGElement | null;
+/** The drawn size of an HTML element, with an inline-style and then a fixed fallback. */
+export declare function htmlNaturalSize(el: HTMLElement): {
+    width: number;
+    height: number;
+};
+/**
+ * Serialize an HTML element - a table lane's frame - to an SVG data URL: a clone with its computed
+ * styles inlined, inside a <foreignObject> the size of the element. The picture is what the reader
+ * saw: the frame's own box, from the top of its scroll.
+ */
+export declare function htmlToSvgDataUrl(el: HTMLElement): {
+    url: string;
+    width: number;
+    height: number;
+};
 /** The measured drawing size of an SVG, with the same fallbacks svgToDataUrl inlines. */
 export declare function svgNaturalSize(svg: SVGSVGElement): {
     width: number;
@@ -25,8 +61,12 @@ export declare function svgNaturalSize(svg: SVGSVGElement): {
  */
 export declare function rasterizeSvgToPngDataUrl(svgDataUrl: string, width: number, height: number, opts?: SnapshotOptions): Promise<string | null>;
 /**
- * Capture the first <svg> under `root` (or the element itself) as a PNG data URL, falling
- * back to the SVG data URL when rasterizing is unavailable, and to null only when there is
- * genuinely nothing on the canvas to capture.
+ * Capture the chart under `root` as a PNG data URL: its table FRAME when the chart is an HTML table
+ * lane (see tableHostOf), else the chart's own <svg> under `root` (chartSvgOf), or the element itself. Falls back to
+ * the SVG data URL when rasterizing is unavailable, and to null only when there is genuinely nothing
+ * on the canvas to capture.
+ *
+ * PASS THE CONTAINER, not an svg found beforehand: only the container lets this tell a table lane
+ * from an SVG chart.
  */
 export declare function captureSvgSnapshot(root: Element | null | undefined, opts?: SnapshotOptions): Promise<string | null>;

package/package.json

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