@spectrum-charts/vega-spec-builder-s2 0.9.0 → 0.11.0

package/dist/@types/src/chartPopover/chartPopoverUtils.d.ts

@@ -1,5 +1,5 @@
 import { Data, FormulaTransform } from 'vega';
-import { AreaSpecOptions, BarSpecOptions, ChartPopoverOptions, ChartPopoverSpecOptions, DonutSpecOptions, LineSpecOptions, ScatterSpecOptions } from '../types';
+import { AreaSpecOptions, BarSpecOptions, ChartPopoverOptions, ChartPopoverSpecOptions, DonutSpecOptions, LineSpecOptions, ScatterSpecOptions } from '../types/index.js';
 type PopoverParentOptions = AreaSpecOptions | BarSpecOptions | DonutSpecOptions | LineSpecOptions | ScatterSpecOptions;
 /**
  * gets all the popovers
@@ -29,4 +29,3 @@ export declare const addPopoverData: (data: Data[], markOptions: PopoverParentOp
  */
 export declare const getGroupIdTransform: (highlightBy: string[], markName: string) => FormulaTransform;
 export {};
-//# sourceMappingURL=chartPopoverUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Data, LinearScale, OrdinalScale, PointScale, Signal } from 'vega';
-import { ChartColors, ChartOptions, ChartSpecOptions, ColorScale, ColorScheme, Colors, LineType, LineTypes, LineWidth, Opacities, ScSpec, SymbolShapes, SymbolSize } from './types';
+import { ChartColors, ChartOptions, ChartSpecOptions, ColorScale, ColorScheme, Colors, LineType, LineTypes, LineWidth, Opacities, ScSpec, SymbolShapes, SymbolSize } from './types/index.js';
 export declare function buildSpec({ animations, animationTypes, accessibleNavigation, 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[];
@@ -29,6 +29,7 @@ export declare const getOpacityScale: (opacities?: Opacities) => OrdinalScale |
  */
 export declare const addData: (state: Data[], args_0: {
     facets: string[];
+    idKey?: string | undefined;
 }) => Data[];
 export declare const isColorScale: (colors: ChartColors) => colors is ColorScale;
 export declare const isColors: (colors: ChartColors) => colors is Colors;
@@ -36,4 +37,3 @@ export declare const isLineTypeArray: (lineTypes: LineTypes) => lineTypes is Lin
 export declare const isStrokeDashArray: (lineType: LineType | LineType[]) => lineType is number[];
 export declare const isNumberArray: (opacities: Opacities) => opacities is number[];
 export declare const isSymbolShapeArray: (symbolShapes: SymbolShapes) => symbolShapes is string[];
-//# sourceMappingURL=chartSpecBuilder.d.ts.map

package/dist/@types/src/combo/comboSpecBuilder.d.ts

@@ -1,9 +1,12 @@
-import { BarOptions, ColorScheme, ComboOptions, HighlightedItem, LineOptions, ScSpec } from '../types';
+import { AnimationType } from '@spectrum-charts/core-s2/constants';
+import { AxisOptions, BarOptions, ColorScheme, ComboOptions, HighlightedItem, LineOptions, ScSpec } from '../types/index.js';
 export declare const addCombo: (state: ScSpec, args_0: ComboOptions & {
+    animations?: boolean | undefined;
+    animationTypes?: AnimationType[] | undefined;
+    axes?: AxisOptions[] | undefined;
     colorScheme?: ColorScheme | undefined;
     highlightedItem?: HighlightedItem | undefined;
     index?: number | undefined;
     idKey: string;
 }) => ScSpec;
 export declare const getComboMarkName: (mark: BarOptions | LineOptions, comboName: string, index: number) => string;
-//# sourceMappingURL=comboSpecBuilder.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Compare, Data, FormulaTransform, SourceData, Transforms, ValuesData } from 'vega';
-import { ChartInspectOptions } from '../types';
+import { ChartInspectOptions } from '../types/index.js';
 export declare const addTimeTransform: (state: Transforms[], args_0: string) => Transforms[];
 /**
  * Whether a transform with the given `as` field already exists in the array — guards against
@@ -32,4 +32,3 @@ export declare const getFilteredInspectData: (chartInspects: ChartInspectOptions
         expr: string;
     }[] | undefined;
 };
-//# sourceMappingURL=dataUtils.d.ts.map

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

@@ -0,0 +1,20 @@
+import { FormulaTransform } from 'vega';
+/** Suffixes of the derived label position fields */
+export type LabelFieldSuffix = 'hemisphere' | 'idealY' | 'radius' | 'labelY' | 'centerY' | 'topY' | 'bottomY' | 'labelHalfWidth' | 'leftX' | 'rightX' | 'nameWidth' | 'valueWidth' | 'detailValueWidth' | 'detailSuffixWidth';
+/**
+ * Gets the derived label field name for a given field prefix and suffix
+ * @param fieldPrefix
+ * @param suffix
+ * @returns field name
+ */
+export declare const getLabelField: (fieldPrefix: string, suffix: LabelFieldSuffix) => string;
+/**
+ * Gets fixed label positions at the segment midpoint.
+ * @param fieldPrefix unique prefix for the fields this util writes
+ * @param arcThetaExpr vega expression for the row's arc center angle
+ * @param anchorRadiusExpr vega expression for the donut's outer radius plus the label gap
+ * @param labelHeightExpr vega expression for the rendered label block height
+ * @param inwardExtentExpr vega expression for the label height extending toward the chart center
+ * @returns transforms to append to a label candidate data source
+ */
+export declare const getLabelPositionTransforms: (fieldPrefix: string, arcThetaExpr: string, anchorRadiusExpr: string, labelHeightExpr: string, inwardExtentExpr?: string) => FormulaTransform[];

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

@@ -0,0 +1,10 @@
+import { DonutOptions, LegendOptions, ScSpec } from '../types/index.js';
+export declare const DONUT_LEGEND_EXTENT = "rscDonutLegendExtent";
+export declare const DONUT_LEGEND_MARGIN = "rscDonutLegendMargin";
+/**
+ * Centers a donut and its left or right legend as a group by padding the chart bounds equally on both sides.
+ * @param spec
+ * @param donut
+ * @param legends
+ */
+export declare const addDonutLegendLayout: (state: ScSpec, args_0: DonutOptions | undefined, args_1: LegendOptions[]) => ScSpec;

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

@@ -1,13 +1,18 @@
 import { Data, Mark, Scale, Signal } from 'vega';
-import { ColorScheme, DonutOptions, DonutSpecOptions, HighlightedItem, ScSpec } from '../types';
+import { AnimationType } from '@spectrum-charts/core-s2/constants';
+import { ChartData, ColorScheme, DonutOptions, DonutSpecOptions, HighlightedItem, ScSpec } from '../types/index.js';
 export declare const addDonut: (state: ScSpec, args_0: DonutOptions & {
+    animations?: boolean | undefined;
+    animationTypes?: AnimationType[] | undefined;
     colorScheme?: ColorScheme | undefined;
+    data?: ChartData[] | undefined;
     highlightedItem?: HighlightedItem | undefined;
+    highlightedSeries?: string | number | undefined;
     index?: number | undefined;
     idKey: string;
+    legendHighlightSignals?: string[] | undefined;
 }) => ScSpec;
 export declare const addData: (state: Data[], args_0: DonutSpecOptions) => Data[];
 export declare const addScales: (state: Scale[], args_0: DonutSpecOptions) => Scale[];
 export declare const addMarks: (state: Mark[], args_0: DonutSpecOptions) => Mark[];
 export declare const addSignals: (state: Signal[], args_0: DonutSpecOptions) => Signal[];
-//# sourceMappingURL=donutSpecBuilder.d.ts.map

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

@@ -1,17 +1,11 @@
-import { ColorValueRef, EncodeEntryName, GroupMark, NumericValueRef, ProductionRule, Signal, SourceData, TextBaselineValueRef, TextEncodeEntry, TextValueRef, ThresholdScale } from 'vega';
-import { DonutSpecOptions, DonutSummarySpecOptions } from '../types';
+import { ColorValueRef, EncodeEntryName, GroupMark, NumericValueRef, ProductionRule, Signal, SourceData, TextEncodeEntry, TextValueRef } from 'vega';
+import { DonutSpecOptions, DonutSummarySpecOptions } from '../types/index.js';
 /**
  * Gets the data for the donut summary
  * @param donutOptions
  * @returns SourceData[]
  */
 export declare const getDonutSummaryData: (donutOptions: DonutSpecOptions) => SourceData[];
-/**
- * Gets the required scales for the donut summary
- * @param donutOptions
- * @returns ThresholdScale[]
- */
-export declare const getDonutSummaryScales: (donutOptions: DonutSpecOptions) => ThresholdScale[];
 /**
  * Gets the signals for the donut summary
  * @param donutOptions
@@ -36,6 +30,16 @@ export declare const getDonutSummaryGroupMark: (options: DonutSummarySpecOptions
  * @returns GroupMark
  */
 export declare const getBooleanDonutSummaryGroupMark: (options: DonutSummarySpecOptions) => GroupMark;
+/**
+ * Hides summary text when it is too small or truncates to only an ellipsis.
+ * @param donutOptions
+ * @param textExpr
+ * @param fontSize
+ * @param fontWeight
+ * @param limitSignal
+ * @returns font size production rule
+ */
+export declare const getSummaryTextFontSize: (donutOptions: DonutSpecOptions, textExpr: string, fontSize: string, fontWeight: number, limitSignal: string) => ProductionRule<NumericValueRef>;
 /**
  * Gets the encode for the summary value
  * @param donutSummaryOptions
@@ -48,24 +52,20 @@ export declare const getSummaryValueEncode: (options: DonutSummarySpecOptions) =
  * @returns TextValueref
  */
 export declare const getSummaryValueText: ({ donutOptions, numberFormat, }: DonutSummarySpecOptions) => ProductionRule<TextValueRef>;
-/**
- * Gets the baseline for the summary value
- * @param hasLineBelow whether a label or delta line renders below the value
- * @returns TextBaselineValueRef
- */
-export declare const getSummaryValueBaseline: (hasLineBelow?: string | boolean) => TextBaselineValueRef;
 /**
  * Gets the limit for the summary value
  * @param donutSummaryOptions
  * @returns NumericValueRef
  */
-export declare const getSummaryValueLimit: ({ donutOptions, label, delta }: DonutSummarySpecOptions) => NumericValueRef;
+export declare const getSummaryValueLimit: (options: DonutSummarySpecOptions) => {
+    signal: string;
+};
 /**
  * Gets the encode for the metric label
  * @param donutSummaryOptions
  * @returns encode
  */
-export declare const getSummaryLabelEncode: ({ donutOptions, hideValue, label, delta, }: DonutSummarySpecOptions & {
+export declare const getSummaryLabelEncode: (options: DonutSummarySpecOptions & {
     label: string;
 }) => Partial<Record<EncodeEntryName, TextEncodeEntry>>;
 /**
@@ -89,4 +89,3 @@ export declare const getSummaryDeltaText: (delta: number) => TextValueRef;
  * @returns ColorValueRef
  */
 export declare const getSummaryDeltaFill: (delta: number, colorScheme: DonutSpecOptions['colorScheme']) => ColorValueRef;
-//# sourceMappingURL=donutSummaryUtils.d.ts.map

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

@@ -1,3 +1,2 @@
-import { DonutSpecOptions } from '../types';
+import { DonutSpecOptions } from '../types/index.js';
 export declare const defaultDonutOptions: DonutSpecOptions;
-//# sourceMappingURL=donutTestUtils.d.ts.map

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

@@ -1,5 +1,21 @@
-import { ArcMark, Signal, SourceData, ThresholdScale } from 'vega';
-import { DonutSpecOptions } from '../types';
+import { ArcMark, NumericValueRef, Signal, SourceData, ThresholdScale } from 'vega';
+import { HoverMatchRule } from '../marks/hoverAnimationUtils.js';
+import { DonutSpecOptions } from '../types/index.js';
+/** Returns whether a donut needs hover state for its labels, interactions, or a highlighted legend. */
+export declare const isDonutInteractive: (options: DonutSpecOptions) => boolean;
+export declare const getDonutAnimIdField: (name: string) => string;
+/** Builds per-segment hover targets using the same precedence as Line hover. */
+export declare const getDonutHoverRules: (options: DonutSpecOptions) => HoverMatchRule[];
+/** Gets the shared arc and label opacity, animated when hover animations are enabled. */
+export declare const getDonutOpacity: (options: DonutSpecOptions) => ({
+    test?: string;
+} & NumericValueRef)[];
+/** Gets the 0-1 linear label fade that starts when the label's slice finishes drawing. */
+export declare const getDonutLabelFadeProgressExpr: (options: DonutSpecOptions) => string;
+/** Combines the draw-in label fade with the donut's existing highlight opacity rules. */
+export declare const getDonutLabelOpacity: (options: DonutSpecOptions) => ({
+    test?: string;
+} & NumericValueRef)[];
 /**
  * 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.
@@ -15,45 +31,102 @@ export declare const getDonutEmptyStateTest: (name: string) => string;
  */
 export declare const getSumData: ({ metric, name }: DonutSpecOptions) => SourceData;
 /**
- * Gets the donut's outer radius, reserving space for SegmentLabel content when needed.
- * @param donutOptions
+ * Gets the name of the signal holding the size-tiered gap (px) between the ring and its segment labels.
+ * @param name donut name
+ * @returns signal name
+ */
+export declare const getDonutLabelRingGapSignalName: (name: string) => string;
+/**
+ * Gets the name of the signal holding the donut's size tier index (0-4 for XS/S/M/L/XL).
+ * @param name donut name
+ * @returns signal name
+ */
+export declare const getDonutSizeTierSignalName: (name: string) => string;
+/** Index of each donut size tier, as held by the size tier signal. */
+export declare const DONUT_SIZE_TIER: {
+    readonly XS: 0;
+    readonly S: 1;
+    readonly M: 2;
+    readonly L: 3;
+    readonly XL: 4;
+};
+/**
+ * Gets an expression that picks the value for the donut's size tier.
+ * @param name donut name
+ * @param values one value per size tier (XS/S/M/L/XL)
  * @returns vega expression string
  */
-export declare const getDonutOuterRadiusExpr: ({ isBoolean, segmentLabels, hideDeemphasizedLabels, emphasizedItems, }: DonutSpecOptions) => string;
+export declare const getSizeTierValueExpr: (name: string, values: (number | string)[]) => string;
+/**
+ * Gets the name of the signal holding the donut's outer radius.
+ * @param donutOptions
+ * @returns signal name
+ */
+export declare const getDonutOuterRadiusExpr: ({ name }: Pick<DonutSpecOptions, 'name'>) => string;
+/**
+ * Gets the name of the signal holding the donut's inner radius.
+ * @param donutOptions
+ * @returns signal name
+ */
+export declare const getDonutInnerRadiusExpr: ({ name }: Pick<DonutSpecOptions, 'name'>) => string;
 /**
- * Gets the threshold scale that snaps a donut's outer diameter to its nearest named size tier's fixed ring width
+ * Gets the threshold scale that maps chart size to the donut's size tier index.
  * @param donutOptions
  * @returns ThresholdScale
  */
-export declare const getRingWidthScale: ({ name }: DonutSpecOptions) => ThresholdScale;
+export declare const getSizeTierScale: (options: DonutSpecOptions) => ThresholdScale;
 /**
- * Gets the signal that resolves a donut's fixed ring width from its outer diameter (the label-reserved
- * radius, so the ring width tier stays consistent with the label font-size tier)
+ * Gets the donut's size tier from its available full-diameter space.
  * @param donutOptions
  * @returns Signal
  */
-export declare const getRingWidthSignal: (options: DonutSpecOptions) => Signal;
+export declare const getSizeTierSignal: (options: DonutSpecOptions) => Signal;
 /**
- * Gets the threshold scale that snaps a donut's outer diameter to its nearest named size tier's fixed slice gap
+ * Gets the signal resolving the size-tiered gap (px) between the ring's outer edge and its segment labels.
  * @param donutOptions
- * @returns ThresholdScale
+ * @returns Signal[]
+ */
+export declare const getLabelRingGapSignals: ({ name, segmentLabels }: DonutSpecOptions) => Signal[];
+/**
+ * Gets the signal that resolves a donut's fixed ring width from its size tier
+ * @param donutOptions
+ * @returns Signal
  */
-export declare const getSliceGapScale: ({ name }: DonutSpecOptions) => ThresholdScale;
+export declare const getRingWidthSignal: ({ name }: DonutSpecOptions) => Signal;
 /**
- * Gets the signal that resolves a donut's fixed segment gap (in px) from its outer diameter (the
- * label-reserved radius, so the slice gap tier stays consistent with the label font-size tier)
+ * Gets the signal that resolves a donut's fixed segment gap (in px) from its size tier, using a fixed 1px gap for pies
  * @param donutOptions
  * @returns Signal
  */
-export declare const getSliceGapSignal: (options: DonutSpecOptions) => Signal;
+export declare const getSliceGapSignal: ({ holeRatio, name }: DonutSpecOptions) => Signal;
 /**
- * Gets the donut's inner radius expression, relative to the label-reserved outer radius. Uses the
- * fixed per-tier ring width when holeRatio is left at its default, otherwise honors an explicitly
- * customized holeRatio as a proportional ring.
+ * Gets the signals resolving the donut's outer and inner radius once per chart size.
  * @param donutOptions
+ * @returns Signal[]
+ */
+export declare const getDonutRadiusSignals: (options: DonutSpecOptions) => Signal[];
+/**
+ * Preserves fixed pie outlines and clamps donut outlines to preserve fill at the inner radius.
+ * @param options
+ * @param requestedWidth
  * @returns vega expression string
  */
-export declare const getDonutInnerRadiusExpr: (options: DonutSpecOptions) => string;
+export declare const getSliceStrokeWidthExpr: (options: DonutSpecOptions, requestedWidth: string) => string;
+export declare const getDonutStartAngle: ({ variant }: Pick<DonutSpecOptions, 'variant'>) => number;
+/** Gets the total angular sweep expression for a donut's variant. */
+export declare const getDonutSweepExpr: ({ variant }: Pick<DonutSpecOptions, 'variant'>) => string;
+/** Gets an arc angle clipped to the draw-in sweep when enabled. */
+export declare const getDonutAngleEncoding: ({ isDrawInAnimate, name }: DonutSpecOptions, angle: 'startAngle' | 'endAngle') => NumericValueRef;
+/** Hides labels until their draw-in fade begins. */
+export declare const getDonutDrawInLabelVisibilityRules: (options: DonutSpecOptions) => ({
+    test: string;
+} & NumericValueRef)[];
+/**
+ * Gets the y anchor for a centered circle or bottom-aligned semicircle.
+ * @param donutOptions
+ * @returns vega signal string
+ */
+export declare const getDonutCenterYSignal: (options: DonutSpecOptions) => string;
 export declare const getArcMark: (options: DonutSpecOptions) => ArcMark;
 /**
  * Gets the empty state arc mark. This is a light gray ring that is only visible
@@ -62,4 +135,3 @@ export declare const getArcMark: (options: DonutSpecOptions) => ArcMark;
  * @returns ArcMark
  */
 export declare const getEmptyStateArcMark: (options: DonutSpecOptions) => ArcMark;
-//# sourceMappingURL=donutUtils.d.ts.map

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

@@ -1,6 +1,5 @@
-import { ColorValueRef, GroupMark, ProductionRule, Signal, SourceData, TextMark, TextValueRef, ThresholdScale } from 'vega';
-import { DonutSpecOptions, SegmentLabelSpecOptions } from '../types';
-export declare const getSegmentLabelScales: (donutOptions: DonutSpecOptions) => ThresholdScale[];
+import { ColorValueRef, GroupMark, ProductionRule, Signal, SourceData, TextMark, TextValueRef } from 'vega';
+import { DonutSpecOptions, SegmentLabelSpecOptions } from '../types/index.js';
 export declare const getSegmentLabelSignals: (donutOptions: DonutSpecOptions) => Signal[];
 export declare const getSegmentLabelData: (donutOptions: DonutSpecOptions) => SourceData[];
 /**
@@ -40,19 +39,13 @@ export declare const getLabelValueFill: (donutOptions: DonutSpecOptions, restCol
  */
 export declare const getSegmentLabelValueText: ({ donutOptions, percent, percentFormat, value, valueFormat, }: SegmentLabelSpecOptions) => ProductionRule<TextValueRef> | undefined;
 /**
- * Gets the threshold scales that snap a donut's outer diameter to its rich SegmentLabel font sizes
- * @param donutOptions
- * @returns ThresholdScale[]
- */
-export declare const getRichSegmentLabelScales: (donutOptions: DonutSpecOptions) => ThresholdScale[];
-/**
- * Gets the signals that resolve rich SegmentLabel font sizes from the donut's outer diameter
+ * Gets the signals that resolve rich SegmentLabel font sizes from the donut's size tier
  * @param donutOptions
  * @returns Signal[]
  */
 export declare const getRichSegmentLabelSignals: (donutOptions: DonutSpecOptions) => Signal[];
 /**
- * Gets the derived, collision-adjusted data source rich SegmentLabel marks read from
+ * Gets the derived data source rich SegmentLabel marks read from
  * @param donutOptions
  * @returns SourceData[]
  */
@@ -69,4 +62,3 @@ export declare const getRichSegmentLabelValueText: (options: SegmentLabelSpecOpt
  * @returns GroupMark[]
  */
 export declare const getRichSegmentLabelMarks: (donutOptions: DonutSpecOptions) => GroupMark[];
-//# sourceMappingURL=segmentLabelUtils.d.ts.map

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

@@ -1,7 +1,6 @@
-import { FormatLocaleDefinition } from 'd3-format';
 import { FontWeight, Locale, NumberLocale, TimeLocale } from 'vega';
-import { LocaleCode, NumberLocaleCode, TimeLocaleCode } from '@spectrum-charts/locales';
-import { NumberFormat } from '../types';
+import { LocaleCode, NumberLocaleCode, TimeLocaleCode, getLocale } from '@spectrum-charts/core-s2/locales';
+import { NumberFormat } from '../types/index.js';
 export interface LabelDatum {
     index: number;
     label: string;
@@ -15,9 +14,13 @@ export declare const getExpressionFunctions: (locale?: Locale | LocaleCode | {
     formatLocaleCurrency: ({ value }: LabelDatum, currencyLocale: string, currencyCode: string, numberFormat: NumberFormat) => string;
     formatShortNumber: (value: number) => string;
     consoleLog: (value: any) => any;
+    cubicBezier: (x1: number, y1: number, x2: number, y2: number, t: number) => number;
+    donutSliceStrokeWidth: (requestedWidth: number, innerRadius: number, startAngle: number, endAngle: number, cutoff?: number) => number;
     formatHorizontalTimeAxisLabels: (datum: LabelDatum) => string;
     formatVerticalAxisTimeLabels: (datum: LabelDatum) => string;
     getLabelWidth: (text: string, fontWeight?: FontWeight, fontSize?: number) => number;
+    hoverFraction: (rows: HoverFractionRow[] | undefined, keyField: string, key: unknown, fallback: number, field?: string) => number;
+    isDonutLabelVisible: (data: Record<string, unknown>[], datum: Record<string, unknown>, hemisphereField: string, collisionBoxesField: string, priorityField: string, idField: string, hoveredId?: unknown) => boolean;
     truncateText: (text: string, maxWidth: number, fontWeight?: FontWeight, fontSize?: number) => string;
 };
 /**
@@ -25,14 +28,20 @@ export declare const getExpressionFunctions: (locale?: Locale | LocaleCode | {
  * @param numberLocale
  * @returns formatted string
  */
-export declare const formatShortNumber: (numberLocale?: string | FormatLocaleDefinition) => (value: number) => string;
+export declare const formatShortNumber: (numberLocale?: string | NumberLocale) => (value: number) => string;
+/**
+ * Formats a percent of total followed by the short number value, e.g. `65.2% (23K)`.
+ * @param locale
+ * @returns formatted string
+ */
+export declare const formatPercentWithValue: (locale?: Parameters<typeof getLocale>[0]) => (percent: number, value: number) => string;
 /**
  * Formats currency values using a currency specific locale and currency code for the position and
  * type of currency symbol.
  * Applies thousands and decimal separators based on the numberFormat.
  * @returns string
  */
-export declare const formatLocaleCurrency: (numberLocale?: FormatLocaleDefinition) => ({ value }: LabelDatum, currencyLocale: string, currencyCode: string, numberFormat: NumberFormat) => string;
+export declare const formatLocaleCurrency: (numberLocale?: NumberLocale) => ({ value }: LabelDatum, currencyLocale: string, currencyCode: string, numberFormat: NumberFormat) => string;
 /**
  * Hides labels that are the same as the previous label
  * @returns string
@@ -49,12 +58,61 @@ export declare const formatVerticalAxisTimeLabels: () => (datum: LabelDatum) =>
  * @param numberLocale
  * @returns formatted sting (HH:MM:SS)
  */
-export declare const formatTimeDurationLabels: (numberLocale?: FormatLocaleDefinition) => ({ value }: LabelDatum) => string;
+export declare const formatTimeDurationLabels: (numberLocale?: NumberLocale) => ({ value }: LabelDatum) => string;
+/**
+ * Keeps fixed-position donut labels in priority order when their rendered blocks do not overlap.
+ * @param data
+ * @param datum
+ * @param hemisphereField
+ * @param collisionBoxesField
+ * @param priorityField
+ * @param idField
+ * @param hoveredId
+ * @returns whether the label should be visible
+ */
+export declare const isDonutLabelVisible: (data: Record<string, unknown>[], datum: Record<string, unknown>, hemisphereField: string, collisionBoxesField: string, priorityField: string, idField: string, hoveredId?: unknown) => boolean;
+type HoverFractionRow = Record<string, unknown> & {
+    fraction?: number;
+};
+/**
+ * Returns a hover animation value (the fraction by default) for `key`, indexing the rows once per data array.
+ * @param rows - the hoverFractionData values
+ * @param keyField - the identity field the rows are keyed by
+ * @param key - the identity of the item being encoded
+ * @param fallback - the value to use when no row matches
+ * @param field - the row field to read
+ * @returns number
+ */
+export declare const hoverFraction: (rows: HoverFractionRow[] | undefined, keyField: string, key: unknown, fallback: number, field?: string) => number;
+/**
+ * Clamps a slice's stroke width so a sliver of fill stays visible at the inner radius.
+ * @param requestedWidth
+ * @param innerRadius
+ * @param startAngle
+ * @param endAngle
+ * @param cutoff - draw-in sweep angle; omit when not animating
+ * @returns stroke width in px
+ */
+export declare const donutSliceStrokeWidth: (requestedWidth: number, innerRadius: number, startAngle: number, endAngle: number, cutoff?: number) => number;
+/**
+ * Evaluates a CSS-style cubic-bezier easing curve (P0 = 0,0 and P3 = 1,1) at progress `t`.
+ * @param x1
+ * @param y1
+ * @param x2
+ * @param y2
+ * @param t - linear progress, clamped to 0-1
+ * @returns eased progress
+ */
+export declare const cubicBezier: (x1: number, y1: number, x2: number, y2: number, t: number) => number;
 export declare const expressionFunctions: {
     consoleLog: (value: any) => any;
+    cubicBezier: (x1: number, y1: number, x2: number, y2: number, t: number) => number;
+    donutSliceStrokeWidth: (requestedWidth: number, innerRadius: number, startAngle: number, endAngle: number, cutoff?: number) => number;
     formatHorizontalTimeAxisLabels: (datum: LabelDatum) => string;
     formatVerticalAxisTimeLabels: (datum: LabelDatum) => string;
     getLabelWidth: (text: string, fontWeight?: FontWeight, fontSize?: number) => number;
+    hoverFraction: (rows: HoverFractionRow[] | undefined, keyField: string, key: unknown, fallback: number, field?: string) => number;
+    isDonutLabelVisible: (data: Record<string, unknown>[], datum: Record<string, unknown>, hemisphereField: string, collisionBoxesField: string, priorityField: string, idField: string, hoveredId?: unknown) => boolean;
     truncateText: (text: string, maxWidth: number, fontWeight?: FontWeight, fontSize?: number) => string;
 };
-//# sourceMappingURL=expressionFunctions.d.ts.map
+export {};

package/dist/@types/src/expressionFunctions/index.d.ts

@@ -1,2 +1 @@
-export * from './expressionFunctions';
-//# sourceMappingURL=index.d.ts.map
+export * from './expressionFunctions.js';

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

@@ -1,6 +1,5 @@
-export * from './chartSpecBuilder';
-export * from './specUtils';
-export * from './types';
-export * from './expressionFunctions';
-export * from './vegaEmbedUtils';
-//# sourceMappingURL=index.d.ts.map
+export * from './chartSpecBuilder.js';
+export * from './specUtils.js';
+export * from './types/index.js';
+export * from './expressionFunctions/index.js';
+export * from './vegaEmbedUtils.js';

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

@@ -1,5 +1,5 @@
 import { Scale } from 'vega';
-import { Facet } from './legendUtils';
+import { Facet } from './legendUtils.js';
 /**
  * Goes through all the scales and finds all the facets that are used
  * A facet is a key in the data that is used to differentiate the data
@@ -22,4 +22,3 @@ export declare const getFacetsFromKeys: (keys: string[], scales: Scale[]) => {
     ordinalFacets: Facet[];
     continuousFacets: Facet[];
 };
-//# sourceMappingURL=legendFacetUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Data, Mark, NumericValueRef, ProductionRule } from 'vega';
-import { LegendOptions } from '../types';
+import { LegendOptions } from '../types/index.js';
 export declare const getLegendHighlightSignals: (legends: LegendOptions[]) => string[];
 /**
  * Injects a legend hover rule into the hover target data for the chart.
@@ -45,4 +45,3 @@ export declare const encodingUsesScale: <T>(encoding?: ProductionRule<T>) => boo
  * @returns
  */
 export declare const flattenMarks: (marks: Mark[]) => Mark[];
-//# sourceMappingURL=legendHighlightUtils.d.ts.map

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

@@ -1,6 +1,6 @@
 import { Data, Legend, Signal } from 'vega';
-import { ColorFacet, ColorScheme, FacetRef, HighlightedItem, LegendOptions, LegendSpecOptions, LineTypeFacet, LineWidthFacet, ScSpec, SymbolShapeFacet } from '../types';
-import { Facet } from './legendUtils';
+import { ColorFacet, ColorScheme, FacetRef, HighlightedItem, LegendOptions, LegendSpecOptions, LineTypeFacet, LineWidthFacet, ScSpec, SymbolShapeFacet } from '../types/index.js';
+import { Facet } from './legendUtils.js';
 export declare const addLegend: (state: ScSpec, args_0: LegendOptions & {
     colorScheme?: ColorScheme | undefined;
     index?: number | undefined;
@@ -39,4 +39,3 @@ export declare const addData: (state: Data[], args_0: LegendSpecOptions & {
     facets: string[];
 }) => Data[];
 export declare const addSignals: (state: Signal[], args_0: LegendSpecOptions) => Signal[];
-//# sourceMappingURL=legendSpecBuilder.d.ts.map

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

@@ -1,5 +1,5 @@
 import { LineMark } from 'vega';
-import { LegendSpecOptions } from '../types';
+import { LegendSpecOptions } from '../types/index.js';
 export declare const opacityEncoding: ({
     value: number;
 } | {
@@ -8,4 +8,3 @@ export declare const opacityEncoding: ({
 })[];
 export declare const defaultMark: LineMark;
 export declare const defaultLegendOptions: LegendSpecOptions;
-//# sourceMappingURL=legendTestUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { ColorValueRef, FilterTransform, LegendEncode, NumericValueRef, ProductionRule, SignalRef } from 'vega';
-import { ColorValueV6, FacetRef, FacetType, LegendSpecOptions, Position, SecondaryFacetType, UserMeta } from '../types';
+import { ColorValueV6, FacetRef, FacetType, LegendSpecOptions, Position, SecondaryFacetType, UserMeta } from '../types/index.js';
 export interface Facet {
     facetType: FacetType | SecondaryFacetType;
     field: string;
@@ -10,6 +10,13 @@ export interface Facet {
  * so columns are based on real content rather than a fixed estimate.
  */
 export declare const getColumns: (position: Position, name: string, labelLimit?: number) => SignalRef | undefined;
+/**
+ * Gets an expression for the legend's widest measured label, capped at the label limit.
+ * @param name legend name
+ * @param labelLimit
+ * @returns vega expression string
+ */
+export declare const getMaxLabelWidthExpr: (name: string, labelLimit?: number) => string;
 /**
  * Gets the filter transform for hidden entries
  * @param hiddenEntries
@@ -58,4 +65,3 @@ export declare const mergeLegendEncodings: (encodings: LegendEncode[]) => Legend
  * @returns symbolShape
  */
 export declare const getSymbolType: (symbolShape: FacetRef<string> | undefined) => string;
-//# sourceMappingURL=legendUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { NumericValueRef, ProductionRule, TextMark, Transforms } from 'vega';
-import { ColorScheme } from '../types';
+import { ColorScheme } from '../types/index.js';
 type PositionRef = NumericValueRef | ProductionRule<NumericValueRef>;
 type FillOverride = {
     field: string;
@@ -36,4 +36,3 @@ export declare const getDirectLabelTextMarks: (backgroundMarkName: string, foreg
  */
 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/lineDataUtils.d.ts

@@ -1,6 +1,15 @@
-import { SourceData } from 'vega';
-import { HoverMatchRule } from '../marks/hoverAnimationUtils';
-import { LineSpecOptions } from '../types';
+import { FilterTransform, SourceData } from 'vega';
+import { HoverMatchRule } from '../marks/hoverAnimationUtils.js';
+import { LineSpecOptions } from '../types/index.js';
+/** Gets hover candidates whose metric positions are inside the plot. */
+export declare const getInBoundsHoverData: (options: LineSpecOptions, source: string) => SourceData;
+/**
+ * Gets a filter that keeps rows whose metric position is inside the plot.
+ * @param options - line spec options
+ * @param metric - metric field to check
+ * @returns FilterTransform
+ */
+export declare const getInPlotMetricFilter: (options: LineSpecOptions, metric?: string) => FilterTransform;
 /**
  * gets the data used for highlighting hovered data points
  * @param name
@@ -40,4 +49,3 @@ export declare const getLineStaticPointData: (name: string, staticPoint: string
  * @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/lineEncodingUtils.d.ts

@@ -0,0 +1,10 @@
+import { NumericValueRef, ProductionRule } from 'vega';
+import { LineMarkOptions } from './lineUtils.js';
+/**
+ * Gets the Y encoding for line marks with dual metric axis support
+ * @param lineMarkOptions - Line mark options including metricAxis and dualMetricAxis
+ * @param metric - The metric field name
+ * @returns Y encoding with conditional scale selection for dual metric axis
+ */
+export declare const getLineYEncoding: (lineMarkOptions: LineMarkOptions, metric: string) => ProductionRule<NumericValueRef>;
+export declare const getLineDeemphasisOpacitySignal: (name: string) => ProductionRule<NumericValueRef>;