manim-web 0.3.6 → 0.3.8

package/dist/core/StateManager.d.ts.map

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

package/dist/core/ThreeDScene.d.ts

@@ -0,0 +1,199 @@
+import { Scene, SceneOptions } from './Scene';
+import { Camera3D } from './Camera';
+import { Lighting } from './Lighting';
+import { OrbitControls, OrbitControlsOptions } from '../interaction/OrbitControls';
+import { Mobject, Vector3Tuple } from './Mobject';
+/**
+ * Options for configuring a ThreeDScene.
+ */
+export interface ThreeDSceneOptions extends SceneOptions {
+    /** Camera field of view in degrees. Defaults to 45. */
+    fov?: number;
+    /** Initial camera phi angle (polar, from Y axis). Defaults to PI/4. */
+    phi?: number;
+    /** Initial camera theta angle (azimuthal, in XZ plane). Defaults to -PI/4. */
+    theta?: number;
+    /** Initial camera distance from origin. Defaults to 15. */
+    distance?: number;
+    /** Enable orbit controls for user interaction. Defaults to true. */
+    enableOrbitControls?: boolean;
+    /** Orbit controls configuration options. */
+    orbitControlsOptions?: OrbitControlsOptions;
+    /** Whether to set up default lighting. Defaults to true. */
+    setupLighting?: boolean;
+}
+/**
+ * Scene configured for 3D content.
+ * Provides a 3D camera, orbit controls, and lighting setup by default.
+ * Compatible with the Timeline system for animations.
+ */
+export declare class ThreeDScene extends Scene {
+    private _camera3D;
+    private _lighting;
+    private _orbitControls;
+    private _orbitControlsEnabled;
+    private _isRendering;
+    private _orbitRafId;
+    private _orbitInteracting;
+    private _hudScene;
+    private _hudCamera;
+    private _fixedMobjects;
+    private _ambientRotationRate;
+    private _lastRenderTime;
+    private _illusionRotationRate;
+    private _illusionOriginPhi;
+    private _illusionOriginTheta;
+    private _illusionThetaTracker;
+    private _illusionPhiTracker;
+    private _illusionActive;
+    /**
+     * Create a new 3D scene.
+     * @param container - DOM element to render into
+     * @param options - Scene configuration options
+     */
+    constructor(container: HTMLElement, options?: ThreeDSceneOptions);
+    /**
+     * Override add to re-enable depth testing for proper 3D occlusion.
+     * The base Scene disables depthTest for 2D render-order layering,
+     * but 3D scenes need depth testing for correct visibility.
+     */
+    add(...mobjects: Mobject[]): this;
+    /**
+     * Get the 3D camera.
+     */
+    get camera3D(): Camera3D;
+    /**
+     * Get the lighting system.
+     */
+    get lighting(): Lighting;
+    /**
+     * Get the orbit controls (if enabled).
+     */
+    get orbitControls(): OrbitControls | null;
+    /**
+     * Set the camera orientation using spherical coordinates.
+     * @param phi - Polar angle from Y axis (0 = top, PI = bottom)
+     * @param theta - Azimuthal angle in XZ plane
+     * @param distance - Optional distance from the look-at point
+     * @returns this for chaining
+     */
+    setCameraOrientation(phi: number, theta: number, distance?: number): this;
+    /**
+     * Set the camera's look-at target.
+     * @param target - Target position [x, y, z]
+     * @returns this for chaining
+     */
+    setLookAt(target: Vector3Tuple): this;
+    /**
+     * Get the current camera orientation angles.
+     * @returns Object with phi, theta, and distance
+     */
+    getCameraOrientation(): {
+        phi: number;
+        theta: number;
+        distance: number;
+    };
+    /**
+     * Begin continuous ambient rotation of the camera around the scene.
+     * Rotates the camera's theta angle at the given rate (radians per second)
+     * during wait() calls and play() calls.
+     * Equivalent to Python Manim's begin_ambient_camera_rotation(rate).
+     * @param rate - Rotation rate in radians per second. Defaults to 0.1.
+     * @returns this for chaining
+     */
+    beginAmbientCameraRotation(rate?: number): this;
+    /**
+     * Stop the ambient camera rotation.
+     * Equivalent to Python Manim's stop_ambient_camera_rotation().
+     * @returns this for chaining
+     */
+    stopAmbientCameraRotation(): this;
+    /**
+     * Begin 3D illusion camera rotation.
+     * Unlike ambient rotation (which only rotates theta), this also oscillates
+     * phi sinusoidally, creating a wobbling 3D illusion as if the viewer walks
+     * around the scene.
+     * Equivalent to Python Manim's begin_3dillusion_camera_rotation(rate).
+     * @param rate - Rotation rate in radians per second. Defaults to 2.
+     * @returns this for chaining
+     */
+    begin3DIllusionCameraRotation(rate?: number): this;
+    /**
+     * Stop the 3D illusion camera rotation.
+     * Equivalent to Python Manim's stop_3dillusion_camera_rotation().
+     * @returns this for chaining
+     */
+    stop3DIllusionCameraRotation(): this;
+    /**
+     * Animate the camera to a new orientation over a given duration.
+     * Equivalent to Python Manim's move_camera(phi, theta, distance).
+     * If no duration is given, snaps instantly.
+     * @param options - Target orientation and duration
+     * @returns Promise that resolves when the animation completes
+     */
+    moveCamera(options: {
+        phi?: number;
+        theta?: number;
+        distance?: number;
+        duration?: number;
+    }): Promise<void>;
+    /**
+     * Enable or disable orbit controls.
+     * @param enabled - Whether orbit controls should be enabled
+     * @returns this for chaining
+     */
+    setOrbitControlsEnabled(enabled: boolean): this;
+    /**
+     * Pin mobjects to the screen (HUD) so they don't move with the 3D camera.
+     * Equivalent to Python Manim's add_fixed_in_frame_mobjects.
+     * @param mobjects - Mobjects to fix in screen space
+     * @returns this for chaining
+     */
+    addFixedInFrameMobjects(...mobjects: Mobject[]): this;
+    /**
+     * Remove mobjects from the fixed-in-frame HUD.
+     * @param mobjects - Mobjects to unpin from screen space
+     * @returns this for chaining
+     */
+    removeFixedInFrameMobjects(...mobjects: Mobject[]): this;
+    /**
+     * Override: also needs per-frame rendering when camera is animating.
+     */
+    protected _needsPerFrameRendering(): boolean;
+    /**
+     * Override _render to use the 3D camera with two-pass rendering for HUD.
+     * This is called by the animation loop internally.
+     */
+    protected _render(): void;
+    /**
+     * Public render - delegates to _render.
+     */
+    render(): void;
+    /**
+     * Override clear to also clear the HUD scene and fixed mobjects.
+     */
+    clear(options?: {
+        render?: boolean;
+    }): this;
+    /**
+     * Override remove to also handle fixed mobjects.
+     */
+    remove(...mobjects: Mobject[]): this;
+    /**
+     * Handle window resize.
+     * @param width - New width in pixels
+     * @param height - New height in pixels
+     */
+    resize(width: number, height: number): this;
+    /**
+     * Start a lightweight rAF loop for orbit controls when the scene
+     * isn't already rendering (no active animations/waits).
+     * Stops automatically when the user releases and damping settles.
+     */
+    private _startOrbitLoop;
+    /**
+     * Clean up all resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=ThreeDScene.d.ts.map

package/dist/core/ThreeDScene.d.ts.map

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

package/dist/core/VMobject.d.ts

@@ -1,27 +1,11 @@
-import { LineMaterial } from 'three/examples/jsm/lines/LineMaterial.js';
-import { Mobject, Vector3Tuple } from './Mobject';
-/**
- * Vectorized Mobject - a mobject defined by cubic Bezier curves.
- * This is the base class for all path-based shapes.
- *
- * Points are stored as cubic Bezier control points:
- * [anchor1, handle1, handle2, anchor2, handle3, handle4, anchor3, ...]
- *
- * Each curve segment uses 4 points: anchor -> handle -> handle -> anchor
- * Consecutive segments share the anchor point.
- */
-import * as THREE from 'three';
-/**
- * 2D Point interface for backward compatibility
- */
-export interface Point {
-    x: number;
-    y: number;
-}
+import { Vector3Tuple } from './Mobject';
+import { VMobjectRendering } from './VMobjectRendering';
+import { Point } from './VMobjectCurves';
+export type { Point } from './VMobjectCurves';
 /**
  * Vectorized mobject class for path-based shapes.
  */
-export declare class VMobject extends Mobject {
+export declare class VMobject extends VMobjectRendering {
     /**
      * Array of cubic Bezier control points in 3D.
      * Each point is [x, y, z].
@@ -30,67 +14,7 @@ export declare class VMobject extends Mobject {
     protected _points3D: number[][];
     /** Number of points visible (for Create animation) */
     protected _visiblePointCount: number | null;
-    /** Three.js stroke material (Line2 LineMaterial for thick strokes) */
-    protected _strokeMaterial: LineMaterial | null;
-    /** Three.js fill material */
-    protected _fillMaterial: THREE.MeshBasicMaterial | null;
-    /** Whether geometry needs rebuild (separate from material dirty) */
-    protected _geometryDirty: boolean;
-    /** Cached Line2 for in-place geometry updates (avoids dispose/recreate) */
-    private _cachedLine2;
-    /** Cached Line2 array for multi-subpath stroke rendering */
-    private _cachedLine2Array;
-    /** Cached fill mesh for in-place geometry updates */
-    private _cachedFillMesh;
-    /** Renderer resolution for LineMaterial (set by Scene) */
-    static _rendererWidth: number;
-    static _rendererHeight: number;
-    /** Camera frame width in world units (set by Scene, for stroke width conversion) */
-    static _frameWidth: number;
-    /**
-     * Convert Manim-compatible strokeWidth to LineMaterial linewidth in pixels.
-     * Python Manim uses cairo_line_width_multiple=0.01, so:
-     *   linewidth_px = strokeWidth * 0.01 * (rendererWidth / frameWidth)
-     */
-    static _toLinewidth(strokeWidth: number): number;
-    /**
-     * When true, VMobjects use GPU Bezier SDF shaders for stroke rendering
-     * instead of the default Line2/LineMaterial approach. This produces
-     * ManimGL-quality anti-aliased curves with variable stroke width and
-     * round caps. Default: false (opt-in).
-     */
-    static useShaderCurves: boolean;
-    /** Shared BezierRenderer instance (lazy-initialized when useShaderCurves is first used) */
-    private static _sharedBezierRenderer;
-    /** Per-instance: cached Bezier SDF stroke mesh */
-    private _cachedBezierMesh;
-    /** Per-instance override for shader curves (null = use static default) */
-    private _useShaderCurvesOverride;
-    /**
-     * When true, render stroke as a mesh ring with miter-joined corners instead
-     * of Line2 for closed paths.  Falls back to Line2 for open/partial paths
-     * (e.g. during Create/Uncreate animations).
-     */
-    useStrokeMesh: boolean;
-    /** Cached mesh-based stroke ring */
-    private _cachedStrokeMesh;
-    /** Material for mesh-based stroke */
-    private _strokeMeshMaterial;
-    /**
-     * Get the shared BezierRenderer, creating it if needed.
-     */
-    private static _getBezierRenderer;
     constructor();
-    /**
-     * Check whether this instance should use shader-based Bezier curve rendering.
-     * Returns the per-instance override if set, otherwise the class-level default.
-     */
-    get shaderCurves(): boolean;
-    /**
-     * Enable or disable shader-based Bezier curve rendering for this instance.
-     * Pass `null` to revert to the class-level VMobject.useShaderCurves default.
-     */
-    set shaderCurves(value: boolean | null);
     /**
      * Get all points as 2D Point objects (derived from _points3D)
      */
@@ -133,6 +57,15 @@ export declare class VMobject extends Mobject {
      * Get points that should be visible (for rendering) as 3D arrays
      */
     getVisiblePoints3D(): number[][];
+    /**
+     * Set visible point count for progressive creation animations.
+     * Use null to show all points.
+     */
+    setVisiblePointCount(count: number | null): void;
+    /**
+     * Get the visible point count (null means all points visible).
+     */
+    getVisiblePointCount(): number | null;
     /**
      * Add points to this VMobject using 2D Point objects
      */
@@ -165,138 +98,43 @@ export declare class VMobject extends Mobject {
      */
     interpolate(target: VMobject, alpha: number): this;
     /**
-     * Align points between this VMobject and a target so they have the same count.
-     * This is necessary for smooth morphing animations.
+     * Align points between this VMobject and a target so they have the same
+     * count, consistent winding, and optimal rotation for smooth morphing.
      * @param target - The target VMobject to align with
      */
     alignPoints(target: VMobject): void;
     /**
-     * Interpolate a 3D point list to have a specific number of points.
+     * Compute the signed area of a 2D polygon formed by the anchor points.
+     * Positive = counter-clockwise, negative = clockwise.
      */
-    protected _interpolatePointList3D(points: number[][], targetCount: number): number[][];
+    private static _signedArea2D;
     /**
-     * Convert Bezier control points to a Three.js Shape for filled rendering.
-     * @returns THREE.Shape representing the path
+     * Reverse a cubic-bezier point path while preserving bezier structure.
+     * For cubic segments [A0, H1, H2, A1, H3, H4, A2, ...],
+     * reversing means the path goes in the opposite direction.
      */
-    protected _pointsToShape(): THREE.Shape;
+    private static _reverseBezierPath;
     /**
-     * Convert points to a THREE.CurvePath for stroke rendering
+     * Find the cyclic rotation of `target` anchor points that minimises
+     * total squared distance to `source`, then apply that rotation.
+     * Only rotates by multiples of the bezier stride (3) to preserve
+     * the cubic bezier segment structure.
      */
-    protected _pointsToCurvePath(): THREE.CurvePath<THREE.Vector3>;
+    private static _bestRotation;
     /**
-     * Build a THREE.BufferGeometry for the filled region using earcut triangulation.
-     *
-     * Earcut handles concave polygons, self-intersecting paths, and holes far
-     * more robustly than Three.js' built-in ShapeGeometry triangulator, which
-     * is a simple ear-clipping implementation that struggles with complex SVG
-     * outlines.
-     *
-     * If earcut returns zero triangles (completely degenerate input) we fall
-     * back to THREE.ShapeGeometry so existing simple shapes still render.
-     *
-     * @param points3D - The visible Bezier control points
-     * @returns A BufferGeometry ready for use as a fill mesh, or null if the
-     *          polygon is too degenerate even for fallback.
-     */
-    protected _buildEarcutFillGeometry(points3D: number[][]): THREE.BufferGeometry | null;
-    /**
-     * Build fill geometry for multi-subpath shapes (compound glyphs).
-     * Uses point-in-polygon containment to distinguish holes (subpaths inside
-     * another subpath, like the counter of "0") from disjoint regions (like
-     * the two bars of "=" or the dot+stroke of "i").
-     */
-    private _buildEarcutFillGeometryMulti;
-    /**
-     * Ray-casting point-in-polygon test (2D).
-     * Returns true if point is inside the polygon ring.
-     */
-    private static _pointInPolygon;
-    /**
-     * Sample the Bezier path into a 2D polyline suitable for earcut triangulation.
-     *
-     * This is similar to _sampleBezierPath but returns [x, y] pairs (no z) and
-     * skips duplicate-point de-duplication at segment boundaries (earcut handles
-     * that correctly and de-dup can introduce off-by-one for hole indices).
-     */
-    private _sampleBezierOutline;
-    /**
-     * Split a sampled outline into separate rings based on subpath control-point
-     * lengths.  Used for compound paths (outer boundary + holes).
-     *
-     * Each subpath length is the number of Bezier control points.  We compute
-     * how many sampled points each subpath produced and split accordingly.
-     */
-    /**
-     * Create the Three.js backing object for this VMobject.
-     * Creates both stroke (using Line2 for thick, smooth strokes) and fill meshes.
-     */
-    protected _createThreeObject(): THREE.Object3D;
-    /**
-     * Update the geometry within the Three.js group.
-     * Reuses existing Line2 / Mesh objects when possible to avoid expensive
-     * dispose-and-recreate cycles during per-frame animation updates.
-     *
-     * When `shaderCurves` is enabled, stroke rendering uses GPU Bezier SDF
-     * shaders via BezierRenderer instead of the Line2 polyline approach.
-     */
-    protected _updateGeometry(group: THREE.Group): void;
-    /**
-     * Update stroke using the classic Line2 approach (polyline approximation).
-     * Supports subpath-aware rendering: when getSubpaths() returns multiple
-     * subpaths, each is rendered as a separate Line2 to avoid visible bridge lines.
-     */
-    private _updateLine2Stroke;
-    /**
-     * Render multiple separate Line2 strokes, one per subpath.
-     */
-    private _updateLine2StrokeMulti;
-    /**
-     * Check if the Bezier control points form a closed path (first ≈ last anchor).
-     */
-    private _isClosedPath;
-    /**
-     * Build a mesh-based stroke ring from a closed sampled path.
-     * Uses miter joins at corners for pixel-perfect sharp corners.
-     * Stroke width is in world units (strokeWidth * 0.005 per side).
-     */
-    private _updateMeshStroke;
-    /**
-     * Remove the cached mesh-based stroke ring.
-     */
-    private _removeMeshStroke;
-    /**
-     * Remove all cached multi-subpath Line2 objects.
-     */
-    private _clearCachedLine2Array;
-    /**
-     * Update stroke using GPU Bezier SDF shader (ManimGL-quality rendering).
-     * Each cubic Bezier segment becomes one instanced quad rendered by the
-     * BezierShaderMaterial fragment shader.
-     */
-    private _updateBezierStroke;
-    /**
-     * Dispose and remove all children from a Three.js group
-     */
-    private _disposeGroupChildren;
-    /**
-     * Sample Bezier curves for smooth rendering.
-     * Uses adaptive sampling: nearly-linear segments (from prepareForNonlinearTransform)
-     * use only their endpoints, avoiding expensive per-sample Bezier evaluation.
-     *
-     * @param points - Bezier control points
-     * @param samplesPerSegment - Number of samples per curved Bezier segment
-     * @returns Sampled points along the path
-     */
-    private _sampleBezierPath;
-    /**
-     * Check if a cubic Bezier segment is nearly linear by measuring the maximum
-     * distance from handles to the chord (p0 → p3).
+     * Interpolate a 3D point list to have a specific number of points.
      */
-    private static _isNearlyLinear;
+    protected _interpolatePointList3D(points: number[][], targetCount: number): number[][];
     /**
-     * Sync material properties to Three.js
+     * Create a copy of this VMobject.
+     * Subclasses override _createCopy() to produce an instance of the right
+     * concrete type (Circle, Square, etc.), but those constructors typically
+     * regenerate points from their own parameters (radius, sideLength, ...).
+     * After a Transform animation has morphed the point data, the regenerated
+     * points no longer match the actual visual state.  We therefore always
+     * overwrite the clone's _points3D with the source's current data.
      */
-    protected _syncMaterialToThree(): void;
+    copy(): VMobject;
     /**
      * Create a copy of this VMobject
      */
@@ -312,6 +150,16 @@ export declare class VMobject extends Mobject {
      * rather than point centroid, which is inaccurate for Bezier control points.
      */
     getCenter(): Vector3Tuple;
+    /** @internal Check if a Bezier segment is nearly linear. */
+    protected static _isNearlyLinear(p0: number[], p1: number[], p2: number[], p3: number[]): boolean;
+    /** @internal Ray-casting point-in-polygon test. */
+    protected static _pointInPolygon(point: number[], ring: number[][]): boolean;
+    /** @internal Sample Bezier outline for earcut triangulation. */
+    protected _sampleBezierOutline(points: number[][], samplesPerSegment: number): number[][];
+    /** @internal Sample Bezier path for stroke rendering. */
+    protected _sampleBezierPath(points: number[][], samplesPerSegment?: number): number[][];
+    /** @internal Check if Bezier control points form a closed path. */
+    protected _isClosedPath(points3D: number[][]): boolean;
     /**
      * Clean up Three.js resources
      */

package/dist/core/VMobject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VMobject.d.ts","sourceRoot":"","sources":["../../src/core/VMobject.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VMobject.d.ts","sourceRoot":"","sources":["../../src/core/VMobject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAW9C,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,qBAAa,QAAS,SAAQ,iBAAiB;IAC7C;;;;OAIG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAM;IAErC,sDAAsD;IACtD,SAAS,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;;IAcnD;;OAEG;IACH,IAAI,MAAM,IAAI,KAAK,EAAE,CAEpB;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI;IAoB7C;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAIrC;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE,EAAE;IAIvB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAIlC;IAED;;OAEG;IACH,gBAAgB,IAAI,KAAK,EAAE;IAK3B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE,EAAE;IAKhC;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMhD;;OAEG;IACH,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,SAAS,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAOnC;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAkC7C;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IA+B7C;;OAEG;IACH,WAAW,IAAI,IAAI;IAYnB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA0ClD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAgCnC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQjC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAmD5B;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE;IAuCtF;;;;;;;;OAQG;IACM,IAAI,IAAI,QAAQ;IAUzB;;OAEG;cACgB,WAAW,IAAI,QAAQ;IAW1C;;;OAGG;IACH,aAAa,IAAI,YAAY;IAmB7B;;;;OAIG;IACM,SAAS,IAAI,YAAY;IA+BlC,4DAA4D;IAC5D,SAAS,CAAC,MAAM,CAAC,eAAe,CAC9B,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,GACX,OAAO;IAIV,mDAAmD;IACnD,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO;IAI5E,gEAAgE;IAChE,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE;IAIzF,yDAAyD;IACzD,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE;IAIvF,mEAAmE;IACnE,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO;IAQtD;;OAEG;IACM,OAAO,IAAI,IAAI;CAIzB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAoBnE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAkBhE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,gDAAgD;IAChD,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAE1C;;;OAGG;gBACS,QAAQ,CAAC,EAAE,QAAQ;IAY/B;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IA2BzC;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ;IAO7B;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAIvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAK3D;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE;IAItD;;OAEG;cACgB,WAAW,IAAI,QAAQ;CAK3C;AAED,eAAe,QAAQ,CAAC"}

package/dist/core/VMobjectCurves.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Curve utility types and pure helper functions for VMobject.
+ *
+ * This module contains only items that do NOT need to construct VMobject
+ * instances, avoiding circular dependency issues.
+ *
+ * Functions that create new VMobject instances (getNthCurve, curvesAsSubmobjects)
+ * live in VMobject.ts and are re-exported from there.
+ */
+/**
+ * 2D Point interface for backward compatibility
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Get the number of curve segments from a Bezier point array.
+ * Each cubic Bezier segment uses 4 points (anchor, handle, handle, anchor),
+ * with consecutive segments sharing anchors.
+ * @param points - The 3D control points array
+ * @returns Number of curve segments
+ */
+export declare function getNumCurvesFromPoints(points: number[][]): number;
+//# sourceMappingURL=VMobjectCurves.d.ts.map

package/dist/core/VMobjectCurves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VMobjectCurves.d.ts","sourceRoot":"","sources":["../../src/core/VMobjectCurves.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAGjE"}

package/dist/core/VMobjectGeometry.d.ts

@@ -0,0 +1,84 @@
+import { Point } from './VMobjectCurves';
+/**
+ * Geometry building utilities for VMobject rendering.
+ *
+ * Provides standalone functions for:
+ * - Sampling Bezier curves into polylines
+ * - Building earcut-triangulated fill geometry
+ * - Converting Bezier control points to THREE.Shape / CurvePath
+ * - Mesh-based stroke ring construction with miter joins
+ * - Point-in-polygon and linearity tests
+ */
+import * as THREE from 'three';
+/**
+ * Check if a cubic Bezier segment is nearly linear by measuring the maximum
+ * distance from handles to the chord (p0 -> p3).
+ */
+export declare function isNearlyLinear(p0: number[], p1: number[], p2: number[], p3: number[]): boolean;
+/**
+ * Sample Bezier curves for smooth rendering.
+ * Uses adaptive sampling: nearly-linear segments (from prepareForNonlinearTransform)
+ * use only their endpoints, avoiding expensive per-sample Bezier evaluation.
+ *
+ * @param points - Bezier control points
+ * @param samplesPerSegment - Number of samples per curved Bezier segment
+ * @returns Sampled points along the path
+ */
+export declare function sampleBezierPath(points: number[][], samplesPerSegment?: number): number[][];
+/**
+ * Sample the Bezier path into a 2D polyline suitable for earcut triangulation.
+ *
+ * This is similar to sampleBezierPath but returns [x, y] pairs (no z) and
+ * skips duplicate-point de-duplication at segment boundaries (earcut handles
+ * that correctly and de-dup can introduce off-by-one for hole indices).
+ */
+export declare function sampleBezierOutline(points: number[][], samplesPerSegment: number): number[][];
+/**
+ * Ray-casting point-in-polygon test (2D).
+ * Returns true if point is inside the polygon ring.
+ */
+export declare function pointInPolygon(point: number[], ring: number[][]): boolean;
+/**
+ * Convert Bezier control points to a Three.js Shape for filled rendering.
+ * @param visiblePoints - The visible points as 2D Point objects
+ * @returns THREE.Shape representing the path
+ */
+export declare function pointsToShape(visiblePoints: Point[]): THREE.Shape;
+/**
+ * Convert points to a THREE.CurvePath for stroke rendering
+ * @param visiblePoints3D - The visible points as 3D arrays
+ */
+export declare function pointsToCurvePath(visiblePoints3D: number[][]): THREE.CurvePath<THREE.Vector3>;
+/**
+ * Build a THREE.BufferGeometry for the filled region using earcut triangulation.
+ *
+ * Earcut handles concave polygons, self-intersecting paths, and holes far
+ * more robustly than Three.js' built-in ShapeGeometry triangulator.
+ *
+ * If earcut returns zero triangles (completely degenerate input) we fall
+ * back to THREE.ShapeGeometry so existing simple shapes still render.
+ *
+ * @param points3D - The visible Bezier control points
+ * @param visiblePoints - 2D points for fallback shape
+ * @param getSubpaths - Optional function to get subpath lengths for compound paths
+ * @returns A BufferGeometry or null if too degenerate
+ */
+export declare function buildEarcutFillGeometry(points3D: number[][], visiblePoints: Point[], getSubpaths?: () => number[]): THREE.BufferGeometry | null;
+/**
+ * Build mesh-based stroke geometry from a closed sampled path.
+ * Uses miter joins at corners for pixel-perfect sharp corners.
+ *
+ * @param group - The THREE.Group for world matrix computation
+ * @param sampledPoints - Sampled path points
+ * @param strokeWidth - Stroke width
+ * @param opacity - Current opacity
+ * @returns BufferGeometry and index data, or null if insufficient points
+ */
+export declare function buildMeshStrokeGeometry(group: THREE.Group, sampledPoints: number[][], strokeWidth: number, opacity: number): {
+    geometry: THREE.BufferGeometry;
+} | null;
+/**
+ * Check if the Bezier control points form a closed path (first ~ last anchor).
+ */
+export declare function isClosedPath(points3D: number[][]): boolean;
+//# sourceMappingURL=VMobjectGeometry.d.ts.map

package/dist/core/VMobjectGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VMobjectGeometry.d.ts","sourceRoot":"","sources":["../../src/core/VMobjectGeometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAM9C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,CAa9F;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAE,MAAU,GAAG,MAAM,EAAE,EAAE,CAqC9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAoC7F;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAazE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CA8BjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAoD7F;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAAE,EAAE,EACpB,aAAa,EAAE,KAAK,EAAE,EACtB,WAAW,CAAC,EAAE,MAAM,MAAM,EAAE,GAC3B,KAAK,CAAC,cAAc,GAAG,IAAI,CAkC7B;AAkFD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,aAAa,EAAE,MAAM,EAAE,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAA;CAAE,GAAG,IAAI,CAuJ3C;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAQ1D"}