@bicharts/chart-host 0.6.82 → 0.6.84

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-7HPVGRQ2.mjs";
+} from "./chunk-GG4U66E4.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -111,31 +111,68 @@ import {
   toSourceRows,
   unpinScrolledAxis,
   valuePlacementFlag
-} from "./chunk-MP5S6MVW.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-ZRSEKV4I.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;
@@ -2073,6 +2138,11 @@ function markerArmedBlind(m2) {
   if (!m2) return false;
   return (m2.h ?? m2.v - 1) <= 0;
 }
+function markerArmedAtMs(m2) {
+  if (!m2) return void 0;
+  const t2 = Math.floor(m2.t);
+  return Number.isFinite(t2) && t2 > 0 ? t2 : void 0;
+}
 function isBlindMarker(m2) {
   if (!m2) return false;
   return typeof m2.c !== "string" || m2.c.trim() === "";
@@ -2131,10 +2201,11 @@ function recoveryFinalOutcome(r2) {
   if (!r2) return null;
   const o3 = String(r2.pollOutcome ?? "").trim().toLowerCase();
   if (r2.isGenerationCancelled === true || r2.isPollFinal === true && o3 === "cancelled") return "cancelled";
-  if (r2.isPollFinal === true) return o3 === "not-received" ? "not-received" : "failed";
+  if (r2.isPollFinal === true) return o3 === "not-received" ? "not-received" : o3 === "lost-in-restart" ? "lost-in-restart" : "failed";
   if (r2.isPollFinal == null && r2.isVersionNotFound === true) {
     const c2 = String(r2.errorCode ?? "").trim().toUpperCase();
     if (c2 === "GENERATION_NOT_RECEIVED") return "not-received";
+    if (c2 === "GENERATION_LOST_IN_RESTART") return "lost-in-restart";
     if (c2 === "GENERATION_FAILED") return "failed";
     if (c2 === "GENERATION_CANCELLED") return "cancelled";
   }
@@ -2152,11 +2223,12 @@ function recoveryLooksUnreachable(transportFailuresInARow, everAnswered) {
 }
 var GENERATION_NOT_RECEIVED_MESSAGE = "The charting service has no record of that request, so nothing was generated and nothing was charged. Generate again.";
 var GENERATION_FAILED_MESSAGE = "That chart didn't finish on the server, so there's nothing to show. Generate again.";
+var GENERATION_LOST_IN_RESTART_MESSAGE = "The charting service restarted while your chart was being built, so nothing was delivered. Click Generate to build it again.";
 var RECOVERY_UNREACHABLE_MESSAGE = "We couldn't reach the charting service to check on your chart - it may be offline, or blocked on this network. Try again in a moment.";
 function recoveryFinalMessage(o3, serverMessage) {
   const s2 = String(serverMessage ?? "").trim();
   if (s2 !== "") return s2;
-  return o3 === "cancelled" ? GENERATION_CANCELLED_MESSAGE : o3 === "not-received" ? GENERATION_NOT_RECEIVED_MESSAGE : GENERATION_FAILED_MESSAGE;
+  return o3 === "cancelled" ? GENERATION_CANCELLED_MESSAGE : o3 === "not-received" ? GENERATION_NOT_RECEIVED_MESSAGE : o3 === "lost-in-restart" ? GENERATION_LOST_IN_RESTART_MESSAGE : GENERATION_FAILED_MESSAGE;
 }
 
 // src/chartPick.ts
@@ -2318,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,
@@ -2327,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,
@@ -2339,6 +2413,7 @@ export {
   FLIP_MODE_DEFAULT,
   GENERATION_CANCELLED_MESSAGE,
   GENERATION_FAILED_MESSAGE,
+  GENERATION_LOST_IN_RESTART_MESSAGE,
   GENERATION_NOT_RECEIVED_MESSAGE,
   GEO_POINT_PRECISIONS,
   GLYPH_SAMPLE_N,
@@ -2348,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,
@@ -2383,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,
@@ -2433,7 +2527,10 @@ export {
   chartSvgOf,
   chooserFitsViewport,
   clearGeoCache,
+  clearLasso,
+  clearPress,
   clearSelectionGlyphs,
+  clickWasDrag,
   clippedTextFlag,
   codeReadsDatesInLocalTime,
   codeReadsOption,
@@ -2456,6 +2553,7 @@ export {
   decidePendingRecovery,
   defaultModelFirst,
   deltaEHex,
+  dispatchRowSet,
   encodePendingGenerate,
   ensureCrossfilterHitTargets,
   explainRenderFailure,
@@ -2470,12 +2568,14 @@ export {
   generationCancelledMessage,
   geoAssetFor,
   geoFromCache,
+  gestureWasDrag,
   glyphSampleGrid,
   hasRefusalsToShow,
   hitBandFlag,
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
+  installLasso,
   invalidSentinelReason,
   isBlankRender,
   isBlindMarker,
@@ -2490,6 +2590,9 @@ export {
   isPickableModelCode,
   isPillBackdropAlpha,
   labelBand,
+  lassoActions,
+  lassoRowCap,
+  lassoVerdict,
   latePickupAction,
   latePickupKeepsMarker,
   launchFavorStyle,
@@ -2498,6 +2601,7 @@ export {
   loadGeo,
   markDefaultModel,
   markKeyOf,
+  markerArmedAtMs,
   markerArmedBlind,
   measureContainerBoxes,
   minContrastOver,
@@ -2527,7 +2631,9 @@ export {
   planFrameGrow,
   planSelectionPaint,
   planTrivialChart,
+  pointInShape,
   pollGiveUpKeepsMarker,
+  pressOf,
   productFeedbackSendable,
   qualifyAuto,
   qualifyCancel,
@@ -2553,9 +2659,11 @@ export {
   recoveryPollRunning,
   recoveryProvesNothingCharged,
   refusalIsSelectable,
+  refusalIsTileBound,
   registerCityTable,
   registerGeo,
   registerGeoAsset,
+  registerLassoAction,
   relativeLuminance,
   requiredD3Plugins,
   resolveAutoColorScale,
@@ -2585,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-MP5S6MVW.mjs";
-import "./chunk-ZRSEKV4I.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";
@@ -44,7 +45,7 @@ export { pinScrolledAxis, unpinScrolledAxis, type AxisPinReport } from "./fitDom
 export { MIN_DELTA_E, pickDistinctColorFromSeed, buildPalette, buildPaletteFromSeed, orderMostDistinct, LEGIBLE_LIGHTNESS, type PaletteResult, type SeedForSlot, type PaletteOptions, } from "./palette";
 export { deltaEHex } from "./deltaE";
 export { resolveAutoColorScale, autoRampMinStep, autoRampCanvas, AUTO_RAMP_CLASSES, AUTO_RAMP_DRAWN_OPACITY, AUTO_RAMP_MIN_STEP_DELTA_E, type AutoColorScale, type AutoColorScaleInput } from "./autoRamp";
-export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_FIRST_POLL_MS, PENDING_RECOVERY_FAST_PHASE_MS, PENDING_RECOVERY_MID_POLL_MS, PENDING_RECOVERY_SLOW_PHASE_MS, PENDING_RECOVERY_SLOW_POLL_MS, pendingRecoveryNextDelayMs, encodePendingGenerate, parsePendingGenerate, markerArmedBlind, isBlindMarker, servedCorrelationProves, sameMarker, decidePendingRecovery, recoveryPollRunning, recoveryOwnsTheSentence, latePickupAction, latePickupKeepsMarker, pollGiveUpKeepsMarker, pendingRecoveryRemainingMs, transportFailureShouldRecover, TRANSPORT_LOST_CHECKING_MESSAGE, GENERATION_CANCELLED_MESSAGE, recoveryAnswerIsCancelled, generationCancelledMessage, recoveryFinalOutcome, recoveryProvesNothingCharged, recoveryGiveUpRefunds, recoveryLooksUnreachable, recoveryFinalMessage, PENDING_RECOVERY_UNREACHABLE_POLLS, GENERATION_NOT_RECEIVED_MESSAGE, GENERATION_FAILED_MESSAGE, RECOVERY_UNREACHABLE_MESSAGE, type PendingGenerateMarker, type PendingRecoveryDecision, type LatePickupAction, type RecoveryFinalOutcome, } from "./pendingGenerate";
+export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_FIRST_POLL_MS, PENDING_RECOVERY_FAST_PHASE_MS, PENDING_RECOVERY_MID_POLL_MS, PENDING_RECOVERY_SLOW_PHASE_MS, PENDING_RECOVERY_SLOW_POLL_MS, pendingRecoveryNextDelayMs, encodePendingGenerate, parsePendingGenerate, markerArmedBlind, markerArmedAtMs, isBlindMarker, servedCorrelationProves, sameMarker, decidePendingRecovery, recoveryPollRunning, recoveryOwnsTheSentence, latePickupAction, latePickupKeepsMarker, pollGiveUpKeepsMarker, pendingRecoveryRemainingMs, transportFailureShouldRecover, TRANSPORT_LOST_CHECKING_MESSAGE, GENERATION_CANCELLED_MESSAGE, recoveryAnswerIsCancelled, generationCancelledMessage, recoveryFinalOutcome, recoveryProvesNothingCharged, recoveryGiveUpRefunds, recoveryLooksUnreachable, recoveryFinalMessage, PENDING_RECOVERY_UNREACHABLE_POLLS, GENERATION_NOT_RECEIVED_MESSAGE, GENERATION_FAILED_MESSAGE, GENERATION_LOST_IN_RESTART_MESSAGE, RECOVERY_UNREACHABLE_MESSAGE, type PendingGenerateMarker, type PendingRecoveryDecision, type LatePickupAction, type RecoveryFinalOutcome, } from "./pendingGenerate";
 export { stripJsComments } from "./codeComments";
 export { reconcileChartPick, type ChartPickReconciliation } from "./chartPick";
 export { isDuplicateGenerate, armGenerateGuard, DUPLICATE_GENERATE_WINDOW_MS, type GenerateGuardKey, type GenerateGuardState, } from "./duplicateGenerateGuard";

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/pendingGenerate.d.ts

@@ -55,6 +55,17 @@ export type PendingRecoveryDecision = "none" | "delivered" | "expired" | "blind"
  * `v - 1` fallback says the same thing for markers written by older builds.
  */
 export declare function markerArmedBlind(m: PendingGenerateMarker | null | undefined): boolean;
+/**
+ * WHEN THIS MARKER'S GENERATE STARTED, as a recovery poll states it: the marker's own `t`, epoch milliseconds on
+ * this host's clock, as a whole number - the `fetchArmedAtMs` a poll by correlation passes to `fetchFields`.
+ *
+ * With it the server can tell a generate that died with a server restart (started before the running process,
+ * no record of it) from one still running, and say so at the first poll instead of after the whole window.
+ * Nothing is shifted or checked against the clock here: a slow or fast host clock is the server's margin to
+ * absorb, and a future time it reads as absent. undefined for no marker or a time that is not a positive
+ * number, so the poll sends exactly what it always sent.
+ */
+export declare function markerArmedAtMs(m: PendingGenerateMarker | null | undefined): number | undefined;
 /**
  * Can this marker be recovered AT ALL? Only by CORRELATION, so only if it carries one.
  *
@@ -198,7 +209,7 @@ export declare function generationCancelledMessage(serverMessage: string | null
  * beside it for older hosts, so this is read FIRST. null = not final. A final answer with an outcome
  * this build does not know reads as "failed": it is final, and it claims nothing about charges.
  */
-export type RecoveryFinalOutcome = "cancelled" | "failed" | "not-received";
+export type RecoveryFinalOutcome = "cancelled" | "failed" | "not-received" | "lost-in-restart";
 export declare function recoveryFinalOutcome(r: {
     isPollFinal?: boolean | null;
     pollOutcome?: string | null;
@@ -207,7 +218,8 @@ export declare function recoveryFinalOutcome(r: {
     errorCode?: string | null;
 } | null | undefined): RecoveryFinalOutcome | null;
 /** Did the server PROVE nothing was charged? Only a cancel and a request it never received do; a
- *  failed generation's charge is its own, and a host claims nothing about it. */
+ *  failed generation's charge is its own, and a generate that died with a restart may have been charged
+ *  before its record was written, so a host claims nothing about either. */
 export declare function recoveryProvesNothingCharged(o: string | null | undefined): boolean;
 /** Does a recovery that ended this way send the refund? Only when it ended with NOTHING PAINTED and
  *  nothing proven - the window closed, the poll itself was refused, or the service could not be
@@ -222,6 +234,10 @@ export declare function recoveryLooksUnreachable(transportFailuresInARow: number
  *  localises by code. */
 export declare const GENERATION_NOT_RECEIVED_MESSAGE = "The charting service has no record of that request, so nothing was generated and nothing was charged. Generate again.";
 export declare const GENERATION_FAILED_MESSAGE = "That chart didn't finish on the server, so there's nothing to show. Generate again.";
+/** The process that was building the chart is gone, so nothing will arrive. Says what happened and what to
+ *  do, and claims nothing about a charge: a free-tier meter can be charged before the generation's record
+ *  exists, so a restart in between can leave a charge that no record shows. */
+export declare const GENERATION_LOST_IN_RESTART_MESSAGE = "The charting service restarted while your chart was being built, so nothing was delivered. Click Generate to build it again.";
 /** Neither the generate's answer nor any check reached us. Claims nothing about a charge: behind a
  *  proxy the generate may have arrived when the checks did not. */
 export declare const RECOVERY_UNREACHABLE_MESSAGE = "We couldn't reach the charting service to check on your chart - it may be offline, or blocked on this network. Try again in a moment.";