@opendata-ai/openchart-core 6.25.4 → 6.27.0

package/dist/index.d.ts

@@ -328,6 +328,8 @@ interface AxisConfig {
     labelPadding?: number;
     /** Color override for axis tick labels and title. Useful in dual-axis charts to match axis color to its series. */
     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;
 }
 /** Scale configuration for an encoding channel. */
 interface ScaleConfig {
@@ -815,6 +817,16 @@ interface AnimationConfig {
  * - AnimationConfig: full control via enter/update/exit phases
  */
 type AnimationSpec = boolean | AnimationConfig;
+/**
+ * Chart display mode.
+ * - `'full'` (default): standard chart with chrome, axes, legend, padding.
+ * - `'sparkline'`: minimal inline mini-chart. Strips chrome, axes, legend,
+ *   watermark, animation, and reduces margins to a tiny safety pad. The mark
+ *   fills the container edge-to-edge. Best with `mark: 'line' | 'area' | 'bar'`.
+ *   Explicit user fields (chrome, legend, encoding.x.axis, etc.) still render
+ *   when set, so users can opt in to specific elements.
+ */
+type Display = 'full' | 'sparkline';
 /**
  * Breakpoint-conditional overrides for chart specs.
  *
@@ -833,6 +845,12 @@ interface ChartSpecOverride {
     annotations?: Annotation[];
     /** Override animation at this breakpoint. */
     animation?: AnimationSpec;
+    /** Override display mode (`'full'` or `'sparkline'`) at this breakpoint. */
+    display?: Display;
+    /** Override watermark visibility at this breakpoint. */
+    watermark?: boolean;
+    /** Override crosshair behavior at this breakpoint. */
+    crosshair?: boolean;
 }
 /**
  * Chart specification: the primary input for standard chart types.
@@ -887,6 +905,28 @@ interface ChartSpec {
      * - AnimationConfig: full control via enter/update/exit phases
      */
     animation?: AnimationSpec;
+    /**
+     * Show a vertical crosshair line that tracks the nearest data point on
+     * line and area charts. Only active when a voronoi overlay is present.
+     * Defaults to false. In sparkline display mode, defaults to false unless
+     * explicitly set.
+     */
+    crosshair?: boolean;
+    /**
+     * Display mode controlling how much chart chrome is rendered.
+     *
+     * - `'full'` (default): full publication chart with chrome, axes, legend, padding.
+     * - `'sparkline'`: inline mini-chart for dashboards/KPI cards. Strips chrome,
+     *   axes, legend, watermark, animation, and crosshair. The mark fills the
+     *   container edge-to-edge with a small safety margin. Best with
+     *   `mark: 'line' | 'area' | 'bar' | 'point'`.
+     *
+     * **Override precedence:** explicit user fields always win, even in sparkline
+     * mode. Setting `chrome.title` on a sparkline still renders the title.
+     * Setting `legend: { show: true }` still renders the legend. This applies at
+     * top-level and per-breakpoint overrides.
+     */
+    display?: Display;
     /**
      * Render order within a LayerSpec. Higher values render on top.
      * When omitted, layers render in array order (later layers paint on top).
@@ -1110,6 +1150,51 @@ interface SankeySpec {
      */
     valueFormat?: string;
 }
+/** Encoding channels specific to tile map visualizations. */
+interface TileMapEncoding {
+    /** State code field (required, nominal). Maps to US state abbreviations. */
+    state: EncodingChannel;
+    /** Value field (required, quantitative). Maps to the sequential color scale. */
+    value: EncodingChannel;
+    /** Tooltip encoding (optional). */
+    tooltip?: EncodingChannel | EncodingChannel[];
+}
+/** Sequential color palette names available for tile maps. */
+type TileMapPalette = 'blue' | 'green' | 'orange' | 'purple';
+interface TileMapSpec {
+    /** Discriminant: always "tilemap". */
+    type: 'tilemap';
+    /**
+     * Data for the tile map. Accepts either:
+     * - A record mapping state codes to numeric values: `{ "CA": 12000, "TX": 8500 }`
+     * - Tabular data rows with state and value fields (requires encoding)
+     */
+    data: Record<string, number | null> | DataRow[];
+    /**
+     * Encoding channels mapping data fields to visual properties.
+     * Required when data is DataRow[]. Auto-generated when data is a record map.
+     */
+    encoding?: TileMapEncoding;
+    /** Sequential color palette. Defaults to 'blue'. */
+    palette?: TileMapPalette;
+    /** Editorial chrome (title, subtitle, source, byline, footer). */
+    chrome?: Chrome;
+    /** Legend display configuration. */
+    legend?: LegendConfig;
+    /** Theme configuration overrides. */
+    theme?: ThemeConfig;
+    /** Dark mode behavior. Defaults to "off". */
+    darkMode?: DarkMode;
+    /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
+    watermark?: boolean;
+    /** Animation configuration for entrance animations. */
+    animation?: AnimationSpec;
+    /**
+     * d3-format string applied to tile values, legend labels, and tooltips.
+     * Examples: ".1f" for one decimal, "$,.0f" for currency, "~s" for SI.
+     */
+    valueFormat?: string;
+}
 /**
  * Top-level visualization spec: union discriminated by structural shape.
  *
@@ -1118,8 +1203,9 @@ interface SankeySpec {
  * - TableSpec: has `type: 'table'`
  * - GraphSpec: has `type: 'graph'`
  * - SankeySpec: has `type: 'sankey'`
+ * - TileMapSpec: has `type: 'tilemap'`
  */
-type VizSpec = ChartSpec | LayerSpec | TableSpec | GraphSpec | SankeySpec;
+type VizSpec = ChartSpec | LayerSpec | TableSpec | GraphSpec | SankeySpec | TileMapSpec;
 /** Chart spec without runtime data, for persistence/storage. */
 type ChartSpecWithoutData = Omit<ChartSpec, 'data'>;
 /** Table spec without runtime data and columns, for persistence/storage. Columns can be auto-generated via dataTable(). */
@@ -1128,8 +1214,10 @@ type TableSpecWithoutData = Omit<TableSpec, 'data' | 'columns'>;
 type GraphSpecWithoutData = Omit<GraphSpec, 'nodes' | 'edges'>;
 /** Sankey spec without runtime data, for persistence/storage. */
 type SankeySpecWithoutData = Omit<SankeySpec, 'data'>;
+/** TileMap spec without runtime data, for persistence/storage. */
+type TileMapSpecWithoutData = Omit<TileMapSpec, 'data'>;
 /** Union of data-stripped spec types for persistence/storage. */
-type StoredVizSpec = ChartSpecWithoutData | TableSpecWithoutData | GraphSpecWithoutData | SankeySpecWithoutData;
+type StoredVizSpec = ChartSpecWithoutData | TableSpecWithoutData | GraphSpecWithoutData | SankeySpecWithoutData | TileMapSpecWithoutData;
 /** Logical AND combinator for filter predicates. */
 interface LogicalAnd<T> {
     and: T[];
@@ -1142,6 +1230,12 @@ interface LogicalOr<T> {
 interface LogicalNot<T> {
     not: T;
 }
+/** A relative-time reference that resolves against the data extent. */
+interface RelativeTimeRef {
+    anchor: 'max' | 'min';
+    offset: number;
+    unit: 'day' | 'week' | 'month' | 'quarter' | 'year';
+}
 /** A predicate that tests a field value against a condition. */
 interface FieldPredicate {
     /** Data field to test. */
@@ -1149,15 +1243,15 @@ interface FieldPredicate {
     /** Equals comparison. */
     equal?: unknown;
     /** Less than. */
-    lt?: number;
+    lt?: number | RelativeTimeRef;
     /** Less than or equal. */
-    lte?: number;
+    lte?: number | RelativeTimeRef;
     /** Greater than. */
-    gt?: number;
+    gt?: number | RelativeTimeRef;
     /** Greater than or equal. */
-    gte?: number;
+    gte?: number | RelativeTimeRef;
     /** Inclusive range [min, max]. */
-    range?: [number, number];
+    range?: [number | RelativeTimeRef, number | RelativeTimeRef];
     /** Value is one of these. */
     oneOf?: unknown[];
     /** Whether the value is valid (non-null, non-undefined, non-NaN). */
@@ -1237,8 +1331,31 @@ interface FoldTransform {
     /** Output field names for [key, value]. Defaults to ['key', 'value']. */
     as?: [string, string];
 }
+/** Window operation types for computing values relative to other rows. */
+type WindowOp = 'lag' | 'lead' | 'diff' | 'pct_change' | 'cumsum' | 'rank' | 'first_value';
+/** Sort field definition for window transforms. */
+interface WindowSortField {
+    field: string;
+    order?: 'ascending' | 'descending';
+}
+/** Window field definition specifying which operation to compute. */
+interface WindowFieldDef {
+    op: WindowOp;
+    field: string;
+    /** Row offset for lag/lead/diff/pct_change. Defaults to 1. */
+    offset?: number;
+    as: string;
+}
+/** Window transform: computes values relative to other rows in sort order within a partition. */
+interface WindowTransform {
+    window: WindowFieldDef[];
+    /** Fields to sort by within each partition. */
+    sort: WindowSortField[];
+    /** Fields to partition (group) by. Each group is windowed independently. */
+    groupby?: string[];
+}
 /** Discriminated union of all transform types. */
-type Transform = FilterTransform | BinTransform | CalculateTransform | TimeUnitTransform | AggregateTransform | FoldTransform;
+type Transform = FilterTransform | BinTransform | CalculateTransform | TimeUnitTransform | AggregateTransform | FoldTransform | WindowTransform;
 /**
  * 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.
@@ -1295,6 +1412,8 @@ declare function isTableSpec(spec: VizSpec | Record<string, unknown>): spec is T
 declare function isGraphSpec(spec: VizSpec | Record<string, unknown>): spec is GraphSpec;
 /** Check if a spec is a SankeySpec. */
 declare function isSankeySpec(spec: VizSpec | Record<string, unknown>): spec is SankeySpec;
+/** Check if a spec is a TileMapSpec. */
+declare function isTileMapSpec(spec: VizSpec | Record<string, unknown>): spec is TileMapSpec;
 /** Check if an annotation is a TextAnnotation. */
 declare function isTextAnnotation(annotation: Annotation): annotation is TextAnnotation;
 /** Check if an annotation is a RangeAnnotation. */
@@ -1731,6 +1850,8 @@ interface AxisTick {
     position: number;
     /** Formatted label string for display. */
     label: string;
+    /** Secondary label text from axis.labelField. */
+    subtitle?: string;
 }
 /** A single gridline with computed positions. */
 interface Gridline {
@@ -2131,7 +2252,7 @@ interface ResolvedAnnotation {
     /** Z-index for render ordering. Higher values render on top. */
     zIndex?: number;
 }
-/** A single entry in the legend. */
+/** A single entry in a categorical legend. */
 interface LegendEntry {
     /** The label text (category name or range description). */
     label: string;
@@ -2144,16 +2265,21 @@ interface LegendEntry {
     /** True for overflow indicator entries ("+N more"). Not interactive. */
     overflow?: boolean;
 }
-/** Resolved legend layout with position and entries. */
-interface LegendLayout {
+/** Base legend layout fields shared by all legend types. */
+interface BaseLegendLayout {
     /** Where the legend is positioned relative to the chart area. */
     position: 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
-    /** Legend entries. */
-    entries: LegendEntry[];
     /** Bounding box for the legend (pixel coordinates). */
     bounds: Rect;
     /** Entry label style. */
     labelStyle: TextStyle;
+}
+/** Categorical legend with discrete swatch entries. */
+interface CategoricalLegendLayout extends BaseLegendLayout {
+    /** Discriminant for legend type. Omitted means categorical (backwards compat). */
+    type?: 'categorical';
+    /** Legend entries. */
+    entries: LegendEntry[];
     /** Swatch size in pixels. */
     swatchSize: number;
     /** Gap between swatch and label. */
@@ -2161,6 +2287,26 @@ interface LegendLayout {
     /** Gap between entries. */
     entryGap: number;
 }
+/** A color stop in a gradient legend. */
+interface GradientColorStop {
+    /** Position along the gradient (0 to 1). */
+    offset: number;
+    /** CSS color value. */
+    color: string;
+}
+/** Gradient legend for continuous color scales. */
+interface GradientLegendLayout extends BaseLegendLayout {
+    /** Discriminant for legend type. */
+    type: 'gradient';
+    /** Color stops for the gradient bar. */
+    colorStops: GradientColorStop[];
+    /** Formatted minimum value label. */
+    minLabel: string;
+    /** Formatted maximum value label. */
+    maxLabel: string;
+}
+/** Resolved legend layout — either categorical (swatches) or gradient (continuous bar). */
+type LegendLayout = CategoricalLegendLayout | GradientLegendLayout;
 /** A single field-value pair in a tooltip. */
 interface TooltipField {
     /** Field label (e.g. "GDP Growth"). */
@@ -2244,6 +2390,10 @@ interface ChartLayout {
     animation?: ResolvedAnimation;
     /** Whether the tryOpenData.ai watermark is enabled. */
     watermark: boolean;
+    /** Display mode controlling chrome/axes/legend stripping. `'sparkline'` produces an edge-to-edge mini chart. */
+    display: Display;
+    /** Whether the crosshair (vertical snap line) is enabled. */
+    crosshair: boolean;
     /** Real text measurement function from the adapter (for accurate SVG text wrapping). */
     measureText?: MeasureTextFn;
 }
@@ -2582,6 +2732,74 @@ interface SankeyLayout {
     /** Real text measurement function from the adapter (for accurate SVG text wrapping). */
     measureText?: MeasureTextFn;
 }
+/** A resolved tile map tile with computed position and visual properties. */
+interface TileMapTileMark {
+    type: 'tile';
+    /** Left edge x position. */
+    x: number;
+    /** Top edge y position. */
+    y: number;
+    /** Tile width and height (tiles are square). */
+    size: number;
+    /** Fill color from the sequential color scale. */
+    fill: string;
+    /** Tile border color. */
+    stroke: string;
+    /** Tile border width. */
+    strokeWidth: number;
+    /** Corner radius. */
+    cornerRadius: number;
+    /** US state abbreviation (e.g. "CA", "TX"). */
+    stateCode: string;
+    /** Numeric value (null if state has no data). */
+    value: number | null;
+    /** Formatted value string (e.g. "12,000" or "–" for missing). */
+    formattedValue: string;
+    /** Whether this state has data. False for missing states. */
+    hasData: boolean;
+    /** State code text label (positioned inside tile). */
+    label: ResolvedLabel;
+    /** Value text label (positioned inside tile, below state code). */
+    valueLabel: ResolvedLabel;
+    /** Accessibility attributes. */
+    aria: MarkAria;
+    /** Index for stagger animation ordering. */
+    animationIndex?: number;
+    /** Original data associated with this tile. */
+    data: Record<string, unknown>;
+}
+/**
+ * TileMapLayout: the complete engine output for tile map visualizations.
+ *
+ * Contains everything an adapter needs to render the tile map: dimensions,
+ * chrome, tiles, gradient legend, tooltip descriptors, and accessibility metadata.
+ */
+interface TileMapLayout {
+    /** The tile map drawing area (after chrome and legend are subtracted). */
+    area: Rect;
+    /** Resolved chrome text elements with positions and styles. */
+    chrome: ResolvedChrome;
+    /** Resolved tile marks with positions, colors, and labels. */
+    tiles: TileMapTileMark[];
+    /** Gradient color legend (null if legend is hidden). */
+    gradientLegend: GradientLegendLayout | null;
+    /** Tooltip content descriptors keyed by state code. */
+    tooltipDescriptors: Map<string, TooltipContent>;
+    /** Accessibility metadata for the tile map. */
+    a11y: A11yMetadata;
+    /** Resolved theme. */
+    theme: ResolvedTheme;
+    /** Total SVG width in pixels. */
+    width: number;
+    /** Total SVG height in pixels. */
+    height: number;
+    /** Resolved animation config (undefined if animation is disabled). */
+    animation: ResolvedAnimation | undefined;
+    /** Whether to render the watermark. */
+    watermark: boolean;
+    /** Text measurement function for the rendering adapter. */
+    measureText: MeasureTextFn;
+}
 /** Function signature for text measurement provided by adapters. */
 type MeasureTextFn = (text: string, fontSize: number, fontWeight?: number) => {
     width: number;
@@ -3247,5 +3465,40 @@ declare function scatterChart(data: DataRow[], x: FieldRef, y: FieldRef, options
  * @param options - Column definitions, chrome, pagination, search, etc.
  */
 declare function dataTable(data: DataRow[], options?: TableBuilderOptions): TableSpec;
+/** Options for the tileMap convenience builder. */
+interface TileMapBuilderOptions {
+    /** Encoding channels (required when data is DataRow[]). */
+    encoding?: TileMapEncoding;
+    /** Sequential color palette name. */
+    palette?: TileMapPalette;
+    /** Editorial chrome. */
+    chrome?: Chrome;
+    /** Legend display configuration. */
+    legend?: LegendConfig;
+    /** Theme overrides. */
+    theme?: ThemeConfig;
+    /** Dark mode setting. */
+    darkMode?: DarkMode;
+    /** Whether to show the watermark. */
+    watermark?: boolean;
+    /** Animation configuration. */
+    animation?: AnimationSpec;
+    /** d3-format string for value formatting. */
+    valueFormat?: string;
+}
+/**
+ * Build a TileMapSpec from a state-to-value record or tabular data.
+ *
+ * @example Record map (simplest):
+ * ```ts
+ * tileMap({ CA: 4.4, TX: 17.6, NY: 4.5 })
+ * ```
+ *
+ * @example Tabular data with encoding:
+ * ```ts
+ * tileMap(data, { encoding: { state: { field: 'code' }, value: { field: 'rate' } } })
+ * ```
+ */
+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 BarTableCell, type BinParams, type BinTransform, type Breakpoint, CATEGORICAL_PALETTE, CHART_ENCODING_RULES, CHART_TYPES, COMPACT_WIDTH, type CalculateExpression, type CalculateTransform, 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 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 GradientDef, 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 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 TimeUnit, type TimeUnitTransform, type TooltipContent, type TooltipField, type Transform, type VizSpec, 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, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, 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 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 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, isChartSpec, isConditionalDef, isEncodingChannel, isGradientDef, isGraphSpec, isLayerSpec, isRangeAnnotation, isRefLineAnnotation, isSankeySpec, isTableSpec, isTextAnnotation, isTileMapSpec, lineChart, meetsAA, pieChart, resolveCollisions, resolveMarkDef, resolveMarkType, resolveTheme, scatterChart, simulateColorBlindness, tileMap, wrapText };

package/dist/index.js

@@ -212,6 +212,9 @@ function isGraphSpec(spec) {
 function isSankeySpec(spec) {
   return "type" in spec && spec.type === "sankey";
 }
+function isTileMapSpec(spec) {
+  return "type" in spec && spec.type === "tilemap";
+}
 function isTextAnnotation(annotation) {
   return annotation.type === "text";
 }
@@ -2856,6 +2859,21 @@ function dataTable(data, options) {
   if (options?.responsive !== void 0) spec.responsive = options.responsive;
   return spec;
 }
+function tileMap(data, options) {
+  return {
+    type: "tilemap",
+    data,
+    ...options?.encoding && { encoding: options.encoding },
+    ...options?.palette && { palette: options.palette },
+    ...options?.chrome && { chrome: options.chrome },
+    ...options?.legend && { legend: options.legend },
+    ...options?.theme && { theme: options.theme },
+    ...options?.darkMode && { darkMode: options.darkMode },
+    ...options?.watermark !== void 0 && { watermark: options.watermark },
+    ...options?.animation && { animation: options.animation },
+    ...options?.valueFormat && { valueFormat: options.valueFormat }
+  };
+}
 export {
   AXIS_TITLE_OFFSET_COMPACT,
   AXIS_TITLE_OFFSET_DEFAULT,
@@ -2934,6 +2952,7 @@ export {
   isSankeySpec,
   isTableSpec,
   isTextAnnotation,
+  isTileMapSpec,
   lineChart,
   meetsAA,
   pieChart,
@@ -2943,6 +2962,7 @@ export {
   resolveTheme,
   scatterChart,
   simulateColorBlindness,
+  tileMap,
   wrapText
 };
 //# sourceMappingURL=index.js.map