@opendata-ai/openchart-core 8.5.2 → 8.6.0

package/dist/index.d.ts

@@ -720,6 +720,13 @@ interface RectMark {
     fill: string | GradientDef;
     /** Resolved fill pattern. Present only when `mark.fillPattern: 'auto'` assigned one. */
     pattern?: ResolvedFillPattern;
+    /**
+     * Fill opacity, independent of stroke. Omitted means fully opaque; the
+     * renderer emits no `fill-opacity` attribute in that case, so an ordinary
+     * bar's serialized SVG is unchanged. Set by the binned-bar renderer when
+     * color groups overlap at the same x.
+     */
+    fillOpacity?: number;
     /** Stroke color. */
     stroke?: string;
     /** Stroke width. */
@@ -2670,8 +2677,12 @@ interface ColumnConfig {
  * - 'waffle': unit grids ("x of 100") for part-to-whole counts
  * - 'calendar': GitHub-style calendar heatmap (weeks x weekdays, daily dates)
  * - 'parliament': hemicycle seat-dot chart for election/legislature results
+ * - 'histogram': binned bars over a continuous field; sugar for a bar with
+ *   `x.bin` + `y: { aggregate: 'count' }`
+ * - 'density': kernel density estimate drawn as a filled curve; sugar for an
+ *   area over a density transform
  */
-type MarkType = 'bar' | 'line' | 'area' | 'point' | 'circle' | 'arc' | 'text' | 'rule' | 'tick' | 'rect' | 'lollipop' | 'beeswarm' | 'range' | 'waffle' | 'calendar' | 'parliament';
+type MarkType = 'bar' | 'line' | 'area' | 'point' | 'circle' | 'arc' | 'text' | 'rule' | 'tick' | 'rect' | 'lollipop' | 'beeswarm' | 'range' | 'waffle' | 'calendar' | 'parliament' | 'histogram' | 'density';
 /** A single color stop in a gradient definition. */
 interface GradientStop {
     /** Position along the gradient, 0 to 1. */
@@ -2824,6 +2835,43 @@ interface MarkDef {
     filled?: boolean;
     /** Default opacity (0-1). */
     opacity?: number;
+    /**
+     * Fill opacity (0-1), independent of stroke (Vega-Lite aligned).
+     *
+     * On a binned bar with more than one color group this defaults to 0.55 so
+     * overlapping distributions stay readable; set it explicitly to override.
+     * On an area, setting it switches the fill from the default gradient to a
+     * flat translucent series color — gradients and overlapping fills don't mix.
+     */
+    fillOpacity?: number;
+    /**
+     * Number of bins. Only meaningful when `type` is `'histogram'`; desugars to
+     * `x.bin.maxbins`. Defaults to 20. For a fixed bin width or a pinned
+     * extent, write `x.bin` directly — it is the canonical form and takes
+     * precedence over this shorthand.
+     */
+    binCount?: number;
+    /**
+     * Plot each group's share of its own total instead of a raw count. Only
+     * meaningful when `type` is `'histogram'`. Makes two distributions of very
+     * different size directly comparable.
+     */
+    normalize?: boolean;
+    /**
+     * Gaussian kernel bandwidth. Only meaningful when `type` is `'density'`.
+     * Omitted uses Silverman's rule of thumb.
+     */
+    bandwidth?: number;
+    /**
+     * Draw the cumulative distribution instead of the density. Only meaningful
+     * when `type` is `'density'`.
+     */
+    cumulative?: boolean;
+    /**
+     * Number of points the density curve is evaluated at. Only meaningful when
+     * `type` is `'density'`. Defaults to 200.
+     */
+    steps?: number;
     /** Default fill color or gradient. */
     fill?: string | GradientDef;
     /** Default stroke color. */
@@ -4276,6 +4324,25 @@ interface WaffleEncoding<TData extends DataRow = DataRow> extends Encoding<TData
 interface ParliamentEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
     color: EncodingChannel<TData> | ConditionalValueDef<TData>;
 }
+/**
+ * Encoding for histogram marks (binned bars over a continuous field).
+ * - `x`: required quantitative, the raw values to bin (not pre-binned)
+ * - `y`: optional; defaults to the per-bin count
+ * - `color`: optional grouping. Groups overlap at the same bins rather than
+ *   dodging or stacking, so two distributions can be compared by shape.
+ */
+interface HistogramEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+}
+/**
+ * Encoding for density marks (kernel density estimates).
+ * - `x`: required quantitative, the raw values to estimate over
+ * - `y`: computed by the density transform, not authored
+ * - `color`: optional grouping, one translucent curve per group
+ */
+interface DensityEncoding<TData extends DataRow = DataRow> extends Encoding<TData> {
+    x: EncodingChannel<TData>;
+}
 /**
  * Encoding for calendar marks (GitHub-style calendar heatmaps).
  * - `x`: required (temporal, daily dates, one row per day)
@@ -4629,6 +4696,16 @@ type ChartSpec<TData extends DataRow = DataRow> = (BaseChartSpec<TData> & {
         type: 'parliament';
     });
     encoding: ParliamentEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'histogram' | (MarkDef & {
+        type: 'histogram';
+    });
+    encoding: HistogramEncoding<TData>;
+}) | (BaseChartSpec<TData> & {
+    mark: 'density' | (MarkDef & {
+        type: 'density';
+    });
+    encoding: DensityEncoding<TData>;
 });
 /** Row density for tables. Maps to 40 / 48 / 56px row heights. */
 type TableDensity = 'condensed' | 'regular' | 'relaxed';
@@ -5398,6 +5475,49 @@ interface TimeUnitTransform {
     field: string;
     as: string;
 }
+/**
+ * Density transform: kernel density estimate over a quantitative field
+ * (Vega-Lite aligned).
+ *
+ * Produces a new dataset — one row per evaluation point, per group — rather
+ * than adding fields to the input rows. The output is what an area mark plots.
+ */
+interface DensityTransform {
+    /** Field of raw values to estimate the density of. */
+    density: string;
+    /** Group the estimate by these fields; one curve per group. */
+    groupby?: string[];
+    /** Gaussian kernel bandwidth. Omitted or 0 uses Silverman's rule of thumb. */
+    bandwidth?: number;
+    /** [min, max] to evaluate over. Defaults to the data extent, padded to close the tails. */
+    extent?: [number, number];
+    /** Emit the cumulative distribution instead of the density. */
+    cumulative?: boolean;
+    /** Scale the curve by the group's row count instead of integrating to 1. */
+    counts?: boolean;
+    /** Number of evaluation points. Default 200. */
+    steps?: number;
+    /** Output field names. Default ['value', 'density']. */
+    as?: [string, string];
+}
+/**
+ * Join-aggregate transform: compute group summaries and write them back onto
+ * every row of the group (VL aligned).
+ *
+ * The difference from `AggregateTransform` is the row count: `aggregate`
+ * collapses a group to one row, `joinaggregate` keeps every row and adds the
+ * group's summary as a new field. That is what makes "this row's value as a
+ * share of its group's total" expressible — compute the total, then divide.
+ */
+interface JoinAggregateTransform {
+    joinaggregate: Array<{
+        op: AggregateOp;
+        field: string;
+        as: string;
+    }>;
+    /** Fields to group by. Omitted or empty treats all rows as one group. */
+    groupby?: string[];
+}
 /**
  * Aggregate transform: group rows and compute summary statistics (VL aligned).
  * Produces one row per group with the groupby fields and computed aggregates.
@@ -5444,7 +5564,7 @@ interface WindowTransform {
     groupby?: string[];
 }
 /** Discriminated union of all transform types. */
-type Transform = FilterTransform | BinTransform | CalculateTransform | TimeUnitTransform | AggregateTransform | FoldTransform | WindowTransform;
+type Transform = FilterTransform | BinTransform | CalculateTransform | TimeUnitTransform | AggregateTransform | JoinAggregateTransform | DensityTransform | 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.
@@ -6847,4 +6967,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_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 };
+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 DensityEncoding, type DensityTransform, 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 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_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

@@ -28,7 +28,9 @@ var MARK_ENCODING_RULES = {
     detail: optional("nominal")
   },
   area: {
-    x: required("temporal", "ordinal"),
+    // Quantitative x is what a density curve needs: the x values are computed
+    // evaluation points, not categories or dates.
+    x: required("temporal", "ordinal", "quantitative"),
     y: required("quantitative"),
     y2: optional("quantitative"),
     color: optional("nominal", "ordinal", "quantitative"),
@@ -175,6 +177,31 @@ var MARK_ENCODING_RULES = {
     opacity: optional("quantitative"),
     tooltip: optional(),
     detail: optional("nominal")
+  },
+  // histogram: x is the raw quantitative field to bin. y is optional because
+  // it defaults to the bin count; supply it only to plot something else per
+  // bin. A color field groups the distributions and they overlap rather than
+  // stack, which is the whole reason this mark exists.
+  histogram: {
+    x: required("quantitative"),
+    y: optional("quantitative"),
+    color: optional("nominal", "ordinal"),
+    size: optional(),
+    opacity: optional("quantitative"),
+    tooltip: optional(),
+    detail: optional("nominal")
+  },
+  // density: x is the raw quantitative field to estimate over. y is computed
+  // by the density transform, never authored, so it stays optional. A color
+  // field yields one translucent curve per group.
+  density: {
+    x: required("quantitative"),
+    y: optional("quantitative"),
+    color: optional("nominal", "ordinal"),
+    size: optional(),
+    opacity: optional("quantitative"),
+    tooltip: optional(),
+    detail: optional("nominal")
   }
 };
 var GRAPH_ENCODING_RULES = {
@@ -252,7 +279,9 @@ var MARK_TYPES = /* @__PURE__ */ new Set([
   "range",
   "waffle",
   "calendar",
-  "parliament"
+  "parliament",
+  "histogram",
+  "density"
 ]);
 function isAxislessMark(markType) {
   return markType === "arc" || markType === "waffle" || markType === "calendar" || markType === "parliament";
@@ -314,7 +343,9 @@ var MARK_DISPLAY_NAMES = {
   range: "Range plot",
   waffle: "Waffle chart",
   calendar: "Calendar heatmap",
-  parliament: "Parliament chart"
+  parliament: "Parliament chart",
+  histogram: "Histogram",
+  density: "Density plot"
 };
 
 // src/colors/colorblind.ts
@@ -2747,6 +2778,10 @@ function generateAltText(spec, data) {
   if (markType === "arc" && markDef.innerRadius && markDef.innerRadius > 0) {
     chartName = "Donut chart";
   }
+  const isBinnedBar = markType === "bar" && !!spec.encoding.x2 && spec.encoding.x?.type === "quantitative" && spec.encoding.y?.type === "quantitative";
+  if (isBinnedBar) {
+    chartName = "Histogram";
+  }
   const parts = [chartName];
   const title = spec.chrome?.title;
   if (title) {
@@ -2780,6 +2815,12 @@ function generateAltText(spec, data) {
       );
     }
   }
+  if (isBinnedBar) {
+    const sourceField = spec.encoding.x?.title ?? spec.encoding.x?.field;
+    if (sourceField) {
+      parts.push(`showing the distribution of ${sourceField}`);
+    }
+  }
   if (spec.encoding.x && markType !== "beeswarm" && data.length > 0) {
     const field = spec.encoding.x.field;
     const values = data.map((d) => d[field]).filter((v) => v != null);