Skip to main content

Interface: VisualizationSpec

Defined in: spec/types.ts:486

Properties​

__resolved?​

optional __resolved?: boolean

Defined in: spec/types.ts:534

Internal marker set by resolveSpecFromMapType to prevent double-resolution. Consumers should not set this field directly.

adapterHints?​

optional adapterHints?: unknown

Defined in: spec/types.ts:511

Deprecated​

No longer used by the adapter. Kept for backward compatibility so existing specs continue to pass validateSpec(). Will be removed in a future breaking-change release.

basemap?​

optional basemap?: BaseMapSpec

Defined in: spec/types.ts:494

description?​

optional description?: string

Defined in: spec/types.ts:490

engine​

engine: "maplibre"

Defined in: spec/types.ts:491

layers​

layers: VisualizationLayer[]

Defined in: spec/types.ts:496

legendEnabled?​

optional legendEnabled?: boolean

Defined in: spec/types.ts:528

Controls whether auto-generated legends are produced for the resolved mapType. Defaults to true. Has no effect on legends the user supplies directly via spec.legends.

legends?​

optional legends?: LegendSpec[]

Defined in: spec/types.ts:498

Optional top-level legend registry used by legend UI components.

mapData?​

optional mapData?: MapData[]

Defined in: spec/types.ts:504

Optional attribute datasets joined to geojson sources. Each entry references a source via mapId and provides per-feature values for use in styling, tooltips, charts.

mapType?​

optional mapType?: MapType

Defined in: spec/types.ts:492

metadata?​

optional metadata?: Record<string, unknown>

Defined in: spec/types.ts:505

scaleMaxValue?​

optional scaleMaxValue?: number

Defined in: spec/types.ts:521

Visual scale ceiling for proportional symbol rendering.

Values above scaleMaxValue render at the maximum symbol size (e.g. max circle radius). The tooltip always shows the real feature value.

When omitted, the adapter computes it from the dataset.

schemaVersion?​

optional schemaVersion?: number

Defined in: spec/types.ts:488

Schema version this spec was authored against. Omit for the current version — see SPEC_SCHEMA_VERSION.

sources​

sources: DataSource[]

Defined in: spec/types.ts:495

title?​

optional title?: string

Defined in: spec/types.ts:489

view?​

optional view?: ViewState

Defined in: spec/types.ts:493

viewPresets?​

optional viewPresets?: ViewPreset[]

Defined in: spec/types.ts:542

Named, curated camera positions the AI (or a UI control) can jump to by id (dispatch({ type: 'set-view-preset' }), PRD-002) — bounded to positions the application actually declared, instead of raw coordinates an AI would otherwise have to invent.