@bicharts/chart-host 0.6.95 → 0.6.97

package/dist/types/index.d.ts

@@ -14,7 +14,7 @@ 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, 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 { installLasso, clearLasso, lassoVerdict, lassoRowCap, lassoActions, lassoEffect, 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, LASSO_DEFAULT_EFFECT, type LassoSetting, type LassoVerdict, type LassoEffect, 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";

package/dist/types/lasso.d.ts

@@ -49,6 +49,12 @@ export type LassoVerdict = "on" | "not-capable" | "disabled" | "over-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[];
+/** What circling a group does to the page: "filter" publishes it as the selection, "highlight" only lights it. */
+export type LassoEffect = "filter" | "highlight";
+/** The effect when the setting names none. */
+export declare const LASSO_DEFAULT_EFFECT: LassoEffect;
+/** The effect in force: "highlight" only when the setting says exactly that, else LASSO_DEFAULT_EFFECT. */
+export declare function lassoEffect(setting: LassoSetting | null | undefined): LassoEffect;
 /** 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];
@@ -104,6 +110,16 @@ export type LassoAction = (ctx: LassoActionContext) => void;
  * 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;
+/**
+ * A NEW HOST ON A CONTAINER claims the bag's lasso for its chart. The bag outlives every host on the element, so a lasso
+ * parked by another chart (a new `code` on the same element, a destroy and create) would be re-drawn on this one and then
+ * persisted with the next slider's write under this chart's state. A different chart, or a parked lasso with no record of
+ * whose it is, starts without it; the same chart built again (a host rebuilt for its config) keeps it. Only the lasso
+ * goes: a slider's value in the bag is meant to outlive a new chart. `sessionState` is the host's own session view-state
+ * on the same element (never a caller's provider, which keys its own state): its `knobs.lasso` is the same parked copy.
+ * Returns whether a parked lasso was dropped.
+ */
+export declare function claimParkedLasso(container: Element | null | undefined, chartKey: unknown, sessionState?: Record<string, unknown> | null): boolean;
 /** What the host gives the lasso. The lasso never reaches into the host's selection itself. */
 export interface LassoEnv {
     container: HTMLElement;
@@ -111,7 +127,8 @@ export interface LassoEnv {
     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). */
+    /** Make this row set the selection (what the "select" action does). The host decides, from the setting's
+     *  effect, whether it is published to the page or only lit inside the chart. */
     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. */

package/dist/types/payload.d.ts

@@ -70,6 +70,10 @@ export interface RenderPayload {
     /** Which columns the re-anchoring actually moved (diagnostics; empty when every date was already
      *  UTC midnight). Present only alongside dateCellsAreUtcDays. */
     utcDayColumns?: string[];
+    /** The host re-anchored timed date cells to the UTC wall clock (opts.localWallClock). Present only when it was requested. */
+    dateCellsAreUtcWallClock?: boolean;
+    /** Which columns that moved (diagnostics). Present only alongside dateCellsAreUtcWallClock. */
+    utcWallClockColumns?: string[];
 }
 export declare function buildRenderPayload(cols: Array<{
     name: string;
@@ -78,6 +82,7 @@ export declare function buildRenderPayload(cols: Array<{
     kind: string;
 } | null, point?: GeoPointBinding | null, destination?: GeoPointBinding | null, opts?: {
     utcDays?: boolean;
+    localWallClock?: boolean;
     aliases?: ReadonlyArray<{
         name: string;
         alias: string;

package/dist/zoom-memory.mjs

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
-  B
-} from "./chunk-NQFJHNMC.mjs";
+  K
+} from "./chunk-KFU44UEN.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/zoomMemory/zoomMemory.ts
@@ -262,7 +262,7 @@ function forgetZoom(host) {
 }
 function createZoomMemoryHook(host) {
   const hook = {
-    keyFor: (code, width, height) => zoomStateKey(B(String(code ?? "")), width, height),
+    keyFor: (code, width, height) => zoomStateKey(K(String(code ?? "")), width, height),
     capture: (d3) => captureZoomBehaviors(d3, host),
     restore: (container, capture, key, d3) => {
       const mine = adoptedContainers.get(host);

package/package.json

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