manim-web 0.2.0

package/dist/core/StateManager.d.ts

@@ -0,0 +1,193 @@
+import { Mobject, MobjectStyle } from './Mobject';
+import { Point } from './VMobject';
+/**
+ * JSON-serializable snapshot of a single mobject's visual state.
+ * Captures position, rotation, scale, style, and VMobject-specific data.
+ */
+export interface MobjectState {
+    /** Mobject id at time of capture (used for lookup during restore) */
+    id: string;
+    /** Position [x, y, z] */
+    position: [number, number, number];
+    /** Euler rotation [x, y, z, order] */
+    rotation: [number, number, number, string];
+    /** Scale [x, y, z] */
+    scale: [number, number, number];
+    /** CSS color string */
+    color: string;
+    /** Overall stroke opacity 0-1 */
+    opacity: number;
+    /** Stroke width */
+    strokeWidth: number;
+    /** Fill opacity 0-1 */
+    fillOpacity: number;
+    /** Full style object */
+    style: MobjectStyle;
+    /** 2D points [{x,y}, ...] */
+    points2D?: Point[];
+    /** 3D Bezier control points [[x,y,z], ...] */
+    points3D?: number[][];
+    /** Visible point count (null means all) */
+    visiblePointCount?: number | null;
+    /** Recursively captured child states */
+    children: MobjectState[];
+    /** Optional user-supplied custom data */
+    custom?: Record<string, unknown>;
+}
+/**
+ * A full scene snapshot: an ordered array of top-level mobject states.
+ */
+export interface SceneSnapshot {
+    /** Human-readable label (optional) */
+    label?: string;
+    /** Timestamp (ms) when snapshot was taken */
+    timestamp: number;
+    /** Ordered array of top-level mobject states (one per scene mobject) */
+    mobjects: MobjectState[];
+}
+/**
+ * Capture a JSON-serializable snapshot of a mobject and its hierarchy.
+ * Non-destructive: does not modify the mobject in any way.
+ *
+ * @param mob - The mobject to serialize
+ * @returns A deep, JSON-safe MobjectState
+ */
+export declare function serializeMobject(mob: Mobject): MobjectState;
+/**
+ * Restore a mobject's properties from a previously captured state.
+ * Applies position, rotation, scale, style, and VMobject points.
+ * Does NOT add/remove children -- it restores properties of existing children
+ * matched by array index (same order as when serialized).
+ *
+ * @param mob - The mobject to restore
+ * @param state - The state to apply
+ */
+export declare function deserializeMobject(mob: Mobject, state: MobjectState): void;
+/**
+ * Convert a MobjectState to a plain JSON string.
+ * Useful for persisting to localStorage or sending over the network.
+ */
+export declare function stateToJSON(state: MobjectState): string;
+/**
+ * Parse a JSON string back into a MobjectState.
+ */
+export declare function stateFromJSON(json: string): MobjectState;
+/**
+ * Convert a SceneSnapshot to a plain JSON string.
+ */
+export declare function snapshotToJSON(snapshot: SceneSnapshot): string;
+/**
+ * Parse a JSON string back into a SceneSnapshot.
+ */
+export declare function snapshotFromJSON(json: string): SceneSnapshot;
+/**
+ * Manages undo/redo state for a collection of mobjects (typically a Scene).
+ *
+ * Usage:
+ * ```ts
+ * const mgr = new SceneStateManager(scene.mobjects);
+ * mgr.save();          // push current state onto undo stack
+ * // ... user makes edits ...
+ * mgr.undo();          // restore previous state
+ * mgr.redo();          // re-apply the undone edit
+ * ```
+ *
+ * The manager does not own the mobjects -- it reads/writes them through
+ * a getter so that additions/removals from the scene are reflected.
+ */
+export declare class SceneStateManager {
+    /** Maximum number of undo entries. Oldest are discarded when exceeded. */
+    readonly maxDepth: number;
+    /** Undo stack (newest on top) */
+    private _undoStack;
+    /** Redo stack (newest on top, cleared on new save) */
+    private _redoStack;
+    /**
+     * Function that returns the current ordered set of scene mobjects.
+     * We store a getter rather than a static list so the manager always
+     * reflects the live scene contents.
+     */
+    private _getMobjects;
+    /**
+     * @param getMobjects - Getter returning the current scene mobjects (ordered)
+     * @param maxDepth - Maximum undo stack depth (default 50)
+     */
+    constructor(getMobjects: () => Mobject[], maxDepth?: number);
+    /**
+     * Capture the current scene state and push it onto the undo stack.
+     * Clears the redo stack (new action branch).
+     *
+     * @param label - Optional human-readable label for this snapshot
+     * @returns The captured SceneSnapshot (for inspection / persistence)
+     */
+    save(label?: string): SceneSnapshot;
+    /**
+     * Undo: restore the most recently saved state.
+     * Pushes the current state onto the redo stack first.
+     *
+     * @returns true if undo was applied, false if nothing to undo
+     */
+    undo(): boolean;
+    /**
+     * Redo: re-apply the last undone state.
+     * Pushes the current state onto the undo stack first.
+     *
+     * @returns true if redo was applied, false if nothing to redo
+     */
+    redo(): boolean;
+    /**
+     * Get a snapshot of the current scene state without pushing it
+     * onto any stack.
+     */
+    getState(label?: string): SceneSnapshot;
+    /**
+     * Apply a previously captured snapshot, overwriting the current scene
+     * state. Does NOT modify undo/redo stacks -- call save() first if you
+     * want the current state preserved.
+     */
+    setState(snapshot: SceneSnapshot): void;
+    /**
+     * Clear both undo and redo stacks.
+     */
+    clearHistory(): void;
+    /** Number of available undo steps */
+    get undoCount(): number;
+    /** Number of available redo steps */
+    get redoCount(): number;
+    /** Whether undo is available */
+    get canUndo(): boolean;
+    /** Whether redo is available */
+    get canRedo(): boolean;
+    /** Read-only view of the undo stack (newest last) */
+    get undoStack(): ReadonlyArray<SceneSnapshot>;
+    /** Read-only view of the redo stack (newest last) */
+    get redoStack(): ReadonlyArray<SceneSnapshot>;
+    private _captureSnapshot;
+    private _applySnapshot;
+}
+/**
+ * Save the current state of a mobject using JSON-serializable snapshots.
+ * Stores:
+ * - A JSON-serializable MobjectState on `mob.__savedMobjectState`
+ * - A deep copy on `mob.savedState` (for Restore animation compatibility)
+ *
+ * This is the functional counterpart to `mob.saveState()`. Both produce
+ * identical results; use whichever API style you prefer.
+ *
+ * @param mob - The mobject to save
+ * @returns The captured MobjectState
+ */
+export declare function saveMobjectState(mob: Mobject): MobjectState;
+/**
+ * Restore a mobject from its JSON-serializable saved state
+ * (from saveMobjectState or serializeMobject).
+ *
+ * This is the functional counterpart to `mob.restoreState()`.
+ * Unlike the class method which uses the deep-copy path,
+ * this function uses the JSON-serializable MobjectState.
+ *
+ * @param mob - The mobject to restore
+ * @returns true if state was restored, false if no saved state exists
+ */
+export declare function restoreMobjectState(mob: Mobject): boolean;
+//# sourceMappingURL=StateManager.d.ts.map

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

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

package/dist/core/VDict.d.ts

@@ -0,0 +1,229 @@
+import { VMobject } from './VMobject';
+import { VGroup } from './VGroup';
+import { Vector3Tuple } from './Mobject';
+/**
+ * VDict and VectorizedPoint classes for dictionary-based VMobject access
+ * and single-point VMobjects.
+ */
+import * as THREE from 'three';
+/**
+ * VDict provides dictionary-like access to named VMobjects.
+ * Useful for creating complex structures with named parts.
+ *
+ * The submobjects are the dictionary values, allowing iteration
+ * and group operations while maintaining named access.
+ *
+ * @example
+ * ```typescript
+ * const face = new VDict({
+ *   leftEye: new Circle({ radius: 0.2 }),
+ *   rightEye: new Circle({ radius: 0.2 }),
+ *   mouth: new Arc({ angle: Math.PI }),
+ * });
+ *
+ * // Access by name
+ * face.get('leftEye')?.setColor('blue');
+ *
+ * // Iterate over entries
+ * for (const [name, vmobject] of face.entries()) {
+ *   console.log(name, vmobject);
+ * }
+ * ```
+ */
+export declare class VDict extends VGroup {
+    /**
+     * Internal dictionary mapping names to VMobjects.
+     */
+    private _dict;
+    /**
+     * Create a VDict from a dictionary of named VMobjects.
+     * @param items - Object mapping names to VMobjects
+     */
+    constructor(items?: Record<string, VMobject>);
+    /**
+     * Get a VMobject by key (string) or index (number).
+     * Overrides VGroup.get() to support both access patterns.
+     * @param keyOrIndex - Name/key of the VMobject (string) or index (number)
+     * @returns The VMobject, or undefined if not found
+     */
+    get(keyOrIndex: string | number): VMobject | undefined;
+    /**
+     * Set a VMobject with a name. If a VMobject with this name already exists,
+     * it will be replaced.
+     * @param key - Name/key for the VMobject
+     * @param vmobject - VMobject to add
+     * @returns this for chaining
+     */
+    set(key: string, vmobject: VMobject): this;
+    /**
+     * Check if a key exists in the VDict.
+     * @param key - Name/key to check
+     * @returns true if the key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Remove a VMobject by key from this VDict.
+     * @param key - Name/key of the VMobject to remove
+     * @returns true if an element was removed, false otherwise
+     */
+    delete(key: string): boolean;
+    /**
+     * Get all keys in the VDict.
+     * @returns Iterator of keys
+     */
+    keys(): IterableIterator<string>;
+    /**
+     * Get all VMobjects in the VDict.
+     * @returns Iterator of VMobjects
+     */
+    values(): IterableIterator<VMobject>;
+    /**
+     * Get all entries as [key, VMobject] pairs.
+     * @returns Iterator of [key, VMobject] tuples
+     */
+    entries(): IterableIterator<[string, VMobject]>;
+    /**
+     * Iterate over vmobjects with a callback.
+     * Overrides VGroup.forEach() to match parent signature.
+     * @param fn - Callback function receiving (vmobject, index)
+     * @returns this for chaining
+     */
+    forEach(fn: (vmobject: VMobject, index: number) => void): this;
+    /**
+     * Iterate over entries with a callback (dict-style).
+     * @param fn - Callback function receiving (vmobject, key, dict)
+     * @returns this for chaining
+     */
+    forEachEntry(fn: (vmobject: VMobject, key: string, dict: VDict) => void): this;
+    /**
+     * Clear all entries from the VDict.
+     * @returns this for chaining
+     */
+    clear(): this;
+    /**
+     * Get the number of named items.
+     */
+    get size(): number;
+    /**
+     * Allow bracket-style access via proxy.
+     * Note: This creates a proxy wrapper. For performance-critical code,
+     * use the get() method directly.
+     * @returns A proxy allowing bracket access like vdict['key']
+     */
+    asProxy(): VDict & {
+        [key: string]: VMobject | undefined;
+    };
+    /**
+     * Create a copy of this VDict.
+     */
+    protected _createCopy(): VMobject;
+    /**
+     * Override copy to properly handle the dictionary mapping.
+     */
+    copy(): VMobject;
+    /**
+     * Add a named VMobject to this VDict (alias for set).
+     * @param name - Name/key for the VMobject
+     * @param vmobject - VMobject to add
+     * @returns this for chaining
+     * @deprecated Use set() instead
+     */
+    addNamed(name: string, vmobject: VMobject): this;
+    /**
+     * Remove a named VMobject from this VDict (alias for delete).
+     * @param name - Name/key of the VMobject to remove
+     * @returns this for chaining
+     * @deprecated Use delete() instead
+     */
+    removeNamed(name: string): this;
+    /**
+     * Get a VMobject by name (alias for get with string key).
+     * @param name - Name/key of the VMobject
+     * @returns The VMobject, or undefined if not found
+     * @deprecated Use get() instead
+     */
+    getItem(name: string): VMobject | undefined;
+    /**
+     * Alias for get - get a VMobject by name.
+     * @param name - Name/key of the VMobject
+     * @returns The VMobject, or undefined if not found
+     * @deprecated Use get() instead
+     */
+    getByName(name: string): VMobject | undefined;
+}
+/**
+ * VectorizedPoint represents a single point as a VMobject.
+ *
+ * Useful as a location marker, invisible anchor, or for
+ * tracking positions in animations.
+ *
+ * Unlike a regular VMobject, VectorizedPoint has no stroke or fill
+ * by default - it's invisible but still has a position.
+ *
+ * @example
+ * ```typescript
+ * // Create a point at the origin
+ * const marker = new VectorizedPoint();
+ *
+ * // Create a point at a specific location
+ * const p = new VectorizedPoint([2, 3, 0]);
+ *
+ * // Get and set location
+ * console.log(p.getLocation()); // [2, 3, 0]
+ * p.setLocation([4, 5, 0]);
+ * ```
+ */
+export declare class VectorizedPoint extends VMobject {
+    /**
+     * Create a VectorizedPoint at the given location.
+     * @param location - The point location as [x, y, z], defaults to [0, 0, 0]
+     */
+    constructor(location?: Vector3Tuple);
+    /**
+     * Get the location of this point.
+     * @returns The location as [x, y, z]
+     */
+    getLocation(): Vector3Tuple;
+    /**
+     * Set the location of this point.
+     * @param point - The new location as [x, y, z]
+     * @returns this for chaining
+     */
+    setLocation(point: Vector3Tuple): this;
+    /**
+     * Get the center of this point (same as getLocation).
+     * @returns The location as [x, y, z]
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Move this point to a new location.
+     * @param point - Target position [x, y, z]
+     * @returns this for chaining
+     */
+    moveTo(point: Vector3Tuple): this;
+    /**
+     * Shift this point by a delta.
+     * @param delta - Translation vector [x, y, z]
+     * @returns this for chaining
+     */
+    shift(delta: Vector3Tuple): this;
+    /**
+     * Create the Three.js backing object.
+     * VectorizedPoint is invisible, so we just create an empty group.
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync to Three.js - update position.
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Create a copy of this VectorizedPoint.
+     */
+    protected _createCopy(): VMobject;
+    /**
+     * Copy this VectorizedPoint.
+     */
+    copy(): VMobject;
+}
+export default VDict;
+//# sourceMappingURL=VDict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VDict.d.ts","sourceRoot":"","sources":["../../src/core/VDict.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,KAAM,SAAQ,MAAM;IAC/B;;OAEG;IACH,OAAO,CAAC,KAAK,CAAoC;IAEjD;;;OAGG;gBACS,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;IAQhD;;;;;OAKG;IACM,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQ/D;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAW1C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAU5B;;;OAGG;IACH,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC;;;OAGG;IACH,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC;IAIpC;;;OAGG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAI/C;;;;;OAKG;IACM,OAAO,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIvE;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAK9E;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,OAAO,IAAI,KAAK,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;KAAE;IAyB1D;;OAEG;cACgB,WAAW,IAAI,QAAQ;IAI1C;;OAEG;IACM,IAAI,IAAI,QAAQ;IA2BzB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIhD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI3C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAG9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C;;;OAGG;gBACS,QAAQ,GAAE,YAAwB;IAc9C;;;OAGG;IACH,WAAW,IAAI,YAAY;IAQ3B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAOtC;;;OAGG;IACM,SAAS,IAAI,YAAY;IAIlC;;;;OAIG;IACM,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAI1C;;;;OAIG;IACM,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IASzC;;;OAGG;cACgB,kBAAkB,IAAI,KAAK,CAAC,QAAQ;IAQvD;;OAEG;cACgB,oBAAoB,IAAI,IAAI;IAO/C;;OAEG;cACgB,WAAW,IAAI,QAAQ;IAI1C;;OAEG;IACM,IAAI,IAAI,QAAQ;CAG1B;AAED,eAAe,KAAK,CAAC"}

package/dist/core/VGroup.d.ts

@@ -0,0 +1,200 @@
+import { Mobject, Vector3Tuple } from './Mobject';
+import { VMobject, Point } from './VMobject';
+/**
+ * VGroup class for grouping VMobjects.
+ * VGroup extends VMobject to provide specialized grouping for vectorized mobjects.
+ */
+import * as THREE from 'three';
+/**
+ * VGroup is a specialized group for VMobjects.
+ * Operations apply to all children, and paths can be combined.
+ */
+export declare class VGroup extends VMobject {
+    /**
+     * Create a new VGroup containing the given mobjects.
+     * Accepts both VMobjects and general Mobjects (e.g., Axes, Group).
+     * @param mobjects - Mobjects to add to the group
+     */
+    constructor(...mobjects: Mobject[]);
+    /**
+     * Add VMobjects to this group.
+     * Accepts VMobjects or arrays of VMobjects.
+     * @param vmobjects - VMobjects to add
+     * @returns this for chaining
+     */
+    addVMobjects(...vmobjects: (VMobject | VMobject[])[]): this;
+    /**
+     * Add mobjects to this group (override from Mobject).
+     * @param mobjects - Mobjects to add
+     * @returns this for chaining
+     */
+    add(...mobjects: Mobject[]): this;
+    /**
+     * Add a single VMobject to this group.
+     */
+    private _addSingleVMobject;
+    /**
+     * Remove VMobjects from this group.
+     * @param vmobjects - VMobjects to remove
+     * @returns this for chaining
+     */
+    removeVMobjects(...vmobjects: VMobject[]): this;
+    /**
+     * Remove mobjects from this group (override from Mobject).
+     * @param mobjects - Mobjects to remove
+     * @returns this for chaining
+     */
+    remove(...mobjects: Mobject[]): this;
+    /**
+     * Get the center of the group (average of all children centers).
+     * @returns Center position as [x, y, z]
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Shift all children by the given delta.
+     * Only shifts children's internal positions, not the group's own position,
+     * to avoid double-counting in THREE.js hierarchy.
+     * @param delta - Translation vector [x, y, z]
+     * @returns this for chaining
+     */
+    shift(delta: Vector3Tuple): this;
+    /**
+     * Move the group center to the given point, or align with another Mobject.
+     * @param target - Target position [x, y, z] or Mobject to align with
+     * @param alignedEdge - Optional edge direction to align (e.g., UL aligns upper-left edges)
+     * @returns this for chaining
+     */
+    moveTo(target: Vector3Tuple | Mobject, alignedEdge?: Vector3Tuple): this;
+    /**
+     * Rotate all children around an axis.
+     * @param angle - Rotation angle in radians
+     * @param axis - Axis of rotation [x, y, z], defaults to Z axis
+     * @returns this for chaining
+     */
+    rotate(angle: number, axis?: Vector3Tuple): this;
+    /**
+     * Scale all children about the group's center.
+     * Each child's size is scaled, and their positions are repositioned
+     * relative to the group center — matching Manim Python behavior.
+     * Does not change the group's own scaleVector.
+     * @param factor - Scale factor (number for uniform, tuple for non-uniform)
+     * @returns this for chaining
+     */
+    scale(factor: number | Vector3Tuple): this;
+    /**
+     * Set the color of all children.
+     * @param color - CSS color string
+     * @returns this for chaining
+     */
+    setColor(color: string): this;
+    /**
+     * Set the opacity of all children.
+     * @param opacity - Opacity value (0-1)
+     * @returns this for chaining
+     */
+    setOpacity(opacity: number): this;
+    /**
+     * Set the stroke width of all children.
+     * @param width - Stroke width in pixels
+     * @returns this for chaining
+     */
+    setStrokeWidth(width: number): this;
+    /**
+     * Set the fill opacity of all children.
+     * @param opacity - Fill opacity (0-1)
+     * @returns this for chaining
+     */
+    setFillOpacity(opacity: number): this;
+    /**
+     * Set the fill color of all children.
+     * @param color - CSS color string
+     * @returns this for chaining
+     */
+    setFill(color?: string, opacity?: number): this;
+    /**
+     * Set the stroke of all children.
+     * @param color - CSS color string
+     * @param width - Stroke width in pixels
+     * @param opacity - Stroke opacity (0-1)
+     * @returns this for chaining
+     */
+    setStroke(color?: string, width?: number, opacity?: number): this;
+    /**
+     * Arrange children in a row or column with specified spacing.
+     * @param direction - Direction to arrange (e.g., RIGHT for row, DOWN for column)
+     * @param buff - Buffer/spacing between children, default 0.25
+     * @param center - Whether to center the arrangement at the group's position, default true
+     * @returns this for chaining
+     */
+    arrange(direction?: Vector3Tuple, buff?: number, center?: boolean): this;
+    /**
+     * Arrange children in a grid layout.
+     * @param rows - Number of rows (if not specified, auto-calculated)
+     * @param cols - Number of columns (if not specified, auto-calculated)
+     * @param buffX - Horizontal buffer between elements, default 0.25
+     * @param buffY - Vertical buffer between elements, default 0.25
+     * @returns this for chaining
+     */
+    arrangeInGrid(rows?: number, cols?: number, buffX?: number, buffY?: number): this;
+    /**
+     * Arrange children in a submobject grid (alias for arrangeInGrid).
+     */
+    arrangeSubmobjects(rows?: number, cols?: number, buffX?: number, buffY?: number): this;
+    /**
+     * Get combined path points from all children.
+     * @returns Combined array of points from all children
+     */
+    getCombinedPoints(): number[][];
+    /**
+     * Create the Three.js backing object for this VGroup.
+     * A VGroup is simply a THREE.Group that contains children.
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Create a copy of this VGroup.
+     */
+    protected _createCopy(): VMobject;
+    /**
+     * Get the number of vmobjects in this group.
+     */
+    get length(): number;
+    /**
+     * Get a vmobject by index.
+     * @param index - Index of the vmobject
+     * @returns The vmobject at the given index, or undefined
+     */
+    get(index: number): VMobject | undefined;
+    /**
+     * Iterate over all vmobjects in the group.
+     */
+    [Symbol.iterator](): Iterator<VMobject>;
+    /**
+     * Apply a function to each vmobject in the group.
+     * @param fn - Function to apply
+     * @returns this for chaining
+     */
+    forEach(fn: (vmobject: VMobject, index: number) => void): this;
+    /**
+     * Map over all vmobjects in the group.
+     * @param fn - Mapping function
+     * @returns Array of mapped values
+     */
+    map<T>(fn: (vmobject: VMobject, index: number) => T): T[];
+    /**
+     * Filter vmobjects in the group.
+     * @param fn - Filter predicate
+     * @returns New VGroup with filtered vmobjects
+     */
+    filter(fn: (vmobject: VMobject, index: number) => boolean): VGroup;
+    /**
+     * Get all points from the VGroup as a flat array (override VMobject).
+     * Returns combined points from all children.
+     */
+    get points(): Point[];
+    /**
+     * Get all 3D points from the VGroup.
+     */
+    getPoints(): number[][];
+}
+export default VGroup;
+//# sourceMappingURL=VGroup.d.ts.map

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

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