manim-web 0.25.0 → 0.27.0

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

@@ -0,0 +1,36 @@
+import { GanttTask, GanttTimeValue } from './GanttChart';
+/** One resolved task, ready to render. */
+export interface GanttTaskSpec {
+    /** Task name. */
+    name: string;
+    /** Start time as a number. */
+    startValue: number;
+    /** End time as a number. */
+    endValue: number;
+    /** Index of the row the task sits on. */
+    rowIndex: number;
+    /** Resolved bar color. */
+    color: string;
+    /** Names of the tasks this task depends on. */
+    dependencies: string[];
+}
+/** The resolved specs plus the distinct row keys, in row order. */
+export interface GanttLayout {
+    /** One spec per task, in task order. */
+    specs: GanttTaskSpec[];
+    /** Distinct row keys, in first-appearance (top-to-bottom) order. */
+    rowKeys: string[];
+}
+/** Read a time value as a number. A Date is read through getTime(). */
+export declare function toTimeNumber(value: GanttTimeValue): number;
+/**
+ * Resolve tasks into render specs and the ordered list of rows.
+ *
+ * The row key of a task is its `row`, or its name when `row` is absent, so a
+ * task without a row key gets its own row. Colors come from the task's own
+ * color, or the palette cycled by row index.
+ */
+export declare function resolveGanttLayout(tasks: GanttTask[], palette: string[]): GanttLayout;
+/** Time range as [min start, max end] across all specs. */
+export declare function ganttTimeRange(specs: GanttTaskSpec[]): [number, number];
+//# sourceMappingURL=ganttLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ganttLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ganttLayout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAwBrF;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWvE"}

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

@@ -25,8 +25,20 @@ 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 { GanttChart, type GanttChartOptions, type GanttTask, type GanttTimeValue, } from './GanttChart';
 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"}