manim-web 0.25.0 → 0.26.0

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

@@ -0,0 +1,90 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Polygon } from '../geometry/Polygon';
+import { Axes } from './Axes';
+/**
+ * Where the step between two points falls.
+ * - 'after': hold the current value, then jump at the next x (matplotlib 'post').
+ * - 'before': jump at the current x, then hold to the next x (matplotlib 'pre').
+ * - 'center': jump halfway between the two x-values (matplotlib 'mid').
+ */
+export type StepMode = 'before' | 'after' | 'center';
+/** Options for creating a StepChart. */
+export interface StepChartOptions {
+    /** Y-values as [series][point]. A flat array is treated as a single series. */
+    values: number[][] | number[];
+    /** Shared x-values, one per point. Default: indices 0, 1, 2, ... */
+    xValues?: number[];
+    /** Where the step falls between points. Default: 'after' */
+    stepMode?: StepMode;
+    /** Series colors. Single color or array. Default: Manim palette */
+    seriesColors?: string | string[];
+    /** Stroke width for the step lines. Default: 3 */
+    lineWidth?: number;
+    /** Draw a dot at each data point. Default: false */
+    showDots?: boolean;
+    /** Dot radius when showDots is set. Default: 0.06 */
+    dotRadius?: 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: white */
+    axisColor?: string;
+}
+/**
+ * StepChart - a line graph drawn as horizontal/vertical steps.
+ *
+ * Each series holds its value across an interval, then jumps to the next
+ * value. The jump falls before, after, or at the center of each interval,
+ * which suits discrete or state-over-time data.
+ *
+ * @example
+ * ```typescript
+ * const chart = new StepChart({
+ *   values: [0, 2, 2, 5, 3],
+ *   stepMode: 'after',
+ * });
+ * ```
+ */
+export declare class StepChart extends Group {
+    /** The coordinate system the steps are plotted on. */
+    axes: Axes;
+    /** The step lines, one per series. */
+    lines: VGroup;
+    /** The data-point dots, when enabled. */
+    dots: VGroup;
+    protected _values: number[][];
+    protected _x: number[];
+    protected _stepMode: StepMode;
+    protected _colors: string[];
+    protected _lineWidth: number;
+    protected _showDots: boolean;
+    protected _dotRadius: number;
+    /** Step vertices in data space, one array per series. */
+    protected _stepPoints: Array<Array<[number, number]>>;
+    constructor(options: StepChartOptions);
+    private _normalize;
+    /** Build the step vertices (data space) for one series. */
+    private _buildStepPoints;
+    private _buildAxes;
+    private _createLines;
+    /** The coordinate system. */
+    getAxes(): Axes;
+    /** The number of series. */
+    getNumSeries(): number;
+    /** The step line of series `s`. */
+    getLine(s: number): Polygon | undefined;
+    /** The step vertices in data space for series `s`. */
+    getStepPoints(s: number): Array<[number, number]>;
+    /** The step mode. */
+    getStepMode(): StepMode;
+    copy(): StepChart;
+}
+//# sourceMappingURL=StepChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StepChart.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/StepChart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAI9B;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,sDAAsD;IACtD,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC9B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;gBAE1C,OAAO,EAAE,gBAAgB;IA8CrC,OAAO,CAAC,UAAU;IAKlB,2DAA2D;IAC3D,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;IAmCpB,6BAA6B;IAC7B,OAAO,IAAI,IAAI;IAIf,4BAA4B;IAC5B,YAAY,IAAI,MAAM;IAItB,mCAAmC;IACnC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIvC,sDAAsD;IACtD,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIjD,qBAAqB;IACrB,WAAW,IAAI,QAAQ;IAId,IAAI,IAAI,SAAS;CAa3B"}

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

@@ -0,0 +1,100 @@
+import { VGroup } from '../../core/VGroup';
+import { Rectangle } from '../geometry/Rectangle';
+import { TreemapNode, TreemapTile } from './treemapLayout';
+/** How a tile picks its color. */
+export type TreemapColorBy = 'category' | 'depth';
+/**
+ * Options for {@link Treemap}.
+ */
+export interface TreemapOptions {
+    /** The root of the value hierarchy. */
+    data: TreemapNode;
+    /** Width of the chart region. Default: 8. */
+    width?: number;
+    /** Height of the chart region. Default: 4.5. */
+    height?: number;
+    /** Inset between a parent tile and its children. Default: 0.06. */
+    padding?: number;
+    /** Tile colors. Single color applies to all, array cycles. Default: Manim palette. */
+    colors?: string | string[];
+    /** Whether a color is chosen by top-level category or by depth. Default: 'category'. */
+    colorBy?: TreemapColorBy;
+    /** Fill opacity of the tiles. Default: 0.85. */
+    fillOpacity?: number;
+    /** Stroke color between tiles. Default: WHITE. */
+    strokeColor?: string;
+    /** Stroke width between tiles. Default: 1. */
+    strokeWidth?: number;
+    /** Whether to draw the root rectangle. Default: false. */
+    showRoot?: boolean;
+    /** Whether to draw a rectangle for internal (non-leaf) nodes. Default: true. */
+    showInternalNodes?: boolean;
+    /** Whether to label leaf tiles that are large enough. Default: true. */
+    showLabels?: boolean;
+    /** Font size for tile labels. Default: 18. */
+    labelFontSize?: number;
+    /** Smallest tile side, in scene units, that still gets a label. Default: 0.6. */
+    minLabelSize?: number;
+}
+/**
+ * Treemap - a squarified treemap of nested rectangles.
+ *
+ * Each node of a value hierarchy becomes a {@link Rectangle} sized in
+ * proportion to its value. Children tile their parent's rectangle, so a child
+ * always sits inside its parent. Tiles are colored by top-level category or by
+ * depth. Empty, single-node, and zero-value inputs produce no error.
+ *
+ * @example
+ * ```typescript
+ * const tree = new Treemap({
+ *   data: {
+ *     name: 'root',
+ *     children: [
+ *       { name: 'A', value: 6 },
+ *       { name: 'B', children: [{ name: 'B1', value: 2 }, { name: 'B2', value: 2 }] },
+ *     ],
+ *   },
+ * });
+ * tree.getTile([1, 0]); // the B1 rectangle
+ * ```
+ */
+export declare class Treemap extends VGroup {
+    /** The tile rectangles, root first. */
+    tiles: VGroup;
+    /** The tile labels. */
+    labelGroup: VGroup;
+    protected _layout: TreemapTile[];
+    protected _options: TreemapOptions;
+    protected _colors: string[];
+    protected _colorBy: TreemapColorBy;
+    protected _fillOpacity: number;
+    protected _strokeColor: string;
+    protected _strokeWidth: number;
+    protected _showRoot: boolean;
+    protected _showInternalNodes: boolean;
+    protected _showLabels: boolean;
+    protected _labelFontSize: number;
+    protected _minLabelSize: number;
+    protected _tileByPath: Map<string, Rectangle>;
+    constructor(options: TreemapOptions);
+    /** Whether a tile has a non-leaf (it has a deeper descendant). */
+    protected _isLeaf(tile: TreemapTile): boolean;
+    /** The color for a tile, by category (top ancestor) or by depth. */
+    protected _colorForTile(tile: TreemapTile): string;
+    /** Build one rectangle per visible tile. */
+    protected _buildTiles(): void;
+    /** Build labels for leaf tiles that are large enough to hold text. */
+    protected _buildLabels(): void;
+    /** All tile rectangles, root first when drawn. */
+    getTiles(): Rectangle[];
+    /**
+     * The rectangle for a node, addressed by its index path from the root.
+     * @param path - Child indices from the root (empty path = root).
+     * @returns The rectangle, or undefined when the node is not drawn.
+     */
+    getTile(path: number[]): Rectangle | undefined;
+    /** The computed layout (rectangles, values, depths) for every node. */
+    getLayout(): TreemapTile[];
+    copy(): Treemap;
+}
+//# sourceMappingURL=Treemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Treemap.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/Treemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAalD,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAK3F,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,OAAQ,SAAQ,MAAM;IACjC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IACjC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC;IACnC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACtC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,WAAW,yBAAgC;gBAEzC,OAAO,EAAE,cAAc;IA+CnC,kEAAkE;IAClE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAQ7C,oEAAoE;IACpE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAKlD,4CAA4C;IAC5C,SAAS,CAAC,WAAW,IAAI,IAAI;IAyB7B,sEAAsE;IACtE,SAAS,CAAC,YAAY,IAAI,IAAI;IAkB9B,kDAAkD;IAClD,QAAQ,IAAI,SAAS,EAAE;IAIvB;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS;IAI9C,uEAAuE;IACvE,SAAS,IAAI,WAAW,EAAE;IAIjB,IAAI,IAAI,OAAO;CAKzB"}

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

@@ -0,0 +1,164 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Rectangle } from '../geometry/Rectangle';
+import { NumberLine } from './NumberLine';
+/** One rendered bar, resolved from the deltas. */
+interface BarSpec {
+    /** Running total at the bottom start of the bar. */
+    startValue: number;
+    /** Running total at the top end of the bar. */
+    endValue: number;
+    /** Running total carried to the next bar (for the connector level). */
+    connectLevel: number;
+    /** Fill/stroke color for the bar. */
+    color: string;
+    /** Label text for the bar, if any. */
+    label?: string;
+}
+/**
+ * Options for creating a WaterfallChart.
+ */
+export interface WaterfallChartOptions {
+    /** Sequential contributions (deltas), left to right. */
+    values: number[];
+    /** Labels for each bar. Default: [] */
+    labels?: string[];
+    /** Color for positive contributions. Default: GREEN. */
+    increaseColor?: string;
+    /** Color for negative contributions. Default: RED. */
+    decreaseColor?: string;
+    /** Color for the total bar. Default: BLUE. */
+    totalColor?: string;
+    /** Whether to draw connector lines between bars. Default: true */
+    showConnectors?: boolean;
+    /** Whether to append a total bar spanning 0 to the sum. Default: false */
+    showTotal?: boolean;
+    /** Label for the appended total bar. Default: 'Total' */
+    totalLabel?: string;
+    /** Width of each bar. Default: 0.6 */
+    barWidth?: number;
+    /** Gap between adjacent bars. Default: 0.4 */
+    barGap?: number;
+    /** Stroke width of the connector lines. Default: 1.5 */
+    connectorWidth?: number;
+    /** Stroke width of the bar outline. Default: 1.5 */
+    barStrokeWidth?: number;
+    /** Fill opacity of the bars. Default: 0.9 */
+    fillOpacity?: number;
+    /** Y-axis range as [min, max, step]. Default: auto-scaled from the running totals. */
+    yRange?: [number, number, number];
+    /** Visual height of the chart 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 number labels. Default: true */
+    includeYLabels?: boolean;
+    /** Whether to draw the per-bar labels. Default: true */
+    showLabels?: boolean;
+    /** Font size for the bar labels. Default: 18 */
+    labelFontSize?: number;
+    /** Font size for the y-axis labels. Default: 20 */
+    yLabelFontSize?: number;
+}
+/**
+ * WaterfallChart - A waterfall (bridge) chart mobject.
+ *
+ * Shows sequential positive and negative contributions as floating bars. Bar i
+ * starts at the running total of the previous bars and spans its own delta.
+ * Positive and negative deltas use separate colors. Connector lines join each
+ * bar to the next at the running-total level. An optional total bar spans from
+ * zero to the final sum.
+ *
+ * The chart is a VGroup, so Create and FadeIn animate it directly.
+ *
+ * @example
+ * ```typescript
+ * const chart = new WaterfallChart({
+ *   values: [100, -40, 30, -20, 50],
+ *   labels: ['Start', 'Q1', 'Q2', 'Q3', 'Q4'],
+ *   showTotal: true,
+ * });
+ * scene.play(new Create(chart));
+ * ```
+ */
+export declare class WaterfallChart extends VGroup {
+    /** The floating bars (deltas, plus the total bar when enabled). */
+    bars: VGroup;
+    /** The connector lines between bars. */
+    connectors: VGroup;
+    /** The y-axis. */
+    yAxis: NumberLine;
+    /** The baseline at value zero. */
+    baseline: VMobject;
+    /** Per-bar labels. */
+    barLabels: VGroup;
+    /** Y-axis labels. */
+    yLabels: VGroup;
+    protected _values: number[];
+    protected _labelTexts: string[];
+    protected _increaseColor: string;
+    protected _decreaseColor: string;
+    protected _totalColor: string;
+    protected _showConnectors: boolean;
+    protected _showTotal: boolean;
+    protected _totalLabel: string;
+    protected _barWidth: number;
+    protected _barGap: number;
+    protected _connectorWidth: number;
+    protected _barStrokeWidth: number;
+    protected _fillOpacity: number;
+    protected _yRange: [number, number, number];
+    protected _height: number;
+    protected _width: number;
+    protected _axisColor: string;
+    protected _includeYTicks: boolean;
+    protected _includeYLabels: boolean;
+    protected _showLabels: boolean;
+    protected _labelFontSize: number;
+    protected _yLabelFontSize: number;
+    protected _specs: BarSpec[];
+    constructor(options: WaterfallChartOptions);
+    /** Resolve the deltas into ordered bar specs. */
+    private _buildSpecs;
+    /** Auto-scale the y range from every running-total level the bars reach. */
+    private _calculateYRange;
+    /** Convert a value to its y-coordinate within the chart area. */
+    valueToY(value: number): number;
+    /** X-coordinate of the center of bar i. */
+    private _barCenterX;
+    /** Create the y-axis. */
+    private _createYAxis;
+    /** Create the baseline at value zero. */
+    private _createBaseline;
+    /** Build one rectangle per bar spec. */
+    private _createBars;
+    /** Build the connector lines between adjacent bars. */
+    private _createConnectors;
+    /** Build the y-axis labels. */
+    private _createYLabels;
+    /** Build the per-bar labels below the baseline. */
+    private _createBarLabels;
+    /** Get the group of bars. */
+    getBars(): VGroup;
+    /** Get bar i, or undefined when out of range. */
+    getBar(index: number): Rectangle | undefined;
+    /** Get the group of connector lines. */
+    getConnectors(): VGroup;
+    /** Get the y-axis range as [min, max, step]. */
+    getYRange(): [number, number, number];
+    /** Get the deltas. */
+    getValues(): number[];
+    /** Get the final running total (sum of all deltas). */
+    getTotal(): number;
+    /** Get the visual height of the chart area. */
+    getChartHeight(): number;
+    /** Get the visual width of the chart area. */
+    getChartWidth(): number;
+    copy(): WaterfallChart;
+}
+export {};
+//# sourceMappingURL=WaterfallChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WaterfallChart.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/WaterfallChart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAM7D,kDAAkD;AAClD,UAAU,OAAO;IACf,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,SAAQ,MAAM;IACxC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAElC,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAEhB,OAAO,EAAE,qBAAqB;IA6E1C,iDAAiD;IACjD,OAAO,CAAC,WAAW;IA+BnB,4EAA4E;IAC5E,OAAO,CAAC,gBAAgB;IAsBxB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/B,2CAA2C;IAC3C,OAAO,CAAC,WAAW;IAQnB,yBAAyB;IACzB,OAAO,CAAC,YAAY;IAepB,yCAAyC;IACzC,OAAO,CAAC,eAAe;IAevB,wCAAwC;IACxC,OAAO,CAAC,WAAW;IAuBnB,uDAAuD;IACvD,OAAO,CAAC,iBAAiB;IAiBzB,+BAA+B;IAC/B,OAAO,CAAC,cAAc;IA2BtB,mDAAmD;IACnD,OAAO,CAAC,gBAAgB;IAkBxB,6BAA6B;IAC7B,OAAO,IAAI,MAAM;IAIjB,iDAAiD;IACjD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5C,wCAAwC;IACxC,aAAa,IAAI,MAAM;IAIvB,gDAAgD;IAChD,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAIrC,sBAAsB;IACtB,SAAS,IAAI,MAAM,EAAE;IAIrB,uDAAuD;IACvD,QAAQ,IAAI,MAAM;IAIlB,+CAA+C;IAC/C,cAAc,IAAI,MAAM;IAIxB,8CAA8C;IAC9C,aAAa,IAAI,MAAM;IAId,IAAI,IAAI,cAAc;CA4BhC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Default color cycle shared by the multi-series charts (stacked/grouped bars,
+ * area charts, step charts). Matches the Manim palette used by BarChart.
+ */
+export declare const DEFAULT_SERIES_COLORS: readonly string[];
+/**
+ * Pick a color for series `index`, cycling through `colors`.
+ *
+ * Falls back to the default palette when `colors` is empty. A negative index
+ * wraps the same way a positive index does.
+ */
+export declare function cycleColor(colors: readonly string[], index: number): string;
+/**
+ * Normalize a color option (single color or array) into a color array.
+ * An empty or missing option yields the default series palette.
+ */
+export declare function toColorList(colors: string | readonly string[] | undefined): string[];
+//# sourceMappingURL=chartColors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chartColors.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/chartColors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EASlD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAIpF"}

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

@@ -0,0 +1,89 @@
+/**
+ * Chord diagram layout.
+ *
+ * The layout turns a square flow matrix into arcs around a circle (one arc per
+ * group, sized by the group's total flow) and ribbons between the arcs (one
+ * ribbon per non-zero pair of groups, sized by the flow). The functions here
+ * are pure. The {@link ChordDiagram} mobject renders the result.
+ */
+/** A directed flow from one group to another, used as link-list input. */
+export interface ChordFlow {
+    /** Source group index. */
+    source: number;
+    /** Target group index. */
+    target: number;
+    /** Flow magnitude. */
+    value: number;
+}
+/** The arc placement for one group. */
+export interface ChordGroupArc {
+    /** Group index. */
+    index: number;
+    /** Start angle of the arc, in radians. */
+    startAngle: number;
+    /** End angle of the arc, in radians. */
+    endAngle: number;
+    /** Total flow of the group (sum of its matrix row). */
+    value: number;
+}
+/** The placement of one ribbon between two groups. */
+export interface ChordRibbonSpan {
+    /** Source group index. */
+    source: number;
+    /** Target group index. */
+    target: number;
+    /** Flow on the source side (`matrix[source][target]`). */
+    sourceValue: number;
+    /** Flow on the target side (`matrix[target][source]`). */
+    targetValue: number;
+    /** Start angle of the source span, in radians. */
+    sourceStart: number;
+    /** End angle of the source span, in radians. */
+    sourceEnd: number;
+    /** Start angle of the target span, in radians. */
+    targetStart: number;
+    /** End angle of the target span, in radians. */
+    targetEnd: number;
+}
+/** The full chord layout. */
+export interface ChordLayout {
+    /** One arc per group, in group order. */
+    groups: ChordGroupArc[];
+    /** One ribbon per non-zero flow pair. */
+    ribbons: ChordRibbonSpan[];
+    /** Sum of all matrix entries. */
+    total: number;
+}
+/** Tunable angles for {@link computeChordLayout}. */
+export interface ChordLayoutOptions {
+    /** Angular gap between adjacent groups, in radians. Default: 0.05. */
+    gap?: number;
+    /** Angle of the first group's start edge, in radians. Default: Math.PI / 2. */
+    startAngle?: number;
+}
+/**
+ * Build a square, non-negative matrix from a link list.
+ *
+ * @param flows - Directed flows between group indices.
+ * @param groupCount - Number of groups (matrix size).
+ * @returns A `groupCount x groupCount` matrix of non-negative flows.
+ */
+export declare function chordMatrixFromFlows(flows: ChordFlow[], groupCount: number): number[][];
+/**
+ * Compute the arcs and ribbons of a chord diagram.
+ *
+ * Group `i`'s arc angle is proportional to the sum of row `i`. The cell
+ * `matrix[i][j]` is a sub-span on arc `i`; a ribbon joins the span `(i, j)` on
+ * arc `i` to the span `(j, i)` on arc `j`. One ribbon is produced per unordered
+ * pair whose combined flow is positive, including a self-ribbon when the
+ * diagonal is positive.
+ *
+ * The function never throws. An empty matrix returns empty arrays, and an
+ * all-zero matrix returns zero-angle arcs and no ribbons.
+ *
+ * @param matrix - The square flow matrix.
+ * @param options - Gap and start angle.
+ * @returns The computed layout.
+ */
+export declare function computeChordLayout(matrix: number[][], options?: ChordLayoutOptions): ChordLayout;
+//# sourceMappingURL=chordLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chordLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/chordLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yCAAyC;IACzC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAUvF;AAcD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAuDb"}

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

@@ -25,8 +25,19 @@ export { FourierSeries, type FourierSeriesOptions } from './FourierSeries';
 export { ComplexPlane, type ComplexPlaneOptions, type Complex } from './ComplexPlane';
 export { PolarPlane, type PolarPlaneOptions } from './ComplexPlane';
 export { BarChart, type BarChartOptions } from './BarChart';
+export { DEFAULT_SERIES_COLORS, cycleColor, toColorList } from './chartColors';
+export { StackedBarChart, type StackedBarChartOptions, type BarChartMode } from './StackedBarChart';
+export { AreaChart, type AreaChartOptions } from './AreaChart';
+export { StepChart, type StepChartOptions, type StepMode } from './StepChart';
+export { CalendarHeatmap, GITHUB_GREENS, type CalendarHeatmapOptions, type CalendarDatum, type CellPosition, } from './CalendarHeatmap';
 export { CandlestickChart, type CandlestickChartOptions, type OHLC } from './CandlestickChart';
+export { RadarChart, type RadarChartOptions } from './RadarChart';
+export { WaterfallChart, type WaterfallChartOptions } from './WaterfallChart';
 export { PieChart, type PieChartOptions, DonutChart, type DonutChartOptions, computeSliceGeometry, type SliceGeometry, type LabelPosition, } from './PieChart';
+export { Treemap, type TreemapOptions, type TreemapColorBy } from './Treemap';
+export { computeTreemapLayout, squarify, treemapNodeValue, type TreemapNode, type TreemapRect, type TreemapTile, } from './treemapLayout';
+export { ChordDiagram, ChordArc, ChordRibbon, type ChordDiagramOptions } from './ChordDiagram';
+export { computeChordLayout, chordMatrixFromFlows, type ChordFlow, type ChordGroupArc, type ChordRibbonSpan, type ChordLayout, type ChordLayoutOptions, } from './chordLayout';
 export { mean, stdDev, quantile, iqr, histogramBins, kde, silvermanBandwidth, boxSummary, extent, niceAxisRange, type HistogramBin, type HistogramBinsOptions, type KdeOptions, type BoxSummary, } from './stats';
 export { Histogram, type HistogramOptions } from './Histogram';
 export { ScatterPlot, type ScatterPlotOptions } from './ScatterPlot';

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

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

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

@@ -0,0 +1,83 @@
+/**
+ * Squarified treemap layout.
+ *
+ * The layout maps a value hierarchy to nested rectangles. A node's area is
+ * proportional to its value, and the children of a node tile the node's
+ * rectangle without gaps or overlap. The squarify strategy keeps each tile's
+ * aspect ratio near 1.
+ *
+ * The functions here are pure. The {@link Treemap} mobject renders the result.
+ */
+/**
+ * One node in the input hierarchy.
+ *
+ * A leaf sets `value`. An internal node sets `children`; its value is the sum
+ * of its children, so an explicit `value` on an internal node is ignored.
+ * Negative values are clamped to 0, because an area cannot be negative.
+ */
+export interface TreemapNode {
+    /** Display name of the node. */
+    name: string;
+    /** Value of a leaf node. Ignored when `children` is present. */
+    value?: number;
+    /** Child nodes. Present on internal nodes. */
+    children?: TreemapNode[];
+}
+/** An axis-aligned rectangle. `(x, y)` is the lower-left (minimum) corner. */
+export interface TreemapRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** The computed placement of one node in the hierarchy. */
+export interface TreemapTile {
+    /** Index path from the root. The root itself has an empty path. */
+    path: number[];
+    /** Node name. */
+    name: string;
+    /** Resolved value (sum of descendants for an internal node). */
+    value: number;
+    /** Depth in the tree. The root is depth 0. */
+    depth: number;
+    /** The node's rectangle. */
+    rect: TreemapRect;
+}
+/**
+ * Resolve the value of a node.
+ *
+ * A leaf returns its own value, clamped to be non-negative. An internal node
+ * returns the sum of its children's resolved values.
+ *
+ * @param node - The node to measure.
+ * @returns The non-negative value of the node.
+ */
+export declare function treemapNodeValue(node: TreemapNode): number;
+/**
+ * Partition `region` into one rectangle per area, in input order.
+ *
+ * The areas must already be scaled so their sum equals the region area. The
+ * result tiles the region exactly (no gaps, no overlap) when the areas are
+ * positive. A zero area yields a zero-size rectangle at the current corner.
+ *
+ * @param areas - Target areas, best supplied in descending order.
+ * @param region - The rectangle to fill.
+ * @returns One rectangle per area, aligned to the `areas` index.
+ */
+export declare function squarify(areas: number[], region: TreemapRect): TreemapRect[];
+/**
+ * Compute the full treemap layout for a hierarchy.
+ *
+ * The root fills `region`. Each internal node's children tile the node's
+ * rectangle, inset by `padding` so a parent border stays visible. With
+ * `padding` 0 the leaves partition the region exactly.
+ *
+ * The function never throws. An empty hierarchy still returns the root tile.
+ *
+ * @param root - The root node.
+ * @param region - The rectangle the root fills.
+ * @param padding - Inset applied before laying out each node's children.
+ * @returns Tiles in pre-order (root first), one per node.
+ */
+export declare function computeTreemapLayout(root: TreemapNode, region: TreemapRect, padding?: number): TreemapTile[];
+//# sourceMappingURL=treemapLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treemapLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/treemapLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAK1D;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CA8C5E;AAqDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,OAAO,SAAI,GACV,WAAW,EAAE,CAOf"}