@opendata-ai/openchart-core 8.0.0-rc.12 → 8.0.0-rc.3

package/dist/index.d.ts

@@ -31,13 +31,8 @@ declare const HEIGHT_SHORT_MAX = 350;
 declare function getHeightClass(height: number): HeightClass;
 /** Label display mode at a given breakpoint. */
 type LabelMode = 'all' | 'important' | 'none';
-/**
- * Legend position at a given breakpoint. `'top-left'` is a map-only overlay
- * position: the legend floats inside the map area's top-left corner (with its
- * own backdrop) instead of reserving a block of figure height. Charts treat
- * it as the default position.
- */
-type LegendPosition = 'top' | 'top-left' | 'right' | 'bottom' | 'bottom-right' | 'inline';
+/** Legend position at a given breakpoint. */
+type LegendPosition = 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
 /** Annotation position strategy. */
 type AnnotationPosition = 'inline' | 'tooltip-only';
 /** Axis label density (controls tick count reduction). */
@@ -968,20 +963,6 @@ interface Encoding<TData extends DataRow = DataRow> {
      * per-panel axes.
      */
     facet?: FacetChannel<TData>;
-    /**
-     * Row facet channel: partitions data into vertically-stacked panels.
-     * Each unique value of the row field produces one panel, arranged in a
-     * single column. Shares the x-axis scale by default; y-axis is independent.
-     * Mutually exclusive with `facet` and `column`.
-     */
-    row?: FacetChannel<TData>;
-    /**
-     * Column facet channel: partitions data into side-by-side panels.
-     * Each unique value of the column field produces one panel, arranged in a
-     * single row. Shares the y-axis scale by default; x-axis is independent.
-     * Mutually exclusive with `facet` and `row`.
-     */
-    column?: FacetChannel<TData>;
 }
 /** Encoding channel for graph nodes and edges. */
 interface GraphEncodingChannel {
@@ -1037,14 +1018,6 @@ interface ChromeTextStyle {
     fontFamily?: string;
     /** Text color (CSS color string). */
     color?: string;
-    /**
-     * Maximum number of lines this chrome text may wrap to. Additional lines are
-     * dropped and the last kept line is truncated with an ellipsis. Bounds the
-     * chrome's contribution to layout height at any container width. Applies
-     * whether the font size comes from the theme default or an explicit override.
-     * Caps height only, not horizontal overflow of a single unbreakable word.
-     */
-    maxLines?: number;
 }
 /** A chrome text element with optional style overrides. */
 interface ChromeText {
@@ -1898,20 +1871,6 @@ interface BaseChartSpec<TData extends DataRow = DataRow> {
     transform?: Transform[];
     /** Editorial chrome (title, subtitle, source, etc.). */
     chrome?: Chrome;
-    /**
-     * How chrome height interacts with the container height budget.
-     *
-     * - `'subtract'` (default): the container height is fixed and chrome text
-     *   (title/subtitle/source) is subtracted from it, shrinking the plot. This
-     *   is the historical behavior.
-     * - `'grow'`: the container height is treated as the *plot* budget, and the
-     *   rendered SVG grows taller by the measured chrome height. The plot keeps
-     *   its full budget (minus axis/padding overhead) regardless of how many
-     *   lines the title wraps to.
-     *
-     * `'grow'` is a no-op for faceted specs in this version.
-     */
-    chromeLayout?: 'subtract' | 'grow';
     /**
      * Top-level title sugar (Vega-Lite aligned). Expanded into `chrome.title`
      * (and `chrome.subtitle` for the object form). `chrome.title` wins when
@@ -1978,12 +1937,7 @@ interface BaseChartSpec<TData extends DataRow = DataRow> {
     darkMode?: DarkMode;
     /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
     watermark?: boolean;
-    /**
-     * Series names to hide from rendering by default. This is the authored
-     * persistence target for legend visibility. Runtime legend toggles
-     * (legend-toggle edit events) layer on top of this via ephemeral runtime
-     * sets but never modify it.
-     */
+    /** Series names to hide from rendering. Hidden series remain in the legend but are visually dimmed. */
     hiddenSeries?: string[];
     /** Per-series visual overrides, keyed by series name (the color field value). */
     seriesStyles?: Record<string, SeriesStyle>;
@@ -2311,16 +2265,7 @@ interface LayerSpec<TData extends DataRow = DataRow> {
     height?: number;
     /** Accepted for Vega-Lite compatibility and ignored (with a compile warning). */
     $schema?: string;
-    /**
-     * Annotations for the layered chart. When present, these are the
-     * annotations rendered and available for editing. When absent, falls back
-     * to the first leaf layer's annotations. Annotations on second and later
-     * leaf layers are not rendered.
-     *
-     * For edit persistence: the `data-annotation-index` stamped on each
-     * rendered annotation maps to this array (or the first leaf's if this is
-     * unset). Place annotations here for reliable index-based edit matching.
-     */
+    /** Annotations on the layered view. */
     annotations?: Annotation[];
     /** Label display configuration. `false` disables all labels, `true` uses defaults. */
     labels?: LabelSpec;
@@ -2336,12 +2281,7 @@ interface LayerSpec<TData extends DataRow = DataRow> {
     watermark?: boolean;
     /** Resolution strategy for shared scales/axes/legends. */
     resolve?: ResolveConfig;
-    /**
-     * Series names to hide from rendering by default. This is the authored
-     * persistence target for legend visibility. Runtime legend toggles
-     * (legend-toggle edit events) layer on top of this via ephemeral runtime
-     * sets but never modify it.
-     */
+    /** Hidden series names. */
     hiddenSeries?: string[];
     /** Endpoint labels column, inherited by child layers that don't set their own. */
     endpointLabels?: boolean | EndpointLabelsConfig;
@@ -2484,21 +2424,9 @@ interface TileMapSpec {
 /** Supported map projections. */
 type MapProjection = 'albersUsa' | 'mercator' | 'equalEarth' | 'identity';
 /** Focus target for map camera: feature id(s) to zoom/pan to. */
-/**
- * Fit the point layer's cluster. `true` fits every point; `{ field, value }`
- * fits only the points whose data row has `row[field] === value` (e.g. only the
- * campuses rated "F"), which lets a story pan between sub-clusters.
- */
-type MapPointsFocus = true | {
-    field: string;
-    value: string | number;
-};
 type MapFocus = string | number | Array<string | number> | {
     features: string | number | Array<string | number>;
     padding?: number;
-} | {
-    points: MapPointsFocus;
-    padding?: number;
 };
 /** Geo configuration for map specs. */
 interface MapGeo {
@@ -2508,20 +2436,13 @@ interface MapGeo {
     idField?: string;
     /** Map projection. Defaults to 'albersUsa'. */
     projection?: MapProjection;
-    /**
-     * Focus the camera. A feature id (or array) fits those features; `{ features, padding }`
-     * adds breathing room; `{ points: true, padding }` fits the points layer's cluster
-     * instead of any feature (use when points occupy a small part of a large feature, so
-     * fitting the feature would leave the cluster small and off-center);
-     * `{ points: { field, value }, padding }` fits only the matching point subset, so a
-     * story can pan between sub-clusters. null clears focus from a prior story step.
-     */
+    /** Focus on specific feature(s). null clears focus from a prior story step. */
     focus?: MapFocus | null;
 }
 /** Encoding channels specific to map visualizations. */
 interface MapEncoding {
-    /** Join key field in the data. Required for choropleth; optional in basemap-only mode (points layer with empty data). */
-    key?: EncodingChannel;
+    /** Join key field in the data (required). Maps data rows to geo features via geo.idField. */
+    key: EncodingChannel;
     /** Color encoding (quantitative or nominal). Drives fill color of features. Optional when a points layer is present (basemap-only mode). */
     color?: EncodingChannel;
     /** Tooltip encoding (optional). */
@@ -2535,16 +2456,14 @@ interface MapPointsLayer {
     longitude: EncodingChannel;
     /** Field holding latitude (y coordinate). */
     latitude: EncodingChannel;
-    /** Optional quantitative size encoding. Area-proportional: r proportional to sqrt(value). No size legend is rendered in v1; explain the scale in chrome.subtitle if needed. */
+    /** Optional quantitative size encoding. Area-proportional: r proportional to sqrt(value). */
     size?: EncodingChannel;
     /** Optional color encoding (nominal or quantitative). Independent scale from choropleth. */
     color?: EncodingChannel;
     /** Tooltip channel(s), same shape as MapEncoding.tooltip. */
     tooltip?: EncodingChannel | EncodingChannel[];
-    /** Stable id for event callbacks. Data-update transitions for points are not yet supported. */
+    /** Stable id field for transitions and event callbacks. */
     key?: EncodingChannel;
-    /** Fill opacity for point circles. Default 0.65. Range 0-1. */
-    opacity?: number;
 }
 interface MapSpec {
     /** Discriminant: always "map". */
@@ -3002,36 +2921,26 @@ type ElementRef = {
     type: 'annotation';
     index: number;
     id?: string;
-    /** RFC 6901 JSON Pointer to the edited property in the spec. */
-    path?: string;
 } | {
     type: 'chrome';
     key: ChromeKey;
-    /** RFC 6901 JSON Pointer to the edited property in the spec. */
-    path?: string;
 } | {
     type: 'series-label';
     series: string;
-    /** RFC 6901 JSON Pointer to the edited property in the spec. */
-    path?: string;
 } | {
     type: 'legend';
-    /** RFC 6901 JSON Pointer to the edited property in the spec. */
-    path?: string;
 } | {
     type: 'legend-entry';
     series: string;
     index: number;
-    /** RFC 6901 JSON Pointer to the edited property in the spec. */
-    path?: string;
 };
 /** Helper constructors for ergonomic ElementRef creation. */
 declare const elementRef: {
-    readonly annotation: (index: number, id?: string, path?: string) => ElementRef;
-    readonly chrome: (key: ChromeKey, path?: string) => ElementRef;
-    readonly seriesLabel: (series: string, path?: string) => ElementRef;
-    readonly legend: (path?: string) => ElementRef;
-    readonly legendEntry: (series: string, index: number, path?: string) => ElementRef;
+    readonly annotation: (index: number, id?: string) => ElementRef;
+    readonly chrome: (key: ChromeKey) => ElementRef;
+    readonly seriesLabel: (series: string) => ElementRef;
+    readonly legend: () => ElementRef;
+    readonly legendEntry: (series: string, index: number) => ElementRef;
 };
 /**
  * Discriminated union of all element edit events.
@@ -3046,31 +2955,21 @@ declare const elementRef: {
  */
 type ElementEdit = {
     type: 'annotation';
-    element: ElementRef;
     annotation: TextAnnotation;
     offset: AnnotationOffset;
 } | {
     type: 'annotation-connector';
-    element: ElementRef;
     annotation: TextAnnotation;
     endpoint: 'from' | 'to';
     offset: AnnotationOffset;
 } | {
     type: 'range-label';
-    element: ElementRef;
     annotation: RangeAnnotation;
     labelOffset: AnnotationOffset;
 } | {
     type: 'refline-label';
-    element: ElementRef;
     annotation: RefLineAnnotation;
     labelOffset: AnnotationOffset;
-} | {
-    type: 'annotation-anchor';
-    element: ElementRef;
-    annotation: TextAnnotation;
-    x: string | number;
-    y: string | number;
 } | {
     type: 'chrome';
     key: ChromeKey;
@@ -3083,21 +2982,10 @@ type ElementEdit = {
 } | {
     type: 'legend';
     offset: AnnotationOffset;
-}
-/**
- * Transient legend visibility toggle. Reports the same runtime show/hide
- * a reader triggers; not persisted by openchart. To author default-hidden
- * series, set `spec.hiddenSeries` directly. Hosts building spec
- * persistence should generally not write legend-toggle edits back into
- * the authored spec. `hidden: true` means the series was just hidden.
- */
- | {
+} | {
     type: 'legend-toggle';
     series: string;
     hidden: boolean;
-} | {
-    type: 'add';
-    annotation: TextAnnotation;
 } | {
     type: 'delete';
     element: ElementRef;
@@ -3133,14 +3021,6 @@ interface MarkEvent {
  * or ChartProps (React component) to receive interaction callbacks.
  */
 interface ChartEventHandlers {
-    /**
-     * Explicitly enable or disable edit interactions (drag, select, keyboard
-     * delete/edit). When true, the interaction layer is wired even without
-     * onEdit. When false, all edit interactions are suppressed even when
-     * onEdit is provided. When omitted, each interaction block uses its
-     * existing callback-presence gate.
-     */
-    editable?: boolean;
     /** Called when a data mark is clicked. */
     onMarkClick?: (event: MarkEvent) => void;
     /** Called when the mouse enters a data mark. */
@@ -3237,12 +3117,6 @@ interface ResolvedChromeElement {
     y: number;
     /** Maximum width for line wrapping. */
     maxWidth: number;
-    /**
-     * Maximum wrapped lines. When set, the renderer caps the wrapped output to
-     * this many lines and truncates the last kept line with an ellipsis. The
-     * layout height reserved for this element already reflects the cap.
-     */
-    maxLines?: number;
     /** Computed text style. */
     style: TextStyle;
 }
@@ -3737,11 +3611,6 @@ interface ResolvedLabel {
         to: Point;
         /** Actual data point the connector is calling out. Renderer uses this for the endpoint marker. */
         endpoint?: Point;
-        /** Author's from-end nudge, re-applied on every geometry rebuild (mirrors `endpoint` for `to`). */
-        fromOffset?: {
-            dx: number;
-            dy: number;
-        };
         /** Connector line color. */
         stroke: string;
         /** Connector style: straight line, curved arrow, or vertical drop-line through the data point. */
@@ -3867,9 +3736,8 @@ interface BaseLegendLayout {
      * read them silently pick whichever comes first.
      */
     channel?: LegendChannel;
-    /** Where the legend is positioned relative to the chart area. `'top-left'`
-     *  is a map-only overlay position (floats inside the map area). */
-    position: 'top' | 'top-left' | 'right' | 'bottom' | 'bottom-right' | 'inline';
+    /** Where the legend is positioned relative to the chart area. */
+    position: 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
     /** Bounding box for the legend (pixel coordinates). */
     bounds: Rect;
     /** Entry label style. */
@@ -4199,23 +4067,6 @@ interface YouDrawItYInvert {
     /** Data value at the bottom pixel. */
     bottomData: number;
 }
-/**
- * Scale inversion anchors serialized from the engine so the vanilla layer
- * can convert pixel positions to data-space values without holding d3
- * scale objects. Generalizes the YouDrawItYInvert pattern to both axes.
- */
-interface ScaleInvert {
-    /** For continuous scales: two reference pixel-to-data anchor points. */
-    topPixel: number;
-    bottomPixel: number;
-    topData: number;
-    bottomData: number;
-    /** Scale type so the vanilla layer applies the correct inverse transform. */
-    scaleType?: 'linear' | 'log' | 'pow' | 'sqrt' | 'symlog' | 'time';
-    /** For band/point scales: ordered domain values and their pixel centers. */
-    domain?: (string | number)[];
-    positions?: number[];
-}
 /**
  * Resolved geometry and config for the "you draw it" interactive format
  * (`youDrawIt`). The vanilla adapter uses this to render the hatched drawing
@@ -4268,7 +4119,6 @@ interface FacetPanelLayout {
         y: number;
         fontSize: number;
         fontWeight: number;
-        textAnchor?: 'start' | 'middle' | 'end';
     };
 }
 /** Layout for a faceted (small-multiples) chart. */
@@ -4281,8 +4131,6 @@ interface FacetLayout {
     columns: number;
     /** Whether scales are shared across panels. */
     sharedScales: boolean;
-    /** How panels are arranged: 'row' (vertical stack), 'column' (horizontal), 'wrap' (grid). */
-    direction: 'row' | 'column' | 'wrap';
 }
 /**
  * ChartLayout: the complete engine output for chart visualizations.
@@ -4357,10 +4205,6 @@ interface ChartLayout {
     crosshair: boolean;
     /** Real text measurement function from the adapter (for accurate SVG text wrapping). */
     measureText?: MeasureTextFn;
-    /** Scale inversion anchors for the x axis. Used by anchor drag to convert pixel to data-space. */
-    xInvert?: ScaleInvert;
-    /** Scale inversion anchors for the y axis. Used by anchor drag to convert pixel to data-space. */
-    yInvert?: ScaleInvert;
     /** Faceted (small-multiples) layout. When present, renderers iterate panels instead of using top-level marks/axes. */
     facet?: FacetLayout;
 }
@@ -4834,9 +4678,7 @@ interface MapPointMark {
     stroke: string;
     /** Stroke width in px. */
     strokeWidth: number;
-    /** Fill opacity (0-1). */
-    fillOpacity: number;
-    /** Stable key for events. */
+    /** Stable key for events and transitions. */
     key: string;
     /** Original data row. */
     data: Record<string, unknown>;
@@ -4997,14 +4839,6 @@ interface CompileOptions {
     width: number;
     /** Total available height in pixels. */
     height: number;
-    /**
-     * How chrome height interacts with the height budget. Mirrors the spec-level
-     * `chromeLayout`; the engine reads whichever is set (spec wins).
-     *
-     * - `'subtract'` (default): `height` is the fixed total; chrome shrinks the plot.
-     * - `'grow'`: `height` is the plot budget; the SVG grows by the chrome height.
-     */
-    chromeLayout?: 'subtract' | 'grow';
     /** Theme overrides. */
     theme?: ThemeConfig;
     /**
@@ -5582,20 +5416,12 @@ declare function computeXAxisExtentFromLabels(input: XAxisExtentInput): number;
  * changes, the other follows.
  */
 declare function maxRotatedLabelWidth(tickAngle: number, tickFontSize: number): number;
-/**
- * Truncate a label with an ellipsis so it fits inside an explicit pixel budget.
- * Returns the label unchanged when it already fits.
- *
- * Binary-search on character count against the real measure function, so it
- * respects proportional fonts rather than assuming a fixed character width.
- */
-declare function truncateToWidth(label: string, budget: number, fontSize: number, fontWeight: number, measure?: (text: string, fontSize: number, fontWeight?: number) => number): string;
 /**
  * Truncate a rotated tick label with an ellipsis so it fits inside the capped
  * reservation. Returns the label unchanged when it already fits.
  *
- * Delegates to `truncateToWidth` with the budget derived from the rotation
- * geometry, so the binary-search stays in one place.
+ * Binary-search on character count against the real measure function, so it
+ * respects proportional fonts rather than assuming a fixed character width.
  */
 declare function truncateRotatedLabel(label: string, tickAngle: number, tickFontSize: number, tickFontWeight: number, measure?: (text: string, fontSize: number, fontWeight?: number) => number): string;
 
@@ -6031,4 +5857,4 @@ declare const CSS_TOKEN_ROOT_SELECTORS: readonly string[];
 declare const CSS_TOKENS: readonly CssTokenDef[];
 declare function cssTokenDefault(name: string, mode: 'light' | 'dark'): string;
 
-export { type A11yConfig, type A11yMetadata, ACHROMATIC_RAMP, AXIS_TITLE_GAP, AXIS_TITLE_OFFSET_COMPACT, AXIS_TITLE_OFFSET_DEFAULT, AXIS_TITLE_TRAILING_PAD, type AggregateOp, type AggregateTransform, type AnimationConfig, type AnimationEase, type AnimationPhaseConfig, type AnimationSpec, type AnimationStagger, type Annotation, type AnnotationAnchor, type AnnotationFootnote, type AnnotationOffset, type AnnotationPosition, type ArcEncoding, type ArcMark, type AreaEncoding, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, BRAND_FONT_SIZE, BRAND_MIN_WIDTH, BRAND_RESERVE_WIDTH, BREAKPOINT_COMPACT_MAX, BREAKPOINT_MEDIUM_MAX, type BarColumnConfig, type BarEncoding, type BarListEncoding, type BarListLayout, type BarListRowMark, type BarListSpec, type BarListSpecWithoutData, type BarTableCell, type BaseLegendLayout, type BeeswarmEncoding, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, COMPACT_WIDTH, CSS_TOKENS, CSS_TOKEN_ROOT_SELECTORS, type CalculateExpression, type CalculateTransform, type CalendarEncoding, type CategoricalLegendLayout, type CategoricalPalette, type CategoryColorsConfig, type CategoryTableCell, type CellStyle, type ChannelRule, type ChartBuilderOptions, type ChartEventHandlers, type ChartLayout, type ChartSpec, type ChartSpecOverride, type ChartSpecWithoutData, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ChromeThemeOverride, type CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type CompileWarning, type Condition, type ConditionalValueDef, type ConnectorConfig, type ConnectorType, type ContinuousLegendBin, type ContinuousLegendLayout, type ContinuousLegendTick, type CssTokenDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type Display, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type EndpointLabelContent, type EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, type FieldPredicate, type FieldRef, type FieldType, type FillPatternType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientColorStop, type GradientDef, type GradientLegendLayout, type GradientStop, type GraphChannelRule, type GraphEdge, type GraphEdgeLayout, type GraphEncoding, type GraphEncodingChannel, type GraphLayout, type GraphLayoutConfig, type GraphNode, type GraphNodeLayout, type GraphSpec, type GraphSpecWithoutData, type Gridline, HEIGHT_CRAMPED_MAX, HEIGHT_SHORT_MAX, HPAD_COMPACT_FRACTION, HPAD_COMPACT_MIN, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type ImageColumnConfig, type ImageTableCell, LABEL_GAP_COMPACT, LABEL_GAP_DEFAULT, LABEL_GAP_NARROW_MAX, type LabelCandidate, type LabelConfig, type LabelDensity, type LabelMode, type LabelPriority, type LabelSpec, type LayerSpec, type LayoutStrategy, type LegendChannel, type LegendConfig, type LegendEntry, type LegendEntryPosition, type LegendLayout, type LegendPosition, type LineEncoding, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, type LollipopEncoding, MARK_DISPLAY_NAMES, MARK_ENCODING_RULES, MARK_TYPES, MAX_LEFT_LABEL_FRACTION_COMPACT, MAX_LEFT_LABEL_FRACTION_DEFAULT, MAX_LEFT_LABEL_FRACTION_MEDIUM, MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX, type MapBorders, type MapEncoding, type MapFeatureMark, type MapFocus, type MapFocusLayout, type MapGeo, type MapLayout, type MapPointMark, type MapPointsLayer, type MapProjection, type MapSpec, type MapSpecWithoutData, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, NARROW_VIEWPORT_MAX, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, type Rect, type RectEncoding, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnimationPhase, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedFillPattern, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, type ResolvedSeriesSearch, type ResolvedTheme, type ResolvedYouDrawIt, type ResponsiveConfig, type RuleMarkLayout, SEQUENTIAL_PALETTES, SUPPORTED_SCHEME_NAMES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleInvert, type ScaleType, type SequentialPalette, type SeriesSearchConfig, type SeriesStrategy, type SeriesStyle, type SizeLegendCircle, type SizeLegendLayout, type SortByField, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, TICK_LABEL_OFFSET, TICK_LINE_HEIGHT_FACTOR, TOP_PAD_EXTRA_NARROW, TOP_PAD_NARROW_MAX, type TableBuilderOptions, type TableCell, type TableCellBase, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TextAnnotation, type TextEncoding, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickEncoding, type TickMarkLayout, type TileMapBuilderOptions, type TileMapEncoding, type TileMapLayout, type TileMapPalette, type TileMapSpec, type TileMapSpecWithoutData, type TileMapTileMark, type TimeUnit, type TimeUnitTransform, type TokenValue, type TooltipContent, type TooltipField, type Transform, type ValueDef, type VizSpec, type WaffleEncoding, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, type XAxisExtentInput, X_AXIS_BAND_HEIGHT, X_AXIS_ROTATED_EXTENT_CAP, X_AXIS_TITLE_BAND, X_AXIS_TITLE_BAND_ROTATED, type YouDrawItConfig, type YouDrawItSample, type YouDrawItYInvert, abbreviateNumber, adaptColorForDarkMode, adaptForLightLineStroke, adaptTheme, areaChart, axisTitleOffset, barChart, buildCompactStepFormatter, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeFieldFormatContext, computeLabelBounds, computeXAxisExtentFromLabels, contrastRatio, cssTokenDefault, dataTable, deepMergeSpec, defaultNumberFormatter, detectCollision, donutChart, dotChart, editorial, elementRef, essay, estimateTextWidth, findAccessibleColor, footnoteBandHeight, formatCurrency, formatDate, formatNumber, formatOrdinal, formatPercent, generateAltText, generateAriaLabels, generateDataTable, getAxisTitleOffset, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, heuristicMeasure, inferFieldType, isAxislessMark, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isMapSpec, isOpaqueColor, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, isValueDef, isYearContext, lineChart, maxRotatedLabelWidth, meetsAA, overlapArea, pickLabelColor, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, scatterChart, simulateColorBlindness, textAscent, tileMap, truncateRotatedLabel, truncateToWidth, wire, wrapText };
+export { type A11yConfig, type A11yMetadata, ACHROMATIC_RAMP, AXIS_TITLE_GAP, AXIS_TITLE_OFFSET_COMPACT, AXIS_TITLE_OFFSET_DEFAULT, AXIS_TITLE_TRAILING_PAD, type AggregateOp, type AggregateTransform, type AnimationConfig, type AnimationEase, type AnimationPhaseConfig, type AnimationSpec, type AnimationStagger, type Annotation, type AnnotationAnchor, type AnnotationFootnote, type AnnotationOffset, type AnnotationPosition, type ArcEncoding, type ArcMark, type AreaEncoding, type AreaMark, type AxisConfig, type AxisLabelDensity, type AxisLayout, type AxisTick, BRAND_FONT_SIZE, BRAND_MIN_WIDTH, BRAND_RESERVE_WIDTH, BREAKPOINT_COMPACT_MAX, BREAKPOINT_MEDIUM_MAX, type BarColumnConfig, type BarEncoding, type BarListEncoding, type BarListLayout, type BarListRowMark, type BarListSpec, type BarListSpecWithoutData, type BarTableCell, type BaseLegendLayout, type BeeswarmEncoding, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, COMPACT_WIDTH, CSS_TOKENS, CSS_TOKEN_ROOT_SELECTORS, type CalculateExpression, type CalculateTransform, type CalendarEncoding, type CategoricalLegendLayout, type CategoricalPalette, type CategoryColorsConfig, type CategoryTableCell, type CellStyle, type ChannelRule, type ChartBuilderOptions, type ChartEventHandlers, type ChartLayout, type ChartSpec, type ChartSpecOverride, type ChartSpecWithoutData, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ChromeThemeOverride, type CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type CompileWarning, type Condition, type ConditionalValueDef, type ConnectorConfig, type ConnectorType, type ContinuousLegendBin, type ContinuousLegendLayout, type ContinuousLegendTick, type CssTokenDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type Display, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type EndpointLabelContent, type EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, type FieldPredicate, type FieldRef, type FieldType, type FillPatternType, type FilterPredicate, type FilterTransform, type FlagTableCell, type FoldTransform, GRAPH_ENCODING_RULES, type GradientColorStop, type GradientDef, type GradientLegendLayout, type GradientStop, type GraphChannelRule, type GraphEdge, type GraphEdgeLayout, type GraphEncoding, type GraphEncodingChannel, type GraphLayout, type GraphLayoutConfig, type GraphNode, type GraphNodeLayout, type GraphSpec, type GraphSpecWithoutData, type Gridline, HEIGHT_CRAMPED_MAX, HEIGHT_SHORT_MAX, HPAD_COMPACT_FRACTION, HPAD_COMPACT_MIN, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type ImageColumnConfig, type ImageTableCell, LABEL_GAP_COMPACT, LABEL_GAP_DEFAULT, LABEL_GAP_NARROW_MAX, type LabelCandidate, type LabelConfig, type LabelDensity, type LabelMode, type LabelPriority, type LabelSpec, type LayerSpec, type LayoutStrategy, type LegendChannel, type LegendConfig, type LegendEntry, type LegendEntryPosition, type LegendLayout, type LegendPosition, type LineEncoding, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, type LollipopEncoding, MARK_DISPLAY_NAMES, MARK_ENCODING_RULES, MARK_TYPES, MAX_LEFT_LABEL_FRACTION_COMPACT, MAX_LEFT_LABEL_FRACTION_DEFAULT, MAX_LEFT_LABEL_FRACTION_MEDIUM, MAX_LEFT_LABEL_FRACTION_MEDIUM_MAX, type MapBorders, type MapEncoding, type MapFeatureMark, type MapFocus, type MapFocusLayout, type MapGeo, type MapLayout, type MapPointMark, type MapPointsLayer, type MapProjection, type MapSpec, type MapSpecWithoutData, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, NARROW_VIEWPORT_MAX, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, type Rect, type RectEncoding, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnimationPhase, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedFillPattern, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, type ResolvedSeriesSearch, type ResolvedTheme, type ResolvedYouDrawIt, type ResponsiveConfig, type RuleMarkLayout, SEQUENTIAL_PALETTES, SUPPORTED_SCHEME_NAMES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleType, type SequentialPalette, type SeriesSearchConfig, type SeriesStrategy, type SeriesStyle, type SizeLegendCircle, type SizeLegendLayout, type SortByField, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, TICK_LABEL_OFFSET, TICK_LINE_HEIGHT_FACTOR, TOP_PAD_EXTRA_NARROW, TOP_PAD_NARROW_MAX, type TableBuilderOptions, type TableCell, type TableCellBase, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TextAnnotation, type TextEncoding, type TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickEncoding, type TickMarkLayout, type TileMapBuilderOptions, type TileMapEncoding, type TileMapLayout, type TileMapPalette, type TileMapSpec, type TileMapSpecWithoutData, type TileMapTileMark, type TimeUnit, type TimeUnitTransform, type TokenValue, type TooltipContent, type TooltipField, type Transform, type ValueDef, type VizSpec, type WaffleEncoding, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, type XAxisExtentInput, X_AXIS_BAND_HEIGHT, X_AXIS_ROTATED_EXTENT_CAP, X_AXIS_TITLE_BAND, X_AXIS_TITLE_BAND_ROTATED, type YouDrawItConfig, type YouDrawItSample, type YouDrawItYInvert, abbreviateNumber, adaptColorForDarkMode, adaptForLightLineStroke, adaptTheme, areaChart, axisTitleOffset, barChart, buildCompactStepFormatter, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeFieldFormatContext, computeLabelBounds, computeXAxisExtentFromLabels, contrastRatio, cssTokenDefault, dataTable, deepMergeSpec, defaultNumberFormatter, detectCollision, donutChart, dotChart, editorial, elementRef, essay, estimateTextWidth, findAccessibleColor, footnoteBandHeight, formatCurrency, formatDate, formatNumber, formatOrdinal, formatPercent, generateAltText, generateAriaLabels, generateDataTable, getAxisTitleOffset, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, heuristicMeasure, inferFieldType, isAxislessMark, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isMapSpec, isOpaqueColor, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, isValueDef, isYearContext, lineChart, maxRotatedLabelWidth, meetsAA, overlapArea, pickLabelColor, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, scatterChart, simulateColorBlindness, textAscent, tileMap, truncateRotatedLabel, wire, wrapText };

package/dist/index.js

@@ -187,31 +187,14 @@ var GRAPH_ENCODING_RULES = {
 
 // src/types/events.ts
 var elementRef = {
-  annotation: (index, id, path) => ({
-    type: "annotation",
-    index,
-    ...id !== void 0 ? { id } : {},
-    ...path !== void 0 ? { path } : {}
-  }),
-  chrome: (key, path) => ({
-    type: "chrome",
-    key,
-    ...path !== void 0 ? { path } : {}
-  }),
-  seriesLabel: (series, path) => ({
-    type: "series-label",
-    series,
-    ...path !== void 0 ? { path } : {}
-  }),
-  legend: (path) => ({
-    type: "legend",
-    ...path !== void 0 ? { path } : {}
-  }),
-  legendEntry: (series, index, path) => ({
+  annotation: (index, id) => ({ type: "annotation", index, id }),
+  chrome: (key) => ({ type: "chrome", key }),
+  seriesLabel: (series) => ({ type: "series-label", series }),
+  legend: () => ({ type: "legend" }),
+  legendEntry: (series, index) => ({
     type: "legend-entry",
     series,
-    index,
-    ...path !== void 0 ? { path } : {}
+    index
   })
 };
 
@@ -1371,16 +1354,17 @@ function maxRotatedLabelWidth(tickAngle, tickFontSize) {
   const usable = X_AXIS_ROTATED_EXTENT_CAP - lineHeight * Math.cos(angleRad) - AXIS_TO_LABEL_GAP;
   return Math.max(0, usable / sin);
 }
-function truncateToWidth(label, budget, fontSize, fontWeight, measure = estimateTextWidth) {
+function truncateRotatedLabel(label, tickAngle, tickFontSize, tickFontWeight, measure = estimateTextWidth) {
+  const budget = maxRotatedLabelWidth(tickAngle, tickFontSize);
   if (!Number.isFinite(budget)) return label;
-  if (measure(label, fontSize, fontWeight) <= budget) return label;
+  if (measure(label, tickFontSize, tickFontWeight) <= budget) return label;
   const ELLIPSIS = "\u2026";
   let lo = 0;
   let hi = label.length;
   while (lo < hi) {
     const mid = Math.ceil((lo + hi) / 2);
     const candidate = label.slice(0, mid) + ELLIPSIS;
-    if (measure(candidate, fontSize, fontWeight) <= budget) {
+    if (measure(candidate, tickFontSize, tickFontWeight) <= budget) {
       lo = mid;
     } else {
       hi = mid - 1;
@@ -1388,10 +1372,6 @@ function truncateToWidth(label, budget, fontSize, fontWeight, measure = estimate
   }
   return lo > 0 ? label.slice(0, lo).trimEnd() + ELLIPSIS : ELLIPSIS;
 }
-function truncateRotatedLabel(label, tickAngle, tickFontSize, tickFontWeight, measure = estimateTextWidth) {
-  const budget = maxRotatedLabelWidth(tickAngle, tickFontSize);
-  return truncateToWidth(label, budget, tickFontSize, tickFontWeight, measure);
-}
 
 // src/theme/defaults.ts
 var DEFAULT_THEME = {
@@ -1887,14 +1867,13 @@ function buildTextStyle(defaults, fontFamily, textColor, width, overrides) {
     textAnchor: "start"
   };
 }
-function estimateLineCount(text, style, maxWidth, measureText, maxLines) {
+function estimateLineCount(text, style, maxWidth, measureText) {
   if (maxWidth <= 0) return 1;
   const segments = text.split("\n");
   if (segments.length > 1) {
-    const count = segments.reduce((total, segment) => {
+    return segments.reduce((total, segment) => {
       return total + (segment.length === 0 ? 1 : estimateLineCount(segment, style, maxWidth, measureText));
     }, 0);
-    return maxLines != null ? Math.min(count, maxLines) : count;
   }
   if (measureText) {
     const textWidth = measureText(text, style.fontSize, style.fontWeight).width;
@@ -1912,7 +1891,7 @@ function estimateLineCount(text, style, maxWidth, measureText, maxLines) {
         current2 = candidate;
       }
     }
-    return maxLines != null ? Math.min(lines2, maxLines) : lines2;
+    return lines2;
   }
   const charWidth = estimateCharWidth(style.fontSize, style.fontWeight);
   const maxChars = Math.floor(maxWidth / charWidth);
@@ -1929,7 +1908,7 @@ function estimateLineCount(text, style, maxWidth, measureText, maxLines) {
       current = candidate;
     }
   }
-  return maxLines != null ? Math.min(lines, maxLines) : lines;
+  return lines;
 }
 var FOOTNOTE_LINE_HEIGHT = 1.3;
 var FOOTNOTE_BAND_GAP = 4;
@@ -1957,14 +1936,12 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
       width,
       eyebrowNorm.style
     );
-    const maxLines = eyebrowNorm.style?.maxLines;
-    const lineCount = estimateLineCount(eyebrowNorm.text, style, maxWidth, measureText, maxLines);
+    const lineCount = estimateLineCount(eyebrowNorm.text, style, maxWidth, measureText);
     const element = {
       text: eyebrowNorm.text,
       x: pad2 + (eyebrowNorm.offset?.dx ?? 0),
       y: topY + (eyebrowNorm.offset?.dy ?? 0),
       maxWidth,
-      ...maxLines != null ? { maxLines } : {},
       style
     };
     topElements.eyebrow = element;
@@ -1979,14 +1956,12 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
       width,
       titleNorm.style
     );
-    const maxLines = titleNorm.style?.maxLines;
-    const lineCount = estimateLineCount(titleNorm.text, style, maxWidth, measureText, maxLines);
+    const lineCount = estimateLineCount(titleNorm.text, style, maxWidth, measureText);
     const element = {
       text: titleNorm.text,
       x: pad2 + (titleNorm.offset?.dx ?? 0),
       y: topY + (titleNorm.offset?.dy ?? 0),
       maxWidth,
-      ...maxLines != null ? { maxLines } : {},
       style
     };
     topElements.title = element;
@@ -2001,14 +1976,12 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
       width,
       subtitleNorm.style
     );
-    const maxLines = subtitleNorm.style?.maxLines;
-    const lineCount = estimateLineCount(subtitleNorm.text, style, maxWidth, measureText, maxLines);
+    const lineCount = estimateLineCount(subtitleNorm.text, style, maxWidth, measureText);
     const element = {
       text: subtitleNorm.text,
       x: pad2 + (subtitleNorm.offset?.dx ?? 0),
       y: topY + (subtitleNorm.offset?.dy ?? 0),
       maxWidth,
-      ...maxLines != null ? { maxLines } : {},
       style
     };
     topElements.subtitle = element;
@@ -2073,14 +2046,7 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
         width,
         item.norm.style
       );
-      const maxLines = item.norm.style?.maxLines;
-      const lineCount = estimateLineCount(
-        item.norm.text,
-        style,
-        bottomMaxWidth,
-        measureText,
-        maxLines
-      );
+      const lineCount = estimateLineCount(item.norm.text, style, bottomMaxWidth, measureText);
       const height = estimateTextHeight(style.fontSize, lineCount, style.lineHeight);
       bottomElements[item.key] = {
         text: item.norm.text,
@@ -2088,7 +2054,6 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
         y: bottomHeight + (item.norm.offset?.dy ?? 0),
         // offset from where bottom chrome starts
         maxWidth: bottomMaxWidth,
-        ...maxLines != null ? { maxLines } : {},
         style
       };
       bottomHeight += height + chromeGap;
@@ -4147,7 +4112,6 @@ export {
   textAscent,
   tileMap,
   truncateRotatedLabel,
-  truncateToWidth,
   wire,
   wrapText
 };