manim-web 0.23.0 → 0.25.0

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/DomainColoring.d.ts

@@ -0,0 +1,114 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Mobject3D } from '../three-d/Mobject3D';
+import { Complex } from './ComplexPlane';
+import * as THREE from 'three';
+/** A complex function w = f(z), mapping one complex number to another. */
+export type ComplexFunction = (z: Complex) => Complex;
+/**
+ * How the modulus |f(z)| drives brightness.
+ *
+ * - `smooth`: brightness rises monotonically with the modulus, dark at zeros
+ *   and bright at poles.
+ * - `banded`: brightness oscillates over each octave (power of two) of the
+ *   modulus, giving the dark/light contour bands of a Wegert phase portrait.
+ */
+export type BrightnessScheme = 'smooth' | 'banded';
+/** Options for creating a {@link DomainColoring}. */
+export interface DomainColoringOptions {
+    /** The complex function w = f(z) to visualize. */
+    func: ComplexFunction;
+    /** Real-axis range [min, max]. Default: [-5, 5] */
+    reRange?: [number, number];
+    /** Imaginary-axis range [min, max]. Default: [-5, 5] */
+    imRange?: [number, number];
+    /** Pixel grid size per axis, or [width, height]. Default: 256 */
+    resolution?: number | [number, number];
+    /** Brightness scheme for the modulus. Default: 'banded' */
+    scheme?: BrightnessScheme;
+    /** Color saturation from 0 to 1. Default: 1 */
+    saturation?: number;
+    /** Darken thin lines where the modulus crosses a power of two. Default: false */
+    contourLines?: boolean;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+}
+/**
+ * Map an evaluated value w = f(z) to an `[r, g, b]` float color (0..1).
+ *
+ * The hue encodes arg(w): the positive real axis is hue 0, and a quarter turn
+ * toward the positive imaginary axis shifts the hue by 90 degrees. The modulus
+ * |w| drives brightness through the chosen scheme. The result is always a valid
+ * color: a pole (|w| not finite) reads bright, a zero reads dark, and any
+ * non-finite channel becomes 0, so poles and zeros never produce NaN colors.
+ */
+export declare function phasePortraitColor(w: Complex, scheme: BrightnessScheme, saturation: number, contourLines: boolean): [number, number, number];
+/**
+ * DomainColoring - a phase portrait of a complex function f: C -> C.
+ *
+ * The region of the complex plane is sampled on a regular pixel grid. Each
+ * pixel's complex value w = f(z) is turned into a color by {@link
+ * phasePortraitColor}: the hue encodes arg(w) and the brightness encodes |w|.
+ * The pixels are written to an RGBA buffer that is uploaded as a texture on a
+ * flat quad spanning `reRange` x `imRange`, mirroring the way {@link HeatMap}
+ * renders a sampled scalar field.
+ *
+ * The pixel buffer is computed in plain TypeScript, so it is deterministic and
+ * readable without a browser. In a browser the buffer becomes a
+ * `THREE.CanvasTexture`; without a DOM it becomes an equivalent
+ * `THREE.DataTexture`.
+ *
+ * Pixel layout: row 0 is the top (im = imMax), the last row is the bottom
+ * (im = imMin); column 0 is the left (re = reMin), the last column is the
+ * right (re = reMax).
+ *
+ * @example
+ * ```typescript
+ * // The identity f(z) = z
+ * const portrait = new DomainColoring({
+ *   func: (z) => z,
+ *   reRange: [-2, 2],
+ *   imRange: [-2, 2],
+ *   resolution: 256,
+ * });
+ * ```
+ */
+export declare class DomainColoring extends Mobject3D {
+    private _func;
+    private _reRange;
+    private _imRange;
+    private _width;
+    private _height;
+    private _scheme;
+    private _saturation;
+    private _contourLines;
+    private _centerPoint;
+    constructor(options: DomainColoringOptions);
+    /** The complex number z sampled at pixel column `col`, row `row`. */
+    pixelToComplex(col: number, row: number): Complex;
+    /** Sample the function over the grid into an RGBA buffer (row 0 at the top). */
+    getPixelData(): Uint8ClampedArray;
+    /** The pixel grid size as [width, height]. */
+    getResolution(): [number, number];
+    /** The hex color the portrait assigns to the complex number `z`. */
+    colorAt(z: Complex): string;
+    /** Build a texture from the pixel buffer, preferring a canvas when a DOM exists. */
+    private _buildTexture;
+    /** Build the textured quad spanning reRange x imRange. */
+    private _buildGeometry;
+    protected _createThreeObject(): THREE.Object3D;
+    protected _syncMaterialToThree(): void;
+    /** Rebuild the geometry and texture after the function or options change. */
+    private _update;
+    /** Get the complex function. */
+    getFunc(): ComplexFunction;
+    /** Set the complex function and rebuild. */
+    setFunc(func: ComplexFunction): this;
+    /** The brightness scheme in use. */
+    getScheme(): BrightnessScheme;
+    /** Set the brightness scheme and rebuild. */
+    setScheme(scheme: BrightnessScheme): this;
+    copy(): DomainColoring;
+}
+//# sourceMappingURL=DomainColoring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainColoring.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/DomainColoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,wDAAwD;IACxD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,OAAO,EACV,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,OAAO,GACpB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAiC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,EAAE,qBAAqB;IA+B1C,qEAAqE;IACrE,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAWjD,gFAAgF;IAChF,YAAY,IAAI,iBAAiB;IAwBjC,8CAA8C;IAC9C,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAIjC,oEAAoE;IACpE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;IAK3B,oFAAoF;IACpF,OAAO,CAAC,aAAa;IA8BrB,0DAA0D;IAC1D,OAAO,CAAC,cAAc;IA0BtB,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cAU3B,oBAAoB,IAAI,IAAI;IAW/C,6EAA6E;IAC7E,OAAO,CAAC,OAAO;IAef,gCAAgC;IAChC,OAAO,IAAI,eAAe;IAI1B,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAMpC,oCAAoC;IACpC,SAAS,IAAI,gBAAgB;IAI7B,6CAA6C;IAC7C,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAMhC,IAAI,IAAI,cAAc;CAehC"}

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"}