@opendata-ai/openchart-core 6.28.5 → 7.0.0

package/dist/index.d.ts

@@ -261,10 +261,13 @@ interface MarkDef {
      * Show point markers on line/area marks.
      * - true: filled circles at each data point
      * - 'transparent': invisible hover targets (legacy behavior)
-     * - 'endpoints': show only first and last point per series
+     * - 'endpoints': show only first and last point per series (hollow dots)
+     * - 'last' / 'first': show only the last (or first) point — filled dot,
+     *   no white halo. Useful for highlighting the latest reading on a line
+     *   chart and the default for sparkline mode.
      * - false: no point marks (default; uses voronoi overlay for tooltips)
      */
-    point?: boolean | 'transparent' | 'endpoints';
+    point?: boolean | 'transparent' | 'endpoints' | 'last' | 'first';
     /**
      * Curve interpolation for line/area marks.
      * Maps to d3-shape curve factories.
@@ -333,6 +336,14 @@ interface AxisConfig {
     labelColor?: string;
     /** Secondary data field to display alongside each tick label. Renders in lighter weight/color. Only effective on categorical y-axis labels (horizontal bar charts). */
     labelField?: string;
+    /**
+     * Where tick labels render relative to the chart area. Editorial line/area
+     * y-axes default to `'inline'`: labels sit above their gridlines at the
+     * chart's left edge, with no left gutter, axis line, or tick marks. Other
+     * axis types default to `'gutter'` (the classic placement outside the chart
+     * area).
+     */
+    tickPosition?: 'inline' | 'gutter';
 }
 /** Scale configuration for an encoding channel. */
 interface ScaleConfig {
@@ -373,10 +384,21 @@ type ScaleType = 'linear' | 'log' | 'pow' | 'sqrt' | 'symlog' | 'time' | 'utc' |
  * Follows the Vega-Lite encoding model: field identifies the column,
  * type determines how the engine interprets values, aggregate applies
  * a transformation before encoding.
+ *
+ * @template TData - The shape of a data row. When `ChartSpec<TData>` is used
+ * with a typed data array, `field` is constrained to `keyof TData & string`,
+ * giving IDE autocomplete and compile-time typo detection. Defaults to `DataRow`
+ * which degrades to plain `string` (no constraint), keeping untyped specs working.
  */
-interface EncodingChannel {
-    /** Data field name (column in the data array). */
-    field: string;
+interface EncodingChannel<TData extends DataRow = DataRow> {
+    /**
+     * Data field name (column in the data array).
+     *
+     * When using `ChartSpec<TData>` with a typed data array, this is constrained
+     * to the actual column names of `TData`. Typos fail at compile time and IDEs
+     * autocomplete your column names.
+     */
+    field: keyof TData & string;
     /**
      * How to interpret the field values.
      * - quantitative: continuous numbers (scale: linear)
@@ -393,18 +415,33 @@ interface EncodingChannel {
     scale?: ScaleConfig;
     /**
      * Stacking behavior for quantitative channels (Vega-Lite aligned).
-     * - undefined | true | 'zero': stack from zero baseline (default)
+     *
+     * Vega-Lite accepts `'zero' | 'normalize' | 'center' | null`. OpenChart adds
+     * `true` (sugar for `'zero'`) and `false` (sugar for `null`) so callers can
+     * write `stack: true` / `stack: false` without learning the string forms.
+     * The string forms are still the canonical input — the boolean shorthand is
+     * normalized to the matching string before reaching layout.
+     *
+     * - undefined: chart-type default (see below)
+     * - true | 'zero': stack from zero baseline
      * - 'normalize': stack and normalize to fraction of total (0-1 per category)
      * - 'center': center stacks around zero (streamgraph style)
-     * - null | false: no stacking -- renders grouped (side-by-side) bars instead
+     * - null | false: no stacking -- renders overlap (area) or grouped/dodged (bar)
      *
-     * Use `stack: null` to get grouped/dodged bars. This is the idiomatic way to
-     * compare values across categories side-by-side rather than stacked on top of
-     * each other. Without it, multi-series bar data stacks by default.
+     * **Defaults differ by chart type:**
+     * - **Bar**: defaults to stacked. Use `stack: null` for grouped (side-by-side) bars.
+     * - **Area**: defaults to overlap (v6 breaking change). Use `stack: 'zero'` (or `true`)
+     *   to opt into stacked areas. Each overlapping series renders as a translucent
+     *   gradient band anchored at the y-domain baseline.
+     * - **Line**: stacking is not applied (lines always overlap).
      *
      * @example
      * // Side-by-side grouped bars (comparing 2018 vs 2022 wages by firm size):
      * "x": { "field": "pay", "type": "quantitative", "stack": null }
+     *
+     * @example
+     * // Stacked area (opt-in; default is overlap):
+     * "y": { "field": "value", "type": "quantitative", "stack": "zero" }
      */
     stack?: boolean | 'zero' | 'normalize' | 'center' | null;
     /**
@@ -445,44 +482,97 @@ interface EncodingChannel {
 }
 /**
  * Encoding object mapping visual channels to data fields.
- * Which channels are required depends on the mark type.
- * See MARK_ENCODING_RULES in encoding.ts for per-type requirements.
- */
-interface Encoding {
-    /** Horizontal position channel. */
-    x?: EncodingChannel;
-    /** Vertical position channel. */
-    y?: EncodingChannel;
-    /** Color channel (series differentiation or heatmap). Accepts conditional definitions. */
-    color?: EncodingChannel | ConditionalValueDef;
-    /** Size channel (bubble charts, dot plots). Accepts conditional definitions. */
-    size?: EncodingChannel | ConditionalValueDef;
-    /** Detail channel (group without encoding to a visual property). */
-    detail?: EncodingChannel;
-    /** Secondary x position (for ranges, error bars). */
-    x2?: EncodingChannel;
-    /** Secondary y position (for ranges, error bars). */
-    y2?: EncodingChannel;
-    /** Data-driven opacity (0-1). Accepts conditional definitions. */
-    opacity?: EncodingChannel | ConditionalValueDef;
-    /** Point shape encoding (circle, square, diamond, triangle-up, etc.). */
-    shape?: EncodingChannel;
-    /** Data-driven stroke dash patterns. */
-    strokeDash?: EncodingChannel;
-    /** Rotation angle encoding. */
-    angle?: EncodingChannel;
-    /** Text content for text marks. */
-    text?: EncodingChannel;
-    /** Tooltip field(s). Can be a single channel or array. */
-    tooltip?: EncodingChannel | EncodingChannel[];
-    /** Hyperlink encoding. */
-    href?: EncodingChannel;
-    /** Stacking/drawing order. */
-    order?: EncodingChannel;
-    /** Angular position for arc marks. */
-    theta?: EncodingChannel;
-    /** Radial position for arc marks. */
-    radius?: EncodingChannel;
+ * Which channels are required depends on the mark type — see the per-mark
+ * encoding interfaces (ArcEncoding, LineEncoding, etc.) and MARK_ENCODING_RULES
+ * in encoding.ts for the full requirements table.
+ *
+ * @template TData - Propagated from ChartSpec<TData>. Constrains `field` in
+ * every channel to `keyof TData & string` when a typed data row is provided.
+ */
+interface Encoding<TData extends DataRow = DataRow> {
+    /**
+     * Horizontal position channel. Required for: bar, line, area, point, tick, rect, lollipop.
+     * Maps a field to the x-axis. Use `type: 'temporal'` for dates, `'nominal'` for categories,
+     * `'quantitative'` for numbers.
+     */
+    x?: EncodingChannel<TData>;
+    /**
+     * Vertical position channel. Required for: bar, line, area, point, tick, rect, arc, lollipop.
+     * For arc marks, this is the value field (slice size). For all others it's the y-axis position.
+     */
+    y?: EncodingChannel<TData>;
+    /**
+     * Color channel. Required for arc marks (determines pie/donut slice coloring).
+     * Optional for all other marks -- used for series differentiation on multi-series charts,
+     * or heatmap intensity. Accepts a conditional definition to apply colors based on data predicates.
+     */
+    color?: EncodingChannel<TData> | ConditionalValueDef<TData>;
+    /**
+     * 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.
+     */
+    size?: EncodingChannel<TData> | ConditionalValueDef<TData>;
+    /**
+     * Detail channel. Groups data into multiple series without mapping to a visual property.
+     * Useful when you want separate lines per category but don't need the color to differ.
+     */
+    detail?: EncodingChannel<TData>;
+    /**
+     * Secondary x position. Used with `x` to define a horizontal span (rect marks, error bars).
+     * Both `x` and `x2` must be quantitative.
+     */
+    x2?: EncodingChannel<TData>;
+    /**
+     * Secondary y position. Used with `y` to define a vertical span (rect marks, error bands).
+     * Both `y` and `y2` must be quantitative.
+     */
+    y2?: EncodingChannel<TData>;
+    /**
+     * Data-driven opacity (0-1 range). Accepts a conditional definition to vary opacity
+     * based on data predicates (e.g., highlight selected points).
+     */
+    opacity?: EncodingChannel<TData> | ConditionalValueDef<TData>;
+    /**
+     * Point shape encoding. Valid values: 'circle', 'square', 'diamond', 'triangle-up',
+     * 'triangle-down', 'cross'. Used on point/scatter marks to differentiate series by shape.
+     */
+    shape?: EncodingChannel<TData>;
+    /**
+     * Stroke dash pattern encoding. Maps a nominal field to different dash patterns
+     * on line marks. Useful when color alone doesn't distinguish series well.
+     */
+    strokeDash?: EncodingChannel<TData>;
+    /** Rotation angle encoding for point marks. Maps a quantitative field to 0-360 degrees. */
+    angle?: EncodingChannel<TData>;
+    /**
+     * Text content for `text` marks. Required when mark is `'text'`.
+     * Not meaningful for other mark types.
+     */
+    text?: EncodingChannel<TData>;
+    /**
+     * Tooltip field(s). Shown on hover. Can be a single channel or an array for
+     * multi-field tooltips. Independent of the x/y/color encoding.
+     */
+    tooltip?: EncodingChannel<TData> | EncodingChannel<TData>[];
+    /** Hyperlink encoding. Maps a field containing URLs to clickable marks. */
+    href?: EncodingChannel<TData>;
+    /**
+     * Drawing order. Controls z-order and stacking sort order for bar/area marks.
+     * Lower values are drawn first (behind higher values).
+     */
+    order?: EncodingChannel<TData>;
+    /**
+     * Angular position for arc marks (pie/donut).
+     * Optional -- defaults to the `y` channel value when omitted.
+     * Not used by any other mark type.
+     */
+    theta?: EncodingChannel<TData>;
+    /**
+     * Radial distance from center for arc marks.
+     * Optional -- only meaningful on donut charts (controls inner radius boundary).
+     * Not used by any other mark type.
+     */
+    radius?: EncodingChannel<TData>;
 }
 /** Encoding channel for graph nodes and edges. */
 interface GraphEncodingChannel {
@@ -549,11 +639,18 @@ interface ChromeText {
     offset?: AnnotationOffset;
 }
 /**
- * Editorial chrome elements: title, subtitle, source attribution, byline, footer.
+ * Editorial chrome elements: eyebrow, title, subtitle, source attribution, byline, footer.
  * These are first-class structural elements, not string-only afterthoughts.
  * Each element can be a simple string or a ChromeText object with style overrides.
  */
 interface Chrome {
+    /**
+     * Editorial kicker/category label rendered above the title. Typically
+     * uppercase, tracked, and tinted with the accent color (e.g.
+     * "Equities · Single Ticker"). Term follows IBM Carbon and Atlassian
+     * Design System conventions; not part of Vega-Lite's title model.
+     */
+    eyebrow?: string | ChromeText;
     /** Main title displayed above the visualization. */
     title?: string | ChromeText;
     /** Subtitle displayed below the title, typically providing context. */
@@ -564,6 +661,12 @@ interface Chrome {
     byline?: string | ChromeText;
     /** Footer text, displayed at the very bottom. */
     footer?: string | ChromeText;
+    /**
+     * Right-anchored brand block on the footer row, paired with a small accent
+     * dot to its left. Visually balances the source/byline left-anchored text.
+     * When set, suppresses the default `tryOpenData.ai` watermark for this chart.
+     */
+    brand?: string | ChromeText;
 }
 /** Pixel offset for fine-grained annotation positioning. */
 interface AnnotationOffset {
@@ -574,6 +677,17 @@ interface AnnotationOffset {
 }
 /** Anchor direction for annotation label placement relative to the data point. */
 type AnnotationAnchor = 'top' | 'bottom' | 'left' | 'right' | 'auto';
+/** Style overrides for the dot marker drawn at the connector's data-point endpoint. */
+interface AnnotationDot {
+    /** Circle radius in pixels. Default 5. */
+    radius?: number;
+    /** Fill color. Defaults to theme background for an "open ring" look. */
+    fill?: string;
+    /** Stroke color. Defaults to theme text color. */
+    stroke?: string;
+    /** Stroke width in pixels. Default 2. */
+    strokeWidth?: number;
+}
 /** Base properties shared by all annotation types. */
 interface AnnotationBase {
     /** Stable identifier for selection and edit callbacks. When provided, edit events include this ID for reliable element matching. */
@@ -603,6 +717,18 @@ interface TextAnnotation extends AnnotationBase {
     y: string | number;
     /** The annotation text. Required for text annotations. */
     text: string;
+    /**
+     * Optional muted second-tone text rendered below the primary `text`.
+     * Used for supporting context (e.g. methodology, source). Newlines in
+     * `text` still produce multi-line primary; subtitle is a separate block.
+     */
+    subtitle?: string;
+    /**
+     * Optional dot marker drawn at the connector's data-point endpoint.
+     * `true` enables the default open-ring style. Pass an object to override
+     * radius, fill, stroke, or strokeWidth.
+     */
+    dot?: boolean | AnnotationDot;
     /** Font size override. */
     fontSize?: number;
     /** Font weight override. */
@@ -614,10 +740,12 @@ interface TextAnnotation extends AnnotationBase {
     /**
      * Connector from label to anchor point.
      * - `true` (default): straight line
+     * - `'straight'`: straight line (alias of `true`)
      * - `'curve'`: curved arrow with arrowhead
+     * - `'drop-line'`: vertical line through the data point's x; label sits beside the line and auto-flips to the opposite side if it would overflow the chart area
      * - `false`: no connector
      */
-    connector?: boolean | 'curve';
+    connector?: boolean | 'straight' | 'curve' | 'drop-line';
     /** Per-endpoint offsets for the connector line. Allows fine-tuning where the connector starts and ends. */
     connectorOffset?: {
         /** Offset for the label-end of the connector. */
@@ -770,6 +898,59 @@ interface LegendConfig {
     /** Series names to exclude from the legend. Excluded series still render in the chart. */
     exclude?: string[];
 }
+/**
+ * Configuration for the endpoint labels column rendered at the chart's right edge
+ * for multi-series line/area charts. Each entry pairs the series name with its
+ * last formatted value, optionally anchored to the line by an open-circle marker.
+ *
+ * The column is independent of the traditional `legend` and the legacy
+ * end-of-line labels. Together with `legend.show`, the three suppression toggles
+ * follow this truth table for ≥2-series line/area charts:
+ *
+ * | `legend.show` | `endpointLabels` | Traditional legend | Endpoint column | End-of-line labels |
+ * |--|--|--|--|--|
+ * | unset | unset | hidden (auto-suppressed) | shown (default) | hidden |
+ * | true  | unset | shown                    | shown           | hidden |
+ * | unset | false | shown (auto-suppress revoked) | hidden     | hidden |
+ * | false | false | hidden                   | hidden          | shown (last-resort) |
+ * | true  | false | shown                    | hidden          | hidden |
+ * | false | true  | hidden                   | shown           | hidden |
+ * | true  | true  | shown                    | shown           | hidden |
+ *
+ * Single-series charts: column is hidden by default (nothing to identify).
+ *
+ * The implementation is in `packages/engine/src/legend/suppression.ts` —
+ * `resolveSuppression` is the single source of truth. The table above is
+ * a user-facing mirror; if the two ever diverge, the engine wins. Tests
+ * in `legend/__tests__/suppression.test.ts` enforce every cell.
+ */
+interface EndpointLabelsConfig {
+    /** Explicit on/off. When undefined, the chart auto-decides based on series count. */
+    show?: boolean;
+    /** Field to read the displayed value from. Defaults to `encoding.y.field`. */
+    valueField?: string;
+    /** d3-format string for the value. Defaults to `encoding.y.axis.format`. */
+    format?: string;
+    /** Max wrap width in pixels for long series names. Default 96. */
+    width?: number;
+    /** Render an open-circle marker on the line at the right edge. Default true. */
+    showMarker?: boolean;
+    /** Override the marker style. */
+    markerStyle?: {
+        fill?: string;
+        stroke?: string;
+        strokeWidth?: number;
+        radius?: number;
+    };
+    /**
+     * Render a thin leader line from the swatch row back to the line endpoint
+     * when collision-sweep displaces a label off its data point. Default false:
+     * the marker on the line plus the swatch in the column already pair label
+     * to data; the connector tends to add visual noise for small displacements.
+     * Opt in when labels collide hard and you need the explicit tie-back.
+     */
+    showLeader?: boolean;
+}
 /** Data row: a plain object with string keys. */
 type DataRow = Record<string, unknown>;
 /** Per-series visual style overrides for line/area charts. */
@@ -866,33 +1047,153 @@ interface ChartSpecOverride {
     crosshair?: boolean;
 }
 /**
- * Chart specification: the primary input for standard chart types.
+ * A KPI/metric cell rendered above the chart in a horizontal row.
  *
- * Uses the Vega-Lite `mark` property instead of `type` to specify
- * the visualization mark. The mark can be a string shorthand or an
- * object with additional properties (interpolation, point markers, etc.).
+ * Used for editorial dashboards (e.g. "CLOSE $186.10 +1.4%") where the chart
+ * is paired with summary statistics. Cells lay out evenly across the chart
+ * width. Hidden in sparkline mode; auto-stripped when the container can't
+ * fit the laid-out values.
  */
-interface ChartSpec {
-    /**
-     * The mark type to render.
-     * String shorthand: `mark: 'bar'`
-     * Object with properties: `mark: { type: 'line', interpolate: 'step' }`
-     */
-    mark: MarkType | MarkDef;
+interface Metric {
+    /** Uppercase eyebrow label, e.g. "CLOSE". */
+    label: string;
+    /** Primary numeric value, e.g. "$186.10". */
+    value: string;
+    /** Optional change indicator, e.g. "+1.4%". Rendered next to the value. */
+    delta?: string;
+    /** Tone for the delta. 'up' = positive (green), 'down' = negative (red). Default 'up'. */
+    deltaTone?: 'up' | 'down';
+    /** Optional secondary value (e.g. multiplier "10.3×"). Rendered after the delta. */
+    secondary?: string;
+}
+/**
+ * Encoding for arc marks (pie/donut charts).
+ * - `y`: required (quantitative — the slice value)
+ * - `color`: required (nominal/ordinal — the category)
+ * - `theta`: optional (defaults to `y` channel)
+ * - `radius`: optional (donut inner radius)
+ */
+interface ArcEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    y: EncodingChannel<TData>;
+    color: EncodingChannel<TData>;
+}
+/**
+ * Encoding for line marks.
+ * - `x`: required (temporal or ordinal — the time/category axis)
+ * - `y`: required (quantitative — the value axis)
+ */
+interface LineEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for bar marks (vertical columns and horizontal bars).
+ * - `x`: required
+ * - `y`: required
+ */
+interface BarEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for area marks.
+ * - `x`: required (temporal or ordinal)
+ * - `y`: required (quantitative)
+ */
+interface AreaEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for point marks (scatter plots).
+ * - `x`: required
+ * - `y`: required
+ */
+interface PointEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for circle marks (dot plots).
+ * - `x`: required (quantitative)
+ * - `y`: required (nominal/ordinal — the category axis)
+ */
+interface CircleEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for lollipop marks.
+ * - `x`: required (quantitative)
+ * - `y`: required (nominal/ordinal)
+ */
+interface LollipopEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for text marks (data-positioned labels).
+ * - `text`: required (the field to render as text)
+ * - `x`, `y`: optional positioning
+ */
+interface TextEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    text: EncodingChannel<TData>;
+}
+/**
+ * Encoding for tick marks (strip/rug plots).
+ * - `x`: required
+ * - `y`: required
+ */
+interface TickEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Encoding for rect marks (heatmaps, 2D binned plots).
+ * - `x`: required
+ * - `y`: required
+ */
+interface RectEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+    y: EncodingChannel<TData>;
+}
+/**
+ * Properties shared across all ChartSpec mark variants.
+ * Extracted to avoid repeating them in every union member.
+ *
+ * @internal
+ */
+interface BaseChartSpec<TData extends DataRow = DataRow> {
     /** Data array: each element is a row with field values. */
-    data: DataRow[];
+    data: TData[];
     /** Data transforms applied in order before encoding (filter, bin, calculate, timeUnit). */
     transform?: Transform[];
-    /** Encoding mapping data fields to visual channels. */
-    encoding: Encoding;
     /** Editorial chrome (title, subtitle, source, etc.). */
     chrome?: Chrome;
+    /**
+     * KPI/metric cells rendered as a horizontal row between subtitle and chart
+     * area. Each cell shows a label/value pair with optional delta and secondary
+     * value. Hidden in sparkline mode and auto-stripped when the container is
+     * too narrow or short, or when value text would overflow its cell.
+     */
+    metrics?: Metric[];
     /** Data annotations (text callouts, highlighted ranges, reference lines). */
     annotations?: Annotation[];
     /** Label display configuration. `false` disables all labels, `true` uses defaults. */
     labels?: LabelSpec;
     /** Legend display configuration (position override). */
     legend?: LegendConfig;
+    /**
+     * Right-side endpoint labels column for multi-series line/area charts.
+     *
+     * - `true` or `EndpointLabelsConfig`: render the column.
+     * - `false`: hide the column.
+     * - omitted: auto-enable for multi-series line/area charts, hide otherwise.
+     *
+     * See {@link EndpointLabelsConfig} for the full suppression truth table that
+     * relates this flag to `legend.show` and the legacy end-of-line labels.
+     */
+    endpointLabels?: boolean | EndpointLabelsConfig;
     /** Whether the chart adapts to container width. Defaults to true. */
     responsive?: boolean;
     /** Theme configuration overrides. */
@@ -948,6 +1249,97 @@ interface ChartSpec {
      */
     zIndex?: number;
 }
+/**
+ * Chart specification: the primary input for standard chart types.
+ *
+ * Uses the Vega-Lite `mark` property instead of `type` to specify
+ * the visualization mark. The mark can be a string shorthand or an
+ * object with additional properties (interpolation, point markers, etc.).
+ *
+ * This is a discriminated union — the `mark` value determines which encoding
+ * channels are required. TypeScript enforces required channels at compile time,
+ * matching the runtime rules in `MARK_ENCODING_RULES`.
+ *
+ * @template TData - The shape of a single data row. When provided, `encoding.*.field`
+ * values are constrained to `keyof TData` and IDEs autocomplete your column names.
+ * Defaults to `DataRow` (no constraint) — existing untyped specs work unchanged.
+ *
+ * @example
+ * // Typed: field autocomplete + typo detection
+ * type SalesRow = { date: string; revenue: number; region: string };
+ * const spec: ChartSpec<SalesRow> = {
+ *   mark: 'line',
+ *   data: rows,
+ *   encoding: {
+ *     x: { field: 'date', type: 'temporal' },      // autocompletes
+ *     y: { field: 'revenue', type: 'quantitative' }, // typos fail at compile time
+ *   }
+ * };
+ *
+ * @example
+ * // Untyped: works exactly as before (no migration needed)
+ * const spec: ChartSpec = {
+ *   mark: 'bar',
+ *   data: myData,
+ *   encoding: { x: { field: 'category', type: 'nominal' }, y: { field: 'value', type: 'quantitative' } }
+ * };
+ */
+type ChartSpec<TData extends DataRow = DataRow> = (BaseChartSpec<TData> & {
+    mark: 'arc' | (MarkDef & {
+        type: 'arc';
+    });
+    encoding: ArcEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'line' | (MarkDef & {
+        type: 'line';
+    });
+    encoding: LineEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'bar' | (MarkDef & {
+        type: 'bar';
+    });
+    encoding: BarEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'area' | (MarkDef & {
+        type: 'area';
+    });
+    encoding: AreaEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'point' | (MarkDef & {
+        type: 'point';
+    });
+    encoding: PointEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'circle' | (MarkDef & {
+        type: 'circle';
+    });
+    encoding: CircleEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'lollipop' | (MarkDef & {
+        type: 'lollipop';
+    });
+    encoding: LollipopEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'text' | (MarkDef & {
+        type: 'text';
+    });
+    encoding: TextEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'tick' | (MarkDef & {
+        type: 'tick';
+    });
+    encoding: TickEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'rect' | (MarkDef & {
+        type: 'rect';
+    });
+    encoding: RectEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'rule' | (MarkDef & {
+        type: 'rule';
+    });
+    encoding: Encoding<TData>;
+});
 /**
  * Table specification: input for data table visualizations.
  *
@@ -1060,14 +1452,19 @@ interface ResolveConfig {
  * Each element in `layer` is either a ChartSpec or another LayerSpec (nested).
  * Shared data, encoding, and transforms at the LayerSpec level are inherited
  * by children that don't define their own.
+ *
+ * @template TData - The shape of a single data row. When all layers share the
+ * same data shape, pass it here to get field autocomplete across the layer.
+ * For layers with different data shapes per child, omit TData (defaults to
+ * `DataRow`) — children can be independently typed.
  */
-interface LayerSpec {
+interface LayerSpec<TData extends DataRow = DataRow> {
     /** Array of child layers (ChartSpec or nested LayerSpec). */
-    layer: (ChartSpec | LayerSpec)[];
+    layer: (ChartSpec<TData> | LayerSpec<TData>)[];
     /** Shared data inherited by children without their own data. */
-    data?: DataRow[];
+    data?: TData[];
     /** Shared encoding inherited by children (overridden per-channel by child). */
-    encoding?: Encoding;
+    encoding?: Encoding<TData>;
     /** Shared transforms. Parent transforms run before child transforms. */
     transform?: Transform[];
     /** Editorial chrome (title, subtitle, source, etc.). */
@@ -1265,8 +1662,11 @@ interface BarListEncoding {
  * - BarListSpec: has `type: 'barlist'`
  */
 type VizSpec = ChartSpec | LayerSpec | TableSpec | GraphSpec | SankeySpec | TileMapSpec | BarListSpec;
-/** Chart spec without runtime data, for persistence/storage. */
-type ChartSpecWithoutData = Omit<ChartSpec, 'data'>;
+/**
+ * Chart spec without runtime data, for persistence/storage.
+ * Generic: `ChartSpecWithoutData<MyRow>` constrains encoding field names.
+ */
+type ChartSpecWithoutData<TData extends DataRow = DataRow> = Omit<ChartSpec<TData>, 'data'>;
 /** Table spec without runtime data and columns, for persistence/storage. Columns can be auto-generated via dataTable(). */
 type TableSpecWithoutData = Omit<TableSpec, 'data' | 'columns'>;
 /** Graph spec without runtime data, for persistence/storage. */
@@ -1299,7 +1699,12 @@ interface RelativeTimeRef {
 }
 /** A predicate that tests a field value against a condition. */
 interface FieldPredicate {
-    /** Data field to test. */
+    /**
+     * Data field to test.
+     * Note: FieldPredicate is used in transforms (FilterTransform) which operate
+     * on the raw DataRow type — field is typed as string here since transforms
+     * can reference computed/derived fields not present in the original TData.
+     */
     field: string;
     /** Equals comparison. */
     equal?: unknown;
@@ -1420,37 +1825,51 @@ type Transform = FilterTransform | BinTransform | CalculateTransform | TimeUnitT
 /**
  * A single condition with a test predicate and resulting value/field.
  * When the test passes for a datum, the condition's value/field is used.
+ *
+ * @template TData - Propagated from ChartSpec<TData>. Constrains `field` to
+ * `keyof TData & string` when a typed data row is provided.
  */
-interface Condition {
+interface Condition<TData extends DataRow = DataRow> {
     /** Predicate to test against each datum. */
     test: FilterPredicate;
-    /** Static value to use when the condition is true. */
-    value?: unknown;
-    /** Data field to use when the condition is true. */
-    field?: string;
+    /**
+     * Static value to use when the condition is true.
+     * Accepted values: CSS color string, opacity (0-1), size number, or boolean flag.
+     */
+    value?: string | number | boolean | null;
+    /**
+     * Data field to use when the condition is true.
+     * Constrained to column names of `TData` when using `ChartSpec<TData>`.
+     */
+    field?: keyof TData & string;
     /** Field type for the conditional field. */
     type?: FieldType;
 }
 /**
  * A conditional value definition for an encoding channel.
  * Evaluates conditions in order, falling back to the default value.
+ *
+ * @template TData - Propagated from ChartSpec<TData>.
  */
-interface ConditionalValueDef {
+interface ConditionalValueDef<TData extends DataRow = DataRow> {
     /** One or more conditions to evaluate. */
-    condition: Condition | Condition[];
-    /** Default value when no condition matches. */
-    value?: unknown;
+    condition: Condition<TData> | Condition<TData>[];
+    /**
+     * Default value when no condition matches.
+     * Accepted values: CSS color string, opacity (0-1), size number, or boolean flag.
+     */
+    value?: string | number | boolean | null;
 }
 /**
  * Check if a channel definition is a regular EncodingChannel (has 'field' at top level).
  * Use this to narrow `EncodingChannel | ConditionalValueDef` in encoding channels
  * that support conditional encoding (color, size, opacity).
  */
-declare function isEncodingChannel(def: EncodingChannel | ConditionalValueDef | undefined): def is EncodingChannel;
+declare function isEncodingChannel<TData extends DataRow = DataRow>(def: EncodingChannel<TData> | ConditionalValueDef<TData> | undefined): def is EncodingChannel<TData>;
 /**
  * Check if a channel definition is a ConditionalValueDef.
  */
-declare function isConditionalDef(def: EncodingChannel | ConditionalValueDef | undefined): def is ConditionalValueDef;
+declare function isConditionalDef<TData extends DataRow = DataRow>(def: EncodingChannel<TData> | ConditionalValueDef<TData> | undefined): def is ConditionalValueDef<TData>;
 /** All valid mark type strings for runtime checking. */
 declare const MARK_TYPES: ReadonlySet<string>;
 /** @deprecated Use MARK_TYPES instead. */
@@ -1727,6 +2146,10 @@ interface ThemeColors {
     annotationFill: string;
     /** Annotation text color. */
     annotationText: string;
+    /** Semantic color for positive/up-trend values (e.g. sparkline trend coloring). */
+    positive: string;
+    /** Semantic color for negative/down-trend values (e.g. sparkline trend coloring). */
+    negative: string;
 }
 /** Font size presets for the typography scale. */
 interface ThemeFontSizes {
@@ -1789,6 +2212,7 @@ interface ChromeDefaults {
 }
 /** Default chrome styles for each element type. */
 interface ThemeChromeDefaults {
+    eyebrow: ChromeDefaults;
     title: ChromeDefaults;
     subtitle: ChromeDefaults;
     source: ChromeDefaults;
@@ -1904,11 +2328,13 @@ interface ResolvedChrome {
     /** Total height consumed by chrome elements below the chart area. */
     bottomHeight: number;
     /** Resolved chrome elements. Only present if specified in the spec. */
+    eyebrow?: ResolvedChromeElement;
     title?: ResolvedChromeElement;
     subtitle?: ResolvedChromeElement;
     source?: ResolvedChromeElement;
     byline?: ResolvedChromeElement;
     footer?: ResolvedChromeElement;
+    brand?: ResolvedChromeElement;
 }
 /** A single axis tick with computed position and formatted label. */
 interface AxisTick {
@@ -1962,15 +2388,27 @@ interface AxisLayout {
     labelOverlap?: boolean | 'parity' | 'greedy';
     /** Whether to flush labels to the axis edges. */
     labelFlush?: boolean;
+    /**
+     * Where tick labels render relative to the chart area.
+     * `'inline'` puts y-axis labels above their gridlines at chart-area x and
+     * suppresses the axis line and tick marks. `'gutter'` (default) keeps the
+     * classic outside-the-area placement.
+     */
+    tickPosition?: 'inline' | 'gutter';
 }
 /** Accessibility attributes for a mark. */
 interface MarkAria {
-    /** ARIA label for the mark. */
-    label: string;
+    /** ARIA label for the mark. Optional when `decorative: true` — decorative
+     *  marks render with `aria-hidden="true"` and don't need a label. */
+    label?: string;
     /** Optional longer description. */
     description?: string;
     /** ARIA role override. */
     role?: string;
+    /** When true, the mark is purely decorative (e.g. a sparkline endpoint dot
+     *  that duplicates an existing data point). Renderers translate this into
+     *  `aria-hidden="true"` and skip the mark from the screen-reader data table. */
+    decorative?: boolean;
 }
 /**
  * Line mark: a series of connected points.
@@ -2079,6 +2517,18 @@ interface RectMark {
     strokeWidth?: number;
     /** Corner radius. */
     cornerRadius?: number;
+    /**
+     * Which corners receive `cornerRadius`. Defaults to all four when unset.
+     * Used by stacked bars/columns to round only the leading edge of the
+     * topmost (vertical) or rightmost (horizontal) segment so the seams
+     * between stacked segments stay square and visually contiguous.
+     */
+    cornerRadiusSides?: {
+        tl?: boolean;
+        tr?: boolean;
+        br?: boolean;
+        bl?: boolean;
+    };
     /** Original data row. */
     data: Record<string, unknown>;
     /** Resolved label. */
@@ -2280,12 +2730,14 @@ interface ResolvedLabel {
     connector?: {
         /** Connector start (at the label). */
         from: Point;
-        /** Connector end (at the data point). */
+        /** Connector end (pulled back from the data point so the line doesn't touch it). */
         to: Point;
+        /** Actual data point the connector is calling out. Renderer uses this for the endpoint marker. */
+        endpoint?: Point;
         /** Connector line color. */
         stroke: string;
-        /** Connector style: straight line or curved arrow. */
-        style: 'straight' | 'curve';
+        /** Connector style: straight line, curved arrow, or vertical drop-line through the data point. */
+        style: 'straight' | 'curve' | 'drop-line';
     };
     /** Background color behind the label text. */
     background?: string;
@@ -2319,6 +2771,28 @@ interface ResolvedAnnotation {
     strokeWidth?: number;
     /** Z-index for render ordering. Higher values render on top. */
     zIndex?: number;
+    /**
+     * For text annotations: optional dot marker drawn at the connector's
+     * data-point endpoint. Coordinates match `label.connector.to` exactly.
+     */
+    dot?: {
+        x: number;
+        y: number;
+        radius: number;
+        fill: string;
+        stroke: string;
+        strokeWidth: number;
+    };
+    /**
+     * For text annotations: optional muted subtitle rendered below the primary
+     * label. Positioned `lineHeight * primaryLineCount + gap` below `label.y`.
+     */
+    subtitle?: {
+        text: string;
+        x: number;
+        y: number;
+        style: TextStyle;
+    };
 }
 /** A single entry in a categorical legend. */
 interface LegendEntry {
@@ -2354,6 +2828,8 @@ interface CategoricalLegendLayout extends BaseLegendLayout {
     swatchGap: number;
     /** Gap between entries. */
     entryGap: number;
+    /** Fill color for the rounded chip background behind the colored bar. */
+    swatchChipFill: string;
 }
 /** A color stop in a gradient legend. */
 interface GradientColorStop {
@@ -2377,6 +2853,55 @@ interface GradientLegendLayout extends BaseLegendLayout {
 }
 /** Resolved legend layout — either categorical (swatches) or gradient (continuous bar). */
 type LegendLayout = CategoricalLegendLayout | GradientLegendLayout;
+/** A single resolved endpoint-label entry, fully positioned. */
+interface EndpointLabelEntry {
+    /** Series identifier (matches mark.seriesKey). */
+    seriesKey: string;
+    /** Pre-wrapped label text lines. */
+    labelLines: string[];
+    /** Formatted value string for the last data point. */
+    value: string;
+    /** Series color. */
+    color: string;
+    /** True pixel y of the last data point on the line. */
+    dataY: number;
+    /** Displaced y after the bidirectional collision sweep. */
+    labelY: number;
+    /** True when |labelY - dataY| exceeds the threshold (renderer draws a leader line). */
+    showLeader: boolean;
+    /** Optional anchor circle drawn on the line at the chart's right edge. */
+    marker?: {
+        x: number;
+        y: number;
+        fill: string;
+        stroke: string;
+        strokeWidth: number;
+        radius: number;
+    };
+}
+/** Resolved layout for the endpoint labels column. */
+interface EndpointLabelsLayout {
+    /** Per-series resolved entries. */
+    entries: EndpointLabelEntry[];
+    /** Bounding box for the column. */
+    bounds: Rect;
+    /** Style for the series-name text. */
+    labelStyle: TextStyle;
+    /** Style for the formatted value text. */
+    valueStyle: TextStyle;
+    /** Width of the colored swatch line drawn left of the label. */
+    swatchSize: number;
+    /** Horizontal gap between swatch and label text. */
+    gap: number;
+    /**
+     * Vertical gap between the last wrapped label line and the value text
+     * directly below it. Resolved by the engine so the renderer can't drift
+     * away from the height the collision sweep budgeted for each entry.
+     */
+    valueGap: number;
+    /** Fill color for the rounded chip background behind the colored bar. */
+    swatchChipFill: string;
+}
 /** A single field-value pair in a tooltip. */
 interface TooltipField {
     /** Field label (e.g. "GDP Growth"). */
@@ -2419,6 +2944,36 @@ interface ResolvedAnimation {
     /** Delay before annotations animate in (ms after marks). */
     annotationDelay: number;
 }
+/**
+ * A resolved KPI metric cell with computed positions for label, value, and
+ * supplementary text spans. Cells render as a row above the chart area.
+ */
+interface ResolvedMetricCell {
+    /** Cell left x in layout coordinates. */
+    x: number;
+    /** Cell width. */
+    cellWidth: number;
+    /** Baseline y for the uppercase label. */
+    labelY: number;
+    /** Baseline y for the primary value. */
+    valueY: number;
+    /** The original metric spec (label/value/delta/etc.). */
+    metric: Metric;
+    /** True if value+delta+secondary would overflow cellWidth. Set by layout for diagnostics. */
+    overflowed: boolean;
+}
+/**
+ * The full metric-bar layout. Present only when spec.metrics is supplied
+ * and the bar fits the container.
+ */
+interface ResolvedMetricBar {
+    /** Top y of the metric row in layout coordinates. */
+    y: number;
+    /** Total reserved height of the row. */
+    height: number;
+    /** Cells laid out evenly across the chart width. */
+    cells: ResolvedMetricCell[];
+}
 /**
  * ChartLayout: the complete engine output for chart visualizations.
  *
@@ -2432,6 +2987,8 @@ interface ChartLayout {
     area: Rect;
     /** Resolved chrome text elements with positions and styles. */
     chrome: ResolvedChrome;
+    /** Resolved KPI metric bar. Present only when spec.metrics is supplied and fits. */
+    metrics?: ResolvedMetricBar;
     /** Resolved axis layouts. */
     axes: {
         x?: AxisLayout;
@@ -2445,6 +3002,12 @@ interface ChartLayout {
     annotations: ResolvedAnnotation[];
     /** Legend layout (position, entries, bounds). */
     legend: LegendLayout;
+    /**
+     * Right-side endpoint labels column for multi-series line/area charts.
+     * Empty `entries` means the column is suppressed (single-series, opt-out, or
+     * auto-suppressed by the truth table).
+     */
+    endpointLabels?: EndpointLabelsLayout;
     /** Tooltip descriptors keyed by a mark identifier. */
     tooltipDescriptors: Map<string, TooltipContent>;
     /** Accessibility metadata. */
@@ -3045,25 +3608,14 @@ declare function meetsAA(fg: string, bg: string, largeText?: boolean): boolean;
 declare function findAccessibleColor(baseColor: string, bg: string, targetRatio?: number): string;
 
 /**
- * Color palettes for @opendata-ai.
- *
- * Categorical palette is Infrographic-influenced with WCAG AA contrast
- * for large text (3:1 ratio) on both light (#ffffff) and dark (#1a1a2e)
- * backgrounds. Several colors do not meet the stricter 4.5:1 ratio
- * required for normal-sized body text. This is acceptable because chart
- * marks (bars, lines, areas, points) are large visual elements.
+ * Default categorical palette. Cyan-led OKLCH-balanced multi-hue ramp.
  *
- * Sequential palettes: 5-7 stops from light to dark.
- * Diverging palettes: 7 stops with a neutral midpoint.
+ * Hex values precomputed from OKLCH via the standard OKLab -> linear sRGB
+ * -> sRGB pipeline. Documented OKLCH source values are the contract; if
+ * the conversion math changes, regenerate from the source rather than
+ * editing hex literals directly.
  */
-/**
- * Default categorical palette. 10 visually distinct colors that meet
- * WCAG AA contrast for large text (3:1) on both white and near-black
- * backgrounds. Some colors fall below the 4.5:1 threshold for normal
- * body text. Influenced by Infrographic's editorial palette with tweaks
- * for accessibility and colorblind distinguishability.
- */
-declare const CATEGORICAL_PALETTE: readonly ["#1b7fa3", "#c44e52", "#6a9f58", "#d47215", "#507e79", "#9a6a8d", "#c4636b", "#9c755f", "#a88f22", "#858078"];
+declare const CATEGORICAL_PALETTE: readonly ["#06b6d4", "#eb7289", "#3bb974", "#ad87ed", "#e69c3a", "#4ba3f7", "#eb8656", "#8494fa", "#00b9c3"];
 type CategoricalPalette = typeof CATEGORICAL_PALETTE;
 /** Sequential palette definition: an array of color stops from light to dark. */
 interface SequentialPalette {
@@ -3106,14 +3658,16 @@ declare function adaptTheme(theme: ResolvedTheme): ResolvedTheme;
 /**
  * Default theme definition.
  *
- * Tuned to match Infrographic's visual weight and editorial style.
- * Inter font family, typography hierarchy for chrome, and color
- * palettes from the colors module.
+ * Editorial design system with cyan-led categorical palette, Inter
+ * Variable typography (weights 400/510/590), and zinc-based achromatic
+ * surfaces. Light is the default surface; dark adaptation lives in
+ * dark-mode.ts.
+ *
+ * resolveTheme() deep-merges user overrides onto this base.
  */
 
 /**
  * The default theme. All fields are required and fully specified.
- * resolveTheme() deep-merges user overrides onto this base.
  */
 declare const DEFAULT_THEME: Theme;
 
@@ -3169,8 +3723,14 @@ declare function resolveTheme(userTheme?: ThemeConfig, base?: Theme): ResolvedTh
  * @param measureText - Optional real text measurement function from the adapter.
  * @param chromeMode - Chrome display mode: full, compact (title only), or hidden.
  * @param padding - Override padding (for scaled padding from dimensions).
- */
-declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme, width: number, measureText?: MeasureTextFn, chromeMode?: ChromeMode, padding?: number, watermark?: boolean): ResolvedChrome;
+ * @param watermark - Whether the brand watermark renders (affects bottom space).
+ * @param bottomLegendHeight - Reserved height for a bottom-positioned legend
+ *   (legend bounds height + gap). When > 0, source/byline/footer y positions
+ *   are shifted down by this amount so the chrome stacks BELOW the legend
+ *   rather than colliding with it. The returned `bottomHeight` includes this
+ *   reservation, so callers should not double-reserve it in margin math.
+ */
+declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme, width: number, measureText?: MeasureTextFn, chromeMode?: ChromeMode, padding?: number, watermark?: boolean, bottomLegendHeight?: number): ResolvedChrome;
 
 /**
  * Estimate the rendered width of a text string.
@@ -3646,4 +4206,4 @@ interface TileMapBuilderOptions {
  */
 declare function tileMap(data: Record<string, number | null> | DataRow[], options?: TileMapBuilderOptions): TileMapSpec;
 
-export { type A11yMetadata, 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 AnnotationOffset, type AnnotationPosition, type ArcMark, 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 BarListEncoding, type BarListLayout, type BarListRowMark, type BarListSpec, type BarListSpecWithoutData, type BarTableCell, type BaseLegendLayout, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, 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 ChartType, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, 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 FieldPredicate, type FieldRef, type FieldType, 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 LegendConfig, type LegendEntry, type LegendLayout, type LegendPosition, type LineMark, type LinearGradient, type LogicalAnd, type LogicalNot, type LogicalOr, 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 Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, NARROW_VIEWPORT_MAX, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedTheme, type RuleMarkLayout, SEQUENTIAL_PALETTES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleType, type SequentialPalette, type SeriesStyle, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, TICK_LABEL_OFFSET, 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 TextMarkLayout, type TextStyle, type TextTableCell, type Theme, type ThemeChromeDefaults, type ThemeColors, type ThemeConfig, type ThemeFontSizes, type ThemeFontWeights, type ThemeFonts, type ThemeSpacing, type TickMarkLayout, type TileMapBuilderOptions, type TileMapEncoding, type TileMapLayout, type TileMapPalette, type TileMapSpec, type TileMapSpecWithoutData, type TileMapTileMark, type TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeLabelBounds, contrastRatio, dataTable, detectCollision, donutChart, dotChart, elementRef, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getAxisTitleOffset, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, inferFieldType, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, tileMap, wrapText };
+export { type A11yMetadata, 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 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 BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, 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 ChartType, type Chrome, type ChromeDefaults, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type Condition, type ConditionalValueDef, 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 EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, type FieldPredicate, type FieldRef, type FieldType, 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 LegendConfig, type LegendEntry, 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 Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, NARROW_VIEWPORT_MAX, type NodeOverride, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type Rect, type RectEncoding, type RectMark, type RefLineAnnotation, type RelativeTimeRef, type ResolveConfig, type ResolveMode, type ResolvedAnimation, type ResolvedAnnotation, type ResolvedChrome, type ResolvedChromeElement, type ResolvedColumn, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, type ResolvedTheme, type RuleMarkLayout, SEQUENTIAL_PALETTES, type SankeyEncoding, type SankeyLayout, type SankeyLinkColor, type SankeyLinkMark, type SankeyNodeAlign, type SankeyNodeMark, type SankeySpec, type SankeySpecWithoutData, type ScaleConfig, type ScaleType, type SequentialPalette, type SeriesStyle, type SortState, type SparklineColumnConfig, type SparklineData, type SparklineTableCell, type StoredVizSpec, TICK_LABEL_OFFSET, 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 TooltipContent, type TooltipField, type Transform, type VizSpec, type WindowFieldDef, type WindowOp, type WindowSortField, type WindowTransform, abbreviateNumber, adaptColorForDarkMode, adaptTheme, areaChart, barChart, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, columnChart, computeChrome, computeLabelBounds, contrastRatio, dataTable, detectCollision, donutChart, dotChart, elementRef, estimateTextWidth, findAccessibleColor, formatDate, formatNumber, generateAltText, generateAriaLabels, generateDataTable, getAxisTitleOffset, getBreakpoint, getHeightClass, getLayoutStrategy, getRepresentativeColor, inferFieldType, isBarListSpec, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, tileMap, wrapText };