@opendata-ai/openchart-core 8.0.0-rc.8 → 8.0.0

package/dist/index.d.ts

@@ -31,8 +31,13 @@ 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. */
-type LegendPosition = 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
+/**
+ * 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';
 /** Annotation position strategy. */
 type AnnotationPosition = 'inline' | 'tooltip-only';
 /** Axis label density (controls tick count reduction). */
@@ -62,7 +67,12 @@ interface LayoutStrategy {
  *
  * Compact: minimal chrome, no inline labels, legend on top, reduced axes.
  * Medium: moderate labels, legend on top, reduced axes.
- * Full: all labels, legend on right, full axes.
+ * Full: all labels, legend on top, full axes.
+ *
+ * Legend position is 'top' at every breakpoint: a top legend reads as a key to
+ * the chart before the eye reaches the plot, and it keeps the plotting area
+ * full-width instead of surrendering a right-hand column. `legend.position`
+ * still overrides it per spec.
  *
  * Height constraints further reduce chrome and legend when container is short.
  */
@@ -427,6 +437,29 @@ declare function isGradientDef(value: unknown): value is GradientDef;
  * overlays that need a flat color.
  */
 declare function getRepresentativeColor(fill: string | GradientDef): string;
+/**
+ * Configuration for the scatter regression trend line. Passed as the object
+ * form of `MarkDef.trendline`.
+ */
+interface TrendlineConfig {
+    /**
+     * Stacking order relative to the point marks. `'below'` (default) draws the
+     * line behind the dots; `'above'` draws it on top so it stays visible over a
+     * dense cloud.
+     */
+    layer?: 'above' | 'below';
+    /**
+     * Stroke color. Defaults to the theme's high-contrast text color so the line
+     * reads on both light and dark grounds. Set an explicit CSS color to override.
+     */
+    stroke?: string;
+    /**
+     * Stroke width in pixels. Defaults to 1.5. Over a dense cloud with `layer:
+     * 'above'`, a heavier line (e.g. 2.5) stays legible where the thin default
+     * disappears into the dots.
+     */
+    strokeWidth?: number;
+}
 /**
  * Mark definition object with visual properties.
  *
@@ -474,7 +507,15 @@ interface MarkDef {
     endAngle?: number;
     /** Corner radius for rect/bar marks. 'pill' sets rx to half the bar thickness. */
     cornerRadius?: number | 'pill';
-    /** Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band. */
+    /**
+     * Bar/column marks: fixed bar thickness in pixels. When set, bars are this
+     * height (horizontal) or width (vertical), centered within the band.
+     *
+     * Point marks: the dot RADIUS in pixels (default 5, typical 2-12). This is
+     * NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of
+     * 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation
+     * rejects values above 50 with the conversion.
+     */
     size?: number;
     /** Whether the mark is filled (vs stroked only). */
     filled?: boolean;
@@ -496,8 +537,13 @@ interface MarkDef {
      * suppress it when the chart already carries its own reference line (e.g. a
      * manual x=y diagonal in a separate layer), which would otherwise produce
      * two competing diagonals.
+     *
+     * Pass an object to control stacking order: the line renders `below` the
+     * points by default, but a dense scatter (thousands of overlapping dots)
+     * fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the
+     * reference line over the cloud.
      */
-    trendline?: boolean;
+    trendline?: boolean | TrendlineConfig;
     /**
      * Horizontal pixel offset from the data anchor. Only meaningful when `type`
      * is `'text'`. Use it to lift a label clear of the mark it annotates instead
@@ -897,9 +943,13 @@ interface Encoding<TData extends DataRow = DataRow> {
      */
     color?: EncodingChannel<TData> | ConditionalValueDef<TData> | ValueDef;
     /**
-     * Size channel. Used by point/bubble charts to scale dot area by a quantitative field.
-     * Accepts a conditional definition to vary size based on data predicates,
-     * or a bare `{ value }` constant (VL aligned; expanded to `mark.size`).
+     * Size channel. Used by point/bubble charts to scale dots by a quantitative
+     * field, area-proportionally (sqrt curve). The units are dot RADII in px:
+     * `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }`
+     * constant expands to `mark.size`, also a radius. This differs from
+     * Vega-Lite, where point size is an area in px^2 -- VL-scale values
+     * (60-900) are rejected by validation with the conversion.
+     * Accepts a conditional definition to vary size based on data predicates.
      */
     size?: EncodingChannel<TData> | ConditionalValueDef<TData> | ValueDef;
     /**
@@ -963,6 +1013,20 @@ 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 {
@@ -972,13 +1036,40 @@ interface GraphEncodingChannel {
     type?: FieldType;
     /** Scale configuration. Auto-derived from data if omitted. */
     scale?: ScaleConfig;
+    /**
+     * Category ordering for the color domain and legend. Graph channels default
+     * `'ascending'` (VL-aligned, deterministic); `string[]` pins an explicit
+     * order; `null` keeps data order.
+     *
+     * NOTE: chart encoding channels keep data-order — this graph default is a
+     * deliberate divergence this release (see docs/migrating-v8.md).
+     */
+    sort?: 'ascending' | 'descending' | null | string[];
+    /**
+     * Category values to emphasize on load; the rest dim. Mirrors the chart
+     * `encoding.color.highlight` value list. Distinct from the `highlight()`
+     * runtime verb and `interaction.hover.mode`.
+     */
+    highlight?: string | string[];
 }
 /** Graph-specific encoding mapping visual properties to node/edge data fields. */
 interface GraphEncoding {
     /** Color mapping for nodes. */
     nodeColor?: GraphEncodingChannel;
-    /** Size mapping for nodes. */
+    /**
+     * Size mapping for nodes. `scale.type` defaults to `'sqrt'` (area-perceptual,
+     * today's behavior); set `scale.type: 'linear'` for a linear radius ramp.
+     * `scale.range` sets the pixel radius extent (default `[3, 12]`).
+     */
     nodeSize?: GraphEncodingChannel;
+    /**
+     * Opacity mapping for nodes (VL opacity channel). Quantitative fields map
+     * linearly to `[0.25, 1]`; `scale.range` overrides.
+     *
+     * NOTE: there is deliberately no `edgeOpacity` channel — edge alpha is owned
+     * by the interaction alpha-tier machinery (hover dimming, search).
+     */
+    nodeOpacity?: GraphEncodingChannel;
     /** Color mapping for edges. */
     edgeColor?: GraphEncodingChannel;
     /** Width mapping for edges. */
@@ -987,6 +1078,13 @@ interface GraphEncoding {
     edgeStyle?: GraphEncodingChannel;
     /** Label field for nodes. */
     nodeLabel?: GraphEncodingChannel;
+    /**
+     * Label priority mapping for nodes. Maps a quantitative field to a 0-1
+     * priority range; higher values are shown first as the user zooms in.
+     * Omit to use the default degree-based priority.
+     * `nodeOverrides[id].alwaysShowLabel` still wins as the hard override.
+     */
+    nodeLabelPriority?: GraphEncodingChannel;
 }
 /** Layout algorithm for graph visualization. */
 interface GraphLayoutConfig {
@@ -1007,6 +1105,31 @@ interface GraphLayoutConfig {
     linkStrength?: number;
     /** Whether to apply center force (default true). */
     centerForce?: boolean;
+    /**
+     * Deterministic layout seed. Same spec + seed ⇒ identical settled layout
+     * within a given execution path (worker vs sync parity is not guaranteed).
+     */
+    seed?: number;
+    /**
+     * Repulsion preset (plain-language, no d3 jargon):
+     * `gentle`/`balanced`/`energetic` → chargeStrength −150/−300/−600 and
+     * velocityDecay 0.5/0.4/0.3. A raw `chargeStrength` wins over the preset.
+     */
+    energy?: 'gentle' | 'balanced' | 'energetic';
+    /**
+     * Settle-speed preset: `quick`/`balanced`/`thorough` → alphaDecay
+     * 0.05/0.0228/0.01. Higher = faster cool-down, less final refinement.
+     */
+    settle?: 'quick' | 'balanced' | 'thorough';
+    /**
+     * Headless settle ticks run before the first paint. `true` → 100 ticks under
+     * a 250ms budget; a number sets an explicit tick count; `false` disables.
+     *
+     * Lives in `layout`, NOT `animation`, on purpose: warmup *reduces* motion, so
+     * it must survive `animation: false` (opt-out consumers get less settling
+     * chaos, not more).
+     */
+    warmup?: boolean | number;
 }
 /** Style overrides for a chrome text element. */
 interface ChromeTextStyle {
@@ -1018,6 +1141,14 @@ 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 {
@@ -1608,6 +1739,20 @@ interface AnimationPhaseConfig {
     /** Stagger config. true = defaults, false = no stagger. Default: true for enter. */
     stagger?: AnimationStagger | boolean;
 }
+/**
+ * Data-update phase config. Adds `maxMarks` on top of the shared phase
+ * options; the cap is meaningless for enter/exit, which animate via CSS.
+ */
+interface UpdatePhaseConfig extends AnimationPhaseConfig {
+    /**
+     * Maximum mark count that still runs a tweened data-update transition.
+     * Default: 500. Above the cap the chart swaps instantly instead, because
+     * per-frame SVG attribute writes on thousands of elements drop frames on
+     * low-end devices. Raise it deliberately when the audience is desktop-heavy
+     * and you have measured the frame budget.
+     */
+    maxMarks?: number;
+}
 /**
  * Full animation config object. Structured as enter/update/exit phases
  * following Vega's encoding set model.
@@ -1616,7 +1761,7 @@ interface AnimationConfig {
     /** Entrance animation when chart first renders. */
     enter?: AnimationPhaseConfig | boolean;
     /** Transition animation when data updates. */
-    update?: AnimationPhaseConfig | boolean;
+    update?: UpdatePhaseConfig | boolean;
     /** Exit animation when marks are removed. */
     exit?: AnimationPhaseConfig | boolean;
     /** Delay before annotations animate in (ms after marks). Default: 200. */
@@ -1871,6 +2016,20 @@ 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
@@ -1937,7 +2096,12 @@ 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. Hidden series remain in the legend but are visually dimmed. */
+    /**
+     * 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.
+     */
     hiddenSeries?: string[];
     /** Per-series visual overrides, keyed by series name (the color field value). */
     seriesStyles?: Record<string, SeriesStyle>;
@@ -2190,6 +2354,70 @@ interface NodeOverride {
     /** Force label to always show regardless of zoom/priority. */
     alwaysShowLabel?: boolean;
 }
+/**
+ * Per-phase and per-behavior motion config for a graph.
+ *
+ * DEFAULT-ON semantics (deliberately different from charts, which are opt-in):
+ * omit `animation` → the resolver returns full defaults; `animation: false` →
+ * no choreography (but `layout.warmup` still applies); a per-phase `false`
+ * disables just that phase. Graphs are default-on because physics motion
+ * already exists on load and choreography reduces the chaos.
+ */
+interface GraphAnimationConfig {
+    /** Node/edge reveal on first render. Default `{ duration: 500, ease: 'smooth', stagger: true }`. */
+    enter?: AnimationPhaseConfig | boolean;
+    /** Data-update enter-fade for newly added marks. Default `{ duration: 300, ease: 'smooth' }`. */
+    update?: AnimationPhaseConfig | boolean;
+    /** Ghost fade-out for removed marks. Default `{ duration: 300, ease: 'smooth' }`. */
+    exit?: AnimationPhaseConfig | boolean;
+    /** Camera flight easing. Default duration `'auto'` (derived from the zoom distance). */
+    camera?: {
+        duration?: number;
+        ease?: AnimationEase;
+    } | boolean;
+    /** Hover emphasis crossfade. Default `{ duration: 150, ease: 'smooth' }`. */
+    hover?: {
+        duration?: number;
+        ease?: AnimationEase;
+    } | boolean;
+}
+/**
+ * Graph motion spec.
+ * - omitted → full defaults (default-ON)
+ * - `false` → no choreography (warmup still applies)
+ * - object → per-phase control
+ *
+ * `prefers-reduced-motion` is always respected regardless of this value.
+ */
+type GraphAnimationSpec = boolean | GraphAnimationConfig;
+/** Interaction behavior for a graph (hover mode, select-fly, opt-in physics). */
+interface GraphInteractionConfig {
+    /**
+     * Hover emphasis behavior. `neighbors` (default) lights the hovered node and
+     * its adjacency; `category` lights same-category nodes; `node` lights only the
+     * hovered node; `none` disables. `dimOpacity` (default 0.15) is the node dim
+     * tier. Named `mode` (not `highlight`) to avoid colliding with the three other
+     * meanings of "highlight" (the encoding value list, the `highlight()` verb).
+     */
+    hover?: {
+        mode?: 'neighbors' | 'category' | 'node' | 'none';
+        dimOpacity?: number;
+    };
+    /** Selecting a node flies the camera to it. Default `false`. */
+    select?: {
+        flyTo?: boolean;
+    };
+    /**
+     * Opt-in cursor repulsion (nodes drift away from the pointer). Disabled under
+     * `prefers-reduced-motion` and above the node-count gate.
+     */
+    cursorRepulsion?: boolean | {
+        radius?: number;
+        strength?: number;
+    };
+    /** Opt-in springy node drag (user-initiated; no reduced-motion gate). */
+    springyDrag?: boolean;
+}
 interface GraphSpec {
     /** Discriminant: always "graph". */
     type: 'graph';
@@ -2211,6 +2439,21 @@ interface GraphSpec {
     theme?: ThemeConfig;
     /** Dark mode behavior. */
     darkMode?: DarkMode;
+    /**
+     * Motion configuration. DEFAULT-ON: omit for full defaults, `false` to opt
+     * out of choreography (layout warmup still applies).
+     */
+    animation?: GraphAnimationSpec;
+    /** Interaction behavior (hover mode, select-fly, opt-in physics). */
+    interaction?: GraphInteractionConfig;
+    /**
+     * Built-in legend. Interactive by default. Set `false` if you render your own
+     * legend, so the built-in filter UI doesn't compete with it.
+     */
+    legend?: boolean | {
+        interactive?: boolean;
+        counts?: boolean;
+    };
     /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
     watermark?: boolean;
 }
@@ -2265,7 +2508,16 @@ interface LayerSpec<TData extends DataRow = DataRow> {
     height?: number;
     /** Accepted for Vega-Lite compatibility and ignored (with a compile warning). */
     $schema?: string;
-    /** Annotations on the layered view. */
+    /**
+     * 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?: Annotation[];
     /** Label display configuration. `false` disables all labels, `true` uses defaults. */
     labels?: LabelSpec;
@@ -2281,7 +2533,12 @@ interface LayerSpec<TData extends DataRow = DataRow> {
     watermark?: boolean;
     /** Resolution strategy for shared scales/axes/legends. */
     resolve?: ResolveConfig;
-    /** Hidden series names. */
+    /**
+     * 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.
+     */
     hiddenSeries?: string[];
     /** Endpoint labels column, inherited by child layers that don't set their own. */
     endpointLabels?: boolean | EndpointLabelsConfig;
@@ -2422,32 +2679,32 @@ interface TileMapSpec {
     valueFormat?: string;
 }
 /** Supported map projections. */
-type MapProjection = 'albersUsa' | 'mercator' | 'equalEarth' | 'identity';
+type GeoMapProjection = '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 | {
+type GeoMapPointsFocus = true | {
     field: string;
     value: string | number;
 };
-type MapFocus = string | number | Array<string | number> | {
+type GeoMapFocus = string | number | Array<string | number> | {
     features: string | number | Array<string | number>;
     padding?: number;
 } | {
-    points: MapPointsFocus;
+    points: GeoMapPointsFocus;
     padding?: number;
 };
 /** Geo configuration for map specs. */
-interface MapGeo {
+interface GeoMapGeo {
     /** TopoJSON topology object. User imports this from us-atlas, world-atlas, or their own source. */
     features: unknown;
     /** Field in the TopoJSON feature properties to use as the join key. Defaults to 'id'. */
     idField?: string;
     /** Map projection. Defaults to 'albersUsa'. */
-    projection?: MapProjection;
+    projection?: GeoMapProjection;
     /**
      * 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
@@ -2456,10 +2713,10 @@ interface MapGeo {
      * `{ 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?: MapFocus | null;
+    focus?: GeoMapFocus | null;
 }
 /** Encoding channels specific to map visualizations. */
-interface MapEncoding {
+interface GeoMapEncoding {
     /** Join key field in the data. Required for choropleth; optional in basemap-only mode (points layer with empty data). */
     key?: EncodingChannel;
     /** Color encoding (quantitative or nominal). Drives fill color of features. Optional when a points layer is present (basemap-only mode). */
@@ -2468,7 +2725,7 @@ interface MapEncoding {
     tooltip?: EncodingChannel | EncodingChannel[];
 }
 /** Point/symbol layer rendered above choropleth features. */
-interface MapPointsLayer {
+interface GeoMapPointsLayer {
     /** Tabular data for the points. Independent of the choropleth data join. */
     data: DataRow[];
     /** Field holding longitude (x coordinate). */
@@ -2479,22 +2736,23 @@ interface MapPointsLayer {
     size?: EncodingChannel;
     /** Optional color encoding (nominal or quantitative). Independent scale from choropleth. */
     color?: EncodingChannel;
-    /** Tooltip channel(s), same shape as MapEncoding.tooltip. */
+    /** Tooltip channel(s), same shape as GeoMapEncoding.tooltip. */
     tooltip?: EncodingChannel | EncodingChannel[];
-    /** Stable id for event callbacks. Data-update transitions for points are not yet supported. */
+    /** Stable id for event callbacks, and the key used to match points across
+     * renders so fill, radius, and position tween on data update. */
     key?: EncodingChannel;
     /** Fill opacity for point circles. Default 0.65. Range 0-1. */
     opacity?: number;
 }
-interface MapSpec {
+interface GeoMapSpec {
     /** Discriminant: always "map". */
     type: 'map';
     /** Geo configuration: TopoJSON features, join key, and projection. */
-    geo: MapGeo;
+    geo: GeoMapGeo;
     /** Tabular data to join to geo features. */
     data: DataRow[];
     /** Encoding channels mapping data fields to visual properties. */
-    encoding: MapEncoding;
+    encoding: GeoMapEncoding;
     /** Editorial chrome (title, subtitle, source, byline, footer). */
     chrome?: Chrome;
     /** Legend display configuration. */
@@ -2506,7 +2764,7 @@ interface MapSpec {
     /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
     watermark?: boolean;
     /** Optional point/symbol layer rendered above choropleth features. */
-    points?: MapPointsLayer;
+    points?: GeoMapPointsLayer;
     /** Animation configuration for entrance animations. */
     animation?: AnimationSpec;
     /**
@@ -2571,7 +2829,7 @@ interface BarListEncoding {
  * - GraphSpec: has `type: 'graph'`
  * - SankeySpec: has `type: 'sankey'`
  * - TileMapSpec: has `type: 'tilemap'`
- * - MapSpec: has `type: 'map'`
+ * - GeoMapSpec: has `type: 'map'`
  * - BarListSpec: has `type: 'barlist'`
  *
  * Election parliament (hemicycle) charts are `ChartSpec` with `mark:
@@ -2581,7 +2839,7 @@ interface BarListEncoding {
  * for free instead of a second bespoke compile path (see
  * `packages/engine/src/charts/parliament/`).
  */
-type VizSpec = ChartSpec | LayerSpec | TableSpec | GraphSpec | SankeySpec | TileMapSpec | MapSpec | BarListSpec;
+type VizSpec = ChartSpec | LayerSpec | TableSpec | GraphSpec | SankeySpec | TileMapSpec | GeoMapSpec | BarListSpec;
 /**
  * Chart spec without runtime data, for persistence/storage.
  * Generic: `ChartSpecWithoutData<MyRow>` constrains encoding field names.
@@ -2596,13 +2854,13 @@ type SankeySpecWithoutData = Omit<SankeySpec, 'data'>;
 /** TileMap spec without runtime data, for persistence/storage. */
 type TileMapSpecWithoutData = Omit<TileMapSpec, 'data'>;
 /** Map spec without runtime data, for persistence/storage. */
-type MapSpecWithoutData = Omit<MapSpec, 'data' | 'points'> & {
-    points?: Omit<MapPointsLayer, 'data'>;
+type GeoMapSpecWithoutData = Omit<GeoMapSpec, 'data' | 'points'> & {
+    points?: Omit<GeoMapPointsLayer, 'data'>;
 };
 /** BarList spec without runtime data, for persistence/storage. */
 type BarListSpecWithoutData = Omit<BarListSpec, 'data'>;
 /** Union of data-stripped spec types for persistence/storage. */
-type StoredVizSpec = ChartSpecWithoutData | TableSpecWithoutData | GraphSpecWithoutData | SankeySpecWithoutData | TileMapSpecWithoutData | MapSpecWithoutData | BarListSpecWithoutData;
+type StoredVizSpec = ChartSpecWithoutData | TableSpecWithoutData | GraphSpecWithoutData | SankeySpecWithoutData | TileMapSpecWithoutData | GeoMapSpecWithoutData | BarListSpecWithoutData;
 /** Logical AND combinator for filter predicates. */
 interface LogicalAnd<T> {
     and: T[];
@@ -2831,8 +3089,8 @@ declare function isSankeySpec(spec: VizSpec | Record<string, unknown>): spec is
 declare function isTileMapSpec(spec: VizSpec | Record<string, unknown>): spec is TileMapSpec;
 /** Check if a spec is a BarListSpec. */
 declare function isBarListSpec(spec: VizSpec | Record<string, unknown>): spec is BarListSpec;
-/** Check if a spec is a MapSpec. */
-declare function isMapSpec(spec: VizSpec | Record<string, unknown>): spec is MapSpec;
+/** Check if a spec is a GeoMapSpec. */
+declare function isGeoMapSpec(spec: VizSpec | Record<string, unknown>): spec is GeoMapSpec;
 /** Check if an annotation is a TextAnnotation. */
 declare function isTextAnnotation(annotation: Annotation): annotation is TextAnnotation;
 /** Check if an annotation is a RangeAnnotation. */
@@ -2942,26 +3200,36 @@ 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) => ElementRef;
-    readonly chrome: (key: ChromeKey) => ElementRef;
-    readonly seriesLabel: (series: string) => ElementRef;
-    readonly legend: () => ElementRef;
-    readonly legendEntry: (series: string, index: number) => 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;
 };
 /**
  * Discriminated union of all element edit events.
@@ -2976,21 +3244,31 @@ 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;
@@ -3003,10 +3281,21 @@ 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;
@@ -3042,6 +3331,14 @@ 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. */
@@ -3138,6 +3435,12 @@ 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;
 }
@@ -3746,6 +4049,8 @@ interface LegendEntry {
     active?: boolean;
     /** True for overflow indicator entries ("+N more"). Not interactive. */
     overflow?: boolean;
+    /** Node/edge count for this category (graph legends). Additive; undefined elsewhere. */
+    count?: number;
 }
 /** The encoding channel a legend keys. */
 type LegendChannel = 'color' | 'size';
@@ -3762,8 +4067,9 @@ interface BaseLegendLayout {
      * read them silently pick whichever comes first.
      */
     channel?: LegendChannel;
-    /** Where the legend is positioned relative to the chart area. */
-    position: 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
+    /** 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';
     /** Bounding box for the legend (pixel coordinates). */
     bounds: Rect;
     /** Entry label style. */
@@ -3983,6 +4289,12 @@ interface A11yMetadata {
     altText: string;
     /** Tabular data fallback for screen readers. Each inner array is a row. */
     dataTableFallback: unknown[][];
+    /**
+     * True row count of the underlying data. Only set when `dataTableFallback`
+     * was truncated, so its presence is the signal that rows are missing and the
+     * caption should name the total.
+     */
+    totalRows?: number;
     /** ARIA role for the visualization root element. */
     role: string;
     /** Whether the visualization is keyboard-navigable. */
@@ -4005,6 +4317,12 @@ interface ResolvedAnimationPhase {
     staggerDelay: number;
     /** Stagger ordering. */
     staggerOrder: 'index' | 'value' | 'reverse';
+    /**
+     * Author-set cap on the mark count that still runs a tweened data-update
+     * transition (update phase only). Present only when explicitly set on the
+     * spec — the renderer supplies the default so it can vary by render mode.
+     */
+    maxMarks?: number;
 }
 /** Resolved animation config. A phase is present iff that phase is enabled. */
 interface ResolvedAnimation {
@@ -4093,6 +4411,23 @@ 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
@@ -4145,6 +4480,7 @@ interface FacetPanelLayout {
         y: number;
         fontSize: number;
         fontWeight: number;
+        textAnchor?: 'start' | 'middle' | 'end';
     };
 }
 /** Layout for a faceted (small-multiples) chart. */
@@ -4157,6 +4493,8 @@ 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.
@@ -4231,8 +4569,22 @@ 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;
+    /**
+     * Resolved rendering backend for point marks. Absent means `'svg'`.
+     *
+     * ADVISORY metadata only: it tells the mount and export layers that a canvas
+     * mark layer is worth creating for this layout. The SVG renderer keys solely
+     * on its own `canvasMarks` render option and never reads this field, so a
+     * server-side or export render of a canvas-mode layout still produces
+     * full-fidelity SVG.
+     */
+    markRenderMode?: 'svg' | 'canvas';
 }
 /** A resolved column definition with computed properties. */
 interface ResolvedColumn {
@@ -4648,7 +5000,7 @@ interface CompileWarning {
     context?: Record<string, unknown>;
 }
 /** Resolved focus target for map camera framing. */
-interface MapFocusLayout {
+interface GeoMapFocusLayout {
     target: {
         x: number;
         y: number;
@@ -4659,7 +5011,7 @@ interface MapFocusLayout {
     ids: Array<string | number>;
 }
 /** A resolved map feature mark with computed SVG path and fill. */
-interface MapFeatureMark {
+interface GeoMapFeatureMark {
     type: 'map-feature';
     /** SVG path `d` attribute for this feature's shape. */
     path: string;
@@ -4690,7 +5042,7 @@ interface MapFeatureMark {
     centroid: [number, number];
 }
 /** A resolved map point mark with projected coordinates and visual properties. */
-interface MapPointMark {
+interface GeoMapPointMark {
     type: 'map-point';
     /** Projected center x in map-local coordinates. */
     cx: number;
@@ -4716,7 +5068,7 @@ interface MapPointMark {
     animationIndex: number;
 }
 /** Border paths for the map (interior borders and coastline/outline). */
-interface MapBorders {
+interface GeoMapBorders {
     /** SVG path `d` for interior borders between features. */
     interiorPath: string;
     /** SVG path `d` for the outer boundary / coastline. */
@@ -4727,23 +5079,23 @@ interface MapBorders {
     outlineStroke: string;
 }
 /**
- * MapLayout: the complete engine output for map visualizations.
+ * GeoMapLayout: the complete engine output for map visualizations.
  *
  * Contains everything an adapter needs to render the map: dimensions,
  * chrome, feature paths, borders, legend, tooltip descriptors, and
  * accessibility metadata.
  */
-interface MapLayout {
+interface GeoMapLayout {
     /** The map drawing area (after chrome and legend are subtracted). */
     area: Rect;
     /** Resolved chrome text elements with positions and styles. */
     chrome: ResolvedChrome;
     /** Resolved feature marks with paths, fills, and joined data. */
-    features: MapFeatureMark[];
+    features: GeoMapFeatureMark[];
     /** Border paths (interior mesh and outline). */
-    borders: MapBorders;
+    borders: GeoMapBorders;
     /** Resolved point marks for the symbol layer (empty array if no points layer). */
-    pointMarks: MapPointMark[];
+    pointMarks: GeoMapPointMark[];
     /** Categorical legend for the point color channel (null if no point color). */
     pointCategoricalLegend: CategoricalLegendLayout | null;
     /** Continuous legend for the point color channel (null if no point color). */
@@ -4776,7 +5128,7 @@ interface MapLayout {
         height: number;
     };
     /** Resolved focus target for camera framing (null if no focus). */
-    focus: MapFocusLayout | null;
+    focus: GeoMapFocusLayout | null;
 }
 /** A resolved bar list row with computed positions and visual properties. */
 interface BarListRowMark {
@@ -4867,6 +5219,14 @@ 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;
     /**
@@ -4877,6 +5237,26 @@ interface CompileOptions {
      * before calling compile. The engine always receives a resolved boolean.
      */
     darkMode?: boolean;
+    /**
+     * Rendering backend for point marks, mirroring vega-embed's `renderer`
+     * embed option: backend choice is host policy, not part of the spec.
+     * High-cardinality scatter plots draw thousands of SVG circles, which is
+     * what makes their entrance and update transitions stutter; a canvas layer
+     * draws the same dots in a handful of batched paint calls.
+     *
+     * - `'auto'` (default): canvas above 1,000 compiled point marks, SVG below.
+     * - `'svg'`: always SVG, whatever the point count.
+     * - `'canvas'`: always canvas, whatever the point count.
+     *
+     * Canvas mode trades per-mark keyboard focus and edit-mode point selection
+     * (the screen-reader data table still carries every row), and draws the
+     * trendline above the dots even when `trendline.layer` is `'below'`.
+     * Tooltips, hover, and click callbacks work the same in both modes.
+     *
+     * Ignored with a console warning for non-point marks, and for faceted,
+     * layered, and sparkline charts.
+     */
+    renderer?: 'auto' | 'svg' | 'canvas';
     /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
     watermark?: boolean;
     /**
@@ -4925,6 +5305,13 @@ interface CompileOptions {
      * different area than the one the axes are rendered in.
      */
     frozenChartArea?: Rect;
+    /**
+     * Marks this compile as one leaf (or the primary spec) of a multi-leaf layer.
+     * Set by compileLayer; callers should not set it. Only consumer today is the
+     * canvas mark-layer resolution, which refuses canvas mode for layered charts
+     * because the layer layout concatenates marks from several compiles.
+     */
+    layered?: boolean;
 }
 /** Extended compile options for table visualizations. */
 interface CompileTableOptions extends CompileOptions {
@@ -5445,12 +5832,20 @@ declare function computeXAxisExtentFromLabels(input: XAxisExtentInput): number;
  */
 declare function maxRotatedLabelWidth(tickAngle: number, tickFontSize: number): number;
 /**
- * Truncate a rotated tick label with an ellipsis so it fits inside the capped
- * reservation. Returns the label unchanged when it already fits.
+ * 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.
+ */
 declare function truncateRotatedLabel(label: string, tickAngle: number, tickFontSize: number, tickFontWeight: number, measure?: (text: string, fontSize: number, fontWeight?: number) => number): string;
 
 /**
@@ -5627,12 +6022,22 @@ declare function buildTemporalFormatter(formatStr: string | undefined): ((value:
  * @param data - The data array.
  */
 declare function generateAltText(spec: ChartSpec, data: DataRow[]): string;
+/**
+ * Maximum number of data rows in the screen-reader table. A 50k-point scatter
+ * would otherwise put 50k hidden rows in the DOM.
+ */
+declare const MAX_SR_TABLE_ROWS = 1000;
 /**
  * Generate a tabular data fallback for screen readers.
  *
  * Returns a 2D array where the first row is headers and subsequent
  * rows are data values. Only includes fields referenced in the encoding.
  *
+ * Data rows are capped at MAX_SR_TABLE_ROWS (the header row does not count
+ * against the cap). SCOPE: this caps the chart compile path only. Graph,
+ * sankey, tilemap and map build their `dataTableFallback` independently and
+ * stay uncapped.
+ *
  * @param spec - The chart spec.
  * @param data - The data array.
  */
@@ -5885,4 +6290,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 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 };
+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 GeoMapBorders, type GeoMapEncoding, type GeoMapFeatureMark, type GeoMapFocus, type GeoMapFocusLayout, type GeoMapGeo, type GeoMapLayout, type GeoMapPointMark, type GeoMapPointsLayer, type GeoMapProjection, type GeoMapSpec, type GeoMapSpecWithoutData, type GradientColorStop, type GradientDef, type GradientLegendLayout, type GradientStop, type GraphAnimationConfig, type GraphAnimationSpec, type GraphChannelRule, type GraphEdge, type GraphEdgeLayout, type GraphEncoding, type GraphEncodingChannel, type GraphInteractionConfig, 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, MAX_SR_TABLE_ROWS, 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 UpdatePhaseConfig, 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, isGeoMapSpec, isGradientDef, isGraphSpec, isLayerSpec, 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 };