MAIDR JavaScript API
    Preparing search index...

    Minimal Vega-Lite top-level specification shape.

    Covers single-view, layered (layer), composite (hconcat / vconcat / concat), faceted (facet operator or encoding.row / encoding.column shorthand), and repeated (repeat) specs.

    interface VegaLiteSpec {
        usermeta?: { maidr?: MaidrTraceDeclaration };
        $schema?: string;
        title?: string | { text?: string; subtitle?: string };
        description?: string;
        data?: unknown;
        transform?: VegaLiteTransform[];
        mark?:
            | string
            | {
                type: string;
                interpolate?: string;
                innerRadius?: number;
                extent?: string;
            };
        encoding?: VegaLiteEncoding;
        layer?: VegaLiteSpec[];
        hconcat?: VegaLiteSpec[];
        vconcat?: VegaLiteSpec[];
        concat?: VegaLiteSpec[];
        facet?: VegaLiteFacetDef;
        spec?: VegaLiteSpec;
        repeat?: VegaLiteRepeatDef;
        columns?: number;
    }
    Index

    Properties

    usermeta?: { maidr?: MaidrTraceDeclaration }

    Vega-Lite's own sanctioned slot for third-party metadata, and the only home a JSON-authored or Altair-produced spec has for one.

    usermeta.maidr carries a MaidrTraceDeclaration — what the chart means, where the drawing does not say. It belongs on the spec node that becomes one MAIDR layer: a single-view spec, a layer[i] child, a concat or facet leaf. A block on a composite parent names no one layer and is ignored with a warning.

    $schema?: string
    title?: string | { text?: string; subtitle?: string }
    description?: string
    data?: unknown
    transform?: VegaLiteTransform[]
    mark?:
        | string
        | {
            type: string;
            interpolate?: string;
            innerRadius?: number;
            extent?: string;
        }

    The mark, as a shorthand string or a mark def. interpolate is how Vega-Lite joins consecutive points: the step, step-before and step-after values draw a piecewise-constant staircase, the rest interpolate. innerRadius is what turns an arc pie into a doughnut — purely visual, so the two convert identically. extent is how far a composite mark's interval reaches — stderr, ci, stdev, iqr — which the adapter reads only when it has to aggregate the raw observations itself.

    encoding?: VegaLiteEncoding
    layer?: VegaLiteSpec[]
    hconcat?: VegaLiteSpec[]
    vconcat?: VegaLiteSpec[]
    concat?: VegaLiteSpec[]
    columns?: number

    Wrap column count for concat, wrapped facet (single-field form), and wrapped repeat (array form). Vega-Lite's default when omitted is an unbounded number of columns (a single row).