@spectrum-charts/vega-spec-builder-s2 0.3.1 → 0.4.0

package/dist/@types/src/area/areaSpecBuilder.d.ts

@@ -7,7 +7,7 @@ export declare const addArea: (state: ScSpec, args_0: AreaOptions & {
     idKey: string;
 }) => ScSpec;
 export declare const addData: (state: Data[], args_0: AreaSpecOptions) => Data[];
-export declare const getAreaHighlightedData: (name: string, idKey: string, hasTooltip: boolean, hasPopover: boolean, hasGroupId: boolean) => SourceData;
+export declare const getAreaHighlightedData: (name: string, idKey: string, hasInspect: boolean, hasPopover: boolean, hasGroupId: boolean) => SourceData;
 export declare const addSignals: (state: Signal[], args_0: AreaSpecOptions) => Signal[];
 /**
  * Adds an on event that clears the controlled highlighted item signal value when the user mouses over the area.

package/dist/@types/src/area/areaUtils.d.ts

@@ -1,5 +1,5 @@
 import { AreaMark, NumericValueRef, ProductionRule } from 'vega';
-import { ChartPopoverOptions, ChartTooltipOptions, ColorFacet, ColorScheme, HighlightedItem, ScaleType } from '../types';
+import { ChartPopoverOptions, ChartInspectOptions, ColorFacet, ColorScheme, HighlightedItem, ScaleType } from '../types';
 export interface AreaMarkOptions {
     color: ColorFacet;
     colorScheme: ColorScheme;
@@ -17,7 +17,7 @@ export interface AreaMarkOptions {
     parentName?: string;
     scaleType: ScaleType;
     chartPopovers?: ChartPopoverOptions[];
-    chartTooltips?: ChartTooltipOptions[];
+    chartInspects?: ChartInspectOptions[];
 }
 export declare const getAreaMark: (areaOptions: AreaMarkOptions, dataSource?: string) => AreaMark;
 export declare function getAreaOpacity(areaOptions: AreaMarkOptions): ProductionRule<NumericValueRef> | undefined;

package/dist/@types/src/axis/axisLabelHoverUtils.d.ts

@@ -0,0 +1,22 @@
+import { NumericValueRef, ProductionRule, Signal } from 'vega';
+import { InteractiveMark } from '../types';
+type MatchedInteractiveMark = Required<InteractiveMark>;
+/**
+ * Vega mark name stamped onto an axis's primary label encode block - shared by hover and click
+ * wiring since Vega only allows one `encode.labels.name` per axis.
+ */
+export declare const getAxisLabelMarkName: (axisName: string) => string;
+/** Filters `usermeta.interactiveMarks` to entries matching this axis's dimension field. */
+export declare const getMatchingInteractiveBarDimensionFields: (scaleField: string | undefined, interactiveMarks?: InteractiveMark[]) => MatchedInteractiveMark[];
+/**
+ * Appends mouseover/mouseout handlers onto each matching bar's existing dimension-hover-area signal.
+ * Never creates the signal itself, so this is a no-op for non-interactive bars.
+ */
+export declare const addAxisLabelHoverSignalWiring: (signals: Signal[], matchingBars: MatchedInteractiveMark[], axisLabelMarkName: string) => Signal[];
+/**
+ * Fade rule for axis labels, keyed on the same dimension-hover-area signal(s) the bars fade on.
+ * Intentionally ignores item-level bar hover - a single hovered segment isn't "this category is hovered."
+ */
+export declare const getAxisLabelDimensionFillOpacity: (matchingBars: MatchedInteractiveMark[]) => ProductionRule<NumericValueRef>;
+export {};
+//# sourceMappingURL=axisLabelHoverUtils.d.ts.map

package/dist/@types/src/axis/axisLabelHoverUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisLabelHoverUtils.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisLabelHoverUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI/D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,sBAAsB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAAc,MAAM,KAAG,MAAkC,CAAC;AAE3F,2FAA2F;AAC3F,eAAO,MAAM,wCAAwC,eACvC,MAAM,GAAG,SAAS,qBACZ,eAAe,EAAE,KAClC,sBAAsB,EAKxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,YAC/B,MAAM,EAAE,gBACH,sBAAsB,EAAE,qBACnB,MAAM,KACxB,MAAM,EAiBR,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,iBAC7B,sBAAsB,EAAE,KACrC,eAAe,eAAe,CAUhC,CAAC"}

package/dist/@types/src/axis/axisLabelHoverUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=axisLabelHoverUtils.test.d.ts.map

package/dist/@types/src/axis/axisLabelHoverUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisLabelHoverUtils.test.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisLabelHoverUtils.test.ts"],"names":[],"mappings":""}

package/dist/@types/src/axis/axisReferenceLineUtils.d.ts

@@ -8,20 +8,24 @@ export declare const scaleTypeSupportsReferenceLines: (scaleType: ScaleType | un
 export declare const getReferenceLineMarks: (axisOptions: AxisSpecOptions, scaleName: string) => Mark[];
 export declare const getPositionEncoding: ({ scaleType }: AxisSpecOptions, { value, position }: ReferenceLineSpecOptions, scaleName: string) => ProductionRule<NumericValueRef> | SignalRef;
 /**
- * Horizontal rule line — spans from x: 5 to x2: width - 5 (aligned with caps).
+ * Horizontal rule line — spans from caret tip to the right cap, with x-start adapting to caret size.
+ * In auto mode (no explicit size) both stroke width and x-start react to chart width via signals.
  */
-export declare const getReferenceLineRuleMark: ({ colorScheme }: AxisSpecOptions, { name }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => RuleMark;
+export declare const getReferenceLineRuleMark: ({ colorScheme }: AxisSpecOptions, { name, secondary, size }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => RuleMark;
 /**
- * Left-pointing arrow cap at the left edge of the chart area.
+ * Left-pointing arrow caps at the left edge of the chart area.
+ * Explicit size: one mark with the size-specific path.
+ * Auto mode: three marks (S/M/L) with reactive opacity, so the caret tier matches the chart width.
  */
-export declare const getReferenceLineStartCapMark: (_axisOptions: AxisSpecOptions, { colorScheme, name }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => PathMark;
+export declare const getReferenceLineStartCapMark: (_axisOptions: AxisSpecOptions, { colorScheme, name, secondary, size }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => PathMark[];
 /**
- * Right-pointing arrow cap at the right edge of the chart area.
+ * Right-pointing arrow caps at the right edge of the chart area.
+ * Explicit size: one mark. Auto mode: three marks (S/M/L) with reactive opacity.
  */
-export declare const getReferenceLineEndCapMark: (_axisOptions: AxisSpecOptions, { colorScheme, name }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => PathMark;
+export declare const getReferenceLineEndCapMark: (_axisOptions: AxisSpecOptions, { colorScheme, name, secondary, size }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => PathMark[];
 /**
  * Two text marks: background halo then foreground.
  * Label is below the line, right-aligned, with S2 typography.
  */
-export declare const getReferenceLineTextMark: ({ colorScheme, label, name }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => TextMark[];
+export declare const getReferenceLineTextMark: ({ colorScheme, label, name, secondary, size }: ReferenceLineSpecOptions, positionEncoding: ProductionRule<NumericValueRef> | SignalRef) => TextMark[];
 //# sourceMappingURL=axisReferenceLineUtils.d.ts.map

package/dist/@types/src/axis/axisReferenceLineUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axisReferenceLineUtils.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisReferenceLineUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAajH,OAAO,EAAE,eAAe,EAAwB,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG3F,eAAO,MAAM,iBAAiB,gBAAiB,eAAe,KAAG,wBAAwB,EAIxF,CAAC;AAYF,eAAO,MAAM,+BAA+B,cAAe,SAAS,GAAG,SAAS,KAAG,OAGlF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,gBACnB,eAAe,aACjB,MAAM,KAChB,IAAI,EAgBN,CAAC;AAEF,eAAO,MAAM,mBAAmB,kBACf,eAAe,uBACT,wBAAwB,aAClC,MAAM,KAChB,eAAe,eAAe,CAAC,GAAG,SAYpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,oBAClB,eAAe,YACtB,wBAAwB,oBAChB,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAmBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,iBACzB,eAAe,yBACN,wBAAwB,oBAC7B,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAcC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,0BAA0B,iBACvB,eAAe,yBACN,wBAAwB,oBAC7B,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAcC,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,wBAAwB,iCACL,wBAAwB,oBACpC,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAAQ,EA4CV,CAAC"}
+{"version":3,"file":"axisReferenceLineUtils.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisReferenceLineUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAyBjH,OAAO,EAAE,eAAe,EAAqC,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGxG,eAAO,MAAM,iBAAiB,gBAAiB,eAAe,KAAG,wBAAwB,EAIxF,CAAC;AAYF,eAAO,MAAM,+BAA+B,cAAe,SAAS,GAAG,SAAS,KAAG,OAGlF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,gBACnB,eAAe,aACjB,MAAM,KAChB,IAAI,EAgBN,CAAC;AAEF,eAAO,MAAM,mBAAmB,kBACf,eAAe,uBACT,wBAAwB,aAClC,MAAM,KAChB,eAAe,eAAe,CAAC,GAAG,SAYpC,CAAC;AAmBF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,oBAClB,eAAe,6BACL,wBAAwB,oBACjC,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QA+BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iBACzB,eAAe,0CACW,wBAAwB,oBAC9C,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAAQ,EA6BV,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,iBACvB,eAAe,0CACW,wBAAwB,oBAC9C,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAAQ,EAgCV,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kDACY,wBAAwB,oBACrD,eAAe,eAAe,CAAC,GAAG,SAAS,KAC5D,QAAQ,EA6CV,CAAC"}

package/dist/@types/src/axis/axisSpecBuilder.d.ts

@@ -53,6 +53,7 @@ export interface AxisAddOptions extends AxisSpecOptions {
  */
 export declare const addAxes: (state: Axis[], args_0: AxisSpecOptions & {
     scaleName: string;
+    scaleField?: string | undefined;
     opposingScaleType?: string | undefined;
     dualMetricAxis?: boolean | undefined;
     usermeta: UserMeta;

package/dist/@types/src/axis/axisSpecBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axisSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisSpecBuilder.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAc,IAAI,EAAa,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA2BlF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAsBrH,eAAO,MAAM,OAAO;;;YAwGnB,CAAC;AAEF,eAAO,MAAM,WAAW;eAAmD,SAAS;YAKlF,CAAC;AAEH,eAAO,MAAM,cAAc,wEAyBzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,WACtB,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,YACzB,QAAQ,oBACA,WAAW;;;;;;gBAaX,CAAC;AAErB;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,IAAI,CAgC9F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,WAAkC,GAC9C,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,mBAAmB,EAAE,OAAO,EAC5B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,WAAkC,QAYhD;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;eAIH,MAAM;;;cAGP,QAAQ;YAwHtB,CAAC;AAyCH,eAAO,MAAM,YAAY;eAIR,MAAM;;;;;cAKP,QAAQ;YA8BtB,CAAC;AA2DH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAGlE"}
+{"version":3,"file":"axisSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisSpecBuilder.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAc,IAAI,EAAa,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA4BlF,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EAEX,KAAK,EACL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,QAAQ,EACT,MAAM,UAAU,CAAC;AA4BlB,eAAO,MAAM,OAAO;;;YAuHnB,CAAC;AAkBF,eAAO,MAAM,WAAW;eAAmD,SAAS;YAKlF,CAAC;AAEH,eAAO,MAAM,cAAc,wEAyBzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,WACtB,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,YACzB,QAAQ,oBACA,WAAW;;;;;;gBAaX,CAAC;AAErB;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,IAAI,CAgC9F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,WAAkC,GAC9C,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,mBAAmB,EAAE,OAAO,EAC5B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,GAAE,WAAkC,QAYhD;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;eAIH,MAAM;;;;cAIP,QAAQ;YA6BtB,CAAC;AAqKH,eAAO,MAAM,YAAY;eAIR,MAAM;;;;;cAKP,QAAQ;YA+BtB,CAAC;AA+DH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAGlE"}

package/dist/@types/src/axis/axisTestUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axisTestUtils.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisTestUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,oBAAoB,EAAE,IAYlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,IAYlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAqBhC,CAAC"}
+{"version":3,"file":"axisTestUtils.d.ts","sourceRoot":"","sources":["../../../../src/axis/axisTestUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,oBAAoB,EAAE,IAYlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,IAYlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAsBhC,CAAC"}

package/dist/@types/src/axisAnnotation/axisAnnotationUtils.d.ts

@@ -52,6 +52,6 @@ export declare const addAxisAnnotationAxis: (axes: Axis[], { offset }: AxisAnnot
 export declare const getAxisAnnotationsFromChildren: ({ axisAnnotations, colorScheme, name: axisName, position, scaleType, }: AxisSpecOptions & {
     scaleType: ScaleType;
 }) => AxisAnnotationSpecOptions[];
-export declare const applyDefaultAxisAnnotationOptions: ({ chartPopovers, chartTooltips, name, format, offset, color, dataKey, options, }: AxisAnnotationOptions, annotationIndex: number, axisName: string, colorScheme: ColorScheme, scaleType: ScaleType) => AxisAnnotationSpecOptions;
+export declare const applyDefaultAxisAnnotationOptions: ({ chartPopovers, chartInspects, name, format, offset, color, dataKey, options, }: AxisAnnotationOptions, annotationIndex: number, axisName: string, colorScheme: ColorScheme, scaleType: ScaleType) => AxisAnnotationSpecOptions;
 export declare const axisTypeSupportsAxisAnnotations: (position: Position | undefined) => boolean;
 //# sourceMappingURL=axisAnnotationUtils.d.ts.map

package/dist/@types/src/bar/barSpecBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/bar/barSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAa,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA+C5F,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAc5F,eAAO,MAAM,MAAM;;;;WAON,MAAM;;YAgFlB,CAAC;AAEF,eAAO,MAAM,UAAU,uDA4BrB,CAAC;AAEH,eAAO,MAAM,OAAO,mDA8BlB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,YAAa,cAAc,KAAG,IAe/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,YAAa,cAAc,KAAG,gBAQ7D,CAAC;AAYF,eAAO,MAAM,2BAA2B,YAAa,cAAc,KAAG,IAYrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,6CAA8C,cAAc,KAAG,gBAOjG,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU,IAAI,EAAE,WAAW,cAAc,SAoB1E,CAAC;AAEF,eAAO,MAAM,SAAS,qDAsBpB,CAAC;AAEH,eAAO,MAAM,iBAAiB,WACpB,KAAK,EAAE,2EAC0D,cAAc,SAQxF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WAAY,KAAK,EAAE,WAAW,cAAc,SAgC1E,CAAC;AAEF,eAAO,MAAM,QAAQ,mDA6BnB,CAAC;AAEH,eAAO,MAAM,gBAAgB,YAAa,cAAc,KAAG,KAU1D,CAAC"}
+{"version":3,"file":"barSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/bar/barSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAa,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA2C5F,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAc5F,eAAO,MAAM,MAAM;;;;WAON,MAAM;;YAqFlB,CAAC;AAEF,eAAO,MAAM,UAAU,uDA6BrB,CAAC;AAEH,eAAO,MAAM,OAAO,mDA8BlB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,YAAa,cAAc,KAAG,IAe/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,YAAa,cAAc,KAAG,gBAQ7D,CAAC;AAYF,eAAO,MAAM,2BAA2B,YAAa,cAAc,KAAG,IAYrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,6CAA8C,cAAc,KAAG,gBAOjG,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU,IAAI,EAAE,WAAW,cAAc,SAoB1E,CAAC;AAEF,eAAO,MAAM,SAAS,qDAsBpB,CAAC;AAEH,eAAO,MAAM,iBAAiB,WACpB,KAAK,EAAE,2EAC0D,cAAc,SAQxF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WAAY,KAAK,EAAE,WAAW,cAAc,SAgC1E,CAAC;AAEF,eAAO,MAAM,QAAQ,mDA6BnB,CAAC;AAEH,eAAO,MAAM,gBAAgB,YAAa,cAAc,KAAG,KAU1D,CAAC"}

package/dist/@types/src/bar/barUtils.d.ts

@@ -29,6 +29,29 @@ export declare const getBarFillEncoding: (options: BarSpecOptions) => ColorValue
 export declare const getBarEnterEncodings: (options: BarSpecOptions) => EncodeEntry;
 export declare const getBarUpdateEncodings: (options: BarSpecOptions) => EncodeEntry;
 export declare const getStroke: (options: BarSpecOptions) => ProductionRule<ColorValueRef>;
+/**
+ * Determines whether the per-item selection ring should be added for this mark.
+ * Mutually exclusive with the dimension-level {@link getDimensionSelectionRing}, which
+ * already provides its own group-spanning ring for `UNSAFE_highlightBy: 'dimension'` popovers.
+ */
+export declare const shouldShowItemSelectionRing: (options: BarSpecOptions) => boolean;
+/**
+ * Opaque backdrop for the selection ring, drawn UNDERNEATH the bar. It is outset from the bar and
+ * filled with the chart's background color so the gap between the bar and the stroke reads as an
+ * opaque halo (elements behind the bar aren't visible through it) rather than showing gridlines or
+ * other marks. It carries no stroke — the visible outline is {@link getBarItemSelectionRing}, drawn
+ * on top. Kept separate so the stroke can render above the bars while the fill stays below (an opaque
+ * fill drawn on top would cover the bar itself).
+ */
+export declare const getBarItemSelectionBackdrop: (options: BarSpecOptions, dataSource: string, dimensionEncodings: RectEncodeEntry) => RectMark;
+/**
+ * The visible selection outline: a stroke-only rect drawn ON TOP of the bar marks so it is never
+ * occluded. This matters for stacked bars, where adjacent segments (drawn after) would paint over a
+ * ring drawn underneath. Its fill is transparent so it doesn't cover the bar; the opaque gap is
+ * provided by {@link getBarItemSelectionBackdrop}, drawn underneath. Only visible for the bar whose
+ * mark ID matches the {@link SELECTED_ITEM} signal.
+ */
+export declare const getBarItemSelectionRing: (options: BarSpecOptions, dataSource: string, dimensionEncodings: RectEncodeEntry) => RectMark;
 export declare const getDimensionSelectionRing: (options: BarSpecOptions) => RectMark;
 export declare const getStrokeDash: ({ chartPopovers, idKey, lineType }: BarSpecOptions) => ProductionRule<ArrayValueRef>;
 export declare const getStrokeWidth: ({ chartPopovers, idKey, lineWidth, name, }: BarSpecOptions) => ProductionRule<NumericValueRef>;

package/dist/@types/src/bar/barUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/barUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACT,MAAM,MAAM,CAAC;AAyBd,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iCAAkC,cAAc,KAAG,OAEjF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAa,cAAc,YAGvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,SAoC5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,YAAa,cAAc,KAAG,eAUrE,CAAC;AAEF,eAAO,MAAM,8BAA8B,YAAa,cAAc,KAAG,eAOxE,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,eA2C5D,CAAC;AAEF,eAAO,MAAM,yBAAyB,YAAa,cAAc,KAAG,eAgDnE,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,cAAc,KAAG,eAmBlE,CAAC;AAEF,eAAO,MAAM,+BAA+B,wCAIzC,cAAc,KAAG,eAYnB,CAAC;AAEF,eAAO,MAAM,2BAA2B,oBACrB,eAAe,mBACf,cAAc,KAC9B,eAQF,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,cAAc,KAAG,WAGjE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,aAM5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,cAAc,KAAG,WAI7D,CAAC;AAEH,eAAO,MAAM,qBAAqB,YAAa,cAAc,KAAG,WAM9D,CAAC;AAEH,eAAO,MAAM,SAAS,YAAa,cAAc,KAAG,eAAe,aAAa,CAc/E,CAAC;AAEF,eAAO,MAAM,yBAAyB,YAAa,cAAc,KAAG,QAmCnE,CAAC;AAEF,eAAO,MAAM,aAAa,uCAAwC,cAAc,KAAG,eAAe,aAAa,CAU9G,CAAC;AAEF,eAAO,MAAM,cAAc,+CAKxB,cAAc,KAAG,eAAe,eAAe,CAmBjD,CAAC;AAEF,eAAO,MAAM,aAAa,iBAAkB,MAAM,iBAAiB,MAAM;;;CAExE,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,cAAc,aAErD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;IACtB,aAAa,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,mBAAmB,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,CAAC;CACtC;AAED,eAAO,MAAM,wBAAwB,gBAAiB,WAAW,cAAc,MAAM,KAAG,wBAiBjF,CAAC;AAER,eAAO,MAAM,gBAAgB,YAAa,cAAc,WAIvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,YAAa,cAAc,QAAQ,SAAS,GAAG,QAAQ,KAAG,QAoB9F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,YAAa,cAAc,KAAG,eAe9E,CAAC"}
+{"version":3,"file":"barUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/barUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACT,MAAM,MAAM,CAAC;AA0Bd,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iCAAkC,cAAc,KAAG,OAEjF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAa,cAAc,YAGvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,SAoC5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,YAAa,cAAc,KAAG,eAUrE,CAAC;AAEF,eAAO,MAAM,8BAA8B,YAAa,cAAc,KAAG,eAOxE,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,eA2C5D,CAAC;AAEF,eAAO,MAAM,yBAAyB,YAAa,cAAc,KAAG,eAgDnE,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,cAAc,KAAG,eAmBlE,CAAC;AAEF,eAAO,MAAM,+BAA+B,wCAIzC,cAAc,KAAG,eAYnB,CAAC;AAEF,eAAO,MAAM,2BAA2B,oBACrB,eAAe,mBACf,cAAc,KAC9B,eAQF,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,cAAc,KAAG,WAGjE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,aAM5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,cAAc,KAAG,WAI7D,CAAC;AAEH,eAAO,MAAM,qBAAqB,YAAa,cAAc,KAAG,WAM9D,CAAC;AAEH,eAAO,MAAM,SAAS,YAAa,cAAc,KAAG,eAAe,aAAa,CAc/E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,YAAa,cAAc,KAAG,OAIrE,CAAC;AAwGF;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,YAC7B,cAAc,cACX,MAAM,sBACE,eAAe,KAClC,QAYD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,YACzB,cAAc,cACX,MAAM,sBACE,eAAe,KAClC,QAcD,CAAC;AAEH,eAAO,MAAM,yBAAyB,YAAa,cAAc,KAAG,QAmCnE,CAAC;AAEF,eAAO,MAAM,aAAa,uCAAwC,cAAc,KAAG,eAAe,aAAa,CAU9G,CAAC;AAEF,eAAO,MAAM,cAAc,+CAKxB,cAAc,KAAG,eAAe,eAAe,CAmBjD,CAAC;AAEF,eAAO,MAAM,aAAa,iBAAkB,MAAM,iBAAiB,MAAM;;;CAExE,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,cAAc,aAErD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;IACtB,aAAa,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,mBAAmB,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,CAAC;CACtC;AAED,eAAO,MAAM,wBAAwB,gBAAiB,WAAW,cAAc,MAAM,KAAG,wBAiBjF,CAAC;AAER,eAAO,MAAM,gBAAgB,YAAa,cAAc,WAIvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,YAAa,cAAc,QAAQ,SAAS,GAAG,QAAQ,KAAG,QAoB9F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,YAAa,cAAc,KAAG,eAe9E,CAAC"}

package/dist/@types/src/bar/dodgedBarUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dodgedBarUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/dodgedBarUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAM3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAW1C,eAAO,MAAM,cAAc,YAAa,cAAc,KAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,EAkD9E,CAAC"}
+{"version":3,"file":"dodgedBarUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/dodgedBarUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAc1C,eAAO,MAAM,cAAc,YAAa,cAAc,KAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,EA4D9E,CAAC"}

package/dist/@types/src/bar/dodgedBarUtils.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dodgedBarUtils.test.d.ts","sourceRoot":"","sources":["../../../../src/bar/dodgedBarUtils.test.ts"],"names":[],"mappings":";AAkLA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB7B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGjC,CAAC"}
+{"version":3,"file":"dodgedBarUtils.test.d.ts","sourceRoot":"","sources":["../../../../src/bar/dodgedBarUtils.test.ts"],"names":[],"mappings":";AAwLA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB7B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGjC,CAAC"}

package/dist/@types/src/bar/stackedBarUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stackedBarUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/stackedBarUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAMlE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAc1C,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,IAAI,EAuBhE,CAAC;AAEF,eAAO,MAAM,0BAA0B,YAAa,cAAc,KAAG,SAYpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,YAAa,cAAc,KAAG,QAmBjE,CAAC;AAEF,eAAO,MAAM,aAAa,YAAa,cAAc,KAAG,QAmBvD,CAAC;AAEF,eAAO,MAAM,4BAA4B,YAAa,cAAc,KAAG,eAYtE,CAAC"}
+{"version":3,"file":"stackedBarUtils.d.ts","sourceRoot":"","sources":["../../../../src/bar/stackedBarUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAKlE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiB1C,eAAO,MAAM,kBAAkB,YAAa,cAAc,KAAG,IAAI,EAqChE,CAAC;AAEF,eAAO,MAAM,0BAA0B,YAAa,cAAc,KAAG,SAwBpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,YAAa,cAAc,KAAG,QAmBjE,CAAC;AAEF,eAAO,MAAM,aAAa,YAAa,cAAc,KAAG,QAmBvD,CAAC;AAEF,eAAO,MAAM,4BAA4B,YAAa,cAAc,KAAG,eAYtE,CAAC"}

package/dist/@types/src/barDirectLabel/barDirectLabelUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barDirectLabelUtils.d.ts","sourceRoot":"","sources":["../../../../src/barDirectLabel/barDirectLabelUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAY,MAAM,MAAM,CAAC;AAMrD,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AASxH;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,aACnC,0BAA0B,cACxB,OAAO,UACX,MAAM,kBACE,MAAM,gBACR,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmD5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,iBAAkB,yBAAyB,cAAc,cAAc,KAAG,IAAI,EA2EhH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,iBACzB,qBAAqB,SAC5B,MAAM,cACD,cAAc,KACzB,yBAWD,CAAC"}
+{"version":3,"file":"barDirectLabelUtils.d.ts","sourceRoot":"","sources":["../../../../src/barDirectLabel/barDirectLabelUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAY,MAAM,MAAM,CAAC;AAOrD,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AASxH;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,aACnC,0BAA0B,cACxB,OAAO,UACX,MAAM,kBACE,MAAM,gBACR,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmD5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,iBAAkB,yBAAyB,cAAc,cAAc,KAAG,IAAI,EAmFhH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,iBACzB,qBAAqB,SAC5B,MAAM,cACD,cAAc,KACzB,yBAYD,CAAC"}

package/dist/@types/src/chartInspect/chartInspectUtils.d.ts

@@ -0,0 +1,53 @@
+import { Data, FormulaTransform, NumericValueRef, Signal } from 'vega';
+import { AreaSpecOptions, BarSpecOptions, ChartInspectOptions, ChartInspectSpecOptions, DonutSpecOptions, LineSpecOptions, ScatterSpecOptions, VennSpecOptions } from '../types';
+type InspectParentOptions = AreaSpecOptions | BarSpecOptions | DonutSpecOptions | LineSpecOptions | ScatterSpecOptions | VennSpecOptions;
+/**
+ * gets all the inspects
+ * @param markOptions
+ * @returns
+ */
+export declare const getInspects: (markOptions: InspectParentOptions) => ChartInspectSpecOptions[];
+/**
+ * Applies all defaults to ChartInspectOptions
+ * @param chartInspectOptions
+ * @returns ChartInspectSpecOptions
+ */
+export declare const applyInspectPropDefaults: ({ highlightBy, targets, ...options }: ChartInspectOptions, markName: string) => ChartInspectSpecOptions;
+/**
+ * Sets all the data needed for inspects
+ *
+ * NOTE: this function mutates the data object so it should only be called from a produce function
+ * @param data
+ * @param markOptions
+ */
+export declare const addInspectData: (data: Data[], markOptions: InspectParentOptions, addHighlightedData?: boolean) => void;
+/**
+ * Gets the group id transform
+ * @param highlightBy
+ * @param markName
+ * @returns FormulaTransform
+ */
+export declare const getGroupIdTransform: (highlightBy: string[], markName: string) => FormulaTransform;
+export declare const isHighlightedByGroup: (markOptions: InspectParentOptions) => boolean;
+/**
+ * Inspect highlights by item or dimension
+ * @param markOptions
+ * @returns
+ */
+export declare const isHighlightedByDimension: (markOptions: InspectParentOptions) => boolean;
+/**
+ * adds the appropriate signals for inspects
+ *
+ * NOTE: this function mutates the signals array so it should only be called from a produce function
+ * @param signals
+ * @param markOptions
+ */
+export declare const addInspectSignals: (signals: Signal[], markOptions: InspectParentOptions) => void;
+export declare const addHoveredItemOpacityRules: (opacityRules: ({
+    test?: string;
+} & NumericValueRef)[], markOptions: InspectParentOptions) => void;
+export declare const addHoverdDimenstionAreaOpacityRules: (opacityRules: ({
+    test?: string;
+} & NumericValueRef)[], markOptions: InspectParentOptions) => void;
+export {};
+//# sourceMappingURL=chartInspectUtils.d.ts.map

package/dist/@types/src/{chartTooltip/chartTooltipUtils.d.ts.map → chartInspect/chartInspectUtils.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"chartTooltipUtils.d.ts","sourceRoot":"","sources":["../../../../src/chartTooltip/chartTooltipUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAgBnF,OAAO,EACL,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,KAAK,oBAAoB,GACrB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,WAAW,gBAAiB,oBAAoB,KAAG,uBAAuB,EAEtF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,yCACuB,mBAAmB,YACnE,MAAM,KACf,uBAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,SAAU,IAAI,EAAE,eAAe,oBAAoB,uCAoB7E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gBAAiB,MAAM,EAAE,YAAY,MAAM,KAAG,gBAM7E,CAAC;AAkBF,eAAO,MAAM,oBAAoB,gBAAiB,oBAAoB,YAGrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gBAAiB,oBAAoB,YAKzE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,YAAa,MAAM,EAAE,eAAe,oBAAoB,SAoBrF,CAAC;AAeF,eAAO,MAAM,0BAA0B,iBACvB,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,EAAE,eACxC,oBAAoB,SAmClC,CAAC;AAEF,eAAO,MAAM,mCAAmC,iBAChC,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,EAAE,eACxC,oBAAoB,SASlC,CAAC;AAEF,eAAO,MAAM,iCAAiC,kBAAmB,mBAAmB,EAAE,YAErF,CAAC"}
+{"version":3,"file":"chartInspectUtils.d.ts","sourceRoot":"","sources":["../../../../src/chartInspect/chartInspectUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAgBnF,OAAO,EACL,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,KAAK,oBAAoB,GACrB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,WAAW,gBAAiB,oBAAoB,KAAG,uBAAuB,EAEtF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,yCACuB,mBAAmB,YACnE,MAAM,KACf,uBAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,SAAU,IAAI,EAAE,eAAe,oBAAoB,uCAoB7E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gBAAiB,MAAM,EAAE,YAAY,MAAM,KAAG,gBAM7E,CAAC;AAkBF,eAAO,MAAM,oBAAoB,gBAAiB,oBAAoB,YAGrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gBAAiB,oBAAoB,YAKzE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,YAAa,MAAM,EAAE,eAAe,oBAAoB,SAoBrF,CAAC;AAeF,eAAO,MAAM,0BAA0B,iBACvB,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,EAAE,eACxC,oBAAoB,SAmClC,CAAC;AAEF,eAAO,MAAM,mCAAmC,iBAChC,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,EAAE,eACxC,oBAAoB,SAUlC,CAAC"}

package/dist/@types/src/chartInspect/chartInspectUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chartInspectUtils.test.d.ts.map

package/dist/@types/src/chartInspect/chartInspectUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartInspectUtils.test.d.ts","sourceRoot":"","sources":["../../../../src/chartInspect/chartInspectUtils.test.ts"],"names":[],"mappings":""}

package/dist/@types/src/chartSpecBuilder.d.ts

@@ -1,6 +1,6 @@
 import { Data, LinearScale, OrdinalScale, PointScale, Signal } from 'vega';
 import { ChartColors, ChartOptions, ChartSpecOptions, ColorScale, ColorScheme, Colors, LineType, LineTypes, LineWidth, Opacities, ScSpec, SymbolShapes, SymbolSize } from './types';
-export declare function buildSpec({ axes, backgroundColor, chartHeight, chartWidth, colors, colorScheme, data, description, hiddenSeries, highlightedItem, highlightedSeries, idKey, legends, lineTypes, lineWidths, marks, opacities, symbolShapes, symbolSizes, title, titles, }: ChartOptions): ScSpec;
+export declare function buildSpec({ animations, axes, backgroundColor, chartHeight, chartWidth, colors, colorScheme, data, description, hiddenSeries, highlightedItem, highlightedSeries, idKey, legends, lineTypes, lineWidths, marks, opacities, symbolShapes, symbolSizes, title, titles, }: ChartOptions): ScSpec;
 export declare const removeUnusedScales: (state?: ScSpec | undefined) => ScSpec;
 export declare const getDefaultSignals: ({ backgroundColor, colors, colorScheme, lineTypes, opacities, hiddenSeries, highlightedItem, highlightedSeries, }: ChartSpecOptions) => Signal[];
 export declare const getTwoDimensionalColorScheme: (colors: ChartColors, colorScheme: ColorScheme) => string[][];

package/dist/@types/src/chartSpecBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chartSpecBuilder.d.ts","sourceRoot":"","sources":["../../../src/chartSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAS,MAAM,EAAE,MAAM,MAAM,CAAC;AAoDlF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,gBAAgB,EAEhB,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AAGjB,wBAAgB,SAAS,CAAC,EACxB,IAAS,EACT,eAA0C,EAC1C,WAAW,EACX,UAAU,EACV,MAAwB,EACxB,WAAkC,EAClC,IAAI,EACJ,WAAW,EACX,YAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,KAAe,EACf,OAAY,EACZ,SAA4C,EAC5C,UAAkB,EAClB,KAAU,EACV,SAAS,EACT,YAAiC,EACjC,WAA0B,EAC1B,KAAK,EACL,MAAW,GACZ,EAAE,YAAY,UAuGd;AAED,eAAO,MAAM,kBAAkB,wCAI7B,CAAC;AAeH,eAAO,MAAM,iBAAiB,sHAS3B,gBAAgB,KAAG,MAAM,EAyB3B,CAAC;AAEF,eAAO,MAAM,4BAA4B,WAAY,WAAW,eAAe,WAAW,KAAG,MAAM,EAAE,EAKpG,CAAC;AAEF,eAAO,MAAM,0BAA0B,cAAe,SAAS,KAAG,MAAM,EAAE,EAAE,EAO3E,CAAC;AAEF,eAAO,MAAM,0BAA0B,cAAe,SAAS,GAAG,SAAS,KAAG,MAAM,EAAE,EAQrF,CAAC;AAqBF,eAAO,MAAM,aAAa,WAAY,WAAW,eAAe,WAAW,KAAG,YAI7E,CAAC;AAEF,eAAO,MAAM,mBAAmB,WAAY,WAAW,eAAe,WAAW,KAAG,WASnF,CAAC;AAEF,eAAO,MAAM,gBAAgB,cAAe,SAAS,KAAG,YAMvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,iBAAkB,YAAY,KAAG,YAMhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAG,WAMzE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAG,WAM9E,CAAC;AAEH,eAAO,MAAM,iBAAiB,eAAgB,SAAS,EAAE,KAAG,YAG3D,CAAC;AAEF,eAAO,MAAM,eAAe,eAAgB,SAAS,KAAG,YAAY,GAAG,UAatE,CAAC;AAiBF;;GAEG;AACH,eAAO,MAAM,OAAO;YAA8B,MAAM,EAAE;YAsBxD,CAAC;AAEH,eAAO,MAAM,YAAY,WAAY,WAAW,yBAE/C,CAAC;AAEF,eAAO,MAAM,QAAQ,WAAY,WAAW,qBAE3C,CAAC;AAEF,eAAO,MAAM,eAAe,cAAe,SAAS,4BAEnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,aAAc,QAAQ,GAAG,QAAQ,EAAE,yBAEhE,CAAC;AAEF,eAAO,MAAM,aAAa,cAAe,SAAS,0BAEjD,CAAC;AAEF,eAAO,MAAM,kBAAkB,iBAAkB,YAAY,6BAE5D,CAAC"}
+{"version":3,"file":"chartSpecBuilder.d.ts","sourceRoot":"","sources":["../../../src/chartSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAS,MAAM,EAAE,MAAM,MAAM,CAAC;AAiElF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,gBAAgB,EAEhB,UAAU,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AAGjB,wBAAgB,SAAS,CAAC,EACxB,UAAU,EACV,IAAS,EACT,eAA0C,EAC1C,WAAW,EACX,UAAU,EACV,MAAwB,EACxB,WAAkC,EAClC,IAAI,EACJ,WAAW,EACX,YAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,KAAe,EACf,OAAY,EACZ,SAA4C,EAC5C,UAAkB,EAClB,KAAU,EACV,SAAS,EACT,YAAiC,EACjC,WAA0B,EAC1B,KAAK,EACL,MAAW,GACZ,EAAE,YAAY,UAiHd;AAED,eAAO,MAAM,kBAAkB,wCAI7B,CAAC;AAeH,eAAO,MAAM,iBAAiB,sHAS3B,gBAAgB,KAAG,MAAM,EA2D3B,CAAC;AAEF,eAAO,MAAM,4BAA4B,WAAY,WAAW,eAAe,WAAW,KAAG,MAAM,EAAE,EAKpG,CAAC;AAEF,eAAO,MAAM,0BAA0B,cAAe,SAAS,KAAG,MAAM,EAAE,EAAE,EAO3E,CAAC;AAEF,eAAO,MAAM,0BAA0B,cAAe,SAAS,GAAG,SAAS,KAAG,MAAM,EAAE,EAQrF,CAAC;AAqBF,eAAO,MAAM,aAAa,WAAY,WAAW,eAAe,WAAW,KAAG,YAI7E,CAAC;AAEF,eAAO,MAAM,mBAAmB,WAAY,WAAW,eAAe,WAAW,KAAG,WASnF,CAAC;AAEF,eAAO,MAAM,gBAAgB,cAAe,SAAS,KAAG,YAMvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,iBAAkB,YAAY,KAAG,YAMhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAG,WAMzE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAG,WAM9E,CAAC;AAEH,eAAO,MAAM,iBAAiB,eAAgB,SAAS,EAAE,KAAG,YAG3D,CAAC;AAEF,eAAO,MAAM,eAAe,eAAgB,SAAS,KAAG,YAAY,GAAG,UAatE,CAAC;AAiBF;;GAEG;AACH,eAAO,MAAM,OAAO;YAA8B,MAAM,EAAE;YAsBxD,CAAC;AAEH,eAAO,MAAM,YAAY,WAAY,WAAW,yBAE/C,CAAC;AAEF,eAAO,MAAM,QAAQ,WAAY,WAAW,qBAE3C,CAAC;AAEF,eAAO,MAAM,eAAe,cAAe,SAAS,4BAEnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,aAAc,QAAQ,GAAG,QAAQ,EAAE,yBAEhE,CAAC;AAEF,eAAO,MAAM,aAAa,cAAe,SAAS,0BAEjD,CAAC;AAEF,eAAO,MAAM,kBAAkB,iBAAkB,YAAY,6BAE5D,CAAC"}

package/dist/@types/src/data/dataUtils.d.ts

@@ -1,5 +1,5 @@
 import { Compare, Data, FormulaTransform, SourceData, Transforms, ValuesData } from 'vega';
-import { ChartTooltipOptions } from '../types';
+import { ChartInspectOptions } from '../types';
 export declare const addTimeTransform: (state: Transforms[], args_0: string) => Transforms[];
 export declare const getTransformSort: (order?: string) => Compare | undefined;
 /**
@@ -19,7 +19,7 @@ export declare const getSeriesIdTransform: (facets: string[]) => FormulaTransfor
  * @param children
  * @returns spec data that filters out items where the `excludeDataKey` is true
  */
-export declare const getFilteredTooltipData: (chartTooltips: ChartTooltipOptions[]) => {
+export declare const getFilteredInspectData: (chartInspects: ChartInspectOptions[]) => {
     name: string;
     source: string;
     transform: {

package/dist/@types/src/donut/donutSpecBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"donutSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/donut/donutSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAoB,IAAI,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAejF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAUhG,eAAO,MAAM,QAAQ;;;;WAOR,MAAM;YA+ClB,CAAC;AAEF,eAAO,MAAM,OAAO,qDA2BlB,CAAC;AA2BH,eAAO,MAAM,SAAS,uDAIpB,CAAC;AAEH,eAAO,MAAM,QAAQ,qDAEnB,CAAC;AAEH,eAAO,MAAM,UAAU,yDAKrB,CAAC"}
+{"version":3,"file":"donutSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/donut/donutSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAoB,IAAI,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAejF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAUhG,eAAO,MAAM,QAAQ;;;;WAOR,MAAM;YA+ClB,CAAC;AAEF,eAAO,MAAM,OAAO,qDA6BlB,CAAC;AA2BH,eAAO,MAAM,SAAS,uDAIpB,CAAC;AAEH,eAAO,MAAM,QAAQ,qDAOnB,CAAC;AAEH,eAAO,MAAM,UAAU,yDAKrB,CAAC"}

package/dist/@types/src/donut/donutUtils.d.ts

@@ -1,4 +1,25 @@
-import { ArcMark } from 'vega';
+import { ArcMark, SourceData } from 'vega';
 import { DonutSpecOptions } from '../types';
+/**
+ * Gets the test expression that is true when the donut has no data or all metric values sum to 0.
+ * When the metric sum is 0, the vega pie transform produces NaN angles which cannot be rendered.
+ * @param name donut name
+ * @returns vega expression string
+ */
+export declare const getDonutEmptyStateTest: (name: string) => string;
+/**
+ * Gets the data source that aggregates the sum of the metric.
+ * Used to detect the empty state (no data or all metric values are 0).
+ * @param donutOptions
+ * @returns SourceData
+ */
+export declare const getSumData: ({ metric, name }: DonutSpecOptions) => SourceData;
 export declare const getArcMark: (options: DonutSpecOptions) => ArcMark;
+/**
+ * Gets the empty state arc mark. This is a light gray ring that is only visible
+ * when the donut has no data or all metric values sum to 0.
+ * @param donutOptions
+ * @returns ArcMark
+ */
+export declare const getEmptyStateArcMark: (options: DonutSpecOptions) => ArcMark;
 //# sourceMappingURL=donutUtils.d.ts.map

package/dist/@types/src/donut/donutUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"donutUtils.d.ts","sourceRoot":"","sources":["../../../../src/donut/donutUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAM/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,eAAO,MAAM,UAAU,YAAa,gBAAgB,KAAG,OA2BtD,CAAC"}
+{"version":3,"file":"donutUtils.d.ts","sourceRoot":"","sources":["../../../../src/donut/donutUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAM3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,SAAU,MAAM,KAAG,MAC2B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,qBAAsB,gBAAgB,KAAG,UAW9D,CAAC;AAEH,eAAO,MAAM,UAAU,YAAa,gBAAgB,KAAG,OA4BtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,gBAAgB,KAAG,OAsBhE,CAAC"}

package/dist/@types/src/donut/donutUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=donutUtils.test.d.ts.map

package/dist/@types/src/donut/donutUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"donutUtils.test.d.ts","sourceRoot":"","sources":["../../../../src/donut/donutUtils.test.ts"],"names":[],"mappings":""}

package/dist/@types/src/donut/segmentLabelUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segmentLabelUtils.d.ts","sourceRoot":"","sources":["../../../../src/donut/segmentLabelUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAmB,cAAc,EAAmB,QAAQ,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAM3G,OAAO,EAAE,gBAAgB,EAAuB,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAgC1F;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iBAAkB,gBAAgB,KAAG,SAAS,EAgB9E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gDAKjC,uBAAuB,KAAG,QAqB5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,YAAa,uBAAuB,KAAG,QAAQ,EAwBvF,CAAC;AA4BF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,kEAMlC,uBAAuB,KAAG,eAAe,YAAY,CAAC,GAAG,SAkB3D,CAAC"}
+{"version":3,"file":"segmentLabelUtils.d.ts","sourceRoot":"","sources":["../../../../src/donut/segmentLabelUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAmB,cAAc,EAAmB,QAAQ,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAM3G,OAAO,EAAE,gBAAgB,EAAuB,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAiC1F;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iBAAkB,gBAAgB,KAAG,SAAS,EAgB9E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gDAKjC,uBAAuB,KAAG,QAsB5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,YAAa,uBAAuB,KAAG,QAAQ,EA2BvF,CAAC;AA4BF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,kEAMlC,uBAAuB,KAAG,eAAe,YAAY,CAAC,GAAG,SAkB3D,CAAC"}

package/dist/@types/src/legend/legendHighlightUtils.d.ts

@@ -1,8 +1,23 @@
-import { Mark, NumericValueRef, ProductionRule } from 'vega';
+import { Data, Mark, NumericValueRef, ProductionRule } from 'vega';
+import { LegendOptions } from '../types';
+export declare const getLegendHighlightSignals: (legends: LegendOptions[]) => string[];
 /**
- * Adds opacity tests for the fill and stroke of marks that use the color scale to set the fill or stroke value.
+ * Injects a legend hover rule into the hover target data for the chart.
+ */
+export declare const injectLegendHoverIntoData: (legendName: string, data: Data[], keys?: string[]) => void;
+/**
+ * Adds opacity tests for marks whose fill/stroke is driven by the color scale, and for marks
+ * that are already per-series (e.g. trendlines, which facet by series regardless of their own
+ * color encoding — a trendline with an overridden literal color still needs to fade on legend hover).
  */
 export declare const setHoverOpacityForMarks: (legendName: string, marks: Mark[], keys?: string[], controlled?: boolean) => void;
+/**
+ * Injects a strokeWidth rule into marks that use the color scale so legend hover thickens the hovered series.
+ */
+export declare const setHoverStrokeWidthForMarks: (legendName: string, marks: Mark[], keys?: string[], controlled?: boolean) => void;
+export declare const getHighlightStrokeWidthRule: (legendName: string, controlled: boolean, keys?: string[]) => {
+    test?: string;
+} & NumericValueRef;
 export declare const getHighlightOpacityRule: (legendName: string, controlled: boolean, keys?: string[]) => {
     test?: string;
 } & NumericValueRef;
@@ -13,6 +28,13 @@ export declare const getHighlightOpacityRule: (legendName: string, controlled: b
  * @returns boolean
  */
 export declare const markUsesSeriesColorScale: (mark: Mark) => boolean;
+/**
+ * Determines if a mark should receive a legend-hover opacity rule — either because its own
+ * fill/stroke uses the color scale, or because it's a trendline/metric range mark.
+ * @param mark
+ * @returns boolean
+ */
+export declare const markIsSeriesAware: (mark: Mark) => boolean;
 /**
  * Determines if the supplied encoding uses a scale to set the value
  * @param encoding

package/dist/@types/src/legend/legendHighlightUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legendHighlightUtils.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendHighlightUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAa,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAWxE;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAgB,MAAM,SAAS,IAAI,EAAE,SAAS,MAAM,EAAE,+BA2BzF,CAAC;AAEF,eAAO,MAAM,uBAAuB,eACtB,MAAM,cACN,OAAO,SACZ,MAAM,EAAE,KACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAiBtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,SAAU,IAAI,KAAG,OAarD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iBAAkB,eAAe,CAAC,CAAC,KAAG,OAOnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAAW,IAAI,EAAE,KAAG,IAAI,EAQhD,CAAC"}
+{"version":3,"file":"legendHighlightUtils.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendHighlightUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsB,IAAI,EAA+B,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAapH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,yBAAyB,YAAa,aAAa,EAAE,KAAG,MAAM,EAInB,CAAC;AA+EzD;;GAEG;AACH,eAAO,MAAM,yBAAyB,eAAgB,MAAM,QAAQ,IAAI,EAAE,SAAS,MAAM,EAAE,KAAG,IAgB7F,CAAC;AAcF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,eAAgB,MAAM,SAAS,IAAI,EAAE,SAAS,MAAM,EAAE,+BAmCzF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,eAAgB,MAAM,SAAS,IAAI,EAAE,SAAS,MAAM,EAAE,+BAiB7F,CAAC;AAEF,eAAO,MAAM,2BAA2B,eAC1B,MAAM,cACN,OAAO,SACZ,MAAM,EAAE,KACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAkBtB,CAAC;AAEF,eAAO,MAAM,uBAAuB,eACtB,MAAM,cACN,OAAO,SACZ,MAAM,EAAE,KACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAiBtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,SAAU,IAAI,KAAG,OAarD,CAAC;AAkBF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,SAAU,IAAI,KAAG,OAC2B,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iBAAkB,eAAe,CAAC,CAAC,KAAG,OAOnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAAW,IAAI,EAAE,KAAG,IAAI,EAQhD,CAAC"}

package/dist/@types/src/legend/legendSpecBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legendSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,MAAM,CAAC;AAoBzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,MAAM,EACN,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,EAAmE,MAAM,eAAe,CAAC;AAEvG,eAAO,MAAM,SAAS;;;;;;YAuGrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,UAC9B,UAAU,GAAG,SAAS,YACnB,aAAa,GAAG,SAAS,aACxB,cAAc,GAAG,SAAS,eACxB,gBAAgB,GAAG,SAAS,eAC5B,WAAW;;;;;CA8BzB,CAAC;AAuBF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAAW,KAAK,WAAW,iBAAiB,KAAG,MAe9E,CAAC;AA8BF;;;;GAIG;AACH,eAAO,MAAM,OAAO;YAAkD,MAAM,EAAE;YAyC7E,CAAC;AAEF,eAAO,MAAM,UAAU,0DAUtB,CAAC"}
+{"version":3,"file":"legendSpecBuilder.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendSpecBuilder.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,MAAM,CAAC;AAoBzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,MAAM,EACN,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,EAAmE,MAAM,eAAe,CAAC;AAEvG,eAAO,MAAM,SAAS;;;;;;YA+GrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,UAC9B,UAAU,GAAG,SAAS,YACnB,aAAa,GAAG,SAAS,aACxB,cAAc,GAAG,SAAS,eACxB,gBAAgB,GAAG,SAAS,eAC5B,WAAW;;;;;CA8BzB,CAAC;AAuBF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAAW,KAAK,WAAW,iBAAiB,KAAG,MAe9E,CAAC;AA+BF;;;;GAIG;AACH,eAAO,MAAM,OAAO;YAAkD,MAAM,EAAE;YAsE7E,CAAC;AAEF,eAAO,MAAM,UAAU,0DAUtB,CAAC"}

package/dist/@types/src/legend/legendUtils.d.ts

@@ -5,12 +5,11 @@ export interface Facet {
     field: string;
 }
 /**
- * Get the number of columns for the legend
- * @param position
- * @param labelLimit
- * @returns
+ * Get the number of columns for the legend.
+ * Uses actual measured label widths (via the ${name}_maxLabelWidth data source) capped at labelLimit
+ * so columns are based on real content rather than a fixed estimate.
  */
-export declare const getColumns: (position: Position, labelLimit?: number) => SignalRef | undefined;
+export declare const getColumns: (position: Position, name: string, labelLimit?: number) => SignalRef | undefined;
 /**
  * Gets the filter transform for hidden entries
  * @param hiddenEntries
@@ -24,6 +23,7 @@ export declare const getHiddenEntriesFilter: (hiddenEntries: string[], name: str
  * @returns
  */
 export declare const getEncodings: (facets: Facet[], legendOptions: LegendSpecOptions, userMeta: UserMeta) => LegendEncode;
+export declare const getLegendOpacity: (options: LegendSpecOptions, userMeta: UserMeta) => ProductionRule<NumericValueRef> | undefined;
 /**
  * simple opacity encoding for legend labels and the symbol stroke opacity
  * @param legendOptions

package/dist/@types/src/legend/legendUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legendUtils.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendUtils.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,aAAa,EACb,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,SAAS,EAEV,MAAM,MAAM,CAAC;AA4Bd,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,SAAS,EAGT,iBAAiB,EACjB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACT,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,aAAc,QAAQ,eAAe,MAAM,KAAG,SAAS,GAAG,SAYhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,kBAAmB,MAAM,EAAE,QAAQ,MAAM,KAAG,eAAe,EAQ7F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,WAAY,KAAK,EAAE,iBAAiB,iBAAiB,YAAY,QAAQ,KAAG,YAcpG,CAAC;AAqEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,6FAC6D,iBAAiB,YACjG,QAAQ,KACjB,eAAe,eAAe,CAAC,GAAG,SAyCpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,KAAK,EAAE,WAAW,iBAAiB,KAAG,YA8ChF,CAAC;AA8CF,eAAO,MAAM,wBAAwB,4DACsB,iBAAiB,cAC9D,YAAY,KACvB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,CAAC,EAWjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAa,iBAAiB,KAAG,YAWjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YAAa,iBAAiB,KAAG,YAiB9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,cAAe,YAAY,EAAE,KAAG,YAMhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,gBAAiB,SAAS,MAAM,CAAC,GAAG,SAAS,KAAG,MAIzE,CAAC"}
+{"version":3,"file":"legendUtils.d.ts","sourceRoot":"","sources":["../../../../src/legend/legendUtils.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,aAAa,EACb,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,SAAS,EAEV,MAAM,MAAM,CAAC;AA6Bd,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,SAAS,EAGT,iBAAiB,EACjB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACT,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,aAAc,QAAQ,QAAQ,MAAM,eAAe,MAAM,KAAG,SAAS,GAAG,SAO9F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,kBAAmB,MAAM,EAAE,QAAQ,MAAM,KAAG,eAAe,EAQ7F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,WAAY,KAAK,EAAE,iBAAiB,iBAAiB,YAAY,QAAQ,KAAG,YAcpG,CAAC;AA8DF,eAAO,MAAM,gBAAgB,YAAa,iBAAiB,YAAY,QAAQ,KAAG,eAAe,eAAe,CAAC,GAAG,SAwBnH,CAAA;AASD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,6FAC6D,iBAAiB,YACjG,QAAQ,KACjB,eAAe,eAAe,CAAC,GAAG,SAyCpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,KAAK,EAAE,WAAW,iBAAiB,KAAG,YAoDhF,CAAC;AA8CF,eAAO,MAAM,wBAAwB,4DACsB,iBAAiB,cAC9D,YAAY,KACvB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,CAAC,EAWjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAa,iBAAiB,KAAG,YAcjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YAAa,iBAAiB,KAAG,YAiB9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,cAAe,YAAY,EAAE,KAAG,YAMhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,gBAAiB,SAAS,MAAM,CAAC,GAAG,SAAS,KAAG,MAIzE,CAAC"}

package/dist/@types/src/line/directLabelUtils.d.ts

@@ -0,0 +1,39 @@
+import { NumericValueRef, ProductionRule, TextMark, Transforms } from 'vega';
+import { ColorScheme } from '../types';
+type PositionRef = NumericValueRef | ProductionRule<NumericValueRef>;
+type FillOverride = {
+    field: string;
+} | {
+    value: string;
+} | {
+    signal: string;
+};
+export interface DirectLabelUpdateEncode {
+    x: PositionRef;
+    y: PositionRef;
+    additional?: Record<string, unknown>;
+}
+export declare const MIN_LABEL_GAP = "rscChartSizeLabelGap";
+/**
+ * Builds the five Vega transforms that compute collision-aware vertical positions for a set of
+ * co-located labels. Shared by direct labels (namespace='') and hover labels (namespace='hover').
+ *
+ * With namespace='': produces fields _seriesCount, _metricRank, _scaledY, _adjustedY, _cumMaxAdjusted
+ * With namespace='hover': produces fields _hover_seriesCount, _hover_metricRank, etc.
+ */
+export declare const getCascadeTransforms: (yScaleName: string, metric: string, namespace: string) => Transforms[];
+/**
+ * Builds the two-mark (background halo + foreground text) pattern for hover-style labels
+ * where position is encoded directly from data (no label transform).
+ * Both marks read from the same dataSource.
+ */
+export declare const getDirectLabelTextMarks: (backgroundMarkName: string, foregroundMarkName: string, dataSource: string, textSignal: string, updateEncode: DirectLabelUpdateEncode, colorScheme: ColorScheme, foregroundFillOverride?: FillOverride) => TextMark[];
+/**
+ * Builds the two-mark (background halo + foreground text) pattern for annotation-style labels
+ * that use Vega's label transform for collision-aware placement.
+ * The background mark runs the label transform; the foreground reads its computed positions
+ * (x, y, align, baseline, opacity) from the background mark.
+ */
+export declare const getLabelTransformTextMarks: (backgroundMarkName: string, foregroundMarkName: string, dataSource: string, textSignal: string, colorScheme: ColorScheme, labelTransform: Transforms, foregroundFillOverride?: FillOverride) => TextMark[];
+export {};
+//# sourceMappingURL=directLabelUtils.d.ts.map

package/dist/@types/src/line/directLabelUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directLabelUtils.d.ts","sourceRoot":"","sources":["../../../../src/line/directLabelUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAK7E,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,KAAK,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AACrE,KAAK,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,CAAC,EAAE,WAAW,CAAC;IACf,CAAC,EAAE,WAAW,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,aAAa,yBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,eAAgB,MAAM,UAAU,MAAM,aAAa,MAAM,KAAG,UAAU,EA8BtG,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uBACd,MAAM,sBACN,MAAM,cACd,MAAM,cACN,MAAM,gBACJ,uBAAuB,eACxB,WAAW,2BACC,YAAY,KACpC,QAAQ,EA6BV,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,uBACjB,MAAM,sBACN,MAAM,cACd,MAAM,cACN,MAAM,eACL,WAAW,kBACR,UAAU,2BACD,YAAY,KACpC,QAAQ,EAiCV,CAAC"}

package/dist/@types/src/line/lineDataUtils.d.ts

@@ -1,4 +1,5 @@
 import { SourceData } from 'vega';
+import { HoverMatchRule } from '../marks/hoverAnimationUtils';
 import { LineSpecOptions } from '../types';
 /**
  * gets the data used for highlighting hovered data points
@@ -7,6 +8,22 @@ import { LineSpecOptions } from '../types';
  * @returns
  */
 export declare const getLineHighlightedData: (options: LineSpecOptions) => SourceData;
+/**
+ * Builds a Vega expression that evaluates to true for series NOT in the primary set.
+ * - number: first N series by color scale order
+ * - string[]: explicitly named series
+ */
+export declare const getPrimarySeriesOtherExpr: (primarySeries: number | string[], datumPath: string) => string;
+/**
+ * Gets a derived data source sorted so "other" series appear first,
+ * causing Vega to draw them first (behind the primary series).
+ */
+export declare const getPrimarySeriesFacetData: (name: string, primarySeries: number | string[]) => SourceData;
+/**
+ * Derives from highlightedData and adds cascade transforms so labels for multiple series
+ * at the same hovered dimension are spread apart rather than overlapping.
+ */
+export declare const getHoverLabelData: (options: LineSpecOptions) => SourceData;
 /**
  * gets the data used for displaying points
  * @param name
@@ -17,4 +34,10 @@ export declare const getLineHighlightedData: (options: LineSpecOptions) => Sourc
  * @returns
  */
 export declare const getLineStaticPointData: (name: string, staticPoint: string | undefined, source: string, isSparkline: boolean | undefined, isMethodLast: boolean | undefined) => SourceData;
+/**
+ * Constructs the conditions for the hover interaction rules, storing the hover state as target values for each hoverable item
+ * @param lineOptions - the line spec options containing the interactive mark name, popover mark name, combo sibling names, and whether the series is highlighted by group
+ * @returns HoverMatchRule[] - the hover interaction rules
+ */
+export declare const getLineHoverRules: ({ interactiveMarkName, popoverMarkName, comboSiblingNames, isHighlightedByGroup }: LineSpecOptions) => HoverMatchRule[];
 //# sourceMappingURL=lineDataUtils.d.ts.map

package/dist/@types/src/line/lineDataUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lineDataUtils.d.ts","sourceRoot":"","sources":["../../../../src/line/lineDataUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAYlC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,YAAa,eAAe,KAAG,UA4BjE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,SAC3B,MAAM,eACC,MAAM,GAAG,SAAS,UACvB,MAAM,eACD,OAAO,GAAG,SAAS,gBAClB,OAAO,GAAG,SAAS,KAChC,UAaF,CAAC"}
+{"version":3,"file":"lineDataUtils.d.ts","sourceRoot":"","sources":["../../../../src/line/lineDataUtils.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIlC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAI3C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,YAAa,eAAe,KAAG,UA4BjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,kBAAmB,MAAM,GAAG,MAAM,EAAE,aAAa,MAAM,KAAG,MAK/F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,SAAU,MAAM,iBAAiB,MAAM,GAAG,MAAM,EAAE,KAAG,UAWzF,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAa,eAAe,KAAG,UAS5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,SAC3B,MAAM,eACC,MAAM,GAAG,SAAS,UACvB,MAAM,eACD,OAAO,GAAG,SAAS,gBAClB,OAAO,GAAG,SAAS,KAChC,UAaF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sFACuD,eAAe,KACjG,cAAc,EAyBhB,CAAC"}