@opendata-ai/openchart-core 8.9.0 → 8.9.1

package/dist/index.d.ts

@@ -111,6 +111,81 @@ interface ChromeEconomy {
  */
 declare function resolveChromeEconomy(width: number, height: number): ChromeEconomy;
 
+/** Supplied semantics; the library never invents a measure or uncertainty. */
+interface FieldMetadata {
+    /** Explicit imported field type; preserved with the portable document. */
+    type?: 'text' | 'number' | 'date';
+    /** Identifies an internal, persistent row identity column. */
+    role?: 'identity';
+    label?: string;
+    unit?: string;
+    measure?: string;
+    provenance?: string;
+    /** Percent is encoded 0–100; proportion is encoded 0–1. */
+    representation?: 'number' | 'percent' | 'proportion';
+    interval?: {
+        lower: string;
+        upper: string;
+    };
+    statusField?: string;
+}
+interface DesignDiagnostic {
+    code: string;
+    severity: 'info' | 'warning' | 'error';
+    status: 'failed' | 'uncheckable';
+    path: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    message: string;
+    origin: 'author' | 'default';
+    fix?: SpecPatch;
+}
+/** Atomic JSON-pointer edits guarded by the complete source document. */
+interface SpecPatch {
+    label: string;
+    /** Canonical source snapshot prevents stale fixes overwriting subsequent edits. */
+    precondition: string;
+    changes: Array<{
+        path: string;
+        value: unknown;
+    }>;
+}
+type DesignQuestion = 'comparison' | 'change' | 'distribution' | 'composition' | 'geography' | 'relationships';
+interface CompositionRecommendation {
+    id: string;
+    title: string;
+    reason: string;
+    tradeoff: string;
+    spec: VizSpec;
+}
+interface ObservationIdentity {
+    observation: string;
+    series?: string;
+    persistent: boolean;
+}
+interface ReaderObservation extends ObservationIdentity {
+    /** Aggregates are visible groups and never imply a raw-row selection. */
+    kind?: 'row' | 'aggregate';
+    datum: DataRow;
+    previous?: DataRow;
+    state: 'visible' | 'filtered';
+}
+interface ReaderSelection {
+    preview: ReaderObservation | null;
+    pinned: ReaderObservation[];
+    announcement: string;
+}
+/** Explicit relationships; aggregate groups never masquerade as raw rows. */
+interface DatasetBinding {
+    dataset: string;
+    entityField: string;
+    kind: 'row' | 'group';
+    transform?: string;
+    groupMembers?: Record<string, Array<string | number>>;
+}
+
 /**
  * Derived neutral ramp.
  *
@@ -165,8 +240,8 @@ declare function deriveNeutralRamp(text: string, bg: string, isDark?: boolean):
 /**
  * Theme types: color palettes, typography, spacing, and chrome defaults.
  *
- * Theme is the user-facing partial config (all optional).
- * ResolvedTheme is the engine-internal fully resolved version (no optionals).
+ * ThemeConfig is the user-facing partial config (all optional).
+ * ResolvedTheme is the public fully resolved output type.
  */
 
 /**
@@ -223,6 +298,20 @@ interface ThemeColors {
     annotationFill: string;
     /** Annotation text color. */
     annotationText: string;
+    /** Annotation label color. */
+    annotationLabel: string;
+    /** Annotation muted color. */
+    annotationMuted: string;
+    /** Annotation leader color. */
+    annotationLeader: string;
+    /** Annotation rule color. */
+    annotationRule: string;
+    /** Annotation rangefill color. */
+    annotationRangeFill: string;
+    /** Annotation markerfill color. */
+    annotationMarkerFill: string;
+    /** Annotation plate color. */
+    annotationPlate: 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). */
@@ -331,10 +420,11 @@ interface ThemeChromeDefaults {
  * works with).
  *
  * Users provide ThemeConfig (from spec.ts) which is the partial/optional
- * version. The theme resolver deep-merges ThemeConfig onto the default Theme
+ * version. The theme resolver deep-merges ThemeConfig onto the default theme
  * to produce a ResolvedTheme.
  */
-interface Theme {
+/** @internal Base structure before runtime color resolution. */
+interface ThemeBase {
     /** Color palettes. */
     colors: ThemeColors;
     /** Typography settings. */
@@ -353,18 +443,10 @@ interface Theme {
     /** Series color assignment strategy. Default: 'palette' (full categorical). */
     seriesStrategy: SeriesStrategy;
 }
-/**
- * Fully resolved theme with no optional fields.
- *
- * This is the result of resolveTheme(): the default theme with user
- * overrides deep-merged in. Every property is guaranteed to have a value.
- * The engine uses ResolvedTheme internally so it never needs null checks.
- *
- * Structurally identical to Theme (both have all required fields), but
- * exists as a separate type for semantic clarity: Theme is the default
- * definition, ResolvedTheme is the runtime-resolved instance.
- */
-interface ResolvedTheme extends Theme {
+/** @deprecated Use ThemeConfig for input or ResolvedTheme for resolved output. */
+type Theme = ThemeBase;
+/** Fully resolved runtime theme, including color adaptation and token metadata. */
+interface ResolvedTheme extends ThemeBase {
     /** Colors plus the neutral ramp derived from `text` and `background`. */
     colors: ResolvedThemeColors;
     /** Whether dark mode adaptations have been applied to this theme. */
@@ -480,6 +562,10 @@ interface ResolvedChrome {
     brand?: ResolvedChromeElement;
     /** Annotation footnotes generated by auto-thinning. Rendered as a numbered list above the source line. */
     footnotes?: AnnotationFootnote[];
+    /** Reserved annotation-note and series-summary band, independent of the current demoted set. */
+    noteBandHeight?: number;
+    /** Height added by the engine in grow mode; hosts must not add it again. */
+    grownHeight?: number;
     /** Responsive series readout above source/methodology. */
     seriesSummary?: Array<{
         key: string;
@@ -984,6 +1070,8 @@ type Mark = LineMark | AreaMark | RectMark | ArcMark | PointMark | TextMarkLayou
  * The collision engine determines whether labels are visible or demoted to tooltip-only.
  */
 interface ResolvedLabel {
+    /** Engine-wrapped display lines; text retains the original identity string. */
+    lines?: string[];
     /** Label text content. */
     text: string;
     /** Computed x position. */
@@ -1000,6 +1088,10 @@ interface ResolvedLabel {
     connector?: {
         /** Connector start (at the label). */
         from: Point;
+        /** Engine-resolved quadratic control point; absent in older hand-built layouts. */
+        control?: Point;
+        /** Authored curve displacement, retained for geometry rebuilds. */
+        bend?: number;
         /** 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. */
@@ -1009,6 +1101,8 @@ interface ResolvedLabel {
             dx: number;
             dy: number;
         };
+        /** Fixed label attachment for outside-reference gutter leaders; retained during animation. */
+        labelAttachment?: 'left-center';
         /** Connector line color. */
         stroke: string;
         /** Connector style: straight line, curved arrow, or vertical drop-line through the data point. */
@@ -1085,6 +1179,7 @@ interface ResolvedAnnotation {
      * label. Positioned `lineHeight * primaryLineCount + gap` below `label.y`.
      */
     subtitle?: {
+        lines?: string[];
         text: string;
         x: number;
         y: number;
@@ -1101,6 +1196,12 @@ interface ResolvedAnnotation {
 }
 /** A footnote entry generated by annotation auto-thinning. */
 interface AnnotationFootnote {
+    /** Engine-wrapped display lines, including the number; omitted for one-line notes. */
+    lines?: string[];
+    /** Source annotation index, independent of note numbering. */
+    specIndex?: number;
+    /** Authored source ID, when present. */
+    id?: string;
     /** 1-indexed footnote number matching the dot marker on the chart. */
     index: number;
     /** The original annotation text that was demoted. */
@@ -2488,11 +2589,10 @@ interface CompileOptions {
     /** Extra pixels to reserve on the right margin for a secondary y-axis. Set by compileLayer when resolve.scale.y is 'independent'. */
     rightAxisReserve?: number;
     /**
-     * Extra pixels to reserve below the plot for the auto-thinning footnote list.
-     * Chicken-and-egg: thinning needs the chart area to decide what to demote, but
-     * the footnotes it produces need space carved out of that same area. compileChart
-     * resolves it by compiling once to learn the footnote count, then recompiling with
-     * this set. Callers should not set it; it is internal to that second pass.
+     * Internal note-band reserve resolved from source annotation capacity and
+     * responsive series-summary lines. Subtract mode consumes the fixed figure
+     * budget; grow mode adds the reserve to the SVG height while keeping the
+     * original layout budget and padding. Callers should not set this field.
      */
     footnoteReserve?: number;
     /** Recursion depth of the footnote-reserve convergence pass. Internal to compileChart. */
@@ -3589,6 +3689,8 @@ type ConnectorType = 'straight' | 'curve' | 'drop-line';
 interface ConnectorConfig {
     /** Connector style. */
     type: ConnectorType;
+    /** Curve displacement along the chord normal, from -1 to 1. Omitted or zero preserves the automatic curve. Ignored for other connector types. */
+    bend?: number;
     /** Whether to draw an arrowhead at the data-point end. Default: true for curve, false for straight. Drop-line never takes a head. */
     arrow?: boolean;
 }
@@ -3650,6 +3752,10 @@ interface TextAnnotation extends AnnotationBase {
      * 700 — the lede + context stack.
      */
     subtitle?: string;
+    /** Subtitle size in pixels. Default: round(fontSize * 0.85). */
+    subtitleFontSize?: number;
+    /** Optional display wrap width in pixels. Omitted or null keeps unbounded lines. */
+    maxWidth?: number | null;
     /**
      * Open-ring marker drawn on the data point itself (not on the pulled-back
      * connector tip).
@@ -3762,6 +3868,8 @@ interface RefLineAnnotation extends AnnotationBase {
     strokeWidth?: number;
     /** Pixel offset for the reference line label. */
     labelOffset?: AnnotationOffset;
+    /** Opt-in screen-space label placement. Outside reserves a right gutter or top lane; omission preserves legacy labelAnchor behavior. */
+    labelPlacement?: 'auto' | 'start' | 'end' | 'outside';
     /** Anchor direction for the reference line label. */
     labelAnchor?: AnnotationAnchor;
     /** Label font size in pixels. Default: 11. */
@@ -3836,6 +3944,20 @@ interface ThemeConfig {
         annotationFill?: TokenValue;
         /** Annotation text color. Accepts a TokenValue for light/dark pairs. */
         annotationText?: TokenValue;
+        /** Annotation label color. Accepts a TokenValue light/dark pair. */
+        annotationLabel?: TokenValue;
+        /** Annotation muted color. Accepts a TokenValue light/dark pair. */
+        annotationMuted?: TokenValue;
+        /** Annotation leader color. Accepts a TokenValue light/dark pair. */
+        annotationLeader?: TokenValue;
+        /** Annotation rule color. Accepts a TokenValue light/dark pair. */
+        annotationRule?: TokenValue;
+        /** Annotation rangefill color. Accepts a TokenValue light/dark pair. */
+        annotationRangeFill?: TokenValue;
+        /** Annotation markerfill color. Accepts a TokenValue light/dark pair. */
+        annotationMarkerFill?: TokenValue;
+        /** Annotation plate color. Accepts a TokenValue light/dark pair. */
+        annotationPlate?: TokenValue;
         /** Semantic color for positive/up-trend values. Accepts a TokenValue for light/dark pairs. */
         positive?: TokenValue;
         /** Semantic color for negative/down-trend values. Accepts a TokenValue for light/dark pairs. */
@@ -3902,17 +4024,17 @@ interface ThemeConfig {
      */
     chrome?: {
         /** Eyebrow (kicker) style override. */
-        eyebrow?: string | ChromeThemeOverride;
+        eyebrow?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
         /** Title style override. */
-        title?: string | ChromeThemeOverride;
+        title?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
         /** Subtitle style override. */
-        subtitle?: string | ChromeThemeOverride;
+        subtitle?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
         /** Source/attribution style override. */
-        source?: string | ChromeThemeOverride;
+        source?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
         /** Byline style override. */
-        byline?: string | ChromeThemeOverride;
+        byline?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
         /** Footer style override. */
-        footer?: string | ChromeThemeOverride;
+        footer?: ChromeThemeOverride | /** @deprecated Use { color }. */ string;
     };
     /**
      * Editorial rule above the chrome block: a short colored bar (the
@@ -4116,8 +4238,10 @@ interface SeriesStyle {
  * Uses CSS linear() curves. Named 'ease' (not 'easing') to match Vega convention.
  */
 type AnimationEase = 'smooth' | 'snappy';
-/** Opt-in motion language. `legacy` preserves the v8 tween timing. */
-type AnimationPreset = 'fluid' | 'subtle' | 'legacy';
+/** Opt-in motion language. */
+type AnimationPreset = 'fluid' | 'subtle'
+/** @deprecated Omit preset for v8 timing. */
+ | 'legacy';
 /** Physical spring parameters. Quantitative motion is bounded at critical damping. */
 interface SpringConfig {
     stiffness?: number;
@@ -4133,6 +4257,8 @@ interface AnimationStagger {
 }
 /** Fine-grained responsive behavior configuration. */
 interface ResponsiveConfig {
+    /** Maximum eligible inline callouts below 400px container width; null or omitted is unlimited. Pinned annotations are exempt. */
+    compactAnnotationLimit?: number | null;
     /** Preserve the final temporal boundary before thinning interior ticks. */
     preserveEnd?: boolean;
     /** Move direct series labels into a keyed list when the inline column cannot fit. */
@@ -4536,6 +4662,7 @@ interface BaseChartSpec<TData extends DataRow = DataRow> {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /**
      * Whether to show the OpenData watermark. Defaults to true; auto-hides
@@ -4770,6 +4897,7 @@ interface TableSpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -4941,6 +5069,7 @@ interface GraphSpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /**
      * Motion configuration. DEFAULT-ON: omit for full defaults, `false` to opt
@@ -5069,6 +5198,7 @@ interface LayerSpec<TData extends DataRow = DataRow> {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -5156,6 +5286,7 @@ interface SankeySpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -5220,6 +5351,7 @@ interface TileMapSpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -5228,8 +5360,6 @@ interface TileMapSpec {
     /**
      * d3-format string applied to tile values, legend labels, and tooltips.
      * Examples: ".1f" for one decimal, "$,.0f" for currency, "~s" for SI.
-     * @deprecated Use the encoding channel's `format` field instead. This
-     * property is expanded into the encoding during compilation.
      */
     valueFormat?: string;
 }
@@ -5343,6 +5473,7 @@ interface GeoMapSpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -5377,6 +5508,7 @@ interface BarListSpec {
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
+    /** @deprecated Use the mount darkMode option; the spec field has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
@@ -5737,154 +5869,6 @@ declare function isRefLineAnnotation(annotation: Annotation): annotation is RefL
 /** Human-readable display names for mark types (used in alt text, error messages). */
 declare const MARK_DISPLAY_NAMES: Record<MarkType, string>;
 
-/** Supplied semantics; the library never invents a measure or uncertainty. */
-interface FieldMetadata {
-    /** Explicit imported field type; preserved with the portable document. */
-    type?: 'text' | 'number' | 'date';
-    /** Identifies an internal, persistent row identity column. */
-    role?: 'identity';
-    label?: string;
-    unit?: string;
-    measure?: string;
-    provenance?: string;
-    /** Percent is encoded 0–100; proportion is encoded 0–1. */
-    representation?: 'number' | 'percent' | 'proportion';
-    interval?: {
-        lower: string;
-        upper: string;
-    };
-    statusField?: string;
-}
-interface DesignDiagnostic {
-    code: string;
-    severity: 'info' | 'warning' | 'error';
-    status: 'failed' | 'uncheckable';
-    path: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    message: string;
-    origin: 'author' | 'default';
-    fix?: SpecPatch;
-}
-/** Atomic JSON-pointer edits guarded by the complete source document. */
-interface SpecPatch {
-    label: string;
-    /** Canonical source snapshot prevents stale fixes overwriting subsequent edits. */
-    precondition: string;
-    changes: Array<{
-        path: string;
-        value: unknown;
-    }>;
-}
-type DesignQuestion = 'comparison' | 'change' | 'distribution' | 'composition' | 'geography' | 'relationships';
-interface CompositionRecommendation {
-    id: string;
-    title: string;
-    reason: string;
-    tradeoff: string;
-    spec: VizSpec;
-}
-interface ObservationIdentity {
-    observation: string;
-    series?: string;
-    persistent: boolean;
-}
-interface ReaderObservation extends ObservationIdentity {
-    /** Aggregates are visible groups and never imply a raw-row selection. */
-    kind?: 'row' | 'aggregate';
-    datum: DataRow;
-    previous?: DataRow;
-    state: 'visible' | 'filtered';
-}
-interface ReaderSelection {
-    preview: ReaderObservation | null;
-    pinned: ReaderObservation[];
-    announcement: string;
-}
-/** Explicit relationships; aggregate groups never masquerade as raw rows. */
-interface DatasetBinding {
-    dataset: string;
-    entityField: string;
-    kind: 'row' | 'group';
-    transform?: string;
-    groupMembers?: Record<string, Array<string | number>>;
-}
-
-/**
- * Per-mark-type encoding validation rules.
- *
- * Defines which encoding channels are required vs optional for each mark type.
- * The engine compiler uses these rules to validate specs at runtime (TypeScript
- * catches compile-time errors; these catch runtime JSON from Claude or APIs).
- */
-
-/** Constraint on what field types are valid for an encoding channel. */
-interface ChannelRule {
-    /** Whether this channel is required for the chart type. */
-    required: boolean;
-    /** Allowed field types. If empty, any field type is accepted. */
-    allowedTypes: FieldType[];
-}
-/** Encoding rules for a single chart type: which channels are required/optional. */
-interface EncodingRule {
-    x: ChannelRule;
-    y: ChannelRule;
-    x2?: ChannelRule;
-    y2?: ChannelRule;
-    color: ChannelRule;
-    size: ChannelRule;
-    opacity?: ChannelRule;
-    strokeDash?: ChannelRule;
-    text?: ChannelRule;
-    tooltip?: ChannelRule;
-    theta?: ChannelRule;
-    detail: ChannelRule;
-}
-/**
- * Encoding rules per mark type.
- *
- * Defines which channels are required and what field types they accept.
- * The compiler uses this map to validate user specs at runtime.
- *
- * Key design decisions:
- * - line/area: x is temporal/ordinal (the axis), y is quantitative (the value)
- * - bar: covers both horizontal and vertical orientations, so both axes accept
- *   all relevant types. The engine validates the combination later (one axis
- *   must be quantitative).
- * - arc: no x axis; y is the value (quantitative), color is the category
- * - circle: y is the category, x is quantitative
- * - point: both axes are quantitative
- * - text/rule: fully optional positioning
- * - tick/rect: both axes required, any type
- * - beeswarm: both axes optional at the channel level; the compiler enforces
- *   the combination (exactly one quantitative value axis, the other axis an
- *   optional nominal/ordinal lane channel)
- * - waffle: no positional axes; y is the share value (quantitative, with
- *   theta accepted as an alias like arc), color is the category
- * - calendar: x is the daily date (temporal), color the per-day value
- *   (quantitative); no y channel (the calendar owns its own geometry)
- * - parliament: no positional axes; theta (aliased to y) is the seat count
- *   (quantitative), color the party
- */
-declare const MARK_ENCODING_RULES: Record<MarkType, EncodingRule>;
-/** Encoding rule for a single graph visual channel. */
-interface GraphChannelRule {
-    /** Whether this channel is required. */
-    required: boolean;
-    /** Allowed field types. Empty means any type. */
-    allowedTypes: FieldType[];
-}
-/**
- * Encoding rules for graph visualizations.
- *
- * All graph encoding channels are optional since a graph can be rendered
- * with just nodes and edges (uniform appearance). Encoding channels add
- * visual differentiation based on data fields.
- */
-declare const GRAPH_ENCODING_RULES: Record<string, GraphChannelRule>;
-
 /**
  * Chart interaction event types.
  *
@@ -5896,6 +5880,23 @@ declare const GRAPH_ENCODING_RULES: Record<string, GraphChannelRule>;
  * mark elements and constructs these typed events from the raw browser events.
  */
 
+/** A source-addressed durable edit. Paths use escaped RFC 6901 JSON Pointers. */
+interface EditOp {
+    op: 'set' | 'remove' | 'add';
+    path: string;
+    value?: unknown;
+    /** Preconditions on the nearest authored annotation ancestor. */
+    expect?: {
+        id?: string;
+        type?: string;
+        text?: string;
+    };
+}
+/** All operations succeed together. Revision is optional host bookkeeping. */
+interface EditTransaction {
+    revision?: string | number;
+    ops: EditOp[];
+}
 /** Identifies a specific chrome text element (title, subtitle, source, byline, footer). */
 type ChromeKey = 'title' | 'subtitle' | 'source' | 'byline' | 'footer';
 /**
@@ -5910,6 +5911,8 @@ type ElementRef = {
     id?: string;
     /** RFC 6901 JSON Pointer to the edited property in the spec. */
     path?: string;
+    /** Rendered facet instance; source identity remains index/id/path. */
+    facetInstance?: string;
 } | {
     type: 'chrome';
     key: ChromeKey;
@@ -5933,7 +5936,9 @@ type ElementRef = {
 };
 /** Helper constructors for ergonomic ElementRef creation. */
 declare const elementRef: {
-    readonly annotation: (index: number, id?: string, path?: string) => ElementRef;
+    readonly annotation: (index: number, id?: string, path?: string) => Extract<ElementRef, {
+        type: "annotation";
+    }>;
     readonly chrome: (key: ChromeKey, path?: string) => ElementRef;
     readonly seriesLabel: (series: string, path?: string) => ElementRef;
     readonly legend: (path?: string) => ElementRef;
@@ -5955,6 +5960,10 @@ type ElementEdit = {
     element: ElementRef;
     annotation: TextAnnotation;
     offset: AnnotationOffset;
+    /** Resolved first-drag placement. Persist together with offset when supplied. */
+    anchor?: TextAnnotation['anchor'];
+    /** A moved annotation stays inline. */
+    responsive?: false;
 } | {
     type: 'annotation-connector';
     element: ElementRef;
@@ -6062,16 +6071,20 @@ interface ChartEventHandlers {
      */
     onHighlightChange?: (values: string[]) => void;
     /** Called when an annotation element is clicked. */
-    onAnnotationClick?: (annotation: Annotation, event: MouseEvent) => void;
-    /** Called when a text annotation label is dragged to a new position. */
+    onAnnotationClick?: (annotation: Annotation, event: MouseEvent, element: ElementRef) => void;
+    /** @deprecated Use onEditTransaction to persist complete edits. */
     onAnnotationEdit?: (annotation: TextAnnotation, updatedOffset: AnnotationOffset) => void;
     /** Unified edit callback. Fires for any spec-modifying edit (repositioning, deletion, text editing). */
     onEdit?: (edit: ElementEdit) => void;
+    /** Optional source revision, stamped on emitted transactions. */
+    revision?: string | number;
+    /** Durable authored edits, applied atomically with applyEditTransaction. */
+    onEditTransaction?: (transaction: EditTransaction) => void;
     /** Fired when an element is selected via click or programmatic select(). */
     onSelect?: (element: ElementRef) => void;
     /** Fired when the current element is deselected (click empty, Escape, or new selection replaces old). */
     onDeselect?: (element: ElementRef) => void;
-    /** Fired when inline text editing commits. Also flows through onEdit as a 'text-edit' event. */
+    /** @deprecated Use onEditTransaction with a text set operation. */
     onTextEdit?: (element: ElementRef, oldText: string, newText: string) => void;
     /**
      * Fired when a "you draw it" (`youDrawIt`) drawing is revealed (button click
@@ -6084,6 +6097,98 @@ interface ChartEventHandlers {
     }>) => void;
 }
 
+type EditTransactionResult<T> = {
+    ok: true;
+    spec: T;
+    inverse: EditTransaction;
+} | {
+    ok: false;
+    error: {
+        opIndex: number;
+        path: string;
+        reason: string;
+    };
+};
+/**
+ * Apply an ordered transaction to a private copy, returning it only when every
+ * operation validates. The original spec is never mutated, even on failure.
+ * The inverse restores both values and optional containers created by add.
+ */
+declare function applyEditTransaction<T>(spec: T, tx: EditTransaction): EditTransactionResult<T>;
+
+/**
+ * Per-mark-type encoding validation rules.
+ *
+ * Defines which encoding channels are required vs optional for each mark type.
+ * The engine compiler uses these rules to validate specs at runtime (TypeScript
+ * catches compile-time errors; these catch runtime JSON from Claude or APIs).
+ */
+
+/** Constraint on what field types are valid for an encoding channel. */
+interface ChannelRule {
+    /** Whether this channel is required for the chart type. */
+    required: boolean;
+    /** Allowed field types. If empty, any field type is accepted. */
+    allowedTypes: FieldType[];
+}
+/** Encoding rules for a single chart type: which channels are required/optional. */
+interface EncodingRule {
+    x: ChannelRule;
+    y: ChannelRule;
+    x2?: ChannelRule;
+    y2?: ChannelRule;
+    color: ChannelRule;
+    size: ChannelRule;
+    opacity?: ChannelRule;
+    strokeDash?: ChannelRule;
+    text?: ChannelRule;
+    tooltip?: ChannelRule;
+    theta?: ChannelRule;
+    detail: ChannelRule;
+}
+/**
+ * Encoding rules per mark type.
+ *
+ * Defines which channels are required and what field types they accept.
+ * The compiler uses this map to validate user specs at runtime.
+ *
+ * Key design decisions:
+ * - line/area: x is temporal/ordinal (the axis), y is quantitative (the value)
+ * - bar: covers both horizontal and vertical orientations, so both axes accept
+ *   all relevant types. The engine validates the combination later (one axis
+ *   must be quantitative).
+ * - arc: no x axis; y is the value (quantitative), color is the category
+ * - circle: y is the category, x is quantitative
+ * - point: both axes are quantitative
+ * - text/rule: fully optional positioning
+ * - tick/rect: both axes required, any type
+ * - beeswarm: both axes optional at the channel level; the compiler enforces
+ *   the combination (exactly one quantitative value axis, the other axis an
+ *   optional nominal/ordinal lane channel)
+ * - waffle: no positional axes; y is the share value (quantitative, with
+ *   theta accepted as an alias like arc), color is the category
+ * - calendar: x is the daily date (temporal), color the per-day value
+ *   (quantitative); no y channel (the calendar owns its own geometry)
+ * - parliament: no positional axes; theta (aliased to y) is the seat count
+ *   (quantitative), color the party
+ */
+declare const MARK_ENCODING_RULES: Record<MarkType, EncodingRule>;
+/** Encoding rule for a single graph visual channel. */
+interface GraphChannelRule {
+    /** Whether this channel is required. */
+    required: boolean;
+    /** Allowed field types. Empty means any type. */
+    allowedTypes: FieldType[];
+}
+/**
+ * Encoding rules for graph visualizations.
+ *
+ * All graph encoding channels are optional since a graph can be rendered
+ * with just nodes and edges (uniform appearance). Encoding channels add
+ * visual differentiation based on data fields.
+ */
+declare const GRAPH_ENCODING_RULES: Record<string, GraphChannelRule>;
+
 /**
  * Color blindness simulation and palette distinguishability checks.
  *
@@ -6316,7 +6421,10 @@ declare function adaptForLightLineStroke(color: string): string;
 /**
  * The default theme. All fields are required and fully specified.
  */
-declare const DEFAULT_THEME: Theme;
+declare const DEFAULT_THEME: ThemeBase;
+
+/** Merge authored theme layers with v8 shallow precedence (later layers win). */
+declare function mergeThemeConfig(base: ThemeConfig | undefined, override: ThemeConfig | undefined): ThemeConfig | undefined;
 
 /**
  * Named theme presets built on the design token system.
@@ -6386,7 +6494,7 @@ declare const legacyEditorial: ThemeConfig;
  * @param base - Base theme to merge onto. Defaults to DEFAULT_THEME.
  * @returns A ResolvedTheme with all properties guaranteed.
  */
-declare function resolveTheme(userTheme?: ThemeConfig, base?: Theme): ResolvedTheme;
+declare function resolveTheme(userTheme?: ThemeConfig, base?: ThemeBase): ResolvedTheme;
 
 /**
  * Chrome layout computation.
@@ -6411,15 +6519,12 @@ declare function resolveTheme(userTheme?: ThemeConfig, base?: Theme): ResolvedTh
  * the last line drifts outside the band that was reserved for it.
  */
 declare const FOOTNOTE_LINE_HEIGHT = 1.3;
+/** Internal compiler arithmetic and compatibility fallback for hand-built layouts. */
+declare function computeNoteBandHeight(input: number | Pick<ResolvedChrome, 'noteBandHeight' | 'footnotes' | 'seriesSummary'>, theme: ResolvedTheme): number;
 /**
- * Vertical space a footnote list of `count` lines occupies below the plot.
- *
- * Single source of truth, deliberately: the engine reserves this band in the
- * bottom margin, the chrome renderer shifts the source row down by it, and the
- * brand watermark shifts by it too. When those three disagree the footnotes
- * land on top of the watermark, which is exactly the bug this centralizes away.
+ * @deprecated Read layout.chrome.noteBandHeight. The numeric signature remains compatible in 8.x.
  */
-declare function footnoteBandHeight(count: number, theme: ResolvedTheme): number;
+declare function footnoteBandHeight(input: number | Pick<ResolvedChrome, 'noteBandHeight' | 'footnotes' | 'seriesSummary'>, theme: ResolvedTheme): number;
 /**
  * Compute resolved chrome layout from a Chrome spec and resolved theme.
  *
@@ -6915,7 +7020,7 @@ interface ChartBuilderOptions {
     responsive?: boolean;
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
-    /** Dark mode behavior. */
+    /** @deprecated Set darkMode on the mount instead; this option has no effect. */
     darkMode?: DarkMode;
 }
 /** Options for the dataTable builder. */
@@ -6928,7 +7033,7 @@ interface TableBuilderOptions {
     chrome?: Chrome;
     /** Theme configuration overrides. */
     theme?: ThemeConfig;
-    /** Dark mode behavior. */
+    /** @deprecated Set darkMode on the mount instead; this option has no effect. */
     darkMode?: DarkMode;
     /** Enable client-side search/filter. */
     search?: boolean;
@@ -6938,7 +7043,9 @@ interface TableBuilderOptions {
     };
     /** Stick the first column during horizontal scroll. */
     stickyFirstColumn?: boolean;
-    /** Compact mode. */
+    /** Row density. */
+    density?: TableDensity;
+    /** @deprecated Use density. */
     compact?: boolean;
     /** Whether the table adapts to container width. */
     responsive?: boolean;
@@ -7059,7 +7166,7 @@ interface TileMapBuilderOptions {
     legend?: LegendConfig;
     /** Theme overrides. */
     theme?: ThemeConfig;
-    /** Dark mode setting. */
+    /** @deprecated Set darkMode on the mount instead; this option has no effect. */
     darkMode?: DarkMode;
     /** Whether to show the watermark. */
     watermark?: boolean;
@@ -7094,6 +7201,12 @@ declare function tileMap(data: Record<string, number | string | null> | DataRow[
  */
 declare function deepMergeSpec(target: any, source: any): any;
 
+/** Matches layer compilation's parent-or-first-leaf annotation ownership. */
+declare function annotationSource(spec: unknown): {
+    annotations: Annotation[];
+    path: string;
+};
+
 /** Deterministic, bounded motion shared by rendering and timestamp-based export. */
 
 interface MotionPhase {
@@ -7142,4 +7255,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 AnimationPreset, 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_EXTENDED_PALETTE, CATEGORICAL_FILL_PALETTE, CATEGORICAL_FILL_PALETTE_DARK, CATEGORICAL_PALETTE, CATEGORICAL_PALETTE_DARK, COMPACT_MAX_X_TICKS, 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 ChromeEconomy, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ChromeThemeOverride, type CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type CompileWarning, type CompositionRecommendation, 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 DatasetBinding, type DateGranularity, type DeltaColumnConfig, type DeltaTableCell, type DensityEncoding, type DensityTransform, type DesignDiagnostic, type DesignQuestion, 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, FLUID_SPRING, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, type FieldMetadata, 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 GeoMapZoomConfig, 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_MINIMAL_MAX, HEIGHT_NO_GRID_MAX, HEIGHT_SHORT_MAX, HPAD_COMPACT_FRACTION, HPAD_COMPACT_MIN, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type HistogramEncoding, type ImageColumnConfig, type ImageTableCell, type JoinAggregateTransform, 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_SPRING_DURATION, MAX_SR_TABLE_ROWS, MOTION_REST_THRESHOLD, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, type MotionPhase, type MotionSample, NARROW_VIEWPORT_MAX, type NeutralRamp, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type ObservationIdentity, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, type ReaderObservation, type ReaderSelection, 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 ResolvedChromeRule, type ResolvedColumn, type ResolvedFillPattern, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, type ResolvedSeriesSearch, type ResolvedTheme, type ResolvedThemeColors, 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 SpecPatch, type SpringConfig, type StoredVizSpec, TICK_LABEL_OFFSET, TICK_LINE_HEIGHT_FACTOR, TOP_PAD_EXTRA_NARROW, TOP_PAD_NARROW_MAX, type TableBuilderOptions, type TableCell, type TableCellBase, type TableDensity, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TableTotalRow, 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 ThemeRule, 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, broadsheet, buildCompactStepFormatter, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, clarity, columnChart, computeChrome, computeFieldFormatContext, computeLabelBounds, computeXAxisExtentFromLabels, contrastRatio, cssTokenDefault, dataTable, deepMergeSpec, defaultNumberFormatter, deriveNeutralRamp, 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, legacyEditorial, lineChart, maxRotatedLabelWidth, meetsAA, motionCSS, overlapArea, pickLabelColor, pieChart, resolveChromeEconomy, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, sampleMotion, scatterChart, simulateColorBlindness, springDuration, terminal, textAscent, tileMap, truncateRotatedLabel, truncateToWidth, wire, wrapText };
+export { type A11yConfig, type A11yMetadata, ACHROMATIC_RAMP, AXIS_TITLE_GAP, AXIS_TITLE_OFFSET_COMPACT, AXIS_TITLE_OFFSET_DEFAULT, AXIS_TITLE_TRAILING_PAD, type AggregateOp, type AggregateTransform, type AnimationConfig, type AnimationEase, type AnimationPhaseConfig, type AnimationPreset, 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_EXTENDED_PALETTE, CATEGORICAL_FILL_PALETTE, CATEGORICAL_FILL_PALETTE_DARK, CATEGORICAL_PALETTE, CATEGORICAL_PALETTE_DARK, COMPACT_MAX_X_TICKS, 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 ChromeEconomy, type ChromeKey, type ChromeMode, type ChromeText, type ChromeTextStyle, type ChromeThemeOverride, type CircleEncoding, type ColorBlindnessType, type ColumnConfig, type CompileOptions, type CompileTableOptions, type CompileWarning, type CompositionRecommendation, 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 DatasetBinding, type DateGranularity, type DeltaColumnConfig, type DeltaTableCell, type DensityEncoding, type DensityTransform, type DesignDiagnostic, type DesignQuestion, type Display, type DivergingPalette, EXTENDED_OFFSET_STRATEGIES, type EditOp, type EditTransaction, type EditTransactionResult, type ElementEdit, type ElementRef, type Encoding, type EncodingChannel, type EncodingRule, type EndpointLabelContent, type EndpointLabelEntry, type EndpointLabelsConfig, type EndpointLabelsLayout, FLUID_SPRING, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, type FieldMetadata, 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 GeoMapZoomConfig, 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_MINIMAL_MAX, HEIGHT_NO_GRID_MAX, HEIGHT_SHORT_MAX, HPAD_COMPACT_FRACTION, HPAD_COMPACT_MIN, type HeatmapColumnConfig, type HeatmapTableCell, type HeightClass, type HistogramEncoding, type ImageColumnConfig, type ImageTableCell, type JoinAggregateTransform, 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_SPRING_DURATION, MAX_SR_TABLE_ROWS, MOTION_REST_THRESHOLD, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, type MotionPhase, type MotionSample, NARROW_VIEWPORT_MAX, type NeutralRamp, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type ObservationIdentity, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, type ReaderObservation, type ReaderSelection, 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 ResolvedChromeRule, type ResolvedColumn, type ResolvedFillPattern, type ResolvedLabel, type ResolvedMetricBar, type ResolvedMetricCell, type ResolvedSeriesSearch, type ResolvedTheme, type ResolvedThemeColors, 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 SpecPatch, type SpringConfig, type StoredVizSpec, TICK_LABEL_OFFSET, TICK_LINE_HEIGHT_FACTOR, TOP_PAD_EXTRA_NARROW, TOP_PAD_NARROW_MAX, type TableBuilderOptions, type TableCell, type TableCellBase, type TableDensity, type TableLayout, type TableRow, type TableSpec, type TableSpecWithoutData, type TableTotalRow, 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 ThemeRule, 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, annotationSource, applyEditTransaction, areaChart, axisTitleOffset, barChart, broadsheet, buildCompactStepFormatter, buildD3Formatter, buildTemporalFormatter, checkPaletteDistinguishability, clarity, columnChart, computeChrome, computeFieldFormatContext, computeLabelBounds, computeNoteBandHeight, computeXAxisExtentFromLabels, contrastRatio, cssTokenDefault, dataTable, deepMergeSpec, defaultNumberFormatter, deriveNeutralRamp, 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, legacyEditorial, lineChart, maxRotatedLabelWidth, meetsAA, mergeThemeConfig, motionCSS, overlapArea, pickLabelColor, pieChart, resolveChromeEconomy, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, sampleMotion, scatterChart, simulateColorBlindness, springDuration, terminal, textAscent, tileMap, truncateRotatedLabel, truncateToWidth, wire, wrapText };