manim-web 0.2.0

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

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

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

@@ -0,0 +1,241 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Rectangle } from '../geometry/Rectangle';
+import { NumberLine } from './NumberLine';
+/**
+ * Options for creating a BarChart
+ */
+export interface BarChartOptions {
+    /** Array of values for the bars. For grouped bars, use 2D array [[series1], [series2], ...] */
+    values: number[] | number[][];
+    /** Width of each bar. Default: 0.6 */
+    barWidth?: number;
+    /** Gap between bars within a group (for grouped bars). Default: 0.05 */
+    barGap?: number;
+    /** Gap between bar groups. Default: 0.25 */
+    groupGap?: number;
+    /** Bar colors. Single color applies to all, array cycles through bars/series. Default: Manim color palette */
+    barColors?: string | string[];
+    /** Fill opacity for bars. Default: 0.8 */
+    barFillOpacity?: number;
+    /** Stroke width for bar outlines. Default: 2 */
+    barStrokeWidth?: number;
+    /** X-axis labels for each bar/group. Default: [] */
+    xLabels?: string[];
+    /** Font size for x-axis labels. Default: 24 */
+    xLabelFontSize?: number;
+    /** Y-axis range as [min, max, step]. Default: auto-calculated from values */
+    yRange?: [number, number, number];
+    /** Visual height of the chart area. Default: 5 */
+    height?: number;
+    /** Visual width of the chart area. Default: 8 */
+    width?: number;
+    /** Color for axes. Default: '#ffffff' */
+    axisColor?: string;
+    /** Whether to include y-axis tick marks. Default: true */
+    includeYTicks?: boolean;
+    /** Whether to include y-axis number labels. Default: true */
+    includeYLabels?: boolean;
+    /** Font size for y-axis labels. Default: 20 */
+    yLabelFontSize?: number;
+    /** Series names for legend (grouped bars). Default: [] */
+    seriesNames?: string[];
+    /** Whether to show a legend. Default: false */
+    showLegend?: boolean;
+}
+/**
+ * BarChart - A bar chart visualization mobject
+ *
+ * Creates a bar chart with customizable bars, axes, and labels.
+ * Supports both simple bar charts and grouped bar charts for comparing multiple series.
+ *
+ * @example
+ * ```typescript
+ * // Simple bar chart
+ * const chart = new BarChart({
+ *   values: [3, 7, 2, 5],
+ *   xLabels: ['A', 'B', 'C', 'D']
+ * });
+ *
+ * // Grouped bar chart comparing two series
+ * const grouped = new BarChart({
+ *   values: [[3, 7, 2], [5, 4, 6]],
+ *   xLabels: ['Q1', 'Q2', 'Q3'],
+ *   seriesNames: ['2023', '2024'],
+ *   showLegend: true
+ * });
+ *
+ * // Animate value changes
+ * chart.changeBarValues([5, 3, 8, 2]);
+ * ```
+ */
+export declare class BarChart extends Group {
+    /** The rectangular bars */
+    bars: VGroup;
+    /** The y-axis (left side) */
+    yAxis: NumberLine;
+    /** X-axis line */
+    xAxisLine: VMobject;
+    /** X-axis labels */
+    xLabels: VGroup;
+    /** Y-axis labels */
+    yLabels: VGroup;
+    /** Legend (if enabled) */
+    legend: VGroup | null;
+    protected _values: number[][];
+    protected _barWidth: number;
+    protected _barGap: number;
+    protected _groupGap: number;
+    protected _barColors: string[];
+    protected _barFillOpacity: number;
+    protected _barStrokeWidth: number;
+    protected _xLabelTexts: string[];
+    protected _yRange: [number, number, number];
+    protected _height: number;
+    protected _width: number;
+    protected _axisColor: string;
+    protected _includeYTicks: boolean;
+    protected _includeYLabels: boolean;
+    protected _xLabelFontSize: number;
+    protected _yLabelFontSize: number;
+    protected _seriesNames: string[];
+    protected _showLegend: boolean;
+    constructor(options: BarChartOptions);
+    /**
+     * Normalize values to 2D array (series x groups)
+     */
+    private _normalizeValues;
+    /**
+     * Get the number of series
+     */
+    private get _numSeries();
+    /**
+     * Get the number of groups/categories
+     */
+    private get _numGroups();
+    /**
+     * Calculate y-range from values
+     */
+    private _calculateYRange;
+    /**
+     * Create the y-axis
+     */
+    private _createYAxis;
+    /**
+     * Create the x-axis line
+     */
+    private _createXAxisLine;
+    /**
+     * Convert a data value to y-coordinate
+     */
+    private _valueToY;
+    /**
+     * Get the x-coordinate for a group center
+     */
+    private _groupCenterX;
+    /**
+     * Get the x-coordinate for a specific bar
+     */
+    private _barCenterX;
+    /**
+     * Get color for a series/bar
+     */
+    private _getBarColor;
+    /**
+     * Create all bars
+     */
+    private _createBars;
+    /**
+     * Create x-axis labels
+     */
+    private _createXLabels;
+    /**
+     * Create y-axis labels
+     */
+    private _createYLabels;
+    /**
+     * Create legend for grouped bar charts
+     */
+    private _createLegend;
+    /**
+     * Get the current values
+     */
+    getValues(): number[][];
+    /**
+     * Get a flat array of values (for single series charts)
+     */
+    getValuesFlat(): number[];
+    /**
+     * Change bar values with animation support
+     *
+     * This method updates the bar heights to reflect new values.
+     * For animations, use this with a Transform animation.
+     *
+     * @param newValues - New values for the bars
+     * @returns The bars VGroup with updated heights (useful for animations)
+     *
+     * @example
+     * ```typescript
+     * // Direct update
+     * chart.changeBarValues([5, 3, 8, 2]);
+     *
+     * // With animation (using scene.play)
+     * const newChart = chart.copy();
+     * newChart.changeBarValues([5, 3, 8, 2]);
+     * scene.play(new Transform(chart, newChart));
+     * ```
+     */
+    changeBarValues(newValues: number[] | number[][]): VGroup;
+    /**
+     * Get a specific bar by group and series index
+     * @param groupIndex - The group/category index
+     * @param seriesIndex - The series index (default 0 for single series)
+     * @returns The Rectangle bar, or undefined if not found
+     */
+    getBar(groupIndex: number, seriesIndex?: number): Rectangle | undefined;
+    /**
+     * Get all bars for a specific series
+     * @param seriesIndex - The series index
+     * @returns VGroup containing the bars for that series
+     */
+    getSeriesBars(seriesIndex: number): VGroup;
+    /**
+     * Get the height of the chart area
+     */
+    getHeight(): number;
+    /**
+     * Get the width of the chart area
+     */
+    getWidth(): number;
+    /**
+     * Get the y-axis range
+     */
+    getYRange(): [number, number, number];
+    /**
+     * Get the number of bar groups
+     */
+    getNumGroups(): number;
+    /**
+     * Get the number of series
+     */
+    getNumSeries(): number;
+    /**
+     * Set bar colors
+     * @param colors - New colors (single color or array)
+     * @returns this for chaining
+     */
+    setBarColors(colors: string | string[]): this;
+    /**
+     * Set bar fill opacity
+     * @param opacity - Fill opacity (0-1)
+     * @returns this for chaining
+     */
+    setBarFillOpacity(opacity: number): this;
+    /**
+     * Create a copy of this BarChart
+     */
+    protected _createCopy(): BarChart;
+}
+export default BarChart;
+//# sourceMappingURL=BarChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/BarChart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAM7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+FAA+F;IAC/F,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8GAA8G;IAC9G,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB;IAClB,SAAS,EAAE,QAAQ,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC;gBAEnB,OAAO,EAAE,eAAe;IAwEpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,KAAK,UAAU,GAErB;IAED;;OAEG;IACH,OAAO,KAAK,UAAU,GAErB;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2BnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAOzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM;IAwDzD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,GAAE,MAAU,GAAG,SAAS,GAAG,SAAS;IAK1E;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAW1C;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAIrC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAmB7C;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;cACgB,WAAW,IAAI,QAAQ;CAsB3C;AAED,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,311 @@
+import { Group } from '../../core/Group';
+import { Vector3Tuple } from '../../core/Mobject';
+import { NumberPlane, NumberPlaneOptions } from './NumberPlane';
+/**
+ * Complex number representation
+ */
+export interface Complex {
+    /** Real part */
+    re: number;
+    /** Imaginary part */
+    im: number;
+}
+/**
+ * Options for creating a ComplexPlane
+ */
+export interface ComplexPlaneOptions extends NumberPlaneOptions {
+    /** Whether to show imaginary unit labels (i, 2i, etc.). Default: true */
+    includeImaginaryLabels?: boolean;
+    /** Font size for labels. Default: 24 */
+    labelFontSize?: number;
+    /** Color for axis labels. Default: '#ffffff' */
+    labelColor?: string;
+}
+/**
+ * ComplexPlane - A coordinate system for complex numbers
+ *
+ * Displays the complex plane with the real axis (horizontal) and
+ * imaginary axis (vertical). Provides methods to convert between
+ * complex numbers and visual points.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple complex plane
+ * const plane = new ComplexPlane();
+ *
+ * // Plot a complex number
+ * const z = { re: 2, im: 3 };
+ * const point = plane.n2p(z);
+ *
+ * // Convert a point back to a complex number
+ * const z2 = plane.p2n([1, -1, 0]);
+ * ```
+ */
+export declare class ComplexPlane extends NumberPlane {
+    private _includeImaginaryLabels;
+    private _labelFontSize;
+    private _labelColor;
+    private _imaginaryLabels;
+    private _coordinateLabels;
+    constructor(options?: ComplexPlaneOptions);
+    /**
+     * Generate labels for the imaginary axis (i, 2i, -i, etc.)
+     */
+    private _generateImaginaryLabels;
+    /**
+     * Format a number as an imaginary label (i, 2i, -i, -2i, etc.)
+     */
+    private _formatImaginaryLabel;
+    /**
+     * Convert a complex number to a visual point
+     * @param z - Complex number as {re, im} or a number (treated as real)
+     * @returns Visual point [x, y, z]
+     */
+    n2p(z: Complex | number): Vector3Tuple;
+    /**
+     * Convert a visual point to a complex number
+     * @param point - Visual point [x, y, z]
+     * @returns Complex number
+     */
+    p2n(point: Vector3Tuple): Complex;
+    /**
+     * Get the modulus (absolute value) of a complex number
+     * @param z - Complex number
+     */
+    static modulus(z: Complex): number;
+    /**
+     * Get the argument (angle) of a complex number in radians
+     * @param z - Complex number
+     */
+    static argument(z: Complex): number;
+    /**
+     * Add two complex numbers
+     */
+    static add(a: Complex, b: Complex): Complex;
+    /**
+     * Multiply two complex numbers
+     */
+    static multiply(a: Complex, b: Complex): Complex;
+    /**
+     * Get the conjugate of a complex number
+     */
+    static conjugate(z: Complex): Complex;
+    /**
+     * Convert polar coordinates to a complex number
+     * @param r - Modulus (radius)
+     * @param theta - Argument (angle in radians)
+     */
+    static fromPolar(r: number, theta: number): Complex;
+    /**
+     * Subtract two complex numbers: a - b
+     */
+    static subtract(a: Complex, b: Complex): Complex;
+    /**
+     * Divide two complex numbers: a / b = (a * conj(b)) / |b|^2
+     */
+    static divide(a: Complex, b: Complex): Complex;
+    /**
+     * Raise a complex number to a real power: z^n via polar form (r^n * e^(in*theta))
+     * @param z - Complex number
+     * @param n - Real exponent
+     */
+    static pow(z: Complex, n: number): Complex;
+    /**
+     * Complex exponential: e^z = e^re * (cos(im) + i*sin(im))
+     */
+    static exp(z: Complex): Complex;
+    /**
+     * Complex logarithm (principal branch): log(z) = ln|z| + i*arg(z)
+     */
+    static log(z: Complex): Complex;
+    /**
+     * Complex square root (principal root) via polar form
+     */
+    static sqrt(z: Complex): Complex;
+    /**
+     * Complex reciprocal: 1/z = conj(z) / |z|^2
+     */
+    static reciprocal(z: Complex): Complex;
+    /**
+     * Get the imaginary labels group
+     */
+    getImaginaryLabels(): Group;
+    /**
+     * Set whether to show imaginary labels
+     */
+    setIncludeImaginaryLabels(include: boolean): this;
+    /**
+     * Apply a complex function to all children of this plane, warping
+     * any VMobject's control points through the function.
+     *
+     * Each point is converted to a complex number via `p2n()`, passed through
+     * `func`, then mapped back to visual space via `n2p()`.
+     *
+     * @param func - A function mapping one complex number to another
+     * @returns this for chaining
+     */
+    applyComplexFunction(func: (z: Complex) => Complex): this;
+    /**
+     * Recursively walk `group` and transform the points of every VMobject child.
+     */
+    private _transformChildren;
+    /**
+     * Add numeric coordinate labels at the specified values.
+     *
+     * - For real (x) values: creates Text labels below the x-axis.
+     * - For imaginary (y) values: creates Text labels (e.g. "2i", "-i") to the
+     *   left of the y-axis.
+     *
+     * If no values are supplied the ranges are derived from the axis settings.
+     *
+     * @param xVals - Real-axis values to label (defaults to integer steps from axis range)
+     * @param yVals - Imaginary-axis values to label (defaults to integer steps from axis range)
+     * @returns this for chaining
+     */
+    addCoordinates(xVals?: number[], yVals?: number[]): this;
+    /**
+     * Get the coordinate labels group
+     */
+    getCoordinateLabels(): Group;
+    /**
+     * Create a copy of this ComplexPlane
+     */
+    protected _createCopy(): ComplexPlane;
+}
+/**
+ * Options for creating a PolarPlane
+ */
+export interface PolarPlaneOptions {
+    /** Maximum radius in coordinate units. Default: 3 */
+    radius?: number;
+    /** Visual size (diameter) of the plane. Default: 6 */
+    size?: number;
+    /** Number of radial divisions (concentric circles). Default: 3 */
+    radialDivisions?: number;
+    /** Number of angular divisions (radial lines). Default: 12 */
+    angularDivisions?: number;
+    /** Stroke color for grid lines. Default: '#555555' */
+    gridColor?: string;
+    /** Stroke width for grid lines. Default: 1 */
+    gridStrokeWidth?: number;
+    /** Grid line opacity. Default: 0.5 */
+    gridOpacity?: number;
+    /** Whether to include angle labels. Default: true */
+    includeAngleLabels?: boolean;
+    /** Whether to include radius labels. Default: true */
+    includeRadiusLabels?: boolean;
+    /** Font size for labels. Default: 20 */
+    labelFontSize?: number;
+    /** Color for axis labels. Default: '#ffffff' */
+    labelColor?: string;
+    /** Azimuth offset angle in radians (0 = right). Default: 0 */
+    azimuthOffset?: number;
+}
+/**
+ * PolarPlane - A polar coordinate system
+ *
+ * Displays a polar coordinate system with radial lines at regular angle
+ * intervals and concentric circles at regular radius intervals.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple polar plane
+ * const polar = new PolarPlane();
+ *
+ * // Convert polar coordinates to a point
+ * const point = polar.pr2pt(2, Math.PI / 4);
+ *
+ * // Convert a point to polar coordinates
+ * const [r, theta] = polar.pt2pr([1, 1, 0]);
+ * ```
+ */
+export declare class PolarPlane extends Group {
+    private _radius;
+    private _size;
+    private _radialDivisions;
+    private _angularDivisions;
+    private _gridColor;
+    private _gridStrokeWidth;
+    private _gridOpacity;
+    private _includeAngleLabels;
+    private _includeRadiusLabels;
+    private _labelFontSize;
+    private _labelColor;
+    private _azimuthOffset;
+    private _concentricCircles;
+    private _radialLines;
+    private _angleLabels;
+    private _radiusLabels;
+    constructor(options?: PolarPlaneOptions);
+    /**
+     * Get the visual scale factor (visual units per coordinate unit)
+     */
+    private _getScaleFactor;
+    /**
+     * Generate the concentric circles and radial lines
+     */
+    private _generateGrid;
+    /**
+     * Generate angle and radius labels
+     */
+    private _generateLabels;
+    /**
+     * Format an angle as a label (0, π/4, π/2, etc.)
+     */
+    private _formatAngleLabel;
+    /**
+     * Convert polar coordinates to a visual point
+     * @param r - Radius in coordinate units
+     * @param theta - Angle in radians (0 = right, counter-clockwise)
+     * @returns Visual point [x, y, z]
+     */
+    pr2pt(r: number, theta: number): Vector3Tuple;
+    /**
+     * Convert a visual point to polar coordinates
+     * @param point - Visual point [x, y, z]
+     * @returns Polar coordinates [r, theta] where theta is in radians
+     */
+    pt2pr(point: Vector3Tuple): [number, number];
+    /**
+     * Get the radius (maximum coordinate value)
+     */
+    getRadius(): number;
+    /**
+     * Get the visual size (diameter)
+     */
+    getSize(): number;
+    /**
+     * Get the origin point in visual coordinates
+     */
+    getOrigin(): Vector3Tuple;
+    /**
+     * Get the concentric circles group
+     */
+    getConcentricCircles(): Group;
+    /**
+     * Get the radial lines group
+     */
+    getRadialLines(): Group;
+    /**
+     * Get the angle labels group
+     */
+    getAngleLabels(): Group;
+    /**
+     * Get the radius labels group
+     */
+    getRadiusLabels(): Group;
+    /**
+     * Set whether to show angle labels
+     */
+    setIncludeAngleLabels(include: boolean): this;
+    /**
+     * Set whether to show radius labels
+     */
+    setIncludeRadiusLabels(include: boolean): this;
+    /**
+     * Create a copy of this PolarPlane
+     */
+    protected _createCopy(): PolarPlane;
+}
+export default ComplexPlane;
+//# sourceMappingURL=ComplexPlane.d.ts.map

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

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