@opendata-ai/openchart-core 8.4.0 → 8.5.0

package/dist/index.d.ts

@@ -7,7 +7,8 @@
  * - full: > 700px (desktop, full-width)
  *
  * Height classes:
- * - cramped: < 200px (dashboard widgets, thumbnails)
+ * - minimal: < 100px (sparklines, chrome-less thumbnails)
+ * - cramped: 100-199px (dashboard widgets with a compact title)
  * - short: 200-350px (embedded panels, short containers)
  * - normal: > 350px (standard containers)
  */
@@ -21,8 +22,9 @@ declare const BREAKPOINT_MEDIUM_MAX = 700;
  */
 declare function getBreakpoint(width: number): Breakpoint;
 /** Height classification based on container height. */
-type HeightClass = 'cramped' | 'short' | 'normal';
+type HeightClass = 'minimal' | 'cramped' | 'short' | 'normal';
 /** Height class thresholds in pixels. */
+declare const HEIGHT_MINIMAL_MAX = 100;
 declare const HEIGHT_CRAMPED_MAX = 200;
 declare const HEIGHT_SHORT_MAX = 350;
 /**
@@ -1155,6 +1157,12 @@ interface CategoricalLegendLayout extends BaseLegendLayout {
     entryPositions?: LegendEntryPosition[];
     /** Row advance used to build entryPositions (single source of truth). */
     rowHeight?: number;
+    /**
+     * Detached "no data" swatch, drawn after the last entry. Only maps set it,
+     * and only when the geography actually has unjoined features -- their hatch
+     * needs a key like every other fill on the map.
+     */
+    noData?: ContinuousLegendNoData;
 }
 /** A color stop in a gradient legend. */
 interface GradientColorStop {
@@ -1245,6 +1253,11 @@ interface ContinuousLegendNoData {
     size: number;
     /** Swatch fill (the same neutral the unmatched features carry). */
     fill: string;
+    /**
+     * Hatch fill matching the no-data features on a map. When present the
+     * renderer resolves it to a `url(#pattern)` and ignores `fill`.
+     */
+    pattern?: ResolvedFillPattern;
     /** Label text, e.g. "No data". */
     label: string;
     /** Label x (pixel coordinates); baseline y is the legend's `labelY`. */
@@ -2186,6 +2199,16 @@ interface GeoMapFeatureMark {
      * `data-bin-index` so hovering a legend swatch can dim everything else.
      */
     binIndex?: number;
+    /**
+     * True when a color encoding is present but the join left this feature
+     * without a value. A value of exactly 0 is data, not a hole.
+     */
+    noData?: boolean;
+    /**
+     * Hatch fill for no-data features. A neutral solid is indistinguishable from
+     * the middle class of a diverging ramp, so holes get a texture instead.
+     */
+    pattern?: ResolvedFillPattern;
 }
 /** A resolved map point mark with projected coordinates and visual properties. */
 interface GeoMapPointMark {
@@ -2594,6 +2617,12 @@ interface ColumnConfig {
      * (1 for the first column).
      */
     priority?: 1 | 2 | 3;
+    /**
+     * Whether the total row sums this column. Defaults to true for
+     * quantitative columns with a summable cell type (text/bar/heatmap); set
+     * `false` to leave the total row blank for this column instead.
+     */
+    total?: boolean;
     /** Heatmap: color the cell background based on numeric value. */
     heatmap?: HeatmapColumnConfig;
     /** Inline bar: render a proportional bar in the cell. */
@@ -4812,6 +4841,44 @@ interface GraphSpec {
     };
     /** Whether to show the OpenData watermark. Defaults to true. */
     watermark?: boolean;
+    /**
+     * Render in two or three dimensions. Defaults to `2` (the Canvas renderer).
+     *
+     * `3` renders with WebGL. The 3D renderer ships on its own subpath so
+     * three.js never enters the default bundle, and it must be imported before
+     * the graph mounts:
+     *
+     * ```ts
+     * import '@opendata-ai/openchart-vanilla/graph-3d';
+     * ```
+     *
+     * (Framework hosts import their own package's mirror of the subpath:
+     * `@opendata-ai/openchart-react/graph-3d`,
+     * `@opendata-ai/openchart-vue/graph-3d`,
+     * `@opendata-ai/openchart-svelte/graph-3d`.) Mounting a `dimensions: 3` spec
+     * without that import throws.
+     *
+     * 3D differs from 2D in these ways:
+     * - Labels use a fixed budget re-ranked by camera distance, not the 2D
+     *   priority declutter, so distant labels drop out.
+     * - The simulation runs on the main thread (no worker, no wall-clock warmup
+     *   budget).
+     * - Keyboard navigation, SVG export, `interaction.cursorRepulsion` and
+     *   `interaction.springyDrag` are unsupported. Each warns and is ignored.
+     *   (`layout.type` of `'radial'` or `'hierarchical'` is rejected by spec
+     *   validation in both dimensions, so it never reaches either renderer.)
+     * - `getCamera()` returns a pose rather than a zoom transform: `x`/`y` are
+     *   the look-at point in world units, alongside `position` and `target`. In
+     *   2D they are the zoom transform's translate in pixels. `onCameraChange`
+     *   carries the same payload, so persisted camera state has to be keyed on
+     *   the dimension it came from. Both are typed `GraphCamera` (vanilla), whose
+     *   `position`/`target` are optional because only 3D sets them.
+     * - A structural `update()` reheats the whole layout globally, so settled
+     *   nodes drift; 2D applies a local impulse instead.
+     * - Above 2000 nodes the spec warns and falls back to 2D.
+     * - `nodeOverrides[*].stroke` and `strokeWidth` are ignored (no ring).
+     */
+    dimensions?: 2 | 3;
 }
 /**
  * Resolution strategy for shared resources across layers.
@@ -6100,8 +6167,13 @@ declare function footnoteBandHeight(count: number, theme: ResolvedTheme): number
  *   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.
+ * @param crampedTitle - Shrinks the default (non-explicit) title font size by
+ *   `CRAMPED_TITLE_SCALE` on top of the width-based scaling. Set by callers for the
+ *   100-199px cramped height range: at that height a full-size compact title
+ *   can push `chrome.topHeight` past the min-chart-height guardrail, which
+ *   would strip the title back out via the hidden-chrome fallback.
  */
-declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme, width: number, measureText?: MeasureTextFn, chromeMode?: ChromeMode, padding?: number, watermark?: boolean, bottomLegendHeight?: number): ResolvedChrome;
+declare function computeChrome(chrome: Chrome | undefined, theme: ResolvedTheme, width: number, measureText?: MeasureTextFn, chromeMode?: ChromeMode, padding?: number, watermark?: boolean, bottomLegendHeight?: number, crampedTitle?: boolean): ResolvedChrome;
 
 /**
  * Text measurement for environments without a DOM.
@@ -6775,4 +6847,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 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 Condition, type ConditionalValueDef, type ConnectorConfig, type ConnectorType, type ContinuousLegendBin, type ContinuousLegendLayout, type ContinuousLegendTick, type CssTokenDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DeltaColumnConfig, type DeltaTableCell, 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, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, 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 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_NO_GRID_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 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_SR_TABLE_ROWS, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, NARROW_VIEWPORT_MAX, type NeutralRamp, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, 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 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, 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, lineChart, maxRotatedLabelWidth, meetsAA, overlapArea, pickLabelColor, pieChart, resolveChromeEconomy, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, scatterChart, simulateColorBlindness, 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 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 Condition, type ConditionalValueDef, type ConnectorConfig, type ConnectorType, type ContinuousLegendBin, type ContinuousLegendLayout, type ContinuousLegendTick, type CssTokenDef, DEFAULT_THEME, DIVERGING_PALETTES, type DarkMode, type DataRow, type DateGranularity, type DeltaColumnConfig, type DeltaTableCell, 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, FOOTNOTE_LINE_HEIGHT, type FacetChannel, type FacetLayout, type FacetPanelLayout, type FieldFormatContext, 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 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 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 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_SR_TABLE_ROWS, type Margins, type Mark, type MarkAria, type MarkDef, type MarkEvent, type MarkType, type MeasureTextFn, type Metric, NARROW_VIEWPORT_MAX, type NeutralRamp, type NodeOverride, type NumberFormatter, OFFSET_STRATEGIES, type OffsetStrategy, type PaginationState, type ParliamentEncoding, type Point, type PointEncoding, type PointMark, type RadialGradient, type RangeAnnotation, type RangeEncoding, 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 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, 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, lineChart, maxRotatedLabelWidth, meetsAA, overlapArea, pickLabelColor, pieChart, resolveChromeEconomy, resolveCollisions, resolveMarkDef, resolveMarkType, resolveMeasurer, resolveNumberFormatter, resolveSchemeName, resolveTheme, scatterChart, simulateColorBlindness, terminal, textAscent, tileMap, truncateRotatedLabel, truncateToWidth, wire, wrapText };

package/dist/index.js

@@ -1231,9 +1231,11 @@ function getBreakpoint(width) {
   if (width <= BREAKPOINT_MEDIUM_MAX) return "medium";
   return "full";
 }
+var HEIGHT_MINIMAL_MAX = 100;
 var HEIGHT_CRAMPED_MAX = 200;
 var HEIGHT_SHORT_MAX = 350;
 function getHeightClass(height) {
+  if (height < HEIGHT_MINIMAL_MAX) return "minimal";
   if (height < HEIGHT_CRAMPED_MAX) return "cramped";
   if (height <= HEIGHT_SHORT_MAX) return "short";
   return "normal";
@@ -1271,10 +1273,10 @@ function getWidthStrategy(breakpoint) {
 }
 function applyHeightConstraints(strategy, heightClass) {
   if (heightClass === "normal") return strategy;
-  if (heightClass === "cramped") {
+  if (heightClass === "minimal" || heightClass === "cramped") {
     return {
       ...strategy,
-      chromeMode: "hidden",
+      chromeMode: heightClass === "minimal" ? "hidden" : "compact",
       legendMaxHeight: 0,
       labelMode: "none",
       annotationPosition: "tooltip-only"
@@ -1974,10 +1976,11 @@ function scaleFontSize(baseFontSize, width) {
   const t = (width - 250) / 250;
   return Math.max(Math.round(baseFontSize * (0.72 + t * 0.28)), 10);
 }
-function buildTextStyle(defaults, fontFamily, textColor, width, overrides) {
+var CRAMPED_TITLE_SCALE = 0.65;
+function buildTextStyle(defaults, fontFamily, textColor, width, overrides, extraScale = 1) {
   const hasExplicitSize = overrides?.fontSize !== void 0;
   const baseFontSize = overrides?.fontSize ?? defaults.fontSize;
-  const fontSize = hasExplicitSize ? baseFontSize : scaleFontSize(baseFontSize, width);
+  const fontSize = hasExplicitSize ? baseFontSize : Math.max(Math.round(scaleFontSize(baseFontSize, width) * extraScale), 10);
   return {
     fontFamily: overrides?.fontFamily ?? fontFamily,
     fontSize,
@@ -2037,7 +2040,7 @@ function footnoteBandHeight(count, theme) {
   if (count <= 0) return 0;
   return count * theme.fonts.sizes.small * FOOTNOTE_LINE_HEIGHT + FOOTNOTE_BAND_GAP;
 }
-function computeChrome(chrome, theme, width, measureText, chromeMode = "full", padding, watermark = true, bottomLegendHeight = 0) {
+function computeChrome(chrome, theme, width, measureText, chromeMode = "full", padding, watermark = true, bottomLegendHeight = 0, crampedTitle = false) {
   if (!chrome || chromeMode === "hidden") {
     if (watermark && width >= BRAND_MIN_WIDTH) {
       const hiddenPad = padding ?? theme.spacing.padding;
@@ -2101,7 +2104,8 @@ function computeChrome(chrome, theme, width, measureText, chromeMode = "full", p
       fontFamily,
       theme.chrome.title.color,
       width,
-      titleNorm.style
+      titleNorm.style,
+      crampedTitle ? CRAMPED_TITLE_SCALE : 1
     );
     const maxLines = titleNorm.style?.maxLines;
     const lineCount = estimateLineCount(titleNorm.text, style, maxWidth, measureText, maxLines);
@@ -3070,6 +3074,7 @@ export {
   FOOTNOTE_LINE_HEIGHT,
   GRAPH_ENCODING_RULES,
   HEIGHT_CRAMPED_MAX,
+  HEIGHT_MINIMAL_MAX,
   HEIGHT_NO_GRID_MAX,
   HEIGHT_SHORT_MAX,
   HPAD_COMPACT_FRACTION,