manim-web 0.2.0

package/dist/interaction/SelectionManager.d.ts

@@ -0,0 +1,125 @@
+import { Mobject } from '../core/Mobject';
+import { Scene } from '../core/Scene';
+/**
+ * Options for configuring the SelectionManager.
+ */
+export interface SelectionManagerOptions {
+    /** Color of the selection highlight outline. Defaults to '#FFFF00' (yellow). */
+    highlightColor?: string;
+    /** Width of the selection highlight outline. Defaults to 2. */
+    highlightWidth?: number;
+    /** Opacity of the box selection overlay. Defaults to 0.15. */
+    boxSelectOpacity?: number;
+    /** Color of the box selection overlay. Defaults to '#58C4DD' (manim blue). */
+    boxSelectColor?: string;
+    /** Callback when selection changes. */
+    onSelectionChange?: (selected: ReadonlySet<Mobject>) => void;
+}
+/**
+ * Manages interactive selection of mobjects in a Scene.
+ *
+ * Attach to a Scene to enable click-to-select, shift-multi-select,
+ * and box/lasso selection with visual feedback.
+ */
+export declare class SelectionManager {
+    private _scene;
+    private _selected;
+    private _options;
+    private _enabled;
+    private _raycaster;
+    private _mouse;
+    private _highlights;
+    private _isBoxSelecting;
+    private _boxStart;
+    private _boxOverlay;
+    private _dragThreshold;
+    private _onMouseDown;
+    private _onMouseMove;
+    private _onMouseUp;
+    private _onKeyDown;
+    /**
+     * Create a new SelectionManager.
+     * @param scene - The Scene whose mobjects can be selected
+     * @param options - Configuration options
+     */
+    constructor(scene: Scene, options?: SelectionManagerOptions);
+    /** Currently selected mobjects (read-only view). */
+    get selected(): ReadonlySet<Mobject>;
+    /** Number of currently selected mobjects. */
+    get count(): number;
+    /** Whether the manager is enabled. */
+    get isEnabled(): boolean;
+    /** Enable selection interactions. */
+    enable(): void;
+    /** Disable selection interactions. Clears current selection. */
+    disable(): void;
+    /**
+     * Programmatically select one or more mobjects.
+     * @param mobjects - Mobjects to select
+     */
+    select(...mobjects: Mobject[]): void;
+    /**
+     * Programmatically deselect one or more mobjects.
+     * @param mobjects - Mobjects to deselect
+     */
+    deselect(...mobjects: Mobject[]): void;
+    /**
+     * Toggle selection state of a mobject.
+     * @param mob - Mobject to toggle
+     */
+    toggleSelect(mob: Mobject): void;
+    /**
+     * Select all mobjects currently in the scene.
+     */
+    selectAll(): void;
+    /**
+     * Deselect all mobjects, removing all highlights.
+     */
+    deselectAll(): void;
+    /**
+     * Check if a specific mobject is selected.
+     */
+    isSelected(mob: Mobject): boolean;
+    /**
+     * Get selected mobjects as an array (ordered by selection time).
+     */
+    getSelectedArray(): Mobject[];
+    /**
+     * Clean up event listeners and highlights.
+     */
+    dispose(): void;
+    private _setupEventListeners;
+    private _teardownEventListeners;
+    private _handleMouseDown;
+    private _handleMouseMove;
+    private _handleMouseUp;
+    private _handleClick;
+    private _handleKeyDown;
+    private _createBoxOverlay;
+    private _updateBoxOverlay;
+    private _removeBoxOverlay;
+    private _finishBoxSelect;
+    /**
+     * Pick the topmost scene mobject under the given screen coordinates.
+     * Uses Three.js Raycaster for accurate intersection testing.
+     */
+    private _pickMobject;
+    /**
+     * Find the scene-level Mobject that owns a Three.js object.
+     */
+    private _findOwnerMobject;
+    /**
+     * Fallback bounding-box pick for mobjects that don't register raycaster hits.
+     */
+    private _boundingBoxPick;
+    private _addHighlight;
+    private _removeHighlight;
+    /**
+     * Refresh highlight positions for all selected mobjects.
+     * Call this after moving/transforming selected mobjects.
+     */
+    refreshHighlights(): void;
+    private _screenToWorld;
+    private _notifyChange;
+}
+//# sourceMappingURL=SelectionManager.d.ts.map

package/dist/interaction/SelectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionManager.d.ts","sourceRoot":"","sources":["../../src/interaction/SelectionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAiB;IAGjC,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,MAAM,CAAsC;IAGpD,OAAO,CAAC,WAAW,CAA+C;IAGlE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,WAAW,CAA+B;IAGlD,OAAO,CAAC,cAAc,CAAa;IAGnC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAA6B;IAE/C;;;;OAIG;gBACS,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,uBAA4B;IAsB/D,oDAAoD;IACpD,IAAI,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,CAEnC;IAED,6CAA6C;IAC7C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,sCAAsC;IACtC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qCAAqC;IACrC,MAAM,IAAI,IAAI;IAId,gEAAgE;IAChE,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,MAAM,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAUpC;;;OAGG;IACH,QAAQ,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAUtC;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAQhC;;OAEG;IACH,SAAS,IAAI,IAAI;IAUjB;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAIjC;;OAEG;IACH,gBAAgB,IAAI,OAAO,EAAE;IAI7B;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAiCxB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,aAAa;IA0DrB,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,aAAa;CAGtB"}

package/dist/interaction/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Interaction module for manimweb.
+ * Provides UI controls for interactive scene manipulation and playback.
+ */
+export { Controls, type ControlsOptions, type ControlsPosition, type ControlsTheme, type SliderConfig, type ButtonConfig, type CheckboxConfig, type ColorPickerConfig, } from './Controls';
+export { PlaybackControls, type PlaybackControlsOptions, type TimeUpdateCallback, } from './PlaybackControls';
+export { Draggable, makeDraggable, type DraggableOptions } from './Draggable';
+export { Hoverable, makeHoverable, type HoverableOptions } from './Hoverable';
+export { Clickable, makeClickable, type ClickableOptions } from './Clickable';
+export { SelectionManager, type SelectionManagerOptions } from './SelectionManager';
+export { OrbitControls, type OrbitControlsOptions } from './OrbitControls';
+//# sourceMappingURL=index.d.ts.map

package/dist/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mobjects/fractals/MandelbrotSet.d.ts

@@ -0,0 +1,92 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import * as THREE from 'three';
+/**
+ * Options for creating a MandelbrotSet visualization
+ */
+export interface MandelbrotSetOptions {
+    /** Width of the render plane in world units. Default: 8 */
+    width?: number;
+    /** Height of the render plane in world units. Default: 6 */
+    height?: number;
+    /** Center of the view in the complex plane [re, im]. Default: [-0.5, 0] */
+    center?: [number, number];
+    /** Zoom level (higher = more zoomed in). Default: 1 */
+    zoom?: number;
+    /** Maximum iteration count. Default: 100 */
+    maxIterations?: number;
+    /** Saturation for HSL-based coloring (0-1). Default: 0.8 */
+    saturation?: number;
+    /** Lightness for HSL-based coloring (0-1). Default: 0.5 */
+    lightness?: number;
+    /** Opacity (0-1). Default: 1 */
+    opacity?: number;
+}
+/**
+ * MandelbrotSet -- GPU-accelerated Mandelbrot set visualisation.
+ *
+ * Renders the classic Mandelbrot fractal on a full-screen quad using a custom
+ * GLSL fragment shader.  All view parameters (center, zoom, maxIterations)
+ * are exposed as animatable uniforms so they can be driven by the Timeline.
+ *
+ * @example
+ * ```typescript
+ * const mandelbrot = new MandelbrotSet({
+ *   width: 8,
+ *   height: 6,
+ *   center: [-0.5, 0],
+ *   zoom: 1,
+ *   maxIterations: 200,
+ * });
+ * scene.add(mandelbrot);
+ *
+ * // Animate a zoom into a region
+ * mandelbrot.setCenter([-0.7435, 0.1314]);
+ * mandelbrot.setZoom(500);
+ * ```
+ */
+export declare class MandelbrotSet extends Mobject {
+    private _width;
+    private _height;
+    private _center;
+    private _zoom;
+    private _maxIterations;
+    private _saturation;
+    private _lightness;
+    private _material;
+    constructor(options?: MandelbrotSetOptions);
+    protected _createThreeObject(): THREE.Object3D;
+    protected _syncMaterialToThree(): void;
+    /** Set the center of the view in the complex plane. */
+    setCenter(center: [number, number]): this;
+    /** Get the current view center. */
+    getCenter(): Vector3Tuple;
+    /** Set the zoom level (higher = more zoomed in). */
+    setZoom(zoom: number): this;
+    /** Get the current zoom level. */
+    getZoom(): number;
+    /** Set the maximum number of iterations. */
+    setMaxIterations(maxIter: number): this;
+    /** Get the maximum number of iterations. */
+    getMaxIterations(): number;
+    /** Set HSL saturation (0-1). */
+    setSaturation(s: number): this;
+    /** Get HSL saturation. */
+    getSaturation(): number;
+    /** Set HSL lightness (0-1). */
+    setLightness(l: number): this;
+    /** Get HSL lightness. */
+    getLightness(): number;
+    /** Set the display width in world units. */
+    setWidth(w: number): this;
+    /** Get the display width. */
+    getWidth(): number;
+    /** Set the display height in world units. */
+    setHeight(h: number): this;
+    /** Get the display height. */
+    getHeight(): number;
+    protected _createCopy(): MandelbrotSet;
+    /** Free GPU resources. */
+    dispose(): void;
+}
+export default MandelbrotSet;
+//# sourceMappingURL=MandelbrotSet.d.ts.map

package/dist/mobjects/fractals/MandelbrotSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MandelbrotSet.d.ts","sourceRoot":"","sources":["../../../src/mobjects/fractals/MandelbrotSet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6ED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAqC;gBAE1C,OAAO,GAAE,oBAAyB;IA6B9C,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cA0B3B,oBAAoB,IAAI,IAAI;IAmB/C,uDAAuD;IACvD,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC,mCAAmC;IAC1B,SAAS,IAAI,YAAY;IAIlC,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,kCAAkC;IAClC,OAAO,IAAI,MAAM;IAIjB,4CAA4C;IAC5C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC,4CAA4C;IAC5C,gBAAgB,IAAI,MAAM;IAI1B,gCAAgC;IAChC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9B,0BAA0B;IAC1B,aAAa,IAAI,MAAM;IAIvB,+BAA+B;IAC/B,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7B,yBAAyB;IACzB,YAAY,IAAI,MAAM;IAItB,4CAA4C;IAC5C,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzB,6BAA6B;IAC7B,QAAQ,IAAI,MAAM;IAIlB,6CAA6C;IAC7C,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM1B,8BAA8B;IAC9B,SAAS,IAAI,MAAM;cAQA,WAAW,IAAI,aAAa;IAiB/C,0BAA0B;IAC1B,OAAO,IAAI,IAAI;CAShB;AAED,eAAe,aAAa,CAAC"}

package/dist/mobjects/fractals/NewtonFractal.d.ts

@@ -0,0 +1,121 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import * as THREE from 'three';
+/**
+ * Options for creating a NewtonFractal visualization
+ */
+export interface NewtonFractalOptions {
+    /** Width of the render plane in world units. Default: 8 */
+    width?: number;
+    /** Height of the render plane in world units. Default: 6 */
+    height?: number;
+    /** Center of the view in the complex plane [re, im]. Default: [0, 0] */
+    center?: [number, number];
+    /** Zoom level (higher = more zoomed in). Default: 1 */
+    zoom?: number;
+    /** Maximum iteration count. Default: 40 */
+    maxIterations?: number;
+    /**
+     * Polynomial coefficients in ascending degree order.
+     * e.g. [-1, 0, 0, 1] represents z^3 - 1  (coeff[0]*z^0 + ... + coeff[3]*z^3).
+     * Default: [-1, 0, 0, 1]  (z^3 - 1)
+     */
+    coefficients?: number[];
+    /** Convergence threshold. Default: 1e-6 */
+    tolerance?: number;
+    /** Root color saturation (0-1). Default: 0.85 */
+    saturation?: number;
+    /** Root color lightness (0-1). Default: 0.5 */
+    lightness?: number;
+    /** Opacity (0-1). Default: 1 */
+    opacity?: number;
+}
+/**
+ * NewtonFractal -- GPU-accelerated Newton's-method fractal visualization.
+ *
+ * Renders a Newton fractal for an arbitrary polynomial in the complex plane.
+ * For each pixel (treated as a complex number z), the shader iterates
+ * Newton's root-finding method z <- z - f(z)/f'(z) and colours based on
+ * which root the iteration converges to and how quickly.
+ *
+ * The default polynomial is z^3 - 1 which has three roots at the cube roots
+ * of unity, producing the classic three-fold symmetric fractal.
+ *
+ * @example
+ * ```typescript
+ * // Default z^3 - 1 fractal
+ * const newton = new NewtonFractal();
+ * scene.add(newton);
+ *
+ * // Custom polynomial z^4 - 1
+ * const quartic = new NewtonFractal({
+ *   coefficients: [-1, 0, 0, 0, 1],
+ *   maxIterations: 60,
+ * });
+ * scene.add(quartic);
+ * ```
+ */
+export declare class NewtonFractal extends Mobject {
+    private _width;
+    private _height;
+    private _center;
+    private _zoom;
+    private _maxIterations;
+    private _coefficients;
+    private _tolerance;
+    private _saturation;
+    private _lightness;
+    private _material;
+    constructor(options?: NewtonFractalOptions);
+    /**
+     * Build the uniform array for polynomial coefficients.
+     * Coefficients are stored as vec2 (re, im) for generality, but the public
+     * API currently only accepts real coefficients.  We zero-pad to MAX_COEFF.
+     */
+    private _buildCoeffUniforms;
+    protected _createThreeObject(): THREE.Object3D;
+    protected _syncMaterialToThree(): void;
+    /** Set the center of the view in the complex plane. */
+    setCenter(center: [number, number]): this;
+    /** Get the current view center. */
+    getCenter(): Vector3Tuple;
+    /** Set the zoom level (higher = more zoomed in). */
+    setZoom(zoom: number): this;
+    /** Get the current zoom level. */
+    getZoom(): number;
+    /** Set the maximum number of iterations. */
+    setMaxIterations(maxIter: number): this;
+    /** Get the maximum number of iterations. */
+    getMaxIterations(): number;
+    /**
+     * Set polynomial coefficients in ascending degree order.
+     * e.g. `[-1, 0, 0, 1]` for z^3 - 1.
+     */
+    setCoefficients(coeffs: number[]): this;
+    /** Get the current polynomial coefficients. */
+    getCoefficients(): number[];
+    /** Set the convergence tolerance. */
+    setTolerance(tol: number): this;
+    /** Get the convergence tolerance. */
+    getTolerance(): number;
+    /** Set HSL saturation (0-1). */
+    setSaturation(s: number): this;
+    /** Get HSL saturation. */
+    getSaturation(): number;
+    /** Set HSL lightness (0-1). */
+    setLightness(l: number): this;
+    /** Get HSL lightness. */
+    getLightness(): number;
+    /** Set the display width in world units. */
+    setWidth(w: number): this;
+    /** Get the display width. */
+    getWidth(): number;
+    /** Set the display height in world units. */
+    setHeight(h: number): this;
+    /** Get the display height. */
+    getHeight(): number;
+    protected _createCopy(): NewtonFractal;
+    /** Free GPU resources. */
+    dispose(): void;
+}
+export default NewtonFractal;
+//# sourceMappingURL=NewtonFractal.d.ts.map

package/dist/mobjects/fractals/NewtonFractal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewtonFractal.d.ts","sourceRoot":"","sources":["../../../src/mobjects/fractals/NewtonFractal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAS3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAqC;gBAE1C,OAAO,GAAE,oBAAyB;IAiC9C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cA6B3B,oBAAoB,IAAI,IAAI;IA6B/C,uDAAuD;IACvD,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzC,mCAAmC;IAC1B,SAAS,IAAI,YAAY;IAIlC,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,kCAAkC;IAClC,OAAO,IAAI,MAAM;IAIjB,4CAA4C;IAC5C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC,4CAA4C;IAC5C,gBAAgB,IAAI,MAAM;IAI1B;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAMvC,+CAA+C;IAC/C,eAAe,IAAI,MAAM,EAAE;IAI3B,qCAAqC;IACrC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM/B,qCAAqC;IACrC,YAAY,IAAI,MAAM;IAItB,gCAAgC;IAChC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9B,0BAA0B;IAC1B,aAAa,IAAI,MAAM;IAIvB,+BAA+B;IAC/B,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7B,yBAAyB;IACzB,YAAY,IAAI,MAAM;IAItB,4CAA4C;IAC5C,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzB,6BAA6B;IAC7B,QAAQ,IAAI,MAAM;IAIlB,6CAA6C;IAC7C,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM1B,8BAA8B;IAC9B,SAAS,IAAI,MAAM;cAQA,WAAW,IAAI,aAAa;IAmB/C,0BAA0B;IAC1B,OAAO,IAAI,IAAI;CAShB;AAED,eAAe,aAAa,CAAC"}

package/dist/mobjects/fractals/index.d.ts

@@ -0,0 +1,3 @@
+export { MandelbrotSet, type MandelbrotSetOptions } from './MandelbrotSet';
+export { NewtonFractal, type NewtonFractalOptions } from './NewtonFractal';
+//# sourceMappingURL=index.d.ts.map

package/dist/mobjects/fractals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/fractals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mobjects/frame/index.d.ts

@@ -0,0 +1,188 @@
+import { Rectangle, RectangleOptions } from '../geometry/Rectangle';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Default 16:9 aspect ratio
+ */
+export declare const DEFAULT_ASPECT_RATIO: number;
+/**
+ * Options for creating a ScreenRectangle
+ */
+export interface ScreenRectangleOptions extends Omit<RectangleOptions, 'width'> {
+    /** Height of the rectangle. Default: 4 */
+    height?: number;
+    /** Aspect ratio (width/height). Default: 16/9 */
+    aspectRatio?: number;
+}
+/**
+ * ScreenRectangle - A rectangle that matches a screen/frame aspect ratio
+ *
+ * Creates a rectangle where the width is calculated from the height and aspect ratio.
+ * Useful for creating screen-like shapes or video frame outlines.
+ *
+ * @example
+ * ```typescript
+ * // Create a 16:9 screen rectangle with height 4
+ * const screen = new ScreenRectangle();
+ *
+ * // Create a 4:3 screen rectangle
+ * const oldScreen = new ScreenRectangle({ aspectRatio: 4/3 });
+ *
+ * // Create a larger screen
+ * const bigScreen = new ScreenRectangle({ height: 6 });
+ * ```
+ */
+export declare class ScreenRectangle extends Rectangle {
+    private _aspectRatio;
+    constructor(options?: ScreenRectangleOptions);
+    /**
+     * Get the aspect ratio of this screen rectangle
+     */
+    getAspectRatio(): number;
+    /**
+     * Set the aspect ratio, recalculating width while keeping height constant
+     */
+    setAspectRatio(ratio: number): this;
+    /**
+     * Override setHeight to maintain aspect ratio
+     */
+    setHeight(value: number): this;
+    /**
+     * Create a copy of this ScreenRectangle
+     */
+    protected _createCopy(): ScreenRectangle;
+}
+/**
+ * Options for creating a FullScreenRectangle
+ */
+export interface FullScreenRectangleOptions {
+    /** Fill color. Default: BLACK (#000000) */
+    color?: string;
+    /** Fill opacity from 0 to 1. Default: 1 */
+    fillOpacity?: number;
+    /** Stroke width in pixels. Default: 0 (no stroke) */
+    strokeWidth?: number;
+    /** Stroke color. Default: same as fill color */
+    strokeColor?: string;
+    /** Frame width in world units. Default: DEFAULT_FRAME_WIDTH (14.222) */
+    frameWidth?: number;
+    /** Frame height in world units. Default: DEFAULT_FRAME_HEIGHT (8) */
+    frameHeight?: number;
+    /** Center position. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+}
+/**
+ * FullScreenRectangle - A rectangle that covers the entire camera frame
+ *
+ * Creates a rectangle sized to match the camera frame dimensions.
+ * Perfect for backgrounds, overlays, and scene-wide effects.
+ *
+ * @example
+ * ```typescript
+ * // Create a black background
+ * const bg = new FullScreenRectangle();
+ *
+ * // Create a semi-transparent blue overlay
+ * const overlay = new FullScreenRectangle({
+ *   color: '#0000ff',
+ *   fillOpacity: 0.3,
+ * });
+ *
+ * // Create a custom-sized full screen for a different camera setup
+ * const customBg = new FullScreenRectangle({
+ *   frameWidth: 16,
+ *   frameHeight: 9,
+ * });
+ * ```
+ */
+export declare class FullScreenRectangle extends Rectangle {
+    private _frameWidth;
+    private _frameHeight;
+    constructor(options?: FullScreenRectangleOptions);
+    /**
+     * Get the frame width
+     */
+    getFrameWidth(): number;
+    /**
+     * Get the frame height
+     */
+    getFrameHeight(): number;
+    /**
+     * Update to match new camera frame dimensions
+     */
+    matchCamera(frameWidth: number, frameHeight: number): this;
+    /**
+     * Create a copy of this FullScreenRectangle
+     */
+    protected _createCopy(): FullScreenRectangle;
+}
+/**
+ * Options for creating a FullScreenFadeRectangle
+ */
+export interface FullScreenFadeRectangleOptions extends Omit<FullScreenRectangleOptions, 'fillOpacity'> {
+    /** Initial opacity for the fade. Default: 0 (invisible) */
+    opacity?: number;
+}
+/**
+ * FullScreenFadeRectangle - A full screen rectangle designed for fade transitions
+ *
+ * Extends FullScreenRectangle with convenience methods for fade effects.
+ * Commonly used for fade-to-black, fade-to-white, or other transition effects.
+ *
+ * @example
+ * ```typescript
+ * // Create a fade-to-black rectangle (starts invisible)
+ * const fadeBlack = new FullScreenFadeRectangle();
+ *
+ * // Create a fade-to-white rectangle
+ * const fadeWhite = new FullScreenFadeRectangle({ color: '#ffffff' });
+ *
+ * // In an animation, gradually increase opacity
+ * timeline.add(fadeIn(fadeBlack));
+ *
+ * // Or manually animate opacity
+ * fadeBlack.setFadeProgress(0.5); // Half faded
+ * fadeBlack.setFadeProgress(1.0); // Fully faded (opaque)
+ * ```
+ */
+export declare class FullScreenFadeRectangle extends FullScreenRectangle {
+    private _fadeProgress;
+    constructor(options?: FullScreenFadeRectangleOptions);
+    /**
+     * Get the current fade progress (0 = transparent, 1 = opaque)
+     */
+    getFadeProgress(): number;
+    /**
+     * Set the fade progress
+     * @param progress Value from 0 (transparent) to 1 (opaque)
+     */
+    setFadeProgress(progress: number): this;
+    /**
+     * Convenience method to set to fully transparent
+     */
+    fadeOut(): this;
+    /**
+     * Convenience method to set to fully opaque
+     */
+    fadeIn(): this;
+    /**
+     * Check if currently fully transparent
+     */
+    isTransparent(): boolean;
+    /**
+     * Check if currently fully opaque
+     */
+    isOpaque(): boolean;
+    /**
+     * Create a copy of this FullScreenFadeRectangle
+     */
+    protected _createCopy(): FullScreenFadeRectangle;
+}
+/**
+ * Create a black fade rectangle for fade-to-black effects
+ */
+export declare function createFadeToBlack(options?: Omit<FullScreenFadeRectangleOptions, 'color'>): FullScreenFadeRectangle;
+/**
+ * Create a white fade rectangle for fade-to-white effects
+ */
+export declare function createFadeToWhite(options?: Omit<FullScreenFadeRectangleOptions, 'color'>): FullScreenFadeRectangle;
+//# sourceMappingURL=index.d.ts.map

package/dist/mobjects/frame/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/frame/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC7E,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,sBAA2B;IAchD;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACM,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;cACgB,WAAW,IAAI,eAAe;CAUlD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,0BAA+B;IA+BpD;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ1D;;OAEG;cACgB,WAAW,IAAI,mBAAmB;CAWtD;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC;IACrG,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,8BAAmC;IAQxD;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOvC;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;cACgB,WAAW,IAAI,uBAAuB;CAW1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,IAAI,CAAC,8BAA8B,EAAE,OAAO,CAAM,GAAG,uBAAuB,CAEtH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,IAAI,CAAC,8BAA8B,EAAE,OAAO,CAAM,GAAG,uBAAuB,CAEtH"}