@spectrum-charts/vega-spec-builder-s2 0.8.0 → 0.10.0

package/dist/@types/src/bullet/bulletSpecBuilder.d.ts

@@ -1,5 +1,5 @@
 import { Data, Scale, Signal } from 'vega';
-import { BulletOptions, BulletSpecOptions, ColorScheme, ScSpec } from '../types';
+import { BulletOptions, BulletSpecOptions, ColorScheme, ScSpec } from '../types/index.js';
 export declare const addBullet: (state: ScSpec, args_0: BulletOptions & {
     colorScheme?: ColorScheme | undefined;
     index?: number | undefined;
@@ -8,4 +8,3 @@ export declare const addBullet: (state: ScSpec, args_0: BulletOptions & {
 export declare const addScales: (state: Scale[], args_0: BulletSpecOptions) => Scale[];
 export declare const addSignals: (state: Signal[], args_0: BulletSpecOptions) => Signal[];
 export declare const addData: (state: Data[], args_0: BulletSpecOptions) => Data[];
-//# sourceMappingURL=bulletSpecBuilder.d.ts.map

package/dist/@types/src/bullet/bulletTestUtils.d.ts

@@ -1,5 +1,4 @@
-import { BulletSpecOptions } from '../types';
+import { BulletSpecOptions } from '../types/index.js';
 export declare const sampleOptionsColumn: BulletSpecOptions;
 export declare const sampleOptionsRow: BulletSpecOptions;
 export declare const sampleOptionsWithInspect: BulletSpecOptions;
-//# sourceMappingURL=bulletTestUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Data, FormulaTransform, NumericValueRef, Signal } from 'vega';
-import { AreaSpecOptions, BarSpecOptions, BulletSpecOptions, ChartInspectOptions, ChartInspectSpecOptions, DonutSpecOptions, LineSpecOptions, ScatterSpecOptions, VennSpecOptions } from '../types';
+import { AreaSpecOptions, BarSpecOptions, BulletSpecOptions, ChartInspectOptions, ChartInspectSpecOptions, DonutSpecOptions, LineSpecOptions, ScatterSpecOptions, VennSpecOptions } from '../types/index.js';
 type InspectParentOptions = AreaSpecOptions | BarSpecOptions | BulletSpecOptions | DonutSpecOptions | LineSpecOptions | ScatterSpecOptions | VennSpecOptions;
 /**
  * gets all the inspects
@@ -52,4 +52,3 @@ export declare const addHoverdDimenstionAreaOpacityRules: (opacityRules: ({
 /** Whether any inspect on this mark targets the dimension-hover-area rect's own tooltip, rather than just the item mark. */
 export declare const hasInspectWithDimensionAreaTarget: (chartInspects: ChartInspectOptions[]) => boolean;
 export {};
-//# sourceMappingURL=chartInspectUtils.d.ts.map

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,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({ animations, animationTypes, axes, backgroundColor, chartHeight, chartWidth, colors, colorScheme, data, description, hiddenSeries, highlightedItem, highlightedSeries, idKey, legends, lineTypes, lineWidths, marks, opacities, symbolShapes, symbolSizes, title, titles, }: ChartOptions): ScSpec;
+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[];
 export declare const getTwoDimensionalColorScheme: (colors: ChartColors, colorScheme: ColorScheme) => string[][];
@@ -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 { 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,40 @@ 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 label
- * @returns TextBaselineValueRef
- */
-export declare const getSummaryValueBaseline: (label?: string) => TextBaselineValueRef;
 /**
  * Gets the limit for the summary value
  * @param donutSummaryOptions
  * @returns NumericValueRef
  */
-export declare const getSummaryValueLimit: ({ donutOptions, label }: 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, }: DonutSummarySpecOptions & {
+export declare const getSummaryLabelEncode: (options: DonutSummarySpecOptions & {
     label: string;
 }) => Partial<Record<EncodeEntryName, TextEncodeEntry>>;
-//# sourceMappingURL=donutSummaryUtils.d.ts.map
+/**
+ * Gets the encode for the sentiment-colored delta line, always the last visible line
+ * @param donutSummaryOptions
+ * @returns encode
+ */
+export declare const getSummaryDeltaEncode: ({ donutOptions, hideValue, label, delta, }: DonutSummarySpecOptions & {
+    delta: number;
+}) => Partial<Record<EncodeEntryName, TextEncodeEntry>>;
+/**
+ * Gets the text value for the delta line, an explicit-sign one-decimal percent (e.g. "+2.5%")
+ * @param delta
+ * @returns TextValueRef
+ */
+export declare const getSummaryDeltaText: (delta: number) => TextValueRef;
+/**
+ * Gets the sentiment-based fill for the delta line - green for non-negative, red for negative
+ * @param delta
+ * @param colorScheme
+ * @returns ColorValueRef
+ */
+export declare const getSummaryDeltaFill: (delta: number, colorScheme: DonutSpecOptions['colorScheme']) => ColorValueRef;

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, SourceData } 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.
@@ -14,6 +30,103 @@ export declare const getDonutEmptyStateTest: (name: string) => string;
  * @returns SourceData
  */
 export declare const getSumData: ({ metric, name }: DonutSpecOptions) => SourceData;
+/**
+ * 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 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 maps chart size to the donut's size tier index.
+ * @param donutOptions
+ * @returns ThresholdScale
+ */
+export declare const getSizeTierScale: (options: DonutSpecOptions) => ThresholdScale;
+/**
+ * Gets the donut's size tier from its available full-diameter space.
+ * @param donutOptions
+ * @returns Signal
+ */
+export declare const getSizeTierSignal: (options: DonutSpecOptions) => Signal;
+/**
+ * Gets the signal resolving the size-tiered gap (px) between the ring's outer edge and its segment labels.
+ * @param donutOptions
+ * @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 getRingWidthSignal: ({ name }: DonutSpecOptions) => Signal;
+/**
+ * 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: ({ holeRatio, name }: DonutSpecOptions) => Signal;
+/**
+ * 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 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
@@ -22,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,27 +1,64 @@
-import { GroupMark, ProductionRule, TextMark, TextValueRef } from 'vega';
-import { DonutSpecOptions, SegmentLabelSpecOptions } from '../types';
+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[];
 /**
- * Gets the marks for the segment label. If there isn't a segment label, an empty array is returned.
- * @param donutOptions
- * @returns GroupMark[]
+ * Converts a text production rule into a single Vega expression string, for use inside getLabelWidth()
+ * @param rule
+ * @returns vega expression string
  */
+export declare const getTextRuleExpr: (rule: ProductionRule<TextValueRef> | undefined) => string;
 export declare const getSegmentLabelMarks: (donutOptions: DonutSpecOptions) => GroupMark[];
 /**
  * Gets the text mark for the segment label
  * @param segmentLabelOptions
  * @returns TextMark
  */
-export declare const getSegmentLabelTextMark: ({ labelKey, value, percent, donutOptions, }: SegmentLabelSpecOptions) => TextMark;
+export declare const getSegmentLabelTextMark: (options: SegmentLabelSpecOptions) => TextMark;
 /**
  * Gets the text mark for the segment label values (percent and/or value)
  * @param segmentLabelOptions
  * @returns TextMark[]
  */
 export declare const getSegmentLabelValueTextMark: (options: SegmentLabelSpecOptions) => TextMark[];
+/**
+ * Gets the fill for a donut label's value line - switches to the hovered/highlighted segment's own
+ * categorical color (matching the arc's color resolution) when either this donut's own arc is
+ * hovered or a paired Legend's hovered entry matches this segment, falling back to restColor
+ * otherwise. Shared by direct labels (gray-700) and rich SegmentLabels (gray-800) - only the name
+ * line's color never changes, this value line always can.
+ * @param donutOptions
+ * @param restColor fallback S2 color token when no hover/highlight matches this segment
+ * @returns ProductionRule<ColorValueRef>
+ */
+export declare const getLabelValueFill: (donutOptions: DonutSpecOptions, restColor: string) => ProductionRule<ColorValueRef>;
 /**
  * Gets the text value ref for the segment label values (percent and/or value)
  * @param segmentLabelOptions
  * @returns TextValueRef
  */
 export declare const getSegmentLabelValueText: ({ donutOptions, percent, percentFormat, value, valueFormat, }: SegmentLabelSpecOptions) => ProductionRule<TextValueRef> | undefined;
-//# sourceMappingURL=segmentLabelUtils.d.ts.map
+/**
+ * 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 data source rich SegmentLabel marks read from
+ * @param donutOptions
+ * @returns SourceData[]
+ */
+export declare const getRichSegmentLabelData: (donutOptions: DonutSpecOptions) => SourceData[];
+/**
+ * Gets the text value ref for a rich SegmentLabel's value/percent row
+ * @param options
+ * @returns TextValueRef
+ */
+export declare const getRichSegmentLabelValueText: (options: SegmentLabelSpecOptions) => ProductionRule<TextValueRef> | undefined;
+/**
+ * Gets the marks for a rich SegmentLabel
+ * @param donutOptions
+ * @returns GroupMark[]
+ */
+export declare const getRichSegmentLabelMarks: (donutOptions: DonutSpecOptions) => GroupMark[];

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.
@@ -11,9 +11,7 @@ export declare const injectLegendHoverIntoData: (legendName: string, data: Data[
  * 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.
- */
+/** Injects a strokeWidth rule so legend hover thickens the hovered series -- the chart's own line mark only. */
 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;
@@ -47,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