@bicharts/chart-host 0.6.83 → 0.6.84

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-4KCSAHL5.mjs";
+} from "./chunk-GG4U66E4.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -111,31 +111,68 @@ import {
   toSourceRows,
   unpinScrolledAxis,
   valuePlacementFlag
-} from "./chunk-CJNONH6V.mjs";
+} from "./chunk-2HKO6GEK.mjs";
+import {
+  LASSO_AXES_SLOT,
+  LASSO_COUNT_CLASS,
+  LASSO_DEFAULT_ACTIONS,
+  LASSO_DRAG_PX,
+  LASSO_EVENT,
+  LASSO_KNOB_KEY,
+  LASSO_MAX_VERTICES,
+  LASSO_MODE_ATTR,
+  LASSO_NOTE_CLASS,
+  LASSO_OUTLINE_CLASS,
+  LASSO_PLOT_CLASS,
+  LASSO_RESTORE_MAX_SHAPES,
+  LASSO_RESTORE_MAX_VERTICES,
+  LASSO_ROW_CAP,
+  LASSO_SAMPLE_PX,
+  LASSO_SURFACE_CLASS,
+  clearLasso,
+  installLasso,
+  lassoActions,
+  lassoRowCap,
+  lassoVerdict,
+  pointInShape,
+  registerLassoAction
+} from "./chunk-QIRLWJBI.mjs";
 import {
   _3,
   l,
   o
-} from "./chunk-2XWE6YFO.mjs";
+} from "./chunk-2ZUUIZWL.mjs";
 import {
   MIN_HIT_BAND_PX,
-  SELECTION_GLYPH_CLASS,
   censusHitBands,
+  ensureCrossfilterHitTargets,
+  hitBandFlag
+} from "./chunk-7HKVV5T5.mjs";
+import {
+  CONTAINER_SLOT_PRESS_AT,
+  DRAG_NOT_CLICK_PX,
+  ROW_SET_MAX,
+  SELECTION_GLYPH_CLASS,
+  clearPress,
   clearSelectionGlyphs,
+  clickWasDrag,
   collectD3GlyphCenters,
   createMarkResolver,
-  ensureCrossfilterHitTargets,
-  hitBandFlag,
+  dispatchRowSet,
+  gestureWasDrag,
   isInsideControl,
   markKeyOf,
   nextClickedMarks,
   nextSelection,
   paintSelectionGlyphs,
   planSelectionPaint,
+  pressOf,
   rowIdxsFromMark,
   sameRowSet,
-  selectionRuleOf
-} from "./chunk-MGAO2DR7.mjs";
+  selectionRuleOf,
+  trackPress,
+  validRowSet
+} from "./chunk-IURROJT7.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -187,7 +224,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-7JWL6LYE.mjs";
+} from "./chunk-MR6TL7QZ.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/optionsVocabulary.ts
@@ -1132,7 +1169,21 @@ function qualifyGroupHeadingFor(row, state) {
   return null;
 }
 function newQualifyRefusalGroupState() {
-  return { poorFit: false, cannotDraw: false };
+  return { poorFit: false, tooSmall: false, cannotDraw: false };
+}
+var QUALIFY_TILE_REFUSAL_CODES = Object.freeze([
+  "TILE_TOO_NARROW",
+  "TILE_TOO_SHORT",
+  "TILE_NOT_SQUARE",
+  "TILE_NOT_TALL",
+  "TILE_TOO_SMALL",
+  "EMBED_NOTHING_FITS_TILE",
+  "EMBED_BEESWARM_TILE_TOO_SMALL"
+]);
+var QUALIFY_TOO_SMALL_HEADING = "Needs a bigger tile";
+function refusalIsTileBound(row) {
+  const code = row?.reasonCode;
+  return typeof code === "string" && QUALIFY_TILE_REFUSAL_CODES.includes(code);
 }
 function refusalIsSelectable(row) {
   return !!row && row.isVeto !== true;
@@ -1140,9 +1191,23 @@ function refusalIsSelectable(row) {
 function orderRefusalsForDisplay(rows) {
   if (!Array.isArray(rows)) return [];
   const named = rows.filter((r2) => !!r2 && typeof r2.name === "string" && r2.name.trim() !== "");
-  return [...named.filter(refusalIsSelectable), ...named.filter((r2) => !refusalIsSelectable(r2))];
+  const tile = named.filter(refusalIsTileBound);
+  const rest = named.filter((r2) => !refusalIsTileBound(r2));
+  return [
+    ...rest.filter(refusalIsSelectable),
+    ...tile.filter(refusalIsSelectable),
+    ...tile.filter((r2) => !refusalIsSelectable(r2)),
+    ...rest.filter((r2) => !refusalIsSelectable(r2))
+  ];
 }
 function qualifyRefusalHeadingFor(row, state) {
+  if (refusalIsTileBound(row)) {
+    if (!state.tooSmall) {
+      state.tooSmall = true;
+      return "tooSmall";
+    }
+    return null;
+  }
   if (refusalIsSelectable(row)) {
     if (!state.poorFit) {
       state.poorFit = true;
@@ -2325,6 +2390,7 @@ export {
   CONTAINER_SLOT_ANIM_STOP,
   CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
+  CONTAINER_SLOT_PRESS_AT,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
@@ -2334,6 +2400,7 @@ export {
   DEFAULT_MODEL_SUFFIX,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
+  DRAG_NOT_CLICK_PX,
   DUPLICATE_GENERATE_WINDOW_MS,
   FILTER_MIN_HEIGHT_PX,
   FILTER_MIN_TERM_CHARS,
@@ -2356,6 +2423,22 @@ export {
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
+  LASSO_AXES_SLOT,
+  LASSO_COUNT_CLASS,
+  LASSO_DEFAULT_ACTIONS,
+  LASSO_DRAG_PX,
+  LASSO_EVENT,
+  LASSO_KNOB_KEY,
+  LASSO_MAX_VERTICES,
+  LASSO_MODE_ATTR,
+  LASSO_NOTE_CLASS,
+  LASSO_OUTLINE_CLASS,
+  LASSO_PLOT_CLASS,
+  LASSO_RESTORE_MAX_SHAPES,
+  LASSO_RESTORE_MAX_VERTICES,
+  LASSO_ROW_CAP,
+  LASSO_SAMPLE_PX,
+  LASSO_SURFACE_CLASS,
   LEGEND_MARK_CLASS,
   LEGIBLE_LIGHTNESS,
   LIFT_SELECTED_CLASS,
@@ -2391,8 +2474,11 @@ export {
   PRODUCT_FEEDBACK_MAX_CHARS,
   PRODUCT_FEEDBACK_MIN_CHARS,
   QUALIFY_REFUSAL_UNSPECIFIED,
+  QUALIFY_TILE_REFUSAL_CODES,
+  QUALIFY_TOO_SMALL_HEADING,
   RECOVERY_UNREACHABLE_MESSAGE,
   ROW_IDX_ATTR,
+  ROW_SET_MAX,
   SAME_SHADE_DELTA_E,
   SCROLL_SLACK_PX,
   SEASONAL_MARKERS_DEFAULT,
@@ -2441,7 +2527,10 @@ export {
   chartSvgOf,
   chooserFitsViewport,
   clearGeoCache,
+  clearLasso,
+  clearPress,
   clearSelectionGlyphs,
+  clickWasDrag,
   clippedTextFlag,
   codeReadsDatesInLocalTime,
   codeReadsOption,
@@ -2464,6 +2553,7 @@ export {
   decidePendingRecovery,
   defaultModelFirst,
   deltaEHex,
+  dispatchRowSet,
   encodePendingGenerate,
   ensureCrossfilterHitTargets,
   explainRenderFailure,
@@ -2478,12 +2568,14 @@ export {
   generationCancelledMessage,
   geoAssetFor,
   geoFromCache,
+  gestureWasDrag,
   glyphSampleGrid,
   hasRefusalsToShow,
   hitBandFlag,
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
+  installLasso,
   invalidSentinelReason,
   isBlankRender,
   isBlindMarker,
@@ -2498,6 +2590,9 @@ export {
   isPickableModelCode,
   isPillBackdropAlpha,
   labelBand,
+  lassoActions,
+  lassoRowCap,
+  lassoVerdict,
   latePickupAction,
   latePickupKeepsMarker,
   launchFavorStyle,
@@ -2536,7 +2631,9 @@ export {
   planFrameGrow,
   planSelectionPaint,
   planTrivialChart,
+  pointInShape,
   pollGiveUpKeepsMarker,
+  pressOf,
   productFeedbackSendable,
   qualifyAuto,
   qualifyCancel,
@@ -2562,9 +2659,11 @@ export {
   recoveryPollRunning,
   recoveryProvesNothingCharged,
   refusalIsSelectable,
+  refusalIsTileBound,
   registerCityTable,
   registerGeo,
   registerGeoAsset,
+  registerLassoAction,
   relativeLuminance,
   requiredD3Plugins,
   resolveAutoColorScale,
@@ -2594,9 +2693,11 @@ export {
   tableHostOf,
   toRGBA,
   toSourceRows,
+  trackPress,
   transportFailureShouldRecover,
   unpinScrolledAxis,
   updateRowHighWater,
+  validRowSet,
   valuePlacementFlag,
   vegaSpecReadsDatesInLocalTime,
   wireLimitCount,

package/dist/page.mjs

@@ -14,7 +14,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-XIAL6EEC.mjs";
+} from "./chunk-DTOGTKAJ.mjs";
+import "./chunk-QIRLWJBI.mjs";
+import "./chunk-IURROJT7.mjs";
+import "./chunk-MR6TL7QZ.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -13,7 +13,7 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-XIAL6EEC.mjs";
+} from "./chunk-DTOGTKAJ.mjs";
 import {
   assembleD3,
   createChartGroup,
@@ -22,11 +22,13 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-CJNONH6V.mjs";
-import "./chunk-2XWE6YFO.mjs";
-import "./chunk-MGAO2DR7.mjs";
+} from "./chunk-2HKO6GEK.mjs";
+import "./chunk-QIRLWJBI.mjs";
+import "./chunk-2ZUUIZWL.mjs";
+import "./chunk-7HKVV5T5.mjs";
+import "./chunk-IURROJT7.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-7JWL6LYE.mjs";
+import "./chunk-MR6TL7QZ.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-7JWL6LYE.mjs";
+} from "./chunk-MR6TL7QZ.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.14.0";
+export declare const HOST_CONTRACT_VERSION = "1.16.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[];
@@ -19,6 +19,18 @@ export declare const MARK_KEY_ATTR = "data-mark-key";
 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";
+/** What the event carries. `source` names who selected ("user" when a reader's gesture did); the host
+ *  passes it on to its subscribers, and "chart" stands in when it is absent. */
+export type XfilterRefreshDetail = {
+    clear: true;
+    source?: string;
+} | {
+    mark: Element;
+    source?: string;
+} | {
+    rows: readonly number[];
+    source?: string;
+};
 export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 export declare const CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 export declare const CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
@@ -109,6 +121,9 @@ export interface RenderOptions {
         rolesRefused?: string[];
     } | null;
     dateCellsAreUtcDays?: boolean;
+    dataComplete?: boolean;
+    rowsWithheld?: number;
+    rowsFilteredOut?: number;
     geoPointDest?: {
         precision: GeoPointPrecision | null;
         precisionCounts: Record<GeoPointPrecision, number>;
@@ -178,6 +193,25 @@ export interface RenderOptions {
      * take the reader's gesture with it: the helper swallows anything this raises.
      */
     onControlChange?: (e: ChartControlChange) => void;
+    /**
+     * THE HOST LASSO (contract 1.16.0): whether this chart gets the gesture that draws around marks and selects the
+     * ones inside, and what the host does when it ends. A chart never draws the gesture; it hears it as an
+     * `llm-lasso` event on its container.
+     *   capable  - the capability the SERVER sent with this chart (the chart's type declares that it has no drag
+     *              gesture of its own and that a lasso means something for it). ABSENT MEANS NOT CAPABLE: no host
+     *              holds a list of chart types, so a chart saved before the capability existed has none.
+     *   enabled  - the reader's setting; on unless it is exactly false. Both must hold for a surface to be drawn.
+     *   rowCap   - the most rows in view that still get a lasso; above it the whole lasso is off and a caption says
+     *              so. Absent is LASSO_ROW_CAP (provisional).
+     *   actions  - what the host runs on release, in order, by name. Absent is ["select"]; a name the host does
+     *              not know is skipped, so a list can be sent ahead of the build that understands it.
+     */
+    lasso?: {
+        enabled?: boolean;
+        rowCap?: number;
+        actions?: string[];
+        capable?: boolean;
+    };
 }
 /** One reader gesture on a chart's own control. */
 export interface ChartControlChange {

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, NO_ROW_MARKS_ATTR, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, 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 { 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, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, 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, type XfilterRefreshDetail, } 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, codeReadsOption, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
@@ -13,14 +13,15 @@ export type { MarkNoteLike, NoteBadgeOptions } from "./markNotes";
 export type { Controls, ControlInfo, ControlsAttachment } from "./controls";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
 export type { Filter, FilterScope, FilterOptions, FilterKey, FilterChangeReason, FilterBinding, BindFilterOptions, VegaInteractionEvent, PageView } from "./filterScope";
-export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, selectionRuleOf, markKeyOf, planSelectionPaint, nextClickedMarks, sameRowSet, type SelectionRule, type ClickedMarks, type SelectionPaintMark, type SelectionPaintMode, type SelectionPaintPlan, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
+export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, DRAG_NOT_CLICK_PX, gestureWasDrag, trackPress, pressOf, clearPress, clickWasDrag, CONTAINER_SLOT_PRESS_AT, type PressPoint, dispatchRowSet, validRowSet, ROW_SET_MAX, selectionRuleOf, markKeyOf, planSelectionPaint, nextClickedMarks, sameRowSet, type SelectionRule, type ClickedMarks, type SelectionPaintMark, type SelectionPaintMode, type SelectionPaintPlan, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
+export { installLasso, clearLasso, lassoVerdict, lassoRowCap, lassoActions, registerLassoAction, pointInShape, LASSO_ROW_CAP, LASSO_DRAG_PX, LASSO_SAMPLE_PX, LASSO_MAX_VERTICES, LASSO_RESTORE_MAX_VERTICES, LASSO_RESTORE_MAX_SHAPES, LASSO_EVENT, LASSO_SURFACE_CLASS, LASSO_OUTLINE_CLASS, LASSO_COUNT_CLASS, LASSO_NOTE_CLASS, LASSO_PLOT_CLASS, LASSO_MODE_ATTR, LASSO_KNOB_KEY, LASSO_AXES_SLOT, LASSO_DEFAULT_ACTIONS, type LassoSetting, type LassoVerdict, type LassoMode, type LassoSpace, type LassoShape, type LassoStored, type LassoEventDetail, type LassoAxes, type LassoAction, type LassoActionContext, type LassoEnv, type LassoHandle, } from "./lasso";
 export type { AdapterEvent, AdapterHit, AdapterId, AdapterScene, MarkHandle, MarkInfo, MarkRole, PaintRequest, RendererAdapter, RowTable, } from "./adapters/types";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
 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 { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, type QualifyGroupState, type QualifyGroupHeading, orderRefusalsForDisplay, refusalIsSelectable, hasRefusalsToShow, qualifyRefusalHeadingFor, newQualifyRefusalGroupState, qualifyRefusalReason, QUALIFY_REFUSAL_UNSPECIFIED, refusalIsTileBound, QUALIFY_TILE_REFUSAL_CODES, QUALIFY_TOO_SMALL_HEADING, 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, 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 { qualifyTableRows, type QualifyTableRow, type QualifyTableSource } from "./qualifyTable";

package/dist/types/lasso.d.ts

@@ -0,0 +1,143 @@
+import { type RenderOptions } from "./contract";
+/**
+ * THE MOST ROWS A CHART MAY HAVE IN VIEW AND STILL OFFER A LASSO.
+ *
+ * PROVISIONAL. Unmeasured: 5,000 is a stand-in until the time Power BI Desktop takes to apply a selection
+ * of that many ids is measured on a release-test page (1,000, 5,000 and 13,000 ids), and that number
+ * replaces this one. Do not read it as a finding. It is the worst case that is allowed for, not the
+ * typical one: a reader can lasso everything.
+ *
+ * Above it the WHOLE lasso is off: no surface is installed, and a one-line caption says why. It is one
+ * number for every host; a host may pass its own through RenderOptions.lasso.rowCap.
+ */
+export declare const LASSO_ROW_CAP = 5000;
+/** Travel, in px on either axis, at which a press stops being a click and becomes a lasso. */
+export declare const LASSO_DRAG_PX = 5;
+/** A freeform point is kept only when it is this far from the last one kept. */
+export declare const LASSO_SAMPLE_PX = 3;
+/** A freeform shape longer than this is thinned before it is used, so what is published, stored and
+ *  restored is one and the same shape. */
+export declare const LASSO_MAX_VERTICES = 400;
+/** What a restore will read, per shape and in all: a bag is untrusted, and a poisoned one must not be able
+ *  to ask for unbounded work. */
+export declare const LASSO_RESTORE_MAX_VERTICES = 2000;
+export declare const LASSO_RESTORE_MAX_SHAPES = 32;
+/** The DOM event a chart listens for on its container. detail is a LassoEventDetail. */
+export declare const LASSO_EVENT = "llm-lasso";
+export declare const LASSO_SURFACE_CLASS = "lch-lasso-surface";
+export declare const LASSO_OUTLINE_CLASS = "lch-lasso-outline";
+export declare const LASSO_COUNT_CLASS = "lch-lasso-count";
+export declare const LASSO_NOTE_CLASS = "lch-lasso-note";
+/** The group a chart draws its plot in; the surface goes over it. Without one the chart's svg is the plot. */
+export declare const LASSO_PLOT_CLASS = "lch-plot";
+/** Set on the container to switch to a rectangle ("rect"); anything else is freeform. */
+export declare const LASSO_MODE_ATTR = "data-lch-lasso-mode";
+/** The key in the shared knob bag. */
+export declare const LASSO_KNOB_KEY = "lasso";
+/** A chart registers { toData([x, y]), toScreen([dx, dy]) } here so the shape is stored in data coordinates.
+ *  x and y are in the user space of the element the surface sits in (the plot group). */
+export declare const LASSO_AXES_SLOT = "__lchLassoAxes";
+/** The action list a host runs when none is configured. */
+export declare const LASSO_DEFAULT_ACTIONS: readonly string[];
+/** RenderOptions.lasso. `capable` is the capability the server sent with this chart (absent means not
+ *  capable); `enabled` is the reader's setting (default on); both must hold. */
+export type LassoSetting = NonNullable<RenderOptions["lasso"]>;
+/** "on" installs a surface. The others say why not; only "over-cap" shows a caption. */
+export type LassoVerdict = "on" | "not-capable" | "disabled" | "over-cap";
+/** The row cap in force: the setting's when it is a positive number, else LASSO_ROW_CAP. */
+export declare function lassoRowCap(setting: LassoSetting | null | undefined): number;
+/** The action names to run on release, in order. Anything that is not a list of names is the default. */
+export declare function lassoActions(setting: LassoSetting | null | undefined): string[];
+/** Whether a chart with `rows` rows in view gets a lasso under `setting`. */
+export declare function lassoVerdict(setting: LassoSetting | null | undefined, rows: number): LassoVerdict;
+type Pt = [number, number];
+export type LassoMode = "free" | "rect";
+export type LassoSpace = "data" | "unit";
+/** One drawn shape as stored: a freeform polygon, or the four corners of a rectangle. */
+export interface LassoShape {
+    mode: LassoMode;
+    pts: Pt[];
+}
+/** What the knob bag holds under LASSO_KNOB_KEY. */
+export interface LassoStored {
+    v: 1;
+    space: LassoSpace;
+    shapes: LassoShape[];
+}
+/** detail of the `llm-lasso` DOM event. `polygon` is the last shape drawn, `polygons` every shape in the
+ *  lasso, both in `space` (data coordinates, or fractions of the plot box); `rows` is empty when the lasso
+ *  was cleared. source: "user" a gesture or a clear, "restore" a lasso re-applied on draw, "host" a clear the
+ *  host made because the selection was replaced from outside. */
+export interface LassoEventDetail {
+    rows: number[];
+    polygon: Pt[];
+    polygons: Pt[][];
+    mode: LassoMode;
+    space: LassoSpace;
+    source: "user" | "restore" | "host";
+}
+export interface LassoAxes {
+    toData(p: [number, number]): ArrayLike<unknown>;
+    toScreen(p: [number, number]): ArrayLike<unknown>;
+}
+/** Point in a shape: the bounding box rejects first; a rectangle is then done, and a freeform polygon is
+ *  an even-odd ray cast. Implemented here so the host takes no dependency on a geometry library. */
+export declare function pointInShape(shape: {
+    mode: LassoMode;
+    pts: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+}, x: number, y: number): boolean;
+/** What an action is given on release. */
+export interface LassoActionContext {
+    /** The rows inside the lasso (every shape of it), ascending. */
+    rows: number[];
+    mode: LassoMode;
+    source: "user";
+    env: LassoEnv;
+}
+export type LassoAction = (ctx: LassoActionContext) => void;
+/**
+ * Make `name` available to the action list (RenderOptions.lasso.actions). A name in the list that nothing
+ * registered is skipped, so a host can carry a list ahead of the build that understands it.
+ */
+export declare function registerLassoAction(name: string, action: LassoAction): void;
+/** What the host gives the lasso. The lasso never reaches into the host's selection itself. */
+export interface LassoEnv {
+    container: HTMLElement;
+    /** The options of the render now on screen (a function, because setOptions replaces them). */
+    options: () => RenderOptions;
+    /** How many rows the chart was handed: the number the cap is measured against. */
+    rows: number;
+    /** Publish this row set as the selection (what the "select" action does). */
+    select(rows: number[]): void;
+    /** Clear the host's selection the way an empty click does: the chart's own clear slot first when the
+     *  chart owns the selection, then a published clear. A no-op when nothing is selected. */
+    clearSelection(): void;
+}
+export interface LassoHandle {
+    /** The surface the gesture is read on; null when the lasso is off at this row count. */
+    readonly surface: Element | null;
+    /** The rows inside the lasso now drawn, ascending; empty when none. */
+    rows(): number[];
+    /** Erase the lasso. By default it also clears the host's selection and says so with `llm-lasso`. */
+    clear(opts?: {
+        publish?: boolean;
+        source?: "user" | "host";
+    }): void;
+    /** Remove the listeners and everything the lasso drew. Nothing is persisted. */
+    destroy(): void;
+}
+/**
+ * Put the lasso on the chart in `env.container`, which has just drawn. Returns null when the chart gets none
+ * (not capable, switched off, nothing to draw on); a handle for the caption when the rows exceed the cap;
+ * otherwise the live handle. A lasso already installed on the container is destroyed first.
+ */
+export declare function installLasso(env: LassoEnv): LassoHandle | null;
+/** Erase the lasso on `container`, if it has one, and clear the selection with it. */
+export declare function clearLasso(container: Element | null | undefined, opts?: {
+    publish?: boolean;
+    source?: "user" | "host";
+}): void;
+export {};

package/dist/types/qualifyGroups.d.ts

@@ -44,15 +44,66 @@ export interface QualifyRefusalRow {
     reason?: string | null;
     /** True = a required channel is ABSENT. Absent/false = a threshold we are willing to waive. */
     isVeto?: boolean | null;
+    /**
+     * WHICH GATE wrote `reason`, as the server's stable code. Absent from a server that predates
+     * the code, which reads as "not known to be about the tile": the row keeps the grouping the
+     * list always had.
+     */
+    reasonCode?: string | null;
 }
 /** Which heading to write BEFORE a refused row, if any. */
-export type QualifyRefusalHeading = "poorFit" | "cannotDraw";
+export type QualifyRefusalHeading = "poorFit" | "tooSmall" | "cannotDraw";
 /** Carried across the refusal loop. One per render. */
 export interface QualifyRefusalGroupState {
     poorFit: boolean;
+    tooSmall: boolean;
     cannotDraw: boolean;
 }
 export declare function newQualifyRefusalGroupState(): QualifyRefusalGroupState;
+/**
+ * THE REFUSAL CODES THAT MEAN "THE TILE", NOT "THE FIELDS".
+ *
+ * Each refusal carries the code of the gate that wrote its sentence. These gates compare what a
+ * chart type needs with the size and shape of the tile and nothing else:
+ *  - TILE_TOO_NARROW, TILE_TOO_SHORT, TILE_NOT_SQUARE, TILE_NOT_TALL: too narrow, too short, not
+ *    square enough, not tall enough.
+ *  - TILE_TOO_SMALL: a type that does not hold up on a small tile, turned down because the tile is
+ *    under the size the full catalogue needs, whatever the data is.
+ *  - EMBED_NOTHING_FITS_TILE: a headline-plus-small-drawing type whose drawing has no form that
+ *    fits the tile; the headline alone is still drawable on a plain card.
+ *  - EMBED_BEESWARM_TILE_TOO_SMALL: a beeswarm turned down because the tile is under the size it
+ *    needs.
+ * The data can be exactly right and the type is still turned down, and the one thing that changes
+ * the answer is a bigger tile.
+ *
+ * Without this split those rows sat under "Can't be drawn from the fields as bound" or "Poor fit
+ * for these fields" - headings that send the reader to rebind data that is fine.
+ *
+ * ONLY GATES THAT LOOK AT THE TILE ALONE ARE LISTED. A gate that weighs the tile against the data
+ * (ROWS_CRAMPED, a row-per-category floor; TOO_MANY_PANELS, a panel budget; CATEGORIES_TOO_WIDE)
+ * can be answered by either, so naming it a tile problem would be the same false instruction
+ * turned around. A code is added here when the server starts sending one that is purely about the
+ * tile; an unknown code keeps the grouping it had.
+ */
+export declare const QUALIFY_TILE_REFUSAL_CODES: readonly string[];
+/**
+ * THE HEADING OVER THE TILE BLOCK, in the one place every host reads it from, so the wording
+ * cannot drift between them and a test pins it once.
+ *
+ * It says what the reader can do about it, not what category the row is in, and it says nothing
+ * about the fields: the rows under it are exactly the ones the fields are not the problem for.
+ * English source text - a host that localizes looks it up like its other headings.
+ */
+export declare const QUALIFY_TOO_SMALL_HEADING = "Needs a bigger tile";
+/**
+ * IS THIS REFUSAL ABOUT THE TILE'S SIZE OR SHAPE? Decided from the server's code, never from the
+ * sentence: a host that matched the English would go blind the day the sentences are translated,
+ * and would re-derive a verdict it was already handed.
+ *
+ * A row with no code (an older server) is NOT tile-bound. That is the safe direction: it keeps
+ * the two-heading grouping the list had before the code existed.
+ */
+export declare function refusalIsTileBound(row: QualifyRefusalRow | null | undefined): boolean;
 /**
  * MAY THE READER PICK THIS ONE? The single place that answers it, in either host.
  *
@@ -63,15 +114,22 @@ export declare function newQualifyRefusalGroupState(): QualifyRefusalGroupState;
  */
 export declare function refusalIsSelectable(row: QualifyRefusalRow | null | undefined): boolean;
 /**
- * The refused rows in RENDER ORDER: everything pickable first, then the vetoes.
+ * The refused rows in RENDER ORDER: the pickable ones first, then the ones the tile alone turned
+ * down, then the vetoes the fields cause.
  *
  * 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.
+ * The 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.
+ *
+ * THE TILE BLOCK SITS BETWEEN THE TWO, and its own rows are pickable-first too. A tile refusal is
+ * a veto or a waivable one like any other (the reader may still pick the waivable ones), but what
+ * it asks of the reader is different: resize, not rebind. Every row the code marks as about the
+ * tile goes there whichever way its veto flag points, so none is left under a heading that names
+ * the fields.
  */
 export declare function orderRefusalsForDisplay<T extends QualifyRefusalRow>(rows: readonly T[] | null | undefined): T[];
 /**