manim-web 0.25.0 → 0.27.0

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

@@ -0,0 +1,101 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Polygon } from '../geometry/Polygon';
+import { Axes } from './Axes';
+/** Options for creating an AreaChart. */
+export interface AreaChartOptions {
+    /** 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[];
+    /** Stack the series so each area rests on the sum below it. Default: false */
+    stacked?: boolean;
+    /** Baseline each (unstacked) area fills down to. Default: 0 */
+    baseline?: number;
+    /** Series colors for fills and lines. Single color or array. Default: Manim palette */
+    seriesColors?: string | string[];
+    /** Series names for the legend. Default: [] */
+    seriesNames?: string[];
+    /** Fill opacity for the areas. Default: 0.4 */
+    fillOpacity?: number;
+    /** Stroke width for the top line. Default: 3 */
+    lineWidth?: 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;
+}
+/** The two mobjects that draw one series of an AreaChart. */
+interface SeriesParts {
+    /** The filled area from the top line down to the band below. */
+    area: Polygon;
+    /** The top boundary line. */
+    line: Polygon;
+}
+/**
+ * AreaChart - one or more series drawn as filled areas under a line.
+ *
+ * Each series becomes a semi-transparent fill from its line down to the
+ * baseline, plus the line itself. When `stacked` is set, each area rests on
+ * the cumulative sum of the series below it.
+ *
+ * @example
+ * ```typescript
+ * const chart = new AreaChart({
+ *   values: [[1, 3, 2, 5], [2, 1, 4, 3]],
+ *   stacked: true,
+ *   seriesNames: ['A', 'B'],
+ * });
+ * ```
+ */
+export declare class AreaChart extends Group {
+    /** The coordinate system the areas are plotted on. */
+    axes: Axes;
+    /** The filled areas, one per series. */
+    areas: VGroup;
+    /** The top boundary lines, one per series. */
+    lines: VGroup;
+    protected _values: number[][];
+    protected _x: number[];
+    protected _stacked: boolean;
+    protected _baseline: number;
+    protected _colors: string[];
+    protected _fillOpacity: number;
+    protected _lineWidth: number;
+    protected _parts: SeriesParts[];
+    constructor(options: AreaChartOptions);
+    private _normalize;
+    /** The cumulative baseline below series `s` at point index `i`. */
+    private _bandBelow;
+    /** The top value of series `s` at point index `i`. */
+    private _bandTop;
+    private _buildAxes;
+    private _createSeries;
+    /** The coordinate system. */
+    getAxes(): Axes;
+    /** The number of series. */
+    getNumSeries(): number;
+    /** The filled area polygon of series `s`. */
+    getArea(s: number): Polygon | undefined;
+    /** The top boundary line of series `s`. */
+    getLine(s: number): Polygon | undefined;
+    /** The area and line of series `s` grouped together. */
+    getSeries(s: number): VGroup;
+    /** The data-space baseline value an unstacked area fills down to. */
+    getBaseline(): number;
+    /** The top data value of series `s` at each x (cumulative when stacked). */
+    getTopValues(s: number): number[];
+    /** The baseline data value below series `s` at each x (cumulative when stacked). */
+    getBottomValues(s: number): number[];
+    copy(): AreaChart;
+}
+export {};
+//# sourceMappingURL=AreaChart.d.ts.map

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

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

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

@@ -0,0 +1,111 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Rectangle } from '../geometry/Rectangle';
+/** GitHub-style green contribution palette (light to dark). */
+export declare const GITHUB_GREENS: readonly string[];
+/** One dated value for a CalendarHeatmap. */
+export interface CalendarDatum {
+    /** The day, as a 'YYYY-MM-DD' string or a Date. */
+    date: string | Date;
+    /** The value that colors the day. */
+    value: number;
+}
+/** The grid position of a day cell. */
+export interface CellPosition {
+    /** Column index (week offset from the start). */
+    week: number;
+    /** Row index (0..6), the weekday within the chart's week layout. */
+    weekday: number;
+}
+/** Options for creating a CalendarHeatmap. */
+export interface CalendarHeatmapOptions {
+    /** The dated values. */
+    data: CalendarDatum[];
+    /** First day shown. Default: the earliest date in the data. */
+    startDate?: string | Date;
+    /** Last day shown. Default: the latest date in the data. */
+    endDate?: string | Date;
+    /** Side length of a day cell. Default: 0.3 */
+    cellSize?: number;
+    /** Gap between cells. Default: 0.06 */
+    cellGap?: number;
+    /** Color palette mapped across the value domain. Default: GitHub greens */
+    palette?: readonly string[];
+    /** Value domain [min, max] mapped across the palette. Auto-computed if omitted. */
+    domain?: [number, number];
+    /** Blend the palette in perceptually-uniform Oklab space. Default: false */
+    useOklab?: boolean;
+    /** First weekday of a column: 0 = Sunday (GitHub), 1 = Monday. Default: 0 */
+    weekStartsOn?: 0 | 1;
+    /** Color for days with no datum. Default: '#ebedf0' */
+    emptyColor?: string;
+    /** Draw month labels above the grid. Default: true */
+    showMonthLabels?: boolean;
+    /** Font size for month labels. Default: 16 */
+    monthLabelFontSize?: number;
+    /** Color for labels. Default: white */
+    labelColor?: string;
+}
+/**
+ * CalendarHeatmap - a GitHub-style grid of day cells colored by value.
+ *
+ * Weeks run as columns and weekdays as rows. Each day is a colored square;
+ * days with a value are colored through the palette, and days with no datum
+ * take the empty color. Month labels sit above the columns where a month
+ * begins.
+ *
+ * @example
+ * ```typescript
+ * const cal = new CalendarHeatmap({
+ *   data: [
+ *     { date: '2024-01-01', value: 3 },
+ *     { date: '2024-01-02', value: 7 },
+ *   ],
+ * });
+ * ```
+ */
+export declare class CalendarHeatmap extends Group {
+    /** The day cells. */
+    cells: VGroup;
+    /** The month labels. */
+    monthLabels: VGroup;
+    protected _cellSize: number;
+    protected _cellGap: number;
+    protected _palette: readonly string[];
+    protected _domain: [number, number];
+    protected _useOklab: boolean;
+    protected _weekStartsOn: 0 | 1;
+    protected _emptyColor: string;
+    protected _labelColor: string;
+    protected _values: Map<string, number>;
+    protected _startTs: number;
+    protected _endTs: number;
+    /** Cell rectangle by day key. */
+    protected _cellByKey: Map<string, Rectangle>;
+    /** Grid position by day key. */
+    protected _posByKey: Map<string, CellPosition>;
+    constructor(options: CalendarHeatmapOptions);
+    private _autoDomain;
+    /** The first column's start day, snapped back to the week's first weekday. */
+    private _resolveBounds;
+    /** The weekday row (0..6) of a day, honoring weekStartsOn. */
+    private _weekdayOf;
+    /** The grid position of a day timestamp. */
+    private _positionOf;
+    /** The cell center in local space for a grid position. */
+    private _centerOf;
+    private _createCells;
+    private _createMonthLabels;
+    /** The value domain [min, max] mapped across the palette. */
+    getDomain(): [number, number];
+    /** The number of day cells drawn. */
+    getNumCells(): number;
+    /** The cell rectangle for a date, or undefined when outside the range. */
+    getCell(date: string | Date): Rectangle | undefined;
+    /** The grid position (week, weekday) of a date. */
+    cellPosition(date: string | Date): CellPosition;
+    /** The color the map assigns to a value. */
+    colorForValue(value: number): string;
+    copy(): CalendarHeatmap;
+}
+//# sourceMappingURL=CalendarHeatmap.d.ts.map

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

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

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

@@ -0,0 +1,122 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { AnnularSector } from '../geometry/AnnularSector';
+import { ChordFlow, ChordGroupArc, ChordLayout, ChordRibbonSpan } from './chordLayout';
+/**
+ * A single group arc of a {@link ChordDiagram}.
+ */
+export declare class ChordArc extends AnnularSector {
+    /** Group index. */
+    readonly groupIndex: number;
+    /** Total flow of the group. */
+    readonly total: number;
+    constructor(options: ConstructorParameters<typeof AnnularSector>[0] & {
+        groupIndex: number;
+        total: number;
+    });
+}
+/**
+ * A single flow ribbon of a {@link ChordDiagram}.
+ *
+ * The ribbon is a closed filled VMobject: an arc along the source span, a
+ * bezier through the center to the target span, an arc along it, and a bezier
+ * back. The source and target span angles are proportional to the flow values.
+ */
+export declare class ChordRibbon extends VMobject {
+    /** Source group index. */
+    readonly source: number;
+    /** Target group index. */
+    readonly target: number;
+    /** Flow on the source side. */
+    readonly sourceValue: number;
+    /** Flow on the target side. */
+    readonly targetValue: number;
+    private readonly _sourceSpanAngle;
+    private readonly _targetSpanAngle;
+    constructor(span: ChordRibbonSpan, radius: number, color: string, fillOpacity: number);
+    /** Angular width of the source span, proportional to {@link sourceValue}. */
+    getSourceSpanAngle(): number;
+    /** Angular width of the target span, proportional to {@link targetValue}. */
+    getTargetSpanAngle(): number;
+}
+/**
+ * Options for {@link ChordDiagram}.
+ */
+export interface ChordDiagramOptions {
+    /** Square flow matrix. `matrix[i][j]` is the flow from group i to group j. */
+    matrix?: number[][];
+    /** Link-list input, used with `groupCount` when `matrix` is omitted. */
+    flows?: ChordFlow[];
+    /** Number of groups, required with `flows`. */
+    groupCount?: number;
+    /** Group labels, by index. Default: []. */
+    labels?: string[];
+    /** Inner radius of the ring (ribbons are drawn inside it). Default: 2.5. */
+    radius?: number;
+    /** Thickness of the group ring. Default: 0.25. */
+    ringWidth?: number;
+    /** Angular gap between groups, in radians. Default: 0.05. */
+    gap?: number;
+    /** Angle of the first group's start edge, in radians. Default: Math.PI / 2. */
+    startAngle?: number;
+    /** Group colors. Single color applies to all, array cycles. Default: Manim palette. */
+    colors?: string | string[];
+    /** Fill opacity of the group arcs. Default: 1. */
+    arcOpacity?: number;
+    /** Fill opacity of the ribbons. Default: 0.6. */
+    ribbonOpacity?: number;
+    /** Whether to draw group labels. Default: true when labels are given. */
+    showLabels?: boolean;
+    /** Font size for group labels. Default: 20. */
+    labelFontSize?: number;
+    /** Gap between the ring and a label. Default: 0.3. */
+    labelBuff?: number;
+}
+/**
+ * ChordDiagram - arcs around a circle linked by proportional ribbons.
+ *
+ * Each group becomes an {@link ChordArc} whose angle is proportional to the
+ * group's total flow. Each non-zero flow pair becomes a {@link ChordRibbon}
+ * whose span angles are proportional to the flow values. Empty, single-group,
+ * and zero-value inputs produce no error.
+ *
+ * @example
+ * ```typescript
+ * const chord = new ChordDiagram({
+ *   matrix: [
+ *     [0, 3, 1],
+ *     [3, 0, 2],
+ *     [1, 2, 0],
+ *   ],
+ *   labels: ['A', 'B', 'C'],
+ * });
+ * chord.getArc(0); // the first group arc
+ * ```
+ */
+export declare class ChordDiagram extends VGroup {
+    /** The group arcs. */
+    arcs: VGroup;
+    /** The flow ribbons. */
+    chords: VGroup;
+    /** The group labels. */
+    labelGroup: VGroup;
+    protected _options: ChordDiagramOptions;
+    protected _layout: ChordLayout;
+    protected _arcs: ChordArc[];
+    protected _chords: ChordRibbon[];
+    constructor(options: ChordDiagramOptions);
+    /** Build a label for each group at its mid-angle, outside the ring. */
+    protected _buildLabels(groups: ChordGroupArc[], labels: string[], labelRadius: number, fontSize: number): void;
+    /** All group arcs, in group order. */
+    getArcs(): ChordArc[];
+    /** The arc for a group index, or undefined when out of range. */
+    getArc(index: number): ChordArc | undefined;
+    /** All flow ribbons, in layout order. */
+    getChords(): ChordRibbon[];
+    /** The ribbon at the given index, or undefined when out of range. */
+    getChord(index: number): ChordRibbon | undefined;
+    /** The computed layout (arcs and ribbon spans). */
+    getLayout(): ChordLayout;
+    copy(): ChordDiagram;
+}
+//# sourceMappingURL=ChordDiagram.d.ts.map

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

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

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

@@ -0,0 +1,179 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Rectangle } from '../geometry/Rectangle';
+import { Line } from '../geometry/Line';
+import { GanttTaskSpec } from './ganttLayout';
+/** A time value, given either as a number or a Date. */
+export type GanttTimeValue = number | Date;
+/**
+ * One task on the timeline.
+ */
+export interface GanttTask {
+    /** Unique task name, used for labels and as a dependency reference. */
+    name: string;
+    /** Start of the task (number or Date). */
+    start: GanttTimeValue;
+    /** End of the task (number or Date). */
+    end: GanttTimeValue;
+    /** Row key. Tasks that share a key share a row. Default: the task name. */
+    row?: string;
+    /** Explicit bar color. Default: cycled from the palette by row. */
+    color?: string;
+    /** Names of tasks this task depends on (for dependency arrows). */
+    dependencies?: string[];
+}
+/**
+ * Options for creating a GanttChart.
+ */
+export interface GanttChartOptions {
+    /** Tasks to render, top to bottom in row order. */
+    tasks: GanttTask[];
+    /** Visual width of the time axis. Default: 8 */
+    width?: number;
+    /** Height of each task bar. Default: 0.4 */
+    rowHeight?: number;
+    /** Vertical gap between rows. Default: 0.2 */
+    rowGap?: number;
+    /** Bar colors. Single color applies to all, array cycles by row. Default: palette. */
+    barColors?: string | readonly string[];
+    /** Fill opacity of the bars. Default: 0.9 */
+    barFillOpacity?: number;
+    /** Stroke width of the bar outline. Default: 1.5 */
+    barStrokeWidth?: number;
+    /** Color for the axis, ticks and labels. Default: WHITE */
+    axisColor?: string;
+    /** Whether to draw the time axis line and ticks. Default: true */
+    showTimeAxis?: boolean;
+    /** Explicit tick values on the time axis (overrides timeTickCount). */
+    timeTicks?: GanttTimeValue[];
+    /** Number of evenly spaced ticks when timeTicks is not given. Default: 5 */
+    timeTickCount?: number;
+    /** Formatter for a tick value. Default: ISO date for Date input, else the number. */
+    formatTime?: (value: number) => string;
+    /** Font size for the time-axis labels. Default: 18 */
+    timeLabelFontSize?: number;
+    /** Whether to draw the per-row task labels. Default: true */
+    showLabels?: boolean;
+    /** Font size for the task labels. Default: 18 */
+    labelFontSize?: number;
+    /** Whether to draw dependency arrows between tasks. Default: false */
+    showDependencies?: boolean;
+    /** Color for the dependency arrows. Default: WHITE */
+    dependencyColor?: string;
+    /** Stroke width of the dependency arrows. Default: 2 */
+    dependencyStrokeWidth?: number;
+    /** Optional "today" marker position (number or Date). */
+    today?: GanttTimeValue;
+    /** Color for the today marker. Default: RED */
+    todayColor?: string;
+    /** Stroke width of the today marker. Default: 2 */
+    todayStrokeWidth?: number;
+}
+/**
+ * GanttChart - A project-timeline chart mobject.
+ *
+ * Each task is a horizontal bar that spans its start to its end on a shared time
+ * x-axis. Each task sits on one row. Tasks that share a `row` key share a row and
+ * may overlap. Optional dependency arrows point from a predecessor's end to a
+ * dependent task's start. An optional "today" marker draws a vertical line.
+ *
+ * Time values are numbers or Dates; a Date is read through getTime(). A task
+ * whose end is at or before its start keeps a minimum-width bar anchored at its
+ * start, so the bar count always equals the task count.
+ *
+ * The chart is a VGroup, so Create and FadeIn animate it directly.
+ *
+ * @example
+ * ```typescript
+ * const chart = new GanttChart({
+ *   tasks: [
+ *     { name: 'Design', start: 0, end: 3 },
+ *     { name: 'Build', start: 3, end: 8, dependencies: ['Design'] },
+ *   ],
+ *   showDependencies: true,
+ *   today: 5,
+ * });
+ * scene.play(new Create(chart));
+ * ```
+ */
+export declare class GanttChart extends VGroup {
+    /** The task bars, one per task, in task order. */
+    bars: VGroup;
+    /** The per-row task labels. */
+    taskLabels: VGroup;
+    /** The dependency arrows (empty unless showDependencies is set). */
+    dependencyArrows: VGroup;
+    /** The time axis line. */
+    timeAxis: VMobject;
+    /** The time-axis tick labels. */
+    timeLabels: VGroup;
+    /** The today marker, when a today value is given; otherwise null. */
+    todayMarker: Line | null;
+    protected _tasks: GanttTask[];
+    protected _width: number;
+    protected _rowHeight: number;
+    protected _rowGap: number;
+    protected _barColors: string[];
+    protected _barFillOpacity: number;
+    protected _barStrokeWidth: number;
+    protected _axisColor: string;
+    protected _showTimeAxis: boolean;
+    protected _timeTicks: number[] | null;
+    protected _timeTickCount: number;
+    protected _formatTime: (value: number) => string;
+    protected _timeLabelFontSize: number;
+    protected _showLabels: boolean;
+    protected _labelFontSize: number;
+    protected _showDependencies: boolean;
+    protected _dependencyColor: string;
+    protected _dependencyStrokeWidth: number;
+    protected _today: number | null;
+    protected _todayColor: string;
+    protected _todayStrokeWidth: number;
+    protected _specs: GanttTaskSpec[];
+    protected _rowKeys: string[];
+    protected _timeRange: [number, number];
+    protected _indexByName: Map<string, number>;
+    private _usesDates;
+    constructor(options: GanttChartOptions);
+    /** Default tick formatter: ISO date for Date input, else a trimmed number. */
+    private _defaultFormat;
+    /** Convert a time value to its x-coordinate on the time axis. */
+    valueToX(value: GanttTimeValue): number;
+    /** Y-coordinate of the center of row `rowIndex` (row 0 is topmost). */
+    rowCenterY(rowIndex: number): number;
+    /** Top y-coordinate of the chart area (above the top row). */
+    private _chartTop;
+    /** Create the horizontal time axis line below the bottom row. */
+    private _createTimeAxis;
+    /** Build one bar per task spec. */
+    private _createBars;
+    /** Build the time-axis tick labels. */
+    private _createTimeLabels;
+    /** The tick values along the time axis. */
+    private _tickValues;
+    /** Build one label per row, placed to the left of the chart. */
+    private _createTaskLabels;
+    /** Build an arrow from each dependency's end to the dependent task's start. */
+    private _createDependencyArrows;
+    /** Build the vertical today marker. */
+    private _createTodayMarker;
+    /** Get the group of task bars. */
+    getBars(): VGroup;
+    /** Get the bar for a task by name, or undefined when there is no such task. */
+    getBar(name: string): Rectangle | undefined;
+    /** Get the group of dependency arrows (empty unless showDependencies is set). */
+    getDependencyArrows(): VGroup;
+    /** Get the today marker, or null when no today value was given. */
+    getTodayMarker(): Line | null;
+    /** Get the time range as [min start, max end]. */
+    getTimeRange(): [number, number];
+    /** Get the number of rows. */
+    getRowCount(): number;
+    /** Get the task definitions. */
+    getTasks(): GanttTask[];
+    /** Get the visual width of the time axis. */
+    getChartWidth(): number;
+    copy(): GanttChart;
+}
+//# sourceMappingURL=GanttChart.d.ts.map

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

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