manim-web 0.16.0 → 0.17.0

package/dist/mobjects/graph/DiGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DiGraph.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graph/DiGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAa,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,OAAQ,SAAQ,YAAY;gBAC3B,OAAO,GAAE,cAAmB;IAexC;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAUxC;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAUvC;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM;IAIjC;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM;IAIvB,IAAI,IAAI,OAAO;CAWzB"}
+{"version":3,"file":"DiGraph.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graph/DiGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAa,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,OAAQ,SAAQ,YAAY;gBAC3B,OAAO,GAAE,cAAmB;IAqBxC;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAUxC;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAUvC;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM;IAIjC;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM;IAIvB,IAAI,IAAI,OAAO;CAWzB"}

package/dist/mobjects/graph/GenericGraph.d.ts

@@ -1,6 +1,7 @@
 import { Mobject, Vector3Tuple } from '../../core/Mobject';
 import { Dot } from '../geometry/Dot';
 import { VertexId, EdgeTuple, LayoutType, VertexStyleOptions, EdgeStyleOptions, VertexConfig, EdgeConfig, LayoutConfig, GenericGraphOptions } from './graphTypes';
+import { Text } from '../text/Text';
 /**
  * GenericGraph - Base class for graph visualization
  *
@@ -20,6 +21,8 @@ export declare class GenericGraph extends Mobject {
     protected _vertexMobjects: Map<VertexId, Dot>;
     /** Map of edge key to Line/Arrow mobject */
     protected _edgeMobjects: Map<string, Mobject>;
+    /** Map of edge key to its weight/label Text mobject */
+    protected _edgeLabelMobjects: Map<string, Text>;
     /** Layout configuration */
     protected _layoutConfig: LayoutConfig;
     /** Default vertex style */
@@ -147,12 +150,24 @@ export declare class GenericGraph extends Mobject {
      * Get the Line/Arrow mobject for an edge
      */
     getEdgeMobject(source: VertexId, target: VertexId): Mobject | undefined;
+    /**
+     * Get the weight/label Text mobject for an edge, if the edge has one.
+     */
+    getEdgeLabelMobject(source: VertexId, target: VertexId): Text | undefined;
+    /**
+     * Check whether an edge is a self-loop (connects a vertex to itself).
+     */
+    isSelfLoop(source: VertexId, target: VertexId): boolean;
     /**
      * Change the layout algorithm
      * @param layout - Layout type or configuration
      * @returns this for chaining
      */
     setLayout(layout: LayoutType | LayoutConfig): this;
+    /**
+     * Remove and forget the label mobject for an edge, if any.
+     */
+    protected _removeEdgeLabel(key: string): void;
     /**
      * Get all vertex positions
      */

package/dist/mobjects/graph/GenericGraph.d.ts.map

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

package/dist/mobjects/graph/graphEdgeDecorations.d.ts

@@ -0,0 +1,27 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Arc } from '../geometry/Arc';
+import { Text } from '../text/Text';
+import { EdgeConfig, EdgeStyleOptions } from './graphTypes';
+/** Default gap between a straight edge and its label. */
+export declare const DEFAULT_EDGE_LABEL_BUFF = 0.2;
+/**
+ * Return the text to render on an edge, or null when there is nothing to show.
+ *
+ * An explicit `label` wins. Otherwise a numeric `weight` renders as its string.
+ */
+export declare function edgeLabelString(cfg?: EdgeConfig): string | null;
+/**
+ * Build the loop arc for a self-loop edge. The arc is a near-full circle above
+ * the vertex. For a directed graph it carries an arrow tip at its end.
+ */
+export declare function createSelfLoopEdge(vertexCenter: Vector3Tuple, vertexRadius: number, style: EdgeStyleOptions, directed: boolean): Arc;
+/** Point at which to place the label of a self-loop edge (above the loop). */
+export declare function selfLoopLabelPoint(vertexCenter: Vector3Tuple, vertexRadius: number, style: EdgeStyleOptions): Vector3Tuple;
+/**
+ * Point at which to place the label of a straight edge: the midpoint, pushed
+ * perpendicular to the edge by `buff` so the text clears the line.
+ */
+export declare function straightEdgeLabelPoint(start: Vector3Tuple, end: Vector3Tuple, buff: number): Vector3Tuple;
+/** Build the text mobject for an edge label (a weight or an explicit label). */
+export declare function createEdgeLabel(text: string, style: EdgeStyleOptions): Text;
+//# sourceMappingURL=graphEdgeDecorations.d.ts.map

package/dist/mobjects/graph/graphEdgeDecorations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEdgeDecorations.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graph/graphEdgeDecorations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMjE,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAW/D;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,OAAO,GAChB,GAAG,CAcL;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,gBAAgB,GACtB,YAAY,CAKd;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,GACX,YAAY,CAed;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAM3E"}

package/dist/mobjects/graph/graphTypes.d.ts

@@ -38,6 +38,14 @@ export interface EdgeStyleOptions {
     tipLength?: number;
     /** For directed graphs, tip width. Default: 0.12 */
     tipWidth?: number;
+    /** Radius of a self-loop arc (edge from a vertex to itself). Default: 0.3 */
+    selfLoopRadius?: number;
+    /** Font size for a weight or label rendered on the edge. Default: 24 */
+    labelFontSize?: number;
+    /** Color for a weight or label rendered on the edge. Default: edge color */
+    labelColor?: string;
+    /** Gap between a straight edge and its label. Default: 0.2 */
+    labelBuff?: number;
 }
 /**
  * Configuration for a single vertex

package/dist/mobjects/graph/graphTypes.d.ts.map

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

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

@@ -0,0 +1,77 @@
+import { VMobject } from '../../core/VMobject';
+import { Axes } from './Axes';
+/** A 2D scalar field g(x, y). */
+export type ContourField = (x: number, y: number) => number;
+/**
+ * Options for creating a ContourPlot.
+ */
+export interface ContourPlotOptions {
+    /** The scalar field g(x, y). Contours are the level sets g = level. */
+    func: ContourField;
+    /** The iso levels to draw. Default: [-2, -1, 0, 1, 2] */
+    levels?: number[];
+    /** X range [min, max]. Default: [-5, 5] */
+    xRange?: [number, number];
+    /** Y range [min, max]. Default: [-5, 5] */
+    yRange?: [number, number];
+    /** Grid cells per axis for the marching-squares sampling. Default: 48 */
+    resolution?: number;
+    /** Stroke color. Default: '#58c4dd' (Manim blue) */
+    color?: string;
+    /** Stroke width in pixels. Default: 2 */
+    strokeWidth?: number;
+    /** Reference axes for coordinate transformation. Optional. */
+    axes?: Axes;
+}
+/**
+ * ContourPlot - iso-contour lines of a 2D scalar field g(x, y).
+ *
+ * The field is sampled on a regular grid, then marching squares (see
+ * {@link marchingSquares}) extracts the line segments of each requested level.
+ * The segments are drawn as one stroked VMobject with a path break between
+ * them, so disjoint contours and nested loops all render. When `axes` is given,
+ * segment endpoints map through `axes.coordsToPoint`, matching
+ * {@link ImplicitFunction}.
+ *
+ * @example
+ * ```typescript
+ * // Concentric circles: g = x^2 + y^2 contoured at 1, 4, 9
+ * const contours = new ContourPlot({
+ *   func: (x, y) => x * x + y * y,
+ *   levels: [1, 4, 9],
+ *   xRange: [-4, 4],
+ *   yRange: [-4, 4],
+ * });
+ * ```
+ */
+export declare class ContourPlot extends VMobject {
+    private _func;
+    private _levels;
+    private _xRange;
+    private _yRange;
+    private _resolution;
+    private _axes;
+    constructor(options: ContourPlotOptions);
+    /** Sample the field grid and return the values plus the coordinate axes. */
+    private _sampleGrid;
+    /** Collect contour segments across every requested level. */
+    private _contourSegments;
+    /** Map a field-space point to scene space through the axes, if any. */
+    private _toScene;
+    /** Convert a straight segment into four cubic-Bezier control points. */
+    private _segmentToBezier;
+    /** Build the stroked path from the contour segments. */
+    private _generatePoints;
+    /** Get the scalar field. */
+    getFunc(): ContourField;
+    /** Set the scalar field and rebuild the contours. */
+    setFunc(func: ContourField): this;
+    /** Get the contour levels. */
+    getLevels(): number[];
+    /** Set the contour levels and rebuild. */
+    setLevels(levels: number[]): this;
+    /** Set the reference axes and rebuild. */
+    setAxes(axes: Axes | null): this;
+    copy(): ContourPlot;
+}
+//# sourceMappingURL=ContourPlot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContourPlot.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ContourPlot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAc;gBAEf,OAAO,EAAE,kBAAkB;IA4BvC,4EAA4E;IAC5E,OAAO,CAAC,WAAW;IAoBnB,6DAA6D;IAC7D,OAAO,CAAC,gBAAgB;IASxB,uEAAuE;IACvE,OAAO,CAAC,QAAQ;IAIhB,wEAAwE;IACxE,OAAO,CAAC,gBAAgB;IAUxB,wDAAwD;IACxD,OAAO,CAAC,eAAe;IAsBvB,4BAA4B;IAC5B,OAAO,IAAI,YAAY;IAIvB,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAMjC,8BAA8B;IAC9B,SAAS,IAAI,MAAM,EAAE;IAIrB,0CAA0C;IAC1C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAMjC,0CAA0C;IAC1C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAMvB,IAAI,IAAI,WAAW;CAc7B"}

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

@@ -0,0 +1,85 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Mobject3D } from '../three-d/Mobject3D';
+import * as THREE from 'three';
+/** A 2D scalar field g(x, y). */
+export type ScalarField2D = (x: number, y: number) => number;
+/**
+ * Options for creating a HeatMap.
+ */
+export interface HeatMapOptions {
+    /** The scalar field g(x, y) to visualize. */
+    func: ScalarField2D;
+    /** X range [min, max]. Default: [-5, 5] */
+    xRange?: [number, number];
+    /** Y range [min, max]. Default: [-5, 5] */
+    yRange?: [number, number];
+    /** Grid cells per axis, or [nx, ny]. Default: 64 */
+    resolution?: number | [number, number];
+    /** Value domain [min, max] mapped across the palette. Auto-computed if omitted. */
+    domain?: [number, number];
+    /** Ordered hex color stops. Default: a viridis-like palette. */
+    palette?: readonly string[];
+    /** Blend the palette in perceptually-uniform Oklab space. Default: false */
+    useOklab?: boolean;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+}
+/**
+ * HeatMap - a colored plane that encodes a 2D scalar field g(x, y).
+ *
+ * The region is sampled on a regular grid and rendered as a flat mesh in the
+ * z = 0 plane. Each grid vertex is colored by its field value through a color
+ * map (see `colormap`), and the GPU interpolates the color across each cell,
+ * so the plane shows a smooth heat gradient. The value domain is taken from the
+ * sampled minimum and maximum unless an explicit `domain` is given.
+ *
+ * @example
+ * ```typescript
+ * // A 2D Gaussian bump
+ * const heat = new HeatMap({
+ *   func: (x, y) => Math.exp(-(x * x + y * y) / 4),
+ *   xRange: [-3, 3],
+ *   yRange: [-3, 3],
+ *   domain: [0, 1],
+ * });
+ * ```
+ */
+export declare class HeatMap extends Mobject3D {
+    private _func;
+    private _xRange;
+    private _yRange;
+    private _nx;
+    private _ny;
+    private _palette;
+    private _useOklab;
+    private _centerPoint;
+    private _domain;
+    private _domainExplicit;
+    constructor(options: HeatMapOptions);
+    /** The x coordinate of grid column `ix`. */
+    private _coordX;
+    /** The y coordinate of grid row `iy`. */
+    private _coordY;
+    /** Scan the grid for the value range when no explicit domain is given. */
+    private _autoDomain;
+    /** Build the indexed plane geometry with a per-vertex color attribute. */
+    private _buildGeometry;
+    protected _createThreeObject(): THREE.Object3D;
+    protected _syncMaterialToThree(): void;
+    /** Rebuild the geometry after the field, domain, or palette changes. */
+    private _updateGeometry;
+    /** The color (hex) that the map assigns to the field at (x, y). */
+    colorAt(x: number, y: number): string;
+    /** The value domain [min, max] mapped across the palette. */
+    getDomain(): [number, number];
+    /** Set the value domain and rebuild. */
+    setDomain(domain: [number, number]): this;
+    /** Get the scalar field. */
+    getFunc(): ScalarField2D;
+    /** Set the scalar field and rebuild. Recomputes an auto domain if in use. */
+    setFunc(func: ScalarField2D): this;
+    copy(): HeatMap;
+}
+//# sourceMappingURL=HeatMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeatMap.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/HeatMap.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;AAIjD,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mFAAmF;IACnF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,OAAQ,SAAQ,SAAS;IACpC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,eAAe,CAAU;gBAErB,OAAO,EAAE,cAAc;IAgCnC,4CAA4C;IAC5C,OAAO,CAAC,OAAO;IAKf,yCAAyC;IACzC,OAAO,CAAC,OAAO;IAKf,0EAA0E;IAC1E,OAAO,CAAC,WAAW;IAoBnB,0EAA0E;IAC1E,OAAO,CAAC,cAAc;IA2CtB,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cAU3B,oBAAoB,IAAI,IAAI;IAY/C,wEAAwE;IACxE,OAAO,CAAC,eAAe;IASvB,mEAAmE;IACnE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAKrC,6DAA6D;IAC7D,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOzC,4BAA4B;IAC5B,OAAO,IAAI,aAAa;IAIxB,6EAA6E;IAC7E,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAOzB,IAAI,IAAI,OAAO;CAezB"}

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

@@ -0,0 +1,34 @@
+/**
+ * Perceptual color maps for scalar-field visualization.
+ *
+ * A color map is an ordered list of hex color stops spread evenly over the
+ * unit interval. {@link sampleColormap} reads a color for any `t` in 0..1 by
+ * blending the two surrounding stops. Blending runs in sRGB by default, or in
+ * perceptually-uniform Oklab (see `utils/oklab`) when `useOklab` is set, which
+ * keeps the midpoint of a palette bright instead of muddy.
+ */
+/** A built-in viridis-like palette: dark blue through green to yellow. */
+export declare const VIRIDIS: readonly string[];
+/** A built-in warm palette: black through red and orange to white. */
+export declare const INFERNO: readonly string[];
+/** A simple blue-white-red diverging palette, centered on white. */
+export declare const COOLWARM: readonly string[];
+/**
+ * Sample a color map at position `t` in 0..1.
+ *
+ * `t` is clamped to 0..1. A palette with one stop returns that stop. Otherwise
+ * `t` is scaled across the stops and the two surrounding stops are blended.
+ *
+ * @param palette Ordered hex color stops. Must hold at least one color.
+ * @param t Position along the palette, clamped to 0..1.
+ * @param useOklab Blend in Oklab space for a perceptually-uniform result.
+ */
+export declare function sampleColormap(palette: readonly string[], t: number, useOklab?: boolean): string;
+/**
+ * Map a scalar `value` in the domain `[min, max]` to a color map color.
+ *
+ * The value is normalized to 0..1 across the domain, then clamped. A zero-width
+ * domain (`min === max`) maps every value to the first stop.
+ */
+export declare function valueToColor(value: number, min: number, max: number, palette: readonly string[], useOklab?: boolean): string;
+//# sourceMappingURL=colormap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colormap.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/colormap.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAOpC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAOpC,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAAsC,CAAC;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAc9F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,UAAQ,GACf,MAAM,CAIR"}

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

@@ -12,6 +12,10 @@ export { type VerticalLinesToGraphOptions, type SecantSlopeGroupOptions } from '
 export { NumberPlane, type NumberPlaneOptions, type BackgroundLineStyle } from './NumberPlane';
 export { FunctionGraph, type FunctionGraphOptions } from './FunctionGraph';
 export { ImplicitFunction, type ImplicitFunctionOptions } from './ImplicitFunction';
+export { sampleColormap, valueToColor, VIRIDIS, INFERNO, COOLWARM } from './colormap';
+export { marchingSquares, type ContourSegment } from './marchingSquares';
+export { HeatMap, type HeatMapOptions, type ScalarField2D } from './HeatMap';
+export { ContourPlot, type ContourPlotOptions, type ContourField } from './ContourPlot';
 export { ParametricFunction, type ParametricFunctionOptions } from './ParametricFunction';
 export { VectorFieldVector, type VectorFieldVectorOptions } from './Vector';
 export { ComplexPlane, type ComplexPlaneOptions, type Complex } from './ComplexPlane';

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":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtF,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGjG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtF,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGjG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxF,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Marching-squares iso-contour extraction for a 2D scalar field.
+ *
+ * The algorithm walks a regular grid of sampled values and emits the line
+ * segments of the iso-contour `value = iso` within each cell. Unlike the
+ * adaptive, zero-level marching squares embedded in {@link ImplicitFunction},
+ * this is a fixed-grid routine that takes an arbitrary iso level, so one grid
+ * can be contoured at many levels. {@link ContourPlot} uses it for that.
+ *
+ * A cell is classified by whether each of its four corners is above `iso`.
+ * The 16 cases map to zero, one, or two segments. Saddle cases (5 and 10) are
+ * resolved with the average of the four corners, the common asymptotic decider.
+ */
+/** A line segment of an iso-contour, in field coordinates. */
+export type ContourSegment = [[number, number], [number, number]];
+/**
+ * Extract the iso-contour segments of a sampled scalar field.
+ *
+ * @param values Grid values indexed `values[iy][ix]`, dimensions
+ *   `(ys.length) x (xs.length)`.
+ * @param xs The x coordinate of each grid column, length `nx + 1`.
+ * @param ys The y coordinate of each grid row, length `ny + 1`.
+ * @param iso The contour level. A corner is "set" when its value is above iso.
+ */
+export declare function marchingSquares(values: number[][], xs: number[], ys: number[], iso?: number): ContourSegment[];
+//# sourceMappingURL=marchingSquares.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marchingSquares.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/marchingSquares.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AA8ElE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,GAAG,SAAI,GACN,cAAc,EAAE,CA6ClB"}

package/dist/mobjects/three-d/ImplicitSurface.d.ts

@@ -0,0 +1,122 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Mobject3D } from './Mobject3D';
+import { ScalarField3D } from './marchingCubes';
+import * as THREE from 'three';
+/**
+ * Options for creating an ImplicitSurface.
+ */
+export interface ImplicitSurfaceOptions {
+    /** The scalar field f(x, y, z). The surface is the level set f = isoLevel. */
+    func: ScalarField3D;
+    /** X range [min, max]. Default: [-2, 2] */
+    xRange?: [number, number];
+    /** Y range [min, max]. Default: [-2, 2] */
+    yRange?: [number, number];
+    /** Z range [min, max]. Default: [-2, 2] */
+    zRange?: [number, number];
+    /** Grid cells per axis for the marching-cubes sampling. Default: 24 */
+    resolution?: number;
+    /** The iso level of the extracted surface. Default: 0 */
+    isoLevel?: number;
+    /** Color as CSS color string. Default: '#58c4dd' (Manim blue) */
+    color?: string;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Render as wireframe. Default: false */
+    wireframe?: boolean;
+    /** Render both sides. Default: true */
+    doubleSided?: boolean;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+}
+/**
+ * ImplicitSurface - the 3D isosurface f(x, y, z) = isoLevel.
+ *
+ * The surface is built with marching cubes (see {@link marchingCubes}) over a
+ * sampled grid, so an arbitrary smooth scalar field can be visualised without a
+ * parametrisation. It extends {@link Mobject3D} and reuses the Surface3D
+ * material and depth conventions, including the transparent depth prepass from
+ * issue #416, so a translucent isosurface occludes itself correctly.
+ *
+ * @example
+ * ```typescript
+ * // A unit sphere: x^2 + y^2 + z^2 = 1
+ * const sphere = new ImplicitSurface({
+ *   func: (x, y, z) => x * x + y * y + z * z,
+ *   isoLevel: 1,
+ *   resolution: 32,
+ * });
+ *
+ * // A torus implicit surface
+ * const torus = new ImplicitSurface({
+ *   func: (x, y, z) => {
+ *     const q = Math.sqrt(x * x + y * y) - 1;
+ *     return q * q + z * z;
+ *   },
+ *   isoLevel: 0.09,
+ *   opacity: 0.6,
+ * });
+ * ```
+ */
+export declare class ImplicitSurface extends Mobject3D {
+    private _func;
+    private _xRange;
+    private _yRange;
+    private _zRange;
+    private _resolution;
+    private _isoLevel;
+    private _wireframe;
+    private _doubleSided;
+    private _centerPoint;
+    private _positions;
+    private _triangleCount;
+    constructor(options: ImplicitSurfaceOptions);
+    /** Run marching cubes and cache the resulting triangle soup. */
+    private _computeSurface;
+    /** Build an indexed-free BufferGeometry with smooth normals from the cache. */
+    private _buildGeometry;
+    /**
+     * The depth prepass only helps a translucent solid. An opaque surface
+     * already writes depth, a wireframe must stay visible, and a faded-out
+     * surface must not depth-block other transparent objects.
+     */
+    private _prepassEnabled;
+    /** Enable or disable the prepass; disabled means skipped by the renderer. */
+    private _applyPrepassState;
+    /** Find the depth-prepass child mesh, if this surface has one. */
+    private _getPrepassMesh;
+    /**
+     * Create the Three.js mesh. A transparent surface renders in two passes to
+     * fix self-occlusion (issue #416): a depth-only prepass writes the front-most
+     * layer, then the color pass depth-tests against it. The prepass mesh is
+     * created before the color mesh so its lower object.id wins three.js'
+     * reversePainterSortStable tiebreak and draws first.
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /** Sync material properties to the Three.js object. */
+    protected _syncMaterialToThree(): void;
+    /** Recompute the surface and rebind the geometry on both meshes. */
+    private _updateGeometry;
+    /** The flat vertex positions of the surface triangles. */
+    getPositions(): Float32Array;
+    /** The number of triangles in the surface. */
+    getTriangleCount(): number;
+    /** Get the scalar field. */
+    getFunc(): ScalarField3D;
+    /** Set a new scalar field and rebuild the surface. */
+    setFunc(func: ScalarField3D): this;
+    /** Get the iso level. */
+    getIsoLevel(): number;
+    /** Set the iso level and rebuild the surface. */
+    setIsoLevel(isoLevel: number): this;
+    /** Get the grid resolution. */
+    getResolution(): number;
+    /** Set the grid resolution and rebuild the surface. */
+    setResolution(resolution: number): this;
+    /** Whether wireframe mode is enabled. */
+    isWireframe(): boolean;
+    /** Set wireframe mode. */
+    setWireframe(value: boolean): this;
+    copy(): ImplicitSurface;
+}
+//# sourceMappingURL=ImplicitSurface.d.ts.map

package/dist/mobjects/three-d/ImplicitSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImplicitSurface.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/ImplicitSurface.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,aAAa,CAAC;AACxC,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,EAAE,sBAAsB;IAqC3C,gEAAgE;IAChE,OAAO,CAAC,eAAe;IAavB,+EAA+E;IAC/E,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB,6EAA6E;IAC7E,OAAO,CAAC,kBAAkB;IAM1B,kEAAkE;IAClE,OAAO,CAAC,eAAe;IAUvB;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;IA4B9C,uDAAuD;cACpC,oBAAoB,IAAI,IAAI;IAoB/C,oEAAoE;IACpE,OAAO,CAAC,eAAe;IAavB,0DAA0D;IAC1D,YAAY,IAAI,YAAY;IAI5B,8CAA8C;IAC9C,gBAAgB,IAAI,MAAM;IAI1B,4BAA4B;IAC5B,OAAO,IAAI,aAAa;IAIxB,sDAAsD;IACtD,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAMlC,yBAAyB;IACzB,WAAW,IAAI,MAAM;IAIrB,iDAAiD;IACjD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMnC,+BAA+B;IAC/B,aAAa,IAAI,MAAM;IAIvB,uDAAuD;IACvD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMvC,yCAAyC;IACzC,WAAW,IAAI,OAAO;IAItB,0BAA0B;IAC1B,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAMzB,IAAI,IAAI,eAAe;CAiBjC"}

package/dist/mobjects/three-d/index.d.ts

@@ -18,4 +18,6 @@ export { TexturedSurface, texturedSphere, type TexturedSurfaceOptions, type Text
 export { ThreeDAxes, type ThreeDAxesOptions } from './ThreeDAxes';
 export { Prism, Dot3D, ThreeDVMobject, type PrismOptions, type Dot3DOptions, type ThreeDVMobjectOptions, } from './ThreeDExtensions';
 export { ConvexHull3D, type ConvexHull3DOptions } from './ConvexHull3D';
+export { marchingCubes, type MarchingCubesOptions, type MarchingCubesResult, type ScalarField3D, } from './marchingCubes';
+export { ImplicitSurface, type ImplicitSurfaceOptions } from './ImplicitSurface';
 //# sourceMappingURL=index.d.ts.map

package/dist/mobjects/three-d/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,KAAK,EACL,KAAK,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,KAAK,EACL,KAAK,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mobjects/three-d/marchingCubes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Marching-cubes isosurface extraction for a 3D scalar field.
+ *
+ * The algorithm samples a scalar field `f(x, y, z)` on a regular grid and
+ * extracts the triangle mesh of the level set `f = iso`. This module uses the
+ * marching-tetrahedra variant: it splits every grid cube into six tetrahedra
+ * that share the cube's main diagonal, then polygonises each tetrahedron. The
+ * tetrahedral form needs no 256-entry lookup table, so it is compact and
+ * watertight, at the cost of more triangles than classic marching cubes.
+ *
+ * The output is a non-indexed triangle soup as a flat `Float32Array`. Three.js
+ * recomputes smooth normals from it, and manim-web renders the surface
+ * double-sided, so triangle winding does not affect the shaded result.
+ */
+/** A scalar field sampled at a point in space. */
+export type ScalarField3D = (x: number, y: number, z: number) => number;
+/** Options that control how the grid is sampled. */
+export interface MarchingCubesOptions {
+    /** The scalar field to polygonise. */
+    field: ScalarField3D;
+    /** X range as [min, max]. */
+    xRange: [number, number];
+    /** Y range as [min, max]. */
+    yRange: [number, number];
+    /** Z range as [min, max]. */
+    zRange: [number, number];
+    /** Grid cells per axis. A higher value gives a finer surface. */
+    resolution: number;
+    /** The iso level of the extracted surface. */
+    isoLevel: number;
+}
+/** The polygonised surface as a non-indexed triangle soup. */
+export interface MarchingCubesResult {
+    /** Flat vertex positions: `[x0, y0, z0, x1, y1, z1, ...]`. */
+    positions: Float32Array;
+    /** The number of triangles. */
+    triangleCount: number;
+}
+/**
+ * Extract the isosurface `field = isoLevel` over the sampled grid.
+ *
+ * The grid holds `resolution` cells per axis, so it samples
+ * `(resolution + 1)^3` points. Field values are evaluated once per grid point
+ * and cached, so the output is deterministic for a given input.
+ */
+export declare function marchingCubes(options: MarchingCubesOptions): MarchingCubesResult;
+//# sourceMappingURL=marchingCubes.d.ts.map

package/dist/mobjects/three-d/marchingCubes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marchingCubes.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/marchingCubes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAExE,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,KAAK,EAAE,aAAa,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,SAAS,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AA8FD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA8DhF"}