manim-web 0.2.0

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

@@ -0,0 +1,123 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+import { Axes } from './Axes';
+/**
+ * Options for creating a FunctionGraph
+ */
+export interface FunctionGraphOptions {
+    /** The function to graph: y = func(x) */
+    func: (x: number) => number;
+    /** X range for the graph as [min, max]. Default: from axes or [-5, 5] */
+    xRange?: [number, number];
+    /** Stroke color. Default: '#58c4dd' (Manim blue) */
+    color?: string;
+    /** Stroke width in pixels. Default: 2 */
+    strokeWidth?: number;
+    /** X values where the function is discontinuous. Default: [] */
+    discontinuities?: number[];
+    /** Number of samples to take. Default: 100 */
+    numSamples?: number;
+    /** Reference axes for coordinate transformation. Optional */
+    axes?: Axes;
+}
+/**
+ * FunctionGraph - A graph of a mathematical function y = f(x)
+ *
+ * Samples a function over a range and creates a smooth curve using Bezier curves.
+ * Can handle discontinuities by breaking the path at specified x values.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple parabola
+ * const parabola = new FunctionGraph({
+ *   func: x => x * x
+ * });
+ *
+ * // Create a sine wave with custom range
+ * const sine = new FunctionGraph({
+ *   func: x => Math.sin(x),
+ *   xRange: [-Math.PI * 2, Math.PI * 2],
+ *   numSamples: 200,
+ *   color: '#ff0000'
+ * });
+ *
+ * // Graph with discontinuity (e.g., 1/x)
+ * const reciprocal = new FunctionGraph({
+ *   func: x => 1 / x,
+ *   xRange: [-5, 5],
+ *   discontinuities: [0]
+ * });
+ * ```
+ */
+export declare class FunctionGraph extends VMobject {
+    private _func;
+    private _xRange;
+    private _discontinuities;
+    private _numSamples;
+    private _axes;
+    constructor(options: FunctionGraphOptions);
+    /**
+     * Generate the curve points by sampling the function
+     */
+    private _generatePoints;
+    /**
+     * Sample the function over a range
+     */
+    private _sampleRange;
+    /**
+     * Convert sampled points to smooth Bezier curve points
+     */
+    private _pointsToBezier;
+    /**
+     * Get a point on the graph at a given x value
+     * @param x - The x coordinate
+     * @returns The 3D point on the graph, or null if x is outside range or at discontinuity
+     */
+    getPointFromX(x: number): Vector3Tuple | null;
+    /**
+     * Get the function being graphed
+     */
+    getFunction(): (x: number) => number;
+    /**
+     * Set a new function to graph
+     */
+    setFunction(func: (x: number) => number): this;
+    /**
+     * Get the x range
+     */
+    getXRange(): [number, number];
+    /** Minimum x value (alias for Python Manim's graph.t_min). */
+    get tMin(): number;
+    /** Maximum x value (alias for Python Manim's graph.t_max). */
+    get tMax(): number;
+    /**
+     * Set the x range
+     */
+    setXRange(xRange: [number, number]): this;
+    /**
+     * Get the discontinuities
+     */
+    getDiscontinuities(): number[];
+    /**
+     * Set the discontinuities
+     */
+    setDiscontinuities(discontinuities: number[]): this;
+    /**
+     * Get the number of samples
+     */
+    getNumSamples(): number;
+    /**
+     * Set the number of samples
+     */
+    setNumSamples(numSamples: number): this;
+    /**
+     * Set the reference axes
+     */
+    setAxes(axes: Axes | null): this;
+    /**
+     * Create a copy of this FunctionGraph
+     */
+    protected _createCopy(): FunctionGraph;
+}
+export default FunctionGraph;
+//# sourceMappingURL=FunctionGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionGraph.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/FunctionGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAc;gBAEf,OAAO,EAAE,oBAAoB;IAoCzC;;OAEG;IACH,OAAO,CAAC,eAAe;IA2CvB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6DvB;;;;OAIG;IACH,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAyB7C;;OAEG;IACH,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM;IAIpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI;IAM9C;;OAEG;IACH,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B,8DAA8D;IAC9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8DAA8D;IAC9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAMnD;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAMhC;;OAEG;cACgB,WAAW,IAAI,aAAa;CAWhD;AAED,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,131 @@
+import { VMobject } from '../../core/VMobject';
+import { Axes } from './Axes';
+/**
+ * Options for creating an ImplicitFunction
+ */
+export interface ImplicitFunctionOptions {
+    /** The implicit function f(x, y) whose zero-level set is plotted */
+    func: (x: number, y: number) => number;
+    /** X range for the plot as [min, max]. Default: [-5, 5] */
+    xRange?: [number, number];
+    /** Y range for the plot as [min, max]. Default: [-5, 5] */
+    yRange?: [number, number];
+    /** Minimum grid depth (grid = 2^minDepth cells per axis). Default: 5 */
+    minDepth?: number;
+    /** Maximum grid depth for adaptive refinement (grid = 2^maxDepth at finest). Default: 9 */
+    maxDepth?: 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;
+}
+/**
+ * ImplicitFunction - Plots the zero-level set of f(x, y) = 0
+ *
+ * Uses the Marching Squares algorithm with adaptive refinement to find
+ * and render implicit curves. Cells containing sign changes are
+ * recursively subdivided from minDepth up to maxDepth for higher
+ * fidelity near the contour without paying the cost of a globally fine grid.
+ *
+ * Can handle multiple disjoint curves, closed loops, and saddle points.
+ *
+ * @example
+ * ```typescript
+ * // Plot a circle: x^2 + y^2 - 1 = 0
+ * const circle = new ImplicitFunction({
+ *   func: (x, y) => x * x + y * y - 1,
+ * });
+ *
+ * // Plot a hyperbola: x^2 - y^2 - 1 = 0
+ * const hyperbola = new ImplicitFunction({
+ *   func: (x, y) => x * x - y * y - 1,
+ *   xRange: [-3, 3],
+ *   yRange: [-3, 3],
+ * });
+ *
+ * // Plot with axes and adaptive refinement
+ * const axes = new Axes();
+ * const curve = new ImplicitFunction({
+ *   func: (x, y) => Math.sin(x) - y,
+ *   axes,
+ *   minDepth: 4,
+ *   maxDepth: 8,
+ * });
+ * ```
+ */
+export declare class ImplicitFunction extends VMobject {
+    private _func;
+    private _xRange;
+    private _yRange;
+    private _minDepth;
+    private _maxDepth;
+    private _axes;
+    constructor(options: ImplicitFunctionOptions);
+    /**
+     * Generate the curve points using adaptive Marching Squares
+     */
+    private _generatePoints;
+    /**
+     * Run the adaptive Marching Squares algorithm to extract line segments
+     * along the zero-level set. Starts at minDepth resolution and recursively
+     * subdivides cells with sign changes up to maxDepth.
+     */
+    private _marchingSquares;
+    /**
+     * Recursively process a single cell. If the cell has a sign change and
+     * the current depth is below maxDepth, subdivide it into 4 sub-cells.
+     * Otherwise, emit marching-squares segments for this cell.
+     */
+    private _processCell;
+    /**
+     * Linear interpolation along a grid edge to find the zero-crossing point.
+     * Interpolates between (x0, y0) with value v0 and (x1, y1) with value v1.
+     */
+    private _interpolateEdge;
+    /**
+     * Chain individual line segments into continuous polylines by matching
+     * endpoints within an epsilon tolerance.
+     */
+    private _chainSegments;
+    /**
+     * Convert sampled points to smooth Bezier curve points using
+     * Catmull-Rom to Bezier conversion with tension 0.5.
+     */
+    private _pointsToBezier;
+    /**
+     * Get the implicit function
+     */
+    getFunction(): (x: number, y: number) => number;
+    /**
+     * Set a new implicit function to plot
+     */
+    setFunction(func: (x: number, y: number) => number): this;
+    /**
+     * Get the x range
+     */
+    getXRange(): [number, number];
+    /**
+     * Set the x range
+     */
+    setXRange(xRange: [number, number]): this;
+    /**
+     * Get the y range
+     */
+    getYRange(): [number, number];
+    /**
+     * Set the y range
+     */
+    setYRange(yRange: [number, number]): this;
+    /**
+     * Set the reference axes
+     */
+    setAxes(axes: Axes | null): this;
+    /**
+     * Create a copy of this ImplicitFunction
+     */
+    protected _createCopy(): ImplicitFunction;
+}
+export default ImplicitFunction;
+//# sourceMappingURL=ImplicitFunction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImplicitFunction.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ImplicitFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAc;gBAEf,OAAO,EAAE,uBAAuB;IA4B5C;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA8HpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkGtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA6DvB;;OAEG;IACH,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM;IAI/C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI;IAMzD;;OAEG;IACH,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC;;OAEG;IACH,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAMhC;;OAEG;cACgB,WAAW,IAAI,gBAAgB;CAYnD;AAED,eAAe,gBAAgB,CAAC"}

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

@@ -0,0 +1,195 @@
+import { VMobject } from '../../core/VMobject';
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+/**
+ * Options for creating a NumberLine
+ */
+export interface NumberLineOptions {
+    /** Range as [min, max, step]. Default: [-5, 5, 1] */
+    xRange?: [number, number, number];
+    /** Visual length of the number line. Default: 10 */
+    length?: number;
+    /** Stroke color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Stroke width in pixels. Default: 2 */
+    strokeWidth?: number;
+    /** Whether to include tick marks. Default: true */
+    includeTicks?: boolean;
+    /** Size of tick marks. Default: 0.2 */
+    tickSize?: number;
+    /** Whether to include number labels. Default: false */
+    includeNumbers?: boolean;
+    /** Numbers to exclude from labels. Default: [] */
+    numbersToExclude?: number[];
+    /** Specific numbers to show as labels (overrides includeNumbers). */
+    numbersToInclude?: number[];
+    /** Numbers that get elongated (taller) tick marks. */
+    numbersWithElongatedTicks?: number[];
+    /** Decimal places for number labels. Default: 0 */
+    decimalPlaces?: number;
+    /** Font size for number labels. Default: 24 */
+    numberFontSize?: number;
+}
+/**
+ * NumberLine - A line with tick marks for representing a range of numbers
+ *
+ * Creates a horizontal line with tick marks at regular intervals.
+ * Can optionally display number labels at each tick.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple number line from -5 to 5
+ * const numberLine = new NumberLine();
+ *
+ * // Create a number line with custom range and labels
+ * const labeledLine = new NumberLine({
+ *   xRange: [0, 10, 2],
+ *   length: 8,
+ *   includeNumbers: true
+ * });
+ * ```
+ */
+export declare class NumberLine extends VMobject {
+    private _xRange;
+    private _length;
+    private _includeTicks;
+    private _tickSize;
+    private _includeNumbers;
+    private _numbersToExclude;
+    private _numbersToInclude;
+    private _numbersWithElongatedTicks;
+    private _decimalPlaces;
+    private _numberFontSize;
+    private _tickMarks;
+    private _numberLabels;
+    constructor(options?: NumberLineOptions);
+    /**
+     * Generate the number line points including main line and ticks
+     */
+    private _generatePoints;
+    /**
+     * Convert a number value to its x position on the line
+     */
+    private _numberToX;
+    /**
+     * Convert a number value to its point on the number line
+     * @param n - The number value to convert
+     * @returns The 3D point [x, y, z] on the number line
+     */
+    numberToPoint(n: number): Vector3Tuple;
+    /**
+     * Convert a point on the number line to its number value
+     * @param point - The 3D point to convert
+     * @returns The number value at that point
+     */
+    pointToNumber(point: Vector3Tuple): number;
+    /**
+     * Get all tick mark VMobjects
+     * @returns Array of VMobjects representing tick marks
+     */
+    getTickMarks(): VMobject[];
+    /**
+     * Get the x range
+     */
+    getXRange(): [number, number, number];
+    /**
+     * Set the x range
+     */
+    setXRange(xRange: [number, number, number]): this;
+    /**
+     * Get the visual length
+     */
+    getLength(): number;
+    /**
+     * Set the visual length
+     */
+    setLength(length: number): this;
+    /**
+     * Get the tick size
+     */
+    getTickSize(): number;
+    /**
+     * Set the tick size
+     */
+    setTickSize(size: number): this;
+    /**
+     * Get whether ticks are included
+     */
+    hasTicks(): boolean;
+    /**
+     * Set whether ticks are included
+     */
+    setIncludeTicks(include: boolean): this;
+    /**
+     * Get the minimum value of the range
+     */
+    getMin(): number;
+    /**
+     * Get the maximum value of the range
+     */
+    getMax(): number;
+    /**
+     * Get the step value of the range
+     */
+    getStep(): number;
+    /**
+     * Get default numbers to show (at each step)
+     */
+    private _getDefaultNumbers;
+    /**
+     * Get number label mobjects
+     */
+    getNumberLabels(): Mobject[];
+    /**
+     * Create a copy of this NumberLine
+     */
+    protected _createCopy(): NumberLine;
+}
+/**
+ * Options for creating a UnitInterval
+ */
+export interface UnitIntervalOptions {
+    /** Visual length of the unit interval. Default: 5 */
+    length?: number;
+    /** Stroke color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Stroke width in pixels. Default: 2 */
+    strokeWidth?: number;
+    /** Whether to include tick marks. Default: true */
+    includeTicks?: boolean;
+    /** Size of tick marks. Default: 0.2 */
+    tickSize?: number;
+    /** Whether to include number labels. Default: false */
+    includeNumbers?: boolean;
+    /** Number of subdivisions. Default: 10 (ticks at 0, 0.1, 0.2, ..., 1) */
+    numDecimalPlaces?: number;
+    /** Numbers to exclude from labels. Default: [] */
+    numbersToExclude?: number[];
+}
+/**
+ * UnitInterval - A NumberLine from 0 to 1
+ *
+ * A convenience class that creates a NumberLine representing the unit interval [0, 1].
+ * Commonly used for probability, percentage, or normalized value visualizations.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple unit interval
+ * const unitInterval = new UnitInterval();
+ *
+ * // Create a unit interval with labels
+ * const labeledInterval = new UnitInterval({
+ *   length: 8,
+ *   includeNumbers: true,
+ *   numDecimalPlaces: 2  // ticks at 0, 0.25, 0.5, 0.75, 1
+ * });
+ * ```
+ */
+export declare class UnitInterval extends NumberLine {
+    constructor(options?: UnitIntervalOptions);
+    /**
+     * Create a copy of this UnitInterval
+     */
+    protected _createCopy(): UnitInterval;
+}
+export default NumberLine;
+//# sourceMappingURL=NumberLine.d.ts.map

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

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

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

@@ -0,0 +1,91 @@
+import { Group } from '../../core/Group';
+import { Axes, AxesOptions } from './Axes';
+/**
+ * Style configuration for background grid lines
+ */
+export interface BackgroundLineStyle {
+    /** Stroke color for grid lines. Default: '#29ABCA' (BLUE_D) */
+    color?: string;
+    /** Stroke width for grid lines. Default: 2 */
+    strokeWidth?: number;
+    /** Opacity for grid lines. Default: 1 */
+    opacity?: number;
+}
+/**
+ * Options for creating a NumberPlane
+ */
+export interface NumberPlaneOptions extends AxesOptions {
+    /** Whether to include background grid lines. Default: true */
+    includeBackgroundLines?: boolean;
+    /** Style configuration for background grid lines */
+    backgroundLineStyle?: BackgroundLineStyle;
+    /** Style configuration for faded sub-grid lines. Auto-computed from backgroundLineStyle if not set. */
+    fadedLineStyle?: BackgroundLineStyle;
+    /** Number of faded lines per interval between main lines. Default: 1 */
+    fadedLineRatio?: number;
+    /** Fading factor for lines far from axes. Default: 1 (no fading) */
+    fadingFactor?: number;
+}
+/**
+ * NumberPlane - A coordinate system with a background grid
+ *
+ * Extends Axes to add a grid of background lines for better visualization
+ * of the coordinate space.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple number plane
+ * const plane = new NumberPlane();
+ *
+ * // Create a number plane with custom grid styling
+ * const styledPlane = new NumberPlane({
+ *   xRange: [-5, 5, 1],
+ *   yRange: [-3, 3, 1],
+ *   backgroundLineStyle: {
+ *     color: '#334455',
+ *     strokeWidth: 0.5,
+ *     opacity: 0.3
+ *   }
+ * });
+ * ```
+ */
+export declare class NumberPlane extends Axes {
+    private _includeBackgroundLines;
+    private _backgroundLineStyle;
+    private _fadedLineStyle;
+    private _fadedLineRatio;
+    private _fadingFactor;
+    private _backgroundLines;
+    constructor(options?: NumberPlaneOptions);
+    /**
+     * Generate the background grid lines
+     */
+    private _generateBackgroundLines;
+    /**
+     * Calculate the opacity of a line based on its distance from the origin
+     */
+    private _calculateLineOpacity;
+    /**
+     * Get the background lines Group
+     * @returns Group containing all background grid lines
+     */
+    getBackgroundLines(): Group;
+    /**
+     * Set whether to show background lines
+     */
+    setIncludeBackgroundLines(include: boolean): this;
+    /**
+     * Set the background line style
+     */
+    setBackgroundLineStyle(style: Partial<BackgroundLineStyle>): this;
+    /**
+     * Get the background line style
+     */
+    getBackgroundLineStyle(): BackgroundLineStyle;
+    /**
+     * Create a copy of this NumberPlane
+     */
+    protected _createCopy(): NumberPlane;
+}
+export default NumberPlane;
+//# sourceMappingURL=NumberPlane.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NumberPlane.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/NumberPlane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,8DAA8D;IAC9D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,uGAAuG;IACvG,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,IAAI;IACnC,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAQ;gBAEpB,OAAO,GAAE,kBAAuB;IAqD5C;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgHhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;OAGG;IACH,kBAAkB,IAAI,KAAK;IAI3B;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAuBjD;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IASjE;;OAEG;IACH,sBAAsB,IAAI,mBAAmB;IAI7C;;OAEG;cACgB,WAAW,IAAI,WAAW;CAe9C;AAED,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,111 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+import { Axes } from './Axes';
+/**
+ * Options for creating a ParametricFunction
+ */
+export interface ParametricFunctionOptions {
+    /** The parametric function: returns [x, y] or [x, y, z] for a given t */
+    func: (t: number) => [number, number] | [number, number, number];
+    /** Parameter range as [min, max]. Default: [0, 1] */
+    tRange?: [number, number];
+    /** Stroke color. Default: '#58c4dd' (Manim blue) */
+    color?: string;
+    /** Stroke width in pixels. Default: 2 */
+    strokeWidth?: number;
+    /** Number of samples to take. Default: 100 */
+    numSamples?: number;
+    /** Reference axes for coordinate transformation. Optional */
+    axes?: Axes;
+    /** Whether to use axes coordinate transformation. Default: true if axes provided */
+    useAxesCoords?: boolean;
+}
+/**
+ * ParametricFunction - A curve defined by parametric equations
+ *
+ * Samples a parametric function over a parameter range and creates a smooth curve.
+ * The function takes a parameter t and returns the position [x, y] or [x, y, z].
+ *
+ * @example
+ * ```typescript
+ * // Create a circle using parametric equations
+ * const circle = new ParametricFunction({
+ *   func: t => [Math.cos(t), Math.sin(t)],
+ *   tRange: [0, 2 * Math.PI]
+ * });
+ *
+ * // Create a Lissajous curve
+ * const lissajous = new ParametricFunction({
+ *   func: t => [Math.sin(3 * t), Math.sin(2 * t)],
+ *   tRange: [0, 2 * Math.PI],
+ *   numSamples: 200
+ * });
+ *
+ * // Create a spiral
+ * const spiral = new ParametricFunction({
+ *   func: t => [t * Math.cos(t * 6), t * Math.sin(t * 6)],
+ *   tRange: [0, 2],
+ *   color: '#ff00ff'
+ * });
+ * ```
+ */
+export declare class ParametricFunction extends VMobject {
+    private _func;
+    private _tRange;
+    private _numSamples;
+    private _axes;
+    private _useAxesCoords;
+    constructor(options: ParametricFunctionOptions);
+    /**
+     * Generate the curve points by sampling the parametric function
+     */
+    private _generatePoints;
+    /**
+     * Convert sampled points to smooth Bezier curve points
+     */
+    private _pointsToBezier;
+    /**
+     * Get a point on the curve at a given parameter value
+     * @param t - The parameter value
+     * @returns The 3D point on the curve
+     */
+    getPointFromT(t: number): Vector3Tuple;
+    /**
+     * Get the parametric function
+     */
+    getFunction(): (t: number) => [number, number] | [number, number, number];
+    /**
+     * Set a new parametric function
+     */
+    setFunction(func: (t: number) => [number, number] | [number, number, number]): this;
+    /**
+     * Get the parameter range
+     */
+    getTRange(): [number, number];
+    /**
+     * Set the parameter range
+     */
+    setTRange(tRange: [number, number]): this;
+    /**
+     * Get the number of samples
+     */
+    getNumSamples(): number;
+    /**
+     * Set the number of samples
+     */
+    setNumSamples(numSamples: number): this;
+    /**
+     * Set the reference axes
+     */
+    setAxes(axes: Axes | null): this;
+    /**
+     * Set whether to use axes coordinate transformation
+     */
+    setUseAxesCoords(use: boolean): this;
+    /**
+     * Create a copy of this ParametricFunction
+     */
+    protected _createCopy(): ParametricFunction;
+}
+export default ParametricFunction;
+//# sourceMappingURL=ParametricFunction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParametricFunction.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ParametricFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjE,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,OAAO,CAAC,KAAK,CAA6D;IAC1E,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,cAAc,CAAU;gBAEpB,OAAO,EAAE,yBAAyB;IA0B9C;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4DvB;;;;OAIG;IACH,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAiBtC;;OAEG;IACH,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAIzE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMnF;;OAEG;IACH,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAMhC;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAMpC;;OAEG;cACgB,WAAW,IAAI,kBAAkB;CAWrD;AAED,eAAe,kBAAkB,CAAC"}