manim-web 0.2.0

package/dist/mobjects/geometry/Arrow.d.ts

@@ -0,0 +1,130 @@
+import { Group } from '../../core/Group';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Options for creating an Arrow
+ */
+export interface ArrowOptions {
+    /** Start point of the arrow. Default: [0, 0, 0] */
+    start?: Vector3Tuple;
+    /** End point of the arrow (where the tip points). Default: [1, 0, 0] */
+    end?: Vector3Tuple;
+    /** Stroke color as CSS color string. Default: WHITE (#FFFFFF) */
+    color?: string;
+    /** Stroke width in pixels. Default: 4 (Manim's default) */
+    strokeWidth?: number;
+    /** Length of the arrowhead tip. Default: 0.25 */
+    tipLength?: number;
+    /** Width of the arrowhead base. Default: 0.15 */
+    tipWidth?: number;
+}
+/**
+ * Arrow - A line with an arrowhead at the end
+ *
+ * Creates a line segment with a triangular arrowhead at the end point.
+ * The arrow automatically calculates the tip orientation based on the line direction.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple arrow
+ * const arrow = new Arrow();
+ *
+ * // Create an arrow from point A to point B
+ * const arrow2 = new Arrow({
+ *   start: [-2, 0, 0],
+ *   end: [2, 1, 0],
+ *   color: '#ff0000'
+ * });
+ *
+ * // Create an arrow with larger tip
+ * const bigTip = new Arrow({ tipLength: 0.4, tipWidth: 0.25 });
+ * ```
+ */
+export declare class Arrow extends Group {
+    private _start;
+    private _end;
+    private _tipLength;
+    private _tipWidth;
+    private _strokeWidth;
+    private _shaft;
+    private _tip;
+    constructor(options?: ArrowOptions);
+    /**
+     * Generate the arrow parts (shaft line + tip triangle)
+     */
+    private _generateParts;
+    /**
+     * Get the start point
+     */
+    getStart(): Vector3Tuple;
+    /**
+     * Set the start point
+     */
+    setStart(point: Vector3Tuple): this;
+    /**
+     * Get the end point (tip of the arrow)
+     */
+    getEnd(): Vector3Tuple;
+    /**
+     * Set the end point (tip of the arrow)
+     */
+    setEnd(point: Vector3Tuple): this;
+    /**
+     * Get the length of the arrow (including tip)
+     */
+    getLength(): number;
+    /**
+     * Get the tip length
+     */
+    getTipLength(): number;
+    /**
+     * Set the tip length
+     */
+    setTipLength(value: number): this;
+    /**
+     * Get the tip width
+     */
+    getTipWidth(): number;
+    /**
+     * Set the tip width
+     */
+    setTipWidth(value: number): this;
+    /**
+     * Get the direction vector of the arrow (normalized)
+     */
+    getDirection(): Vector3Tuple;
+    /**
+     * Get the angle of the arrow in the XY plane (in radians)
+     */
+    getAngle(): number;
+    /**
+     * Create a copy of this Arrow
+     */
+    protected _createCopy(): Arrow;
+}
+/**
+ * DoubleArrow - An arrow with tips on both ends
+ */
+export declare class DoubleArrow extends Group {
+    private _start;
+    private _end;
+    private _tipLength;
+    private _tipWidth;
+    private _strokeWidth;
+    constructor(options?: ArrowOptions);
+    private _generateParts;
+    getStart(): Vector3Tuple;
+    setStart(point: Vector3Tuple): this;
+    getEnd(): Vector3Tuple;
+    setEnd(point: Vector3Tuple): this;
+    getLength(): number;
+    protected _createCopy(): DoubleArrow;
+}
+/**
+ * Vector - An Arrow starting from the origin by default
+ */
+export declare class Vector extends Arrow {
+    constructor(options?: Omit<ArrowOptions, 'start'> & {
+        direction?: Vector3Tuple;
+    });
+}
+//# sourceMappingURL=Arrow.d.ts.map

package/dist/mobjects/geometry/Arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Arrow.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geometry/Arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,KAAM,SAAQ,KAAK;IAC9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAyB;gBAEzB,OAAO,GAAE,YAAiB;IAsBtC;;OAEG;IACH,OAAO,CAAC,cAAc;IAiEtB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC;;OAEG;IACH,MAAM,IAAI,YAAY;IAItB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC;;OAEG;IACH,YAAY,IAAI,YAAY;IAY5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAOlB;;OAEG;cACgB,WAAW,IAAI,KAAK;CAUxC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,YAAiB;IAsBtC,OAAO,CAAC,cAAc;IA6DtB,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM,IAAI,YAAY;IAItB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC,SAAS,IAAI,MAAM;cAOA,WAAW,IAAI,WAAW;CAU9C;AAED;;GAEG;AACH,qBAAa,MAAO,SAAQ,KAAK;gBACnB,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,YAAY,CAAA;KAAO;CAQrF"}

package/dist/mobjects/geometry/ArrowTips.d.ts

@@ -0,0 +1,238 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Base options for all arrow tips
+ */
+export interface ArrowTipOptions {
+    /** Length of the tip along the arrow direction. Default: 0.25 */
+    length?: number;
+    /** Width of the tip perpendicular to arrow direction. Default: 0.15 */
+    width?: number;
+    /** Color of the tip. Default: Manim's blue (#58C4DD) */
+    color?: string;
+    /** Stroke width in pixels. Default: 4 */
+    strokeWidth?: number;
+    /** Fill opacity from 0 to 1. Default: 0 for unfilled tips */
+    fillOpacity?: number;
+    /** Position at end of line (tip point). Default: [0, 0, 0] */
+    position?: Vector3Tuple;
+    /** Direction the tip points towards (normalized). Default: [1, 0, 0] */
+    direction?: Vector3Tuple;
+}
+/**
+ * ArrowTip - Base class for arrow tips
+ *
+ * This is an abstract base class that defines the interface for arrow tips.
+ * Concrete tip styles extend this class.
+ *
+ * @example
+ * ```typescript
+ * // Tips are typically used with Arrow class, but can be standalone
+ * const tip = new ArrowTriangleTip({
+ *   position: [1, 0, 0],
+ *   direction: [1, 0, 0],
+ *   length: 0.3,
+ *   width: 0.2
+ * });
+ * ```
+ */
+export declare abstract class ArrowTip extends VMobject {
+    protected _length: number;
+    protected _width: number;
+    protected _position: Vector3Tuple;
+    protected _direction: Vector3Tuple;
+    constructor(options?: ArrowTipOptions);
+    /**
+     * Get the tip length
+     */
+    getLength(): number;
+    /**
+     * Set the tip length
+     */
+    setLength(value: number): this;
+    /**
+     * Get the tip width
+     */
+    getWidth(): number;
+    /**
+     * Set the tip width
+     */
+    setWidth(value: number): this;
+    /**
+     * Get the tip position (point where it attaches)
+     */
+    getPosition(): Vector3Tuple;
+    /**
+     * Set the tip position
+     */
+    setTipPosition(position: Vector3Tuple): this;
+    /**
+     * Get the tip direction
+     */
+    getDirection(): Vector3Tuple;
+    /**
+     * Set the tip direction
+     */
+    setDirection(direction: Vector3Tuple): this;
+    /**
+     * Get the base point of the tip (opposite to the point)
+     */
+    getBase(): Vector3Tuple;
+    /**
+     * Get the angle of the tip relative to the X axis (radians)
+     */
+    getAngle(): number;
+    /**
+     * Generate the points for this tip - implemented by subclasses
+     */
+    protected abstract _generatePoints(): void;
+}
+/**
+ * ArrowTriangleTip - Standard unfilled triangle arrow tip
+ *
+ * Creates a simple triangular arrowhead outline.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowTriangleTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   color: '#ff0000'
+ * });
+ * ```
+ */
+export declare class ArrowTriangleTip extends ArrowTip {
+    constructor(options?: ArrowTipOptions);
+    protected _generatePoints(): void;
+    protected _createCopy(): ArrowTriangleTip;
+}
+/**
+ * ArrowTriangleFilledTip - Filled triangle arrow tip
+ *
+ * Creates a solid filled triangular arrowhead.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowTriangleFilledTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   color: '#ff0000'
+ * });
+ * ```
+ */
+export declare class ArrowTriangleFilledTip extends ArrowTriangleTip {
+    constructor(options?: ArrowTipOptions);
+    protected _createCopy(): ArrowTriangleFilledTip;
+}
+/**
+ * ArrowCircleTip - Unfilled circle at the end of an arrow
+ *
+ * Creates a circular arrowhead outline.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowCircleTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   width: 0.2  // Radius of the circle
+ * });
+ * ```
+ */
+export declare class ArrowCircleTip extends ArrowTip {
+    private _numSegments;
+    constructor(options?: ArrowTipOptions & {
+        numSegments?: number;
+    });
+    protected _generatePoints(): void;
+    protected _createCopy(): ArrowCircleTip;
+}
+/**
+ * ArrowCircleFilledTip - Filled circle at the end of an arrow
+ *
+ * Creates a solid filled circular arrowhead.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowCircleFilledTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   width: 0.2  // Radius of the circle
+ * });
+ * ```
+ */
+export declare class ArrowCircleFilledTip extends ArrowCircleTip {
+    constructor(options?: ArrowTipOptions & {
+        numSegments?: number;
+    });
+    protected _createCopy(): ArrowCircleFilledTip;
+}
+/**
+ * ArrowSquareTip - Unfilled square at the end of an arrow
+ *
+ * Creates a square arrowhead outline.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowSquareTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   width: 0.15
+ * });
+ * ```
+ */
+export declare class ArrowSquareTip extends ArrowTip {
+    constructor(options?: ArrowTipOptions);
+    protected _generatePoints(): void;
+    protected _createCopy(): ArrowSquareTip;
+}
+/**
+ * ArrowSquareFilledTip - Filled square at the end of an arrow
+ *
+ * Creates a solid filled square arrowhead.
+ *
+ * @example
+ * ```typescript
+ * const tip = new ArrowSquareFilledTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   width: 0.15
+ * });
+ * ```
+ */
+export declare class ArrowSquareFilledTip extends ArrowSquareTip {
+    constructor(options?: ArrowTipOptions);
+    protected _createCopy(): ArrowSquareFilledTip;
+}
+/**
+ * StealthTip - Stealth fighter style sharp arrow tip
+ *
+ * Creates a sleek, swept-back arrow tip similar to a stealth aircraft.
+ * The tip has an indented back creating a sharper, more aggressive look.
+ *
+ * @example
+ * ```typescript
+ * const tip = new StealthTip({
+ *   position: [2, 0, 0],
+ *   direction: [1, 0, 0],
+ *   length: 0.35,
+ *   width: 0.2
+ * });
+ * ```
+ */
+export declare class StealthTip extends ArrowTip {
+    private _backAngle;
+    constructor(options?: ArrowTipOptions & {
+        backAngle?: number;
+    });
+    protected _generatePoints(): void;
+    /**
+     * Get the back angle (notch depth ratio)
+     */
+    getBackAngle(): number;
+    /**
+     * Set the back angle (notch depth ratio, 0-1)
+     */
+    setBackAngle(value: number): this;
+    protected _createCopy(): StealthTip;
+}
+//# sourceMappingURL=ArrowTips.d.ts.map

package/dist/mobjects/geometry/ArrowTips.d.ts.map

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

package/dist/mobjects/geometry/BooleanOperations.d.ts

@@ -0,0 +1,163 @@
+import { VMobject } from '../../core/VMobject';
+/**
+ * 2D vertex for polygon clipping operations
+ */
+interface Vertex2D {
+    x: number;
+    y: number;
+}
+/**
+ * Options for boolean operations
+ */
+export interface BooleanOperationOptions {
+    /** Stroke color. Default: inherited from first shape */
+    color?: string;
+    /** Fill color (separate from stroke). If set, overrides color for fill. */
+    fillColor?: string;
+    /** Fill opacity. Default: inherited from first shape */
+    fillOpacity?: number;
+    /** Stroke width. Default: inherited from first shape */
+    strokeWidth?: number;
+    /** Number of samples per Bezier segment for polygon approximation. Default: 8 */
+    samplesPerSegment?: number;
+}
+/**
+ * Base class for boolean operation results
+ */
+export declare class BooleanResult extends VMobject {
+    protected _resultVertices: Vertex2D[][];
+    /** Control-point counts per subpath (for multi-polygon results) */
+    private _subpathLengths;
+    constructor();
+    /**
+     * Get subpath control-point counts for multi-polygon results.
+     * Used by VMobject's fill and stroke renderers to handle
+     * disjoint regions without visible bridge lines.
+     */
+    getSubpaths(): number[];
+    /**
+     * Get the result polygon vertices
+     */
+    getResultVertices(): Vertex2D[][];
+    /**
+     * Re-center the VMobject: compute the centroid of all points,
+     * subtract it from every point (making them local-space), and
+     * set `this.position` to the centroid.  This ensures getCenter(),
+     * nextTo(), and other layout helpers work correctly.
+     */
+    protected _centerOnPoints(): void;
+    /**
+     * Set VMobject points from a single polygon's vertices.
+     * Converts vertices to cubic Bezier line segments with 1/3 and 2/3 control points.
+     */
+    protected _setPointsFromVertices(vertices: Vertex2D[]): void;
+    /**
+     * Set VMobject points from multiple polygons.
+     * Each polygon becomes a separate subpath (no bridge segments).
+     * Subpath lengths are tracked for proper fill and stroke rendering.
+     */
+    protected _setPointsFromMultiplePolygons(polygons: Vertex2D[][]): void;
+}
+/**
+ * Union - Boolean union of two shapes (combine)
+ *
+ * Creates a new shape that encompasses both input shapes.
+ * Uses the Martinez-Rueda-Feito algorithm for robust handling of all polygon types.
+ *
+ * @example
+ * ```typescript
+ * const circle1 = new Circle({ radius: 1 });
+ * const circle2 = new Circle({ radius: 1 }).shift([1, 0, 0]);
+ * const combined = new Union(circle1, circle2);
+ * ```
+ */
+export declare class Union extends BooleanResult {
+    constructor(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions);
+}
+/**
+ * Intersection - Boolean intersection of two shapes (overlap area)
+ *
+ * Creates a new shape representing the overlapping region of both inputs.
+ * Uses the Martinez-Rueda-Feito algorithm for robust handling of all polygon types.
+ *
+ * @example
+ * ```typescript
+ * const square1 = new Square({ sideLength: 2 });
+ * const square2 = new Square({ sideLength: 2 }).shift([1, 1, 0]);
+ * const overlap = new Intersection(square1, square2);
+ * ```
+ */
+export declare class Intersection extends BooleanResult {
+    constructor(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions);
+}
+/**
+ * Difference - Boolean difference of two shapes (subtract second from first)
+ *
+ * Creates a new shape representing the first shape with the second removed.
+ * Uses the Martinez-Rueda-Feito algorithm for robust handling of all polygon types,
+ * including proper hole representation when one shape is inside another.
+ *
+ * @example
+ * ```typescript
+ * const bigCircle = new Circle({ radius: 2 });
+ * const smallCircle = new Circle({ radius: 1 });
+ * const donut = new Difference(bigCircle, smallCircle);
+ * ```
+ */
+export declare class Difference extends BooleanResult {
+    constructor(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions);
+}
+/**
+ * Exclusion - Boolean XOR of two shapes (non-overlapping areas)
+ *
+ * Creates shapes representing the areas that are in one shape but not both.
+ * Uses the Martinez-Rueda-Feito algorithm for robust handling of all polygon types.
+ *
+ * @example
+ * ```typescript
+ * const circle1 = new Circle({ radius: 1 });
+ * const circle2 = new Circle({ radius: 1 }).shift([0.5, 0, 0]);
+ * const xorShape = new Exclusion(circle1, circle2);
+ * ```
+ */
+export declare class Exclusion extends BooleanResult {
+    constructor(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions);
+}
+/**
+ * Create a boolean union of two shapes
+ *
+ * @param shape1 - First shape
+ * @param shape2 - Second shape
+ * @param options - Optional styling options
+ * @returns New VMobject representing the union
+ */
+export declare function union(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions): Union;
+/**
+ * Create a boolean intersection of two shapes
+ *
+ * @param shape1 - First shape
+ * @param shape2 - Second shape
+ * @param options - Optional styling options
+ * @returns New VMobject representing the intersection
+ */
+export declare function intersection(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions): Intersection;
+/**
+ * Create a boolean difference of two shapes (subtract second from first)
+ *
+ * @param shape1 - First shape (base)
+ * @param shape2 - Second shape (to subtract)
+ * @param options - Optional styling options
+ * @returns New VMobject representing the difference
+ */
+export declare function difference(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions): Difference;
+/**
+ * Create a boolean exclusion (XOR) of two shapes
+ *
+ * @param shape1 - First shape
+ * @param shape2 - Second shape
+ * @param options - Optional styling options
+ * @returns New VMobject representing the exclusion
+ */
+export declare function exclusion(shape1: VMobject, shape2: VMobject, options?: BooleanOperationOptions): Exclusion;
+export {};
+//# sourceMappingURL=BooleanOperations.d.ts.map

package/dist/mobjects/geometry/BooleanOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BooleanOperations.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geometry/BooleanOperations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAU/C;;GAEG;AACH,UAAU,QAAQ;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,eAAe,EAAE,QAAQ,EAAE,EAAE,CAAM;IAC7C,mEAAmE;IACnE,OAAO,CAAC,eAAe,CAAgB;;IAMvC;;;;OAIG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,iBAAiB,IAAI,QAAQ,EAAE,EAAE;IAIjC;;;;;OAKG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAqBjC;;;OAGG;IACH,SAAS,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI;IAwB5D;;;;OAIG;IACH,SAAS,CAAC,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI;CAoCvE;AAgID;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAM,SAAQ,aAAa;gBAC1B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B;CAyCtF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBACjC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B;CA8BtF;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B;CAmCtF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B;CA8BtF;AAMD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,KAAK,CAEP;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,YAAY,CAEd;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,UAAU,CAEZ;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,SAAS,CAEX"}

package/dist/mobjects/geometry/Circle.d.ts

@@ -0,0 +1,92 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Options for creating a Circle
+ */
+export interface CircleOptions {
+    /** Radius of the circle. Default: 1 */
+    radius?: number;
+    /** Stroke color as CSS color string. Default: Manim's blue (#58C4DD) */
+    color?: string;
+    /** Fill opacity from 0 to 1. Default: 0 */
+    fillOpacity?: number;
+    /** Stroke width in pixels. Default: 4 (Manim's default) */
+    strokeWidth?: number;
+    /** Number of points for Bezier approximation. Default: 64 */
+    numPoints?: number;
+    /** Center position. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+}
+/**
+ * Circle - A circular VMobject
+ *
+ * Creates a circle using cubic Bezier curves. Four cubic Bezier segments
+ * can approximate a circle with high accuracy using the kappa constant.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit circle
+ * const circle = new Circle();
+ *
+ * // Create a red circle with radius 2
+ * const redCircle = new Circle({ radius: 2, color: '#ff0000' });
+ *
+ * // Create a filled circle
+ * const filled = new Circle({ fillOpacity: 0.5 });
+ * ```
+ */
+export declare class Circle extends VMobject {
+    private _radius;
+    private _numPoints;
+    private _centerPoint;
+    constructor(options?: CircleOptions);
+    /**
+     * Generate the circle points using Bezier curve approximation.
+     * Uses 4 cubic Bezier segments for optimal circle approximation.
+     */
+    private _generatePoints;
+    /**
+     * Get the radius of the circle
+     */
+    getRadius(): number;
+    /**
+     * Set the radius of the circle
+     */
+    setRadius(value: number): this;
+    /**
+     * Get the center of the circle
+     */
+    getCircleCenter(): Vector3Tuple;
+    /**
+     * Set the center of the circle
+     */
+    setCircleCenter(value: Vector3Tuple): this;
+    /**
+     * Scale the circle by changing its actual radius (not scaleVector).
+     * Scales about the circle's own center so the center stays put.
+     */
+    scale(factor: number | Vector3Tuple): this;
+    /**
+     * Shift the circle by updating its center point and regenerating geometry.
+     * Does not change Mobject.position to avoid double-counting in THREE.js hierarchy.
+     */
+    shift(delta: Vector3Tuple): this;
+    /**
+     * Get the circumference of the circle
+     */
+    getCircumference(): number;
+    /**
+     * Get the area of the circle
+     */
+    getArea(): number;
+    /**
+     * Get a point on the circle at a given angle (in radians)
+     * @param angle Angle in radians from the positive x-axis
+     */
+    pointAtAngle(angle: number): Vector3Tuple;
+    /**
+     * Create a copy of this Circle
+     */
+    protected _createCopy(): Circle;
+}
+//# sourceMappingURL=Circle.d.ts.map

package/dist/mobjects/geometry/Circle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geometry/Circle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAO,SAAQ,QAAQ;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,GAAE,aAAkB;IAuBvC;;;OAGG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM9B;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAM1C;;;OAGG;IACM,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAWnD;;;OAGG;IACM,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IASzC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAQzC;;OAEG;cACgB,WAAW,IAAI,MAAM;CAUzC"}