manim-web 0.22.0 → 0.24.0

package/dist/mobjects/graphing/BoxPlot.d.ts

@@ -0,0 +1,99 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Rectangle } from '../geometry/Rectangle';
+import { Line } from '../geometry/Line';
+import { Axes } from './Axes';
+import { BoxSummary } from './stats';
+/** Orientation of a box or violin plot. */
+export type PlotOrientation = 'vertical' | 'horizontal';
+/** Options for creating a BoxPlot. */
+export interface BoxPlotOptions {
+    /** One data group (number[]) or several groups (number[][]). */
+    data: number[] | number[][];
+    /** Lay boxes along the x-axis ('vertical') or y-axis ('horizontal'). Default: 'vertical' */
+    orientation?: PlotOrientation;
+    /** Box color, or a per-group color array. Default: Manim color palette */
+    colors?: string | string[];
+    /** Fill opacity for the boxes. Default: 0.6 */
+    fillOpacity?: number;
+    /** Stroke width for box, median and whiskers. Default: 2 */
+    strokeWidth?: number;
+    /** Whisker length as a multiple of the IQR. Default: 1.5 */
+    whiskerFactor?: number;
+    /** Box thickness in category units. Default: 0.5 */
+    boxWidth?: number;
+    /** Radius of the outlier dots. Default: 0.05 */
+    outlierRadius?: number;
+    /** An existing Axes to draw onto. When omitted, one is built from the data. */
+    axes?: Axes;
+    /** Visual length of the x-axis when auto-building axes. Default: 8 */
+    xLength?: number;
+    /** Visual length of the y-axis when auto-building axes. Default: 6 */
+    yLength?: number;
+    /** Color for the axes when auto-building. Default: '#ffffff' */
+    axisColor?: string;
+}
+/**
+ * BoxPlot - a box-and-whisker plot for one or more data groups.
+ *
+ * Each group draws a box from Q1 to Q3 with a median line, whiskers that reach
+ * the most extreme values inside 1.5*IQR, and dots for the outliers beyond the
+ * whiskers. Groups sit side by side along the category axis.
+ *
+ * @example
+ * ```typescript
+ * const box = new BoxPlot({
+ *   data: [[1, 2, 3, 4, 5, 100], [2, 3, 4, 5, 6]],
+ *   orientation: 'vertical',
+ * });
+ * const summary = box.getSummary(0); // { q1, median, q3, whiskerLow, ... }
+ * ```
+ */
+export declare class BoxPlot extends Group {
+    /** The coordinate system the boxes are drawn on. */
+    axes: Axes;
+    protected _groupsData: number[][];
+    protected _orientation: PlotOrientation;
+    protected _boxWidth: number;
+    protected _summaries: BoxSummary[];
+    protected _groupMobjects: VGroup[];
+    protected _boxes: (Rectangle | null)[];
+    protected _medianLines: (Line | null)[];
+    protected _whiskerGroups: VGroup[];
+    protected _outlierGroups: VGroup[];
+    constructor(options: BoxPlotOptions);
+    /** Padded value range covering every data value across all groups. */
+    private _valueRange;
+    /** Map a (category, value) pair to a world point, respecting orientation. */
+    private _toPoint;
+    /** Build the box, median, whiskers and outliers for one group. */
+    private _buildGroup;
+    /** Build the Q1..Q3 box rectangle for one group. */
+    private _buildBox;
+    /** A whisker stem from a box edge value to a whisker end value. */
+    private _stem;
+    /** A whisker cap: a short line perpendicular to the stem at a value. */
+    private _cap;
+    /** Get the coordinate system. */
+    getAxes(): Axes;
+    /** Get the computed summary for one group. */
+    getSummary(index: number): BoxSummary;
+    /** Get all group summaries. */
+    getSummaries(): BoxSummary[];
+    /** Get the mobject group for one data group. */
+    getGroup(index: number): VGroup | undefined;
+    /** Get the box rectangle for one group, or null for an empty group. */
+    getBox(index: number): Rectangle | null;
+    /** Get the median line for one group, or null for an empty group. */
+    getMedianLine(index: number): Line | null;
+    /** Get the whisker lines for one group. */
+    getWhiskers(index: number): VGroup | undefined;
+    /** Get the outlier dots for one group. */
+    getOutlierDots(index: number): VGroup | undefined;
+    /** The number of data groups. */
+    get numGroups(): number;
+    copy(): BoxPlot;
+}
+/** Normalize a one-group or many-group data argument to number[][]. */
+export declare function normalizeGroups(data: number[] | number[][]): number[][];
+//# sourceMappingURL=BoxPlot.d.ts.map

package/dist/mobjects/graphing/BoxPlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxPlot.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/BoxPlot.ts"],"names":[],"mappings":"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"}

package/dist/mobjects/graphing/CandlestickChart.d.ts

@@ -0,0 +1,191 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Rectangle } from '../geometry/Rectangle';
+import { Line } from '../geometry/Line';
+import { NumberLine } from './NumberLine';
+/**
+ * One open/high/low/close data point for a CandlestickChart.
+ */
+export interface OHLC {
+    /** Opening price. */
+    open: number;
+    /** Highest price in the period. */
+    high: number;
+    /** Lowest price in the period. */
+    low: number;
+    /** Closing price. */
+    close: number;
+    /** Optional date or category label for the x-axis. */
+    date?: string;
+    /** Optional free-form label for the x-axis (overrides date). */
+    label?: string;
+    /** Optional traded volume, shown when showVolume is true. */
+    volume?: number;
+}
+/**
+ * Options for creating a CandlestickChart.
+ */
+export interface CandlestickChartOptions {
+    /** Array of OHLC data points, left to right. */
+    data: OHLC[];
+    /** Fill/stroke color for bullish candles (close >= open). Default: GREEN. */
+    bullishColor?: string;
+    /** Fill/stroke color for bearish candles (close < open). Default: RED. */
+    bearishColor?: string;
+    /** Width of each candle body. Default: 0.5 */
+    candleWidth?: number;
+    /** Gap between adjacent candles. Default: 0.2 */
+    candleSpacing?: number;
+    /** Stroke width of the high/low wick line. Default: 2 */
+    wickWidth?: number;
+    /** Stroke width of the candle body outline. Default: 1.5 */
+    bodyStrokeWidth?: number;
+    /** Fill opacity of the candle body. Default: 0.9 */
+    bodyFillOpacity?: number;
+    /** Y-axis (price) range as [min, max, step]. Default: auto-scaled from data. */
+    yRange?: [number, number, number];
+    /** Visual height of the price area. Default: 5 */
+    height?: number;
+    /** Visual width of the chart area. Default: 8 */
+    width?: number;
+    /** Color for the axes and labels. Default: WHITE */
+    axisColor?: string;
+    /** Whether to include y-axis tick marks. Default: true */
+    includeYTicks?: boolean;
+    /** Whether to include y-axis price labels. Default: true */
+    includeYLabels?: boolean;
+    /** Font size for y-axis labels. Default: 20 */
+    yLabelFontSize?: number;
+    /** Explicit x-axis labels (overrides date/label on the data). Default: [] */
+    xLabels?: string[];
+    /** Font size for x-axis labels. Default: 20 */
+    xLabelFontSize?: number;
+    /** Whether to draw volume bars below the price area. Default: false */
+    showVolume?: boolean;
+    /** Visual height of the volume area. Default: 1 */
+    volumeHeight?: number;
+}
+/**
+ * CandlestickChart - A financial candlestick / OHLC chart mobject.
+ *
+ * Renders each period as a body rectangle that spans open to close, plus a
+ * high/low wick line. Bullish periods (close >= open) and bearish periods
+ * (close < open) use separate colors. The price y-axis auto-scales to the data
+ * unless an explicit range is given. Optional volume bars render below.
+ *
+ * The chart is a VGroup, so Create and FadeIn animate it directly.
+ *
+ * @example
+ * ```typescript
+ * const chart = new CandlestickChart({
+ *   data: [
+ *     { open: 10, high: 15, low: 8, close: 14, date: 'Mon' },
+ *     { open: 14, high: 16, low: 11, close: 12, date: 'Tue' },
+ *   ],
+ *   showVolume: true,
+ * });
+ * scene.play(new Create(chart));
+ * ```
+ */
+export declare class CandlestickChart extends VGroup {
+    /** The candle VGroups (each holds a body Rectangle and a wick Line). */
+    candles: VGroup;
+    /** The volume bars, when showVolume is enabled. */
+    volumeBars: VGroup;
+    /** The price y-axis. */
+    yAxis: NumberLine;
+    /** The x-axis baseline. */
+    xAxisLine: VMobject;
+    /** X-axis labels. */
+    xLabels: VGroup;
+    /** Y-axis labels. */
+    yLabels: VGroup;
+    protected _data: OHLC[];
+    protected _bullishColor: string;
+    protected _bearishColor: string;
+    protected _candleWidth: number;
+    protected _candleSpacing: number;
+    protected _wickWidth: number;
+    protected _bodyStrokeWidth: number;
+    protected _bodyFillOpacity: number;
+    protected _yRange: [number, number, number];
+    protected _height: number;
+    protected _width: number;
+    protected _axisColor: string;
+    protected _includeYTicks: boolean;
+    protected _includeYLabels: boolean;
+    protected _yLabelFontSize: number;
+    protected _xLabelTexts: string[];
+    protected _xLabelFontSize: number;
+    protected _showVolume: boolean;
+    protected _volumeHeight: number;
+    constructor(options: CandlestickChartOptions);
+    /** Whether a period is bullish (close at or above open). */
+    private _isBullish;
+    /** Color for a period, by direction. */
+    private _candleColor;
+    /**
+     * Auto-scale the price range from the data lows and highs.
+     */
+    private _calculateYRange;
+    /**
+     * Convert a price to its y-coordinate within the price area.
+     */
+    priceToY(price: number): number;
+    /**
+     * X-coordinate of the center column for candle i.
+     */
+    private _candleCenterX;
+    /**
+     * Create the price y-axis.
+     */
+    private _createYAxis;
+    /**
+     * Create the x-axis baseline at the bottom of the price area.
+     */
+    private _createXAxisLine;
+    /**
+     * Build one candle (body rectangle + wick line) per data point.
+     */
+    private _createCandles;
+    /**
+     * Build volume bars below the price area.
+     */
+    private _createVolumeBars;
+    /**
+     * Create x-axis labels from the explicit option or the data date/label.
+     */
+    private _createXLabels;
+    /**
+     * Create y-axis price labels.
+     */
+    private _createYLabels;
+    /** Get all candle VGroups. */
+    getCandles(): VGroup[];
+    /**
+     * Get a single candle VGroup by index.
+     * @returns The candle, or undefined when out of range.
+     */
+    getCandle(index: number): VGroup | undefined;
+    /**
+     * Get the body rectangle of candle i.
+     * @returns The body, or undefined when out of range.
+     */
+    getBody(index: number): Rectangle | undefined;
+    /**
+     * Get the wick line of candle i.
+     * @returns The wick, or undefined when out of range.
+     */
+    getWick(index: number): Line | undefined;
+    /** Get all volume bars (empty when showVolume is off). */
+    getVolumeBars(): Rectangle[];
+    /** Get the price (y-axis) range as [min, max, step]. */
+    getYRange(): [number, number, number];
+    /** Get the data points. */
+    getData(): OHLC[];
+    /** Get the visual height of the price area. */
+    getChartHeight(): number;
+    /** Get the visual width of the chart area. */
+    getChartWidth(): number;
+}
+//# sourceMappingURL=CandlestickChart.d.ts.map

package/dist/mobjects/graphing/CandlestickChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CandlestickChart.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/CandlestickChart.ts"],"names":[],"mappings":"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"}

package/dist/mobjects/graphing/FourierEpicycles.d.ts

@@ -0,0 +1,149 @@
+import { Group } from '../../core/Group';
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+import { ValueTracker } from '../value-tracker/ValueTracker';
+import { Complex } from './ComplexPlane';
+import { FourierCoefficient, FourierOrder } from './fourier';
+/** A parametric complex path: `func(t)` for `t` over `tRange` (default `[0, 1]`). */
+export interface ComplexPathFunction {
+    /** Maps a parameter to a complex plane point. */
+    func: (t: number) => Complex;
+    /** Parameter range as `[min, max]`. Default `[0, 1]`. */
+    tRange?: [number, number];
+}
+/**
+ * The path an epicycle chain approximates. One of:
+ * - `number[][]`: equally spaced samples, each `[x, y]` read as the complex point `x + i·y`.
+ * - {@link VMobject}: sampled along its arc length into complex points.
+ * - {@link ComplexPathFunction}: a parametric complex function sampled over its range.
+ */
+export type FourierPathInput = number[][] | VMobject | ComplexPathFunction;
+/**
+ * Options for {@link FourierEpicycles}.
+ */
+export interface FourierEpicyclesOptions {
+    /** The path to approximate. */
+    path: FourierPathInput;
+    /** Number of rotating vectors to show. Default: all coefficients. */
+    numTerms?: number;
+    /** Samples taken from a {@link VMobject} or {@link ComplexPathFunction}. Default `256`. */
+    numSamples?: number;
+    /** Origin of the vector chain (the fixed tail of the first vector). Default `[0, 0, 0]`. */
+    center?: Vector3Tuple;
+    /** Vector chain ordering. Default `'frequency'` (the iconic `0, +1, -1, +2, -2, …`). */
+    order?: FourierOrder;
+    /** Color of the rotating vectors (arrows). Default `'#58c4dd'`. */
+    color?: string;
+    /** Whether to draw the circles behind the vectors. Default `true`. */
+    showCircles?: boolean;
+    /** Color of the circles. Default `'#888888'`. */
+    circleColor?: string;
+    /** Opacity of the circles' stroke. Default `0.5`. */
+    circleOpacity?: number;
+    /** Color of the traced output curve. Default `'#ffff00'`. */
+    traceColor?: string;
+    /** Stroke width of the traced curve. Default `3`. */
+    traceWidth?: number;
+    /** Stroke width of the vectors. Default `2`. */
+    strokeWidth?: number;
+    /** Arrow tip length for the vectors. Default `0.15`. */
+    tipLength?: number;
+    /** Whether to show a pen dot at the chain tip. Default `true`. */
+    showPen?: boolean;
+    /** Cycles per second advanced by the internal updater. Default `0.2`. */
+    speed?: number;
+    /** Install an updater that advances time each frame. Default `true`. */
+    animate?: boolean;
+    /**
+     * Optional tracker that drives time instead of the internal clock. When set,
+     * `time` is read from the tracker each frame (one period spans value `0 → 1`).
+     */
+    tracker?: ValueTracker;
+    /** Maximum number of accumulated trace points before the oldest are dropped. Default `2000`. */
+    maxTracePoints?: number;
+}
+/**
+ * FourierEpicycles - the rotating-vector ("epicycle") approximation of a path.
+ *
+ * Given a path and a number of terms `N`, this builds the chain of `N` rotating
+ * vectors (and their circles) whose tip-to-tail sum tracks the path, plus the
+ * curve traced by the final tip. An updater rotates each vector at its own
+ * frequency and extends the traced curve over time, reproducing the iconic
+ * 3Blue1Brown Fourier-series animation.
+ *
+ * The geometry is deterministic: {@link setTime} fully determines every vector,
+ * circle, and the tip for a given normalized time `t`.
+ *
+ * @example
+ * ```typescript
+ * // Approximate a square wave path with 50 rotating vectors.
+ * const path: number[][] = [];
+ * for (let i = 0; i < 256; i++) {
+ *   const a = (2 * Math.PI * i) / 256;
+ *   path.push([Math.cos(a), Math.sin(3 * a) / 3]);
+ * }
+ * const epicycles = new FourierEpicycles({ path, numTerms: 50 });
+ * scene.add(epicycles);
+ * ```
+ */
+export declare class FourierEpicycles extends Group {
+    private _coefficients;
+    private _center;
+    private _speed;
+    private _tracker;
+    private _maxTracePoints;
+    private _showPen;
+    private _circlesGroup;
+    private _vectorsGroup;
+    private _tracedPath;
+    private _circles;
+    private _vectors;
+    private _pen;
+    private _time;
+    private _tracePoints;
+    private _lastTip;
+    private _sourceSamples;
+    private _options;
+    constructor(options: FourierEpicyclesOptions);
+    /**
+     * Resolve a {@link FourierPathInput} into equally spaced complex samples.
+     */
+    private static _resolveSamples;
+    /**
+     * Advance the internal clock by `dt` seconds (scaled by `speed`), reposition
+     * the chain, and extend the traced curve. When a tracker drives time, its
+     * value is used directly instead of the internal clock.
+     */
+    private _advance;
+    private _appendTracePoint;
+    private _rebuildTrace;
+    /**
+     * Position every vector and circle for normalized time `t` and move the pen
+     * to the chain tip. One full period spans `t ∈ [0, 1)`. Pure positioning:
+     * this does not extend the traced curve.
+     *
+     * @param t - Normalized time.
+     * @returns The chain tip as `[x, y, z]`, equal to the `numTerms` partial sum.
+     */
+    setTime(t: number): Vector3Tuple;
+    /** Current normalized time of the internal clock. */
+    getTime(): number;
+    /** The chain tip computed at the most recent {@link setTime}. */
+    getTipPoint(): Vector3Tuple;
+    /** The ordered coefficients actually shown (length equals the vector count). */
+    getCoefficients(): FourierCoefficient[];
+    /** The number of rotating vectors (equals the requested, clamped, term count). */
+    getNumTerms(): number;
+    /** The group of rotating-vector arrows. */
+    getVectors(): Group;
+    /** The group of circles (empty when `showCircles` is `false`). */
+    getCircles(): Group;
+    /** The VMobject holding the traced output curve. */
+    getTracedPath(): VMobject;
+    /** The accumulated trace points, oldest first. */
+    getTracePoints(): number[][];
+    /** Clear the accumulated traced curve. */
+    clearTrace(): this;
+    copy(): FourierEpicycles;
+}
+//# sourceMappingURL=FourierEpicycles.d.ts.map

package/dist/mobjects/graphing/FourierEpicycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FourierEpicycles.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/FourierEpicycles.ts"],"names":[],"mappings":"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"}

package/dist/mobjects/graphing/FourierSeries.d.ts

@@ -0,0 +1,60 @@
+import { FunctionGraph, FunctionGraphOptions } from './FunctionGraph';
+/**
+ * Options for {@link FourierSeries}.
+ */
+export interface FourierSeriesOptions {
+    /** The target real periodic function to approximate, `y = f(x)`. */
+    func: (x: number) => number;
+    /** Number of harmonics kept, chosen by amplitude. Default: all sampled terms. */
+    numTerms?: number;
+    /** Length of one period of {@link func}. Default `2π`. */
+    period?: number;
+    /** Start of the sampled period. Default: the graph's `xRange[0]`, else `0`. */
+    periodStart?: number;
+    /** Samples used to compute the Fourier coefficients. Default `256`. */
+    coefficientSamples?: number;
+    /** X range for the plotted curve as `[min, max]`. */
+    xRange?: [number, number];
+    /** Stroke color. Default `'#58c4dd'`. */
+    color?: string;
+    /** Stroke width in pixels. Default `2`. */
+    strokeWidth?: number;
+    /** Samples used to draw the curve. Default `200`. */
+    numSamples?: number;
+    /** Reference axes for coordinate transformation. */
+    axes?: FunctionGraphOptions['axes'];
+}
+/**
+ * FourierSeries - the truncated Fourier partial sum of a function, as a graph.
+ *
+ * Computes the discrete Fourier coefficients of a real periodic function,
+ * keeps the `numTerms` largest harmonics, and plots the resulting partial-sum
+ * approximation `y = f_N(x)` like a {@link FunctionGraph}. As `numTerms` grows,
+ * the curve converges to the target function.
+ *
+ * @example
+ * ```typescript
+ * // Approximate a square wave with 7 harmonics over [-π, π].
+ * const square = (x: number) => (Math.sin(x) >= 0 ? 1 : -1);
+ * const series = new FourierSeries({
+ *   func: square,
+ *   numTerms: 7,
+ *   period: 2 * Math.PI,
+ *   xRange: [-Math.PI, Math.PI],
+ *   axes,
+ * });
+ * ```
+ */
+export declare class FourierSeries extends FunctionGraph {
+    private _targetFunc;
+    private _numTerms;
+    private _period;
+    constructor(options: FourierSeriesOptions);
+    /** The target function this series approximates. */
+    getTargetFunction(): (x: number) => number;
+    /** The number of harmonics requested (`undefined` means all sampled terms). */
+    getNumTerms(): number | undefined;
+    /** The period used to compute the coefficients. */
+    getPeriod(): number;
+}
+//# sourceMappingURL=FourierSeries.d.ts.map

package/dist/mobjects/graphing/FourierSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FourierSeries.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/FourierSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,oBAAoB;IAyBzC,oDAAoD;IACpD,iBAAiB,IAAI,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM;IAI1C,+EAA+E;IAC/E,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,mDAAmD;IACnD,SAAS,IAAI,MAAM;CAGpB"}

package/dist/mobjects/graphing/Histogram.d.ts

@@ -0,0 +1,71 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Rectangle } from '../geometry/Rectangle';
+import { Axes } from './Axes';
+import { HistogramBin } from './stats';
+/** Options for creating a Histogram. */
+export interface HistogramOptions {
+    /** The raw data values to bin. */
+    data: number[];
+    /** Number of equal-width bins. Ignored when binEdges is given. Default: 10 */
+    bins?: number;
+    /** Explicit bin edges (length n+1 for n bins). Overrides bins. */
+    binEdges?: number[];
+    /** Plot bar height as probability density instead of count. Default: false */
+    density?: boolean;
+    /** Plot bar height as relative frequency (count / N). Ignored if density. Default: false */
+    normalize?: boolean;
+    /** Fill color for the bars. Default: Manim's blue */
+    color?: string;
+    /** Fill opacity for the bars. Default: 0.75 */
+    fillOpacity?: number;
+    /** Stroke width for the bar outlines. Default: 1 */
+    strokeWidth?: number;
+    /** An existing Axes to draw onto. When omitted, one is built from the bins. */
+    axes?: Axes;
+    /** Visual length of the x-axis when auto-building axes. Default: 8 */
+    xLength?: number;
+    /** Visual length of the y-axis when auto-building axes. Default: 6 */
+    yLength?: number;
+    /** Color for the axes when auto-building. Default: '#ffffff' */
+    axisColor?: string;
+}
+/**
+ * Histogram - bars over an x-axis from binned raw data.
+ *
+ * The raw data is binned into equal-width bins (or the given explicit edges).
+ * Bar height is the bin count, the relative frequency, or the probability
+ * density. When no Axes is supplied, one is built to fit the bins.
+ *
+ * @example
+ * ```typescript
+ * const hist = new Histogram({
+ *   data: [1, 2, 2, 3, 3, 3, 4, 4, 5],
+ *   bins: 5,
+ *   density: true,
+ * });
+ * ```
+ */
+export declare class Histogram extends Group {
+    /** The coordinate system the bars are drawn on. */
+    axes: Axes;
+    /** The rectangular bars, one per bin, left to right. */
+    bars: VGroup;
+    protected _data: number[];
+    protected _bins: HistogramBin[];
+    constructor(options: HistogramOptions);
+    /** Map a bin to its bar height given the count/frequency/density mode. */
+    private _barHeight;
+    /** Get the coordinate system. */
+    getAxes(): Axes;
+    /** Get the group of bars. */
+    getBars(): VGroup;
+    /** Get a single bar by bin index, or undefined when out of range. */
+    getBar(index: number): Rectangle | undefined;
+    /** Get the computed bins (edges, counts, density). */
+    getBins(): HistogramBin[];
+    /** The number of bins. */
+    get numBins(): number;
+    copy(): Histogram;
+}
+//# sourceMappingURL=Histogram.d.ts.map

package/dist/mobjects/graphing/Histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Histogram.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/Histogram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1E,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,mDAAmD;IACnD,IAAI,EAAE,IAAI,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;gBAEpB,OAAO,EAAE,gBAAgB;IA8DrC,0EAA0E;IAC1E,OAAO,CAAC,UAAU;IAMlB,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAIf,6BAA6B;IAC7B,OAAO,IAAI,MAAM;IAIjB,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5C,sDAAsD;IACtD,OAAO,IAAI,YAAY,EAAE;IAIzB,0BAA0B;IAC1B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEQ,IAAI,IAAI,SAAS;CAK3B"}

package/dist/mobjects/graphing/ScatterPlot.d.ts

@@ -0,0 +1,66 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Dot } from '../geometry/Dot';
+import { Axes } from './Axes';
+/** Options for creating a ScatterPlot. */
+export interface ScatterPlotOptions {
+    /** X coordinates of the points. */
+    x: number[];
+    /** Y coordinates of the points. Paired with x by index. */
+    y: number[];
+    /** Dot radius, or a per-point radius array for a bubble chart. Default: 0.06 */
+    sizes?: number | number[];
+    /** Dot color, or a per-point color array. Default: Manim color palette */
+    colors?: string | string[];
+    /** Fill opacity for the dots. Default: 1 */
+    fillOpacity?: number;
+    /** Stroke width for the dots. Default: 0 */
+    strokeWidth?: number;
+    /** An existing Axes to plot onto. When omitted, one is built from the data. */
+    axes?: Axes;
+    /** X-axis range override as [min, max] or [min, max, step]. */
+    xRange?: [number, number] | [number, number, number];
+    /** Y-axis range override as [min, max] or [min, max, step]. */
+    yRange?: [number, number] | [number, number, number];
+    /** Visual length of the x-axis when auto-building axes. Default: 8 */
+    xLength?: number;
+    /** Visual length of the y-axis when auto-building axes. Default: 6 */
+    yLength?: number;
+    /** Color for the axes when auto-building. Default: '#ffffff' */
+    axisColor?: string;
+}
+/**
+ * ScatterPlot - points plotted as dots on a coordinate system.
+ *
+ * Each (x, y) pair becomes a Dot. Per-point sizes and colors turn the plot
+ * into a bubble chart. When no Axes is supplied, one is built to fit the data.
+ *
+ * @example
+ * ```typescript
+ * const plot = new ScatterPlot({
+ *   x: [1, 2, 3, 4],
+ *   y: [2, 1, 4, 3],
+ *   sizes: [0.05, 0.1, 0.15, 0.2],
+ *   colors: ['#ff0000', '#00ff00'],
+ * });
+ * ```
+ */
+export declare class ScatterPlot extends Group {
+    /** The coordinate system the points are plotted on. */
+    axes: Axes;
+    /** The plotted dots, one per (x, y) pair. */
+    dots: VGroup;
+    protected _x: number[];
+    protected _y: number[];
+    constructor(options: ScatterPlotOptions);
+    /** Get the coordinate system. */
+    getAxes(): Axes;
+    /** Get the group of plotted dots. */
+    getDots(): VGroup;
+    /** Get a single dot by point index, or undefined when out of range. */
+    getDot(index: number): Dot | undefined;
+    /** The number of plotted points. */
+    get numPoints(): number;
+    copy(): ScatterPlot;
+}
+//# sourceMappingURL=ScatterPlot.d.ts.map