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

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

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

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

@@ -1,5 +1,5 @@
 import { Data, Mark, Scale, Signal, SourceData } from 'vega';
-import { AreaOptions, AreaSpecOptions, ColorScheme, HighlightedItem, ScSpec } from '../types';
+import { AreaOptions, AreaSpecOptions, ColorScheme, HighlightedItem, ScSpec } from '../types/index.js';
 export declare const addArea: (state: ScSpec, args_0: AreaOptions & {
     colorScheme?: ColorScheme | undefined;
     highlightedItem?: HighlightedItem | undefined;
@@ -17,4 +17,9 @@ export declare const addSignals: (state: Signal[], args_0: AreaSpecOptions) => S
 export declare const addHighlightedItemEvents: (signals: Signal[], areaName: string) => void;
 export declare const setScales: (state: Scale[], args_0: AreaSpecOptions) => Scale[];
 export declare const addAreaMarks: (state: Mark[], args_0: AreaSpecOptions) => Mark[];
-//# sourceMappingURL=areaSpecBuilder.d.ts.map
+/**
+ * Gets the field for the top edge of the area, used to position hover and anchor points.
+ * @param areaOptions
+ * @returns string
+ */
+export declare const getHoverPointMetric: ({ metric, metricEnd, metricStart }: AreaSpecOptions) => string;

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

@@ -1,5 +1,5 @@
 import { AreaMark, NumericValueRef, ProductionRule } from 'vega';
-import { ChartPopoverOptions, ChartInspectOptions, ColorFacet, ColorScheme, HighlightedItem, ScaleType } from '../types';
+import { ChartPopoverOptions, ChartInspectOptions, ColorFacet, ColorScheme, HighlightedItem, ScaleType } from '../types/index.js';
 export interface AreaMarkOptions {
     color: ColorFacet;
     colorScheme: ColorScheme;
@@ -22,4 +22,3 @@ export interface AreaMarkOptions {
 export declare const getAreaMark: (areaOptions: AreaMarkOptions, dataSource?: string) => AreaMark;
 export declare function getAreaOpacity(areaOptions: AreaMarkOptions): ProductionRule<NumericValueRef> | undefined;
 export declare const getX: (scaleType: ScaleType, dimension: string) => ProductionRule<NumericValueRef>;
-//# sourceMappingURL=areaUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { NumericValueRef, ProductionRule, Signal } from 'vega';
-import { InteractiveMark } from '../types';
+import { InteractiveMark } from '../types/index.js';
 type MatchedInteractiveMark = Required<InteractiveMark>;
 /**
  * Vega mark name stamped onto an axis's primary label encode block - shared by hover and click
@@ -19,4 +19,3 @@ export declare const addAxisLabelHoverSignalWiring: (signals: Signal[], matching
  */
 export declare const getAxisLabelDimensionFillOpacity: (matchingBars: MatchedInteractiveMark[]) => ProductionRule<NumericValueRef>;
 export {};
-//# sourceMappingURL=axisLabelHoverUtils.d.ts.map

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

@@ -1,5 +1,5 @@
-import { Align, Baseline, EncodeEntry, FontWeight, GuideEncodeEntry, NumberValue, ProductionRule, TextEncodeEntry, TextValueRef, TickCount } from 'vega';
-import { AxisSpecOptions, Granularity, Label, LabelAlign, Orientation, Position } from '../types';
+import { Align, Baseline, EncodeEntry, FontWeight, GuideEncodeEntry, NumberValue, ProductionRule, StringValueRef, TextEncodeEntry, TextValueRef, TickCount } from 'vega';
+import { AxisSpecOptions, Granularity, Label, LabelAlign, Orientation, Position } from '../types/index.js';
 /**
  * Gets the display value of the label. If it's an object, it will return the value property, otherwise it will return the label.
  * @param label
@@ -85,6 +85,12 @@ export declare const getLabelOffset: (labelAlign: LabelAlign, scaleName: string,
  * @returns
  */
 export declare const getLabelFormat: ({ labelFormat, labelOrientation, numberFormat, position, truncateLabels, currencyLocale, currencyCode, }: AxisSpecOptions, scaleName: string) => ProductionRule<TextValueRef>;
+/**
+ * Tooltip production rule: per-value override, suppress, or the label's raw value.
+ * @param name axis name
+ * @returns tooltip production rule
+ */
+export declare const getAxisLabelTooltipRule: (name: string) => ProductionRule<StringValueRef>;
 /**
  * Gets the axis label encoding
  * @param labelAlign
@@ -106,4 +112,3 @@ export declare const getAxisLabelsEncoding: (labelAlign: LabelAlign, labelFontWe
  * @returns align | baseline
  */
 export declare const getEncodedLabelAnchor: (position: Position, signalName: string, labelOrientation: Orientation, defaultLabelAlign: LabelAlign) => EncodeEntry;
-//# sourceMappingURL=axisLabelUtils.d.ts.map

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

@@ -0,0 +1,7 @@
+import { Position } from '../types/index.js';
+/**
+ * Returns whether the axis is vertical.
+ * @param position
+ * @returns boolean
+ */
+export declare const isVerticalAxis: (position: Position) => boolean;

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

@@ -1,5 +1,5 @@
 import { Mark, NumericValueRef, PathMark, ProductionRule, RuleMark, ScaleType, SignalRef, TextMark } from 'vega';
-import { AxisSpecOptions, ReferenceLineSpecOptions } from '../types';
+import { AxisSpecOptions, ReferenceLineSpecOptions } from '../types/index.js';
 export declare const getReferenceLines: (axisOptions: AxisSpecOptions) => ReferenceLineSpecOptions[];
 export declare const scaleTypeSupportsReferenceLines: (scaleType: ScaleType | undefined) => boolean;
 /**
@@ -28,4 +28,3 @@ export declare const getReferenceLineEndCapMark: (_axisOptions: AxisSpecOptions,
  * Label is below the line, right-aligned, with S2 typography.
  */
 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/axisSpecBuilder.d.ts

@@ -1,6 +1,6 @@
 import { Axis, Data, Mark, ScaleType, Signal } from 'vega';
-import { AxisOptions, AxisSpecOptions, ColorScheme, Label, Orientation, Position, ScSpec, UserMeta } from '../types';
-import { DivergingBarContext } from './axisUtils';
+import { AxisOptions, AxisSpecOptions, ColorScheme, Label, Orientation, Position, ScSpec, UserMeta } from '../types/index.js';
+import { DivergingBarContext } from './axisUtils.js';
 export declare const addAxis: (state: ScSpec, args_0: AxisOptions & {
     colorScheme?: ColorScheme | undefined;
     index?: number | undefined;
@@ -72,4 +72,3 @@ export declare const addAxesMarks: (state: Mark[], args_0: AxisSpecOptions & {
     usermeta: UserMeta;
 }) => Mark[];
 export declare function setAxisBaseline(axis: Axis, baseline?: boolean): Axis;
-//# sourceMappingURL=axisSpecBuilder.d.ts.map

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

@@ -1,6 +1,5 @@
 import { Mark } from 'vega';
-import { AxisSpecOptions } from '../types';
+import { AxisSpecOptions } from '../types/index.js';
 export declare const defaultXBaselineMark: Mark;
 export declare const defaultYBaselineMark: Mark;
 export declare const defaultAxisOptions: AxisSpecOptions;
-//# sourceMappingURL=axisTestUtils.d.ts.map

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

@@ -1,6 +1,6 @@
 import { ImageMark, ScaleType, Signal, TextEncodeEntry } from 'vega';
-import { AxisSpecOptions, AxisThumbnailSpecOptions, Position } from '../types';
-import { DivergingBarContext } from './axisUtils';
+import { AxisSpecOptions, AxisThumbnailSpecOptions, Position } from '../types/index.js';
+import { DivergingBarContext } from './axisUtils.js';
 /**
  * Extracts and processes axis thumbnail options from the main axis options.
  * Maps each thumbnail option to a fully configured specification with default values applied.
@@ -99,4 +99,3 @@ export declare const getAxisThumbnailPosition: (scaleName: string, scaleField: s
  * @returns Text encoding entries for label offset adjustments
  */
 export declare const getAxisThumbnailLabelOffset: (axisThumbnailName: string, position: Position, isNegativeBarExpr?: string) => TextEncodeEntry;
-//# sourceMappingURL=axisThumbnailUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Axis, GroupMark, Spec } from 'vega';
-import { AxisSpecOptions } from '../types';
+import { AxisSpecOptions } from '../types/index.js';
 /**
  * Checks the spec to see if it is a trellised chart
  * @param spec
@@ -31,4 +31,3 @@ export declare const getTrellisGroupProperties: (groupMark: GroupMark) => {
     facetName: string;
     trellisScaleName: string;
 };
-//# sourceMappingURL=axisTrellisUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Axis, Mark, Scale, SignalRef } from 'vega';
-import { AxisSpecOptions, DivergingBarMark, Orientation, Position } from '../types';
+import { AxisSpecOptions, DivergingBarMark, Orientation, Position } from '../types/index.js';
 /**
  * Generates a default vega axis from the axis options
  * @param axisOptions
@@ -42,7 +42,7 @@ export declare const getRange: (position: Position) => 'width' | 'height';
  * @param position
  * @returns scaleType
  */
-export declare const getOpposingScaleType: (scales: Scale[], position: Position) => "linear" | "point" | "time" | "band" | "identity" | "ordinal" | "quantile" | "log" | "pow" | "utc" | "sequential" | "symlog" | "sqrt" | "quantize" | "threshold" | "bin-ordinal" | undefined;
+export declare const getOpposingScaleType: (scales: Scale[], position: Position) => "linear" | "point" | "time" | "band" | "pow" | "sqrt" | "log" | "symlog" | "utc" | "sequential" | "ordinal" | "quantile" | "quantize" | "threshold" | "bin-ordinal" | "identity" | undefined;
 /**
  * Gets the scale range for the opposing scale
  * @param position
@@ -111,12 +111,6 @@ export declare const getDivergingLabelEncode: (position: Position, isNegativeTes
 export declare const productionRuleToExpr: (rule: unknown) => string;
 /** Merges two ProductionRules by priority (`priorityRule`'s tested entries first) into one `{signal}`, so `deepmerge` replaces rather than array-concatenates and crashes the parser. */
 export declare const getPriorityMergedSignal: (priorityRule: unknown, fallbackRule: unknown) => SignalRef;
-/**
- * Returns whether the axis is vertical.
- * @param position
- * @returns boolean
- */
-export declare const isVerticalAxis: (position: Position) => boolean;
 /**
  * Determines tick count based on axis type and available space.
  * Uses Vega's tickCount parameter which is treated as a suggestion rather than a strict limit.
@@ -144,4 +138,3 @@ export declare const hasSubLabels: ({ subLabels, labelOrientation }: AxisSpecOpt
  * @returns Whether the axis is a metric axis
  */
 export declare function getIsMetricAxis(position: Position, chartOrientation: Orientation): boolean;
-//# sourceMappingURL=axisUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Axis, Data, Mark, ScaleType, Signal } from 'vega';
-import { AxisAnnotationOptions, AxisAnnotationSpecOptions, AxisSpecOptions, ColorScheme, Position } from '../types';
+import { AxisAnnotationOptions, AxisAnnotationSpecOptions, AxisSpecOptions, ColorScheme, Position } from '../types/index.js';
 /**
  * Adds the required data for axis annotations.
  *
@@ -54,4 +54,3 @@ export declare const getAxisAnnotationsFromChildren: ({ axisAnnotations, colorSc
 }) => 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/barAnnotationUtils.d.ts

@@ -1,5 +1,5 @@
 import { GroupMark, NumericValueRef, ProductionRule, RectEncodeEntry } from 'vega';
-import { BarAnnotationStyleOptions, BarSpecOptions, Orientation } from '../types';
+import { BarAnnotationStyleOptions, BarSpecOptions, Orientation } from '../types/index.js';
 type AnnotationWidth = {
     value: number;
 } | {
@@ -43,4 +43,3 @@ export declare const getAnnotationPositionOffset: ({ orientation }: BarSpecOptio
  */
 export declare const getAnnotationMetricAxisPosition: (options: BarSpecOptions, annotationWidth: AnnotationWidth, padding: number) => ProductionRule<NumericValueRef>;
 export {};
-//# sourceMappingURL=barAnnotationUtils.d.ts.map

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

@@ -0,0 +1,12 @@
+import { RectMark } from 'vega';
+import { BarSpecOptions } from '../types/index.js';
+export declare const getBarFocusRing: (options: BarSpecOptions) => RectMark;
+export declare const getChartFocusRing: (options: BarSpecOptions) => RectMark;
+/** Focus ring around a whole stack (column) when that stack is focused. */
+export declare const getStackFocusRing: (options: BarSpecOptions) => RectMark;
+/**
+ * Focus ring around a whole dodge group (a category's cluster of side-by-side bars) when that group
+ * is focused. Named the same as `getStackFocusRing`'s mark so the adapter's ring lookups work
+ * unchanged for either bar type.
+ */
+export declare const getDodgedGroupFocusRing: (options: BarSpecOptions) => RectMark;

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

@@ -1,11 +1,18 @@
 import { Data, FormulaTransform, Mark, Scale, Signal } from 'vega';
-import { BarOptions, BarSpecOptions, ColorScheme, HighlightedItem, ScSpec } from '../types';
+import { AnimationType } from '@spectrum-charts/core-s2/constants';
+import { BarOptions, BarSpecOptions, ChartData, ColorScheme, HighlightedItem, ScSpec } from '../types/index.js';
 export declare const addBar: (state: ScSpec, args_0: BarOptions & {
+    animations?: boolean | undefined;
+    animationTypes?: AnimationType[] | undefined;
+    accessibleNavigation?: boolean | undefined;
     colorScheme?: ColorScheme | undefined;
+    data?: ChartData[] | undefined;
     highlightedItem?: HighlightedItem | undefined;
+    highlightedSeries?: string | number | undefined;
     index?: number | undefined;
     idKey: string;
     comboSiblingNames?: string[] | undefined;
+    legendHighlightSignals?: string[] | undefined;
 }) => ScSpec;
 export declare const addSignals: (state: Signal[], args_0: BarSpecOptions) => Signal[];
 export declare const addData: (state: Data[], args_0: BarSpecOptions) => Data[];
@@ -32,4 +39,3 @@ export declare const addDimensionScale: (scales: Scale[], { dimension, paddingRa
 export declare const addSecondaryScales: (scales: Scale[], options: BarSpecOptions) => void;
 export declare const addMarks: (state: Mark[], args_0: BarSpecOptions) => Mark[];
 export declare const getRepeatedScale: (options: BarSpecOptions) => Scale;
-//# sourceMappingURL=barSpecBuilder.d.ts.map

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

@@ -1,5 +1,5 @@
 import { NumericValueRef, ProductionRule, RectEncodeEntry } from 'vega';
-import { BarSpecOptions } from '../types';
+import { BarSpecOptions } from '../types/index.js';
 export declare const defaultBarOptions: BarSpecOptions;
 export declare const defaultBarOptionsWithSecondayColor: BarSpecOptions;
 export declare const defaultStackedYEncodings: RectEncodeEntry;
@@ -757,4 +757,3 @@ export declare const dodgedSubSeriesAnnotationMarks: ({
 })[];
 export declare const defaultBarEnterEncodings: RectEncodeEntry;
 export declare const defaultBarStrokeEncodings: RectEncodeEntry;
-//# sourceMappingURL=barTestUtils.d.ts.map

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

@@ -1,10 +1,27 @@
 import { ArrayValueRef, ColorValueRef, EncodeEntry, GroupMark, NumericValueRef, ProductionRule, RectEncodeEntry, RectMark } from 'vega';
-import { BarSpecOptions, Orientation } from '../types';
+import { HoverMatchRule } from '../marks/hoverAnimationUtils.js';
+import { BarSpecOptions, Orientation } from '../types/index.js';
+/** Per-mark-namespaced field name for the composite per-bar hover-animation identity (see `BarSpecOptions.barIds`). */
+export declare const getBarAnimIdField: (name: string) => string;
 /**
  * checks to see if the bar is faceted in the stacked and dodged dimensions
  * @param color
  */
 export declare const isDodgedAndStacked: ({ color, lineType, opacity }: BarSpecOptions) => boolean;
+/**
+ * Checks whether the bar stacks its segments, either as a stacked bar or within each dodged group.
+ * @param options
+ * @returns boolean
+ */
+export declare const isBarStacked: (options: BarSpecOptions) => boolean;
+/**
+ * Gets a bar label's 0-1 draw-in fade, which starts once the bar (or, per segment, its stacked segment) finishes.
+ * @param options
+ * @param perSegment - whether the label belongs to a single stacked segment rather than the whole bar
+ * @param datum - expression path to the data row
+ * @returns expression string
+ */
+export declare const getBarDrawInLabelFadeExpr: (options: BarSpecOptions, perSegment: boolean, datum?: string) => string;
 /**
  * Checks if the bar chart is a dual metric axis chart
  * @param options - The bar chart options
@@ -14,12 +31,36 @@ export declare const isDualMetricAxis: (options: BarSpecOptions) => boolean;
 export declare const getDodgedGroupMark: (options: BarSpecOptions) => GroupMark;
 export declare const getDodgedDimensionEncodings: (options: BarSpecOptions) => RectEncodeEntry;
 export declare const getTrellisedDimensionEncodings: (options: BarSpecOptions) => RectEncodeEntry;
-export declare const getMetricEncodings: (options: BarSpecOptions) => RectEncodeEntry;
-export declare const getStackedMetricEncodings: (options: BarSpecOptions) => RectEncodeEntry;
+/**
+ * Gets the metric-axis encodings for a bar.
+ * @param options
+ * @param drawIn - read the animated draw-in value instead of the final metric
+ * @returns RectEncodeEntry
+ */
+export declare const getMetricEncodings: (options: BarSpecOptions, drawIn?: boolean) => RectEncodeEntry;
+/**
+ * Gets the metric-axis encodings for a stacked bar segment, leaving a small gap between segments.
+ * @param options
+ * @param drawIn - read the animated draw-in value instead of the segment's final end
+ * @returns RectEncodeEntry
+ */
+export declare const getStackedMetricEncodings: (options: BarSpecOptions, drawIn?: boolean) => RectEncodeEntry;
 export declare const getCornerRadiusEncodings: (options: BarSpecOptions) => RectEncodeEntry;
 export declare const getStackedCornerRadiusEncodings: ({ name, metric, hasSquareCorners, }: BarSpecOptions) => RectEncodeEntry;
 export declare const rotateRectClockwiseIfNeeded: (rectEncodeEntry: RectEncodeEntry, { orientation }: BarSpecOptions) => RectEncodeEntry;
 export declare const getBaseBarEnterEncodings: (options: BarSpecOptions) => EncodeEntry;
+/**
+ * Gets the metric encodings that animate during draw-in; they must live in update so they track the clock.
+ * @param options
+ * @returns EncodeEntry
+ */
+export declare const getBarDrawInUpdateEncodings: (options: BarSpecOptions) => EncodeEntry;
+/**
+ * Gets the background bar's draw-in encodings: final geometry, hidden until draw-in finishes so it never animates.
+ * @param options
+ * @returns EncodeEntry
+ */
+export declare const getBarBackgroundDrawInUpdateEncodings: (options: BarSpecOptions) => EncodeEntry;
 /**
  * Returns the Vega fill encoding for the bar. When {@link BarSpecOptions.colorOverride} is set
  * it takes precedence and the bar fill is taken from that data field (one color per row).
@@ -28,6 +69,14 @@ export declare const getBaseBarEnterEncodings: (options: BarSpecOptions) => Enco
 export declare const getBarFillEncoding: (options: BarSpecOptions) => ColorValueRef;
 export declare const getBarEnterEncodings: (options: BarSpecOptions) => EncodeEntry;
 export declare const getBarUpdateEncodings: (options: BarSpecOptions) => EncodeEntry;
+/** Builds the hover-animation engine's match rules for a bar mark (see `getLineHoverRules` for the line analog). */
+export declare const getBarHoverRules: (options: BarSpecOptions) => HoverMatchRule[];
+/**
+ * Bar's opacity encoding: the animated per-bar fraction when hover-animated, else `getMarkOpacity`.
+ * @param options - the bar spec options
+ * @returns ProductionRule<NumericValueRef>
+ */
+export declare const getBarOpacity: (options: BarSpecOptions) => ProductionRule<NumericValueRef>;
 export declare const getStroke: (options: BarSpecOptions) => ProductionRule<ColorValueRef>;
 /**
  * Determines whether the per-item selection ring should be added for this mark.
@@ -82,4 +131,3 @@ export declare const getBarDimensionHoverArea: (options: BarSpecOptions, type: '
  * @returns
  */
 export declare const getBarDimensionAreaPositionEncodings: (options: BarSpecOptions) => RectEncodeEntry;
-//# sourceMappingURL=barUtils.d.ts.map

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

@@ -1,4 +1,3 @@
 import { GroupMark, RectMark } from 'vega';
-import { BarSpecOptions } from '../types';
+import { BarSpecOptions } from '../types/index.js';
 export declare const getDodgedMarks: (options: BarSpecOptions) => (GroupMark | RectMark)[];
-//# sourceMappingURL=dodgedBarUtils.d.ts.map

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

@@ -1,8 +1,7 @@
 import { GroupMark, Mark, RectEncodeEntry, RectMark } from 'vega';
-import { BarSpecOptions } from '../types';
+import { BarSpecOptions } from '../types/index.js';
 export declare const getStackedBarMarks: (options: BarSpecOptions) => Mark[];
 export declare const getDodgedAndStackedBarMark: (options: BarSpecOptions) => GroupMark;
 export declare const getStackedBackgroundBar: (options: BarSpecOptions) => RectMark;
 export declare const getStackedBar: (options: BarSpecOptions) => RectMark;
 export declare const getStackedDimensionEncodings: (options: BarSpecOptions) => RectEncodeEntry;
-//# sourceMappingURL=stackedBarUtils.d.ts.map

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

@@ -0,0 +1,11 @@
+import { BarSpecOptions } from '../types/index.js';
+export interface BarTrellisProperties {
+    facetName: string;
+    scaleName: 'xTrellisBand' | 'yTrellisBand';
+    markName: 'xTrellisGroup' | 'yTrellisGroup';
+    dimensionSizeSignal: 'width' | 'height';
+    axis: 'x' | 'y';
+    paddingInner: number;
+}
+export declare const getTrellisProperties: ({ trellisOrientation, name, trellisPadding, }: BarSpecOptions) => BarTrellisProperties;
+export declare const isTrellised: (options: BarSpecOptions) => boolean;

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

@@ -1,5 +1,5 @@
 import { GroupMark, Mark, Scale } from 'vega';
-import { BarSpecOptions } from '../types';
+import { BarSpecOptions } from '../types/index.js';
 /**
  * Generates the trellis group mark
  * @param options
@@ -10,14 +10,3 @@ import { BarSpecOptions } from '../types';
 export declare const getTrellisGroupMark: (options: BarSpecOptions, marks: Mark[], repeatedScale: Scale) => GroupMark;
 export declare const addTrellisScale: (scales: Scale[], options: BarSpecOptions) => void;
 export declare const getTrellisedEncodeEntries: (options: BarSpecOptions) => import("vega").RectEncodeEntry;
-export interface BarTrellisProperties {
-    facetName: string;
-    scaleName: 'xTrellisBand' | 'yTrellisBand';
-    markName: 'xTrellisGroup' | 'yTrellisGroup';
-    dimensionSizeSignal: 'width' | 'height';
-    axis: 'x' | 'y';
-    paddingInner: number;
-}
-export declare const getTrellisProperties: ({ trellisOrientation, name, trellisPadding, }: BarSpecOptions) => BarTrellisProperties;
-export declare const isTrellised: (options: BarSpecOptions) => boolean;
-//# sourceMappingURL=trellisedBarUtils.d.ts.map

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

@@ -1,180 +1,45 @@
-import { ColorValueRef, Mark } from 'vega';
-import { BarDirectLabelOptions, BarDirectLabelPositionType, BarDirectLabelSpecOptions, BarSpecOptions } from '../types';
+import { Mark } from 'vega';
+import { BarDirectLabelOptions, BarDirectLabelSpecOptions, BarSpecOptions } from '../types/index.js';
+export interface LabelGeometry {
+    x: string;
+    y: string;
+    align: string;
+    baseline: string;
+}
 /**
- * Returns position-specific Vega encoding values for a bar direct label.
- * @param position - where to place the label relative to the bar
- * @param isVertical - whether the bar is vertically oriented
- * @param metric - the metric field name
- * @param metricScaleKey - the Vega scale name for the metric axis
- * @param fillEncoding - the series color encoding used for labels placed outside the bar
- * @param textSignal - the Vega signal expression that produces the label's text
+ * Gets the label text expression for a bar item.
+ * @param bar - expression path to the bar item
+ * @param labelOptions
  */
-export declare const getBarDirectLabelPositionEncodings: (position: BarDirectLabelPositionType, isVertical: boolean, metric: string, metricScaleKey: string, fillEncoding: ColorValueRef, textSignal: string) => {
-    metricAxisEncoding: ({
-        test: string;
-        scale: string;
-        value: number;
-        offset: number;
-        field?: undefined;
-    } | {
-        test: string;
-        scale: string;
-        field: string;
-        offset: number;
-        value?: undefined;
-    } | {
-        scale: string;
-        field: string;
-        offset: number;
-        test?: undefined;
-        value?: undefined;
-    })[];
-    verticalBaseline: ({
-        test: string;
-        value: "top";
-    } | {
-        value: "bottom";
-        test?: undefined;
-    })[];
-    horizontalAlign: {
-        value: "center";
-    };
-    seriesFill: (import("vega").SignalRef | {
-        field: import("vega").Field;
-    } | {
-        scale: import("vega").Field;
-        value: string | number | boolean | null;
-    } | {
-        scale: import("vega").Field;
-        band: number | boolean;
-    } | {
-        scale: import("vega").Field;
-        range: number | boolean;
-    } | {
-        value: string | null;
-    } | {
-        value: import("vega").LinearGradient | import("vega").RadialGradient;
-    } | {
-        gradient: import("vega").Field;
-        start?: number[] | undefined;
-        stop?: number[] | undefined;
-        count?: number | undefined;
-    } | {
-        color: import("vega").ColorRGB | import("vega").ColorHSL | import("vega").ColorLAB | import("vega").ColorHCL;
-    } | {
-        test: string;
-        signal: string;
-    })[];
-    isInsideTest: string;
-} | {
-    metricAxisEncoding: ({
-        test: string;
-        scale: string;
-        value: number;
-        offset: number;
-        field?: undefined;
-    } | {
-        test: string;
-        scale: string;
-        field: string;
-        offset: number;
-        value?: undefined;
-    } | {
-        scale: string;
-        field: string;
-        offset: number;
-        test?: undefined;
-        value?: undefined;
-    })[];
-    verticalBaseline: {
-        value: "middle";
-    };
-    horizontalAlign: ({
-        test: string;
-        value: "right";
-    } | {
-        value: "left";
-        test?: undefined;
-    })[];
-    seriesFill: (import("vega").SignalRef | {
-        field: import("vega").Field;
-    } | {
-        scale: import("vega").Field;
-        value: string | number | boolean | null;
-    } | {
-        scale: import("vega").Field;
-        band: number | boolean;
-    } | {
-        scale: import("vega").Field;
-        range: number | boolean;
-    } | {
-        value: string | null;
-    } | {
-        value: import("vega").LinearGradient | import("vega").RadialGradient;
-    } | {
-        gradient: import("vega").Field;
-        start?: number[] | undefined;
-        stop?: number[] | undefined;
-        count?: number | undefined;
-    } | {
-        color: import("vega").ColorRGB | import("vega").ColorHSL | import("vega").ColorLAB | import("vega").ColorHCL;
-    } | {
-        test: string;
-        signal: string;
-    })[];
-    isInsideTest: string;
-} | {
-    metricAxisEncoding: {
-        signal: string;
-    };
-    verticalBaseline: {
-        value: "middle";
-    };
-    horizontalAlign: {
-        value: "center";
-    };
-    seriesFill: {
-        signal: string;
-    };
-    isInsideTest: string | undefined;
-} | {
-    metricAxisEncoding: ({
-        offset: number;
-        field: string;
-        test: string;
-        scale: string;
-    } | {
-        offset: number;
-        field: string;
-        scale: string;
-    })[];
-    verticalBaseline: ({
-        test: string;
-        value: "top" | "bottom";
-    } | {
-        value: "top" | "bottom";
-        test?: undefined;
-    })[];
-    horizontalAlign: ({
-        test: string;
-        value: "left" | "right";
-    } | {
-        value: "left" | "right";
-        test?: undefined;
-    })[];
-    seriesFill: ColorValueRef;
-    isInsideTest: string | undefined;
-};
+export declare const getBarDirectLabelText: (bar: string, { format, metric }: BarDirectLabelSpecOptions) => string;
 /**
- * Text marks: background stroke halo + foreground fill, placed outside the tip of each bar.
- * Vertical bars: label above (positive) or below (negative) the bar, horizontally centered.
- * Horizontal bars: label to the right (positive) or left (negative) of the bar, vertically centered.
- *
- * No separate data source is needed — each row in FILTERED_TABLE is already one bar.
+ * Gets the expression that tests whether the label fits inside its bar.
+ * @param bar - expression path to the bar item
+ * @param labelOptions
  */
-export declare const getBarDirectLabelMarks: (labelOptions: BarDirectLabelSpecOptions, barOptions: BarSpecOptions) => Mark[];
+export declare const getBarDirectLabelFitsTest: (bar: string, labelOptions: BarDirectLabelSpecOptions) => string;
+/**
+ * Gets the label geometry for a label placed inside its bar.
+ * @param bar - expression path to the bar item
+ * @param labelOptions
+ */
+export declare const getInsideLabelGeometry: (bar: string, { metric, orientation, position }: BarDirectLabelSpecOptions) => LabelGeometry;
+/**
+ * Gets the mark name for a bar direct label.
+ * @param labelOptions
+ */
+export declare const getBarDirectLabelMarkName: ({ barName, index }: BarDirectLabelSpecOptions) => string;
+/**
+ * Whether outside labels for this direct label are laid out with collision detection.
+ * @param labelOptions
+ */
+export declare const usesCollisionLayout: ({ overflow, position }: BarDirectLabelSpecOptions) => boolean;
+/**
+ * Gets the marks for every direct label on a bar. Later labels avoid earlier ones.
+ * @param barOptions
+ */
+export declare const getBarDirectLabelsMarks: (barOptions: BarSpecOptions) => Mark[];
 /**
  * Applies defaults and inherits context from the parent bar, producing BarDirectLabelSpecOptions.
  */
 export declare const getBarDirectLabelSpecOptions: (labelOptions: BarDirectLabelOptions, index: number, barOptions: BarSpecOptions) => BarDirectLabelSpecOptions;
-//# sourceMappingURL=barDirectLabelUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Data, FormulaTransform, ValuesData } from 'vega';
-import { BulletSpecOptions, ThresholdBackground } from '../types';
+import { BulletSpecOptions, ThresholdBackground } from '../types/index.js';
 /**
  * Retrieves the bullet table data from the provided data array.
  * If it doesn't exist, creates and pushes a new one.
@@ -24,4 +24,3 @@ export declare const getBulletTransforms: (bulletOptions: BulletSpecOptions) =>
  * @returns A string representing the Vega expression for the color.
  */
 export declare function generateThresholdColorExpr(thresholds: ThresholdBackground[], metricField: string, defaultColor: string): string;
-//# sourceMappingURL=bulletDataUtils.d.ts.map

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

@@ -1,5 +1,5 @@
 import { Axis, Mark, TextValueRef } from 'vega';
-import { BulletSpecOptions } from '../types';
+import { BulletSpecOptions } from '../types/index.js';
 export declare const addMarks: (state: Mark[], args_0: BulletSpecOptions) => Mark[];
 export declare function getBulletMarkRect(bulletOptions: BulletSpecOptions): Mark;
 export declare function getBulletMarkTarget(bulletOptions: BulletSpecOptions): Mark;
@@ -20,4 +20,3 @@ export declare function getBulletLabelAxesLeft(labelOffset: any): Axis;
 export declare function getBulletLabelAxesRight(bulletOptions: BulletSpecOptions, labelOffset: any): Axis;
 export declare function getBulletScaleAxes(bulletOptions: BulletSpecOptions): Axis;
 export declare const addAxes: (state: Axis[], args_0: BulletSpecOptions) => Axis[];
-//# sourceMappingURL=bulletMarkUtils.d.ts.map