manim-web 0.2.0

package/dist/interaction/Controls.d.ts

@@ -0,0 +1,174 @@
+import { Scene } from '../core/Scene';
+/**
+ * Position options for the controls panel.
+ */
+export type ControlsPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/**
+ * Theme options for the controls panel.
+ */
+export type ControlsTheme = 'dark' | 'light';
+/**
+ * Options for configuring the Controls panel.
+ */
+export interface ControlsOptions {
+    /** Position of the controls panel. Defaults to 'top-right'. */
+    position?: ControlsPosition;
+    /** Color theme. Defaults to 'dark'. */
+    theme?: ControlsTheme;
+    /** Panel width in pixels. Defaults to 250. */
+    width?: number;
+}
+/**
+ * Configuration for a slider control.
+ */
+export interface SliderConfig {
+    /** Label text displayed above the slider. */
+    label: string;
+    /** Minimum value. */
+    min: number;
+    /** Maximum value. */
+    max: number;
+    /** Initial value. Defaults to min. */
+    value?: number;
+    /** Step increment. Defaults to (max-min)/100. */
+    step?: number;
+    /** Callback when value changes. */
+    onChange: (value: number) => void;
+}
+/**
+ * Configuration for a button control.
+ */
+export interface ButtonConfig {
+    /** Button label text. */
+    label: string;
+    /** Callback when button is clicked. */
+    onClick: () => void;
+}
+/**
+ * Configuration for a checkbox control.
+ */
+export interface CheckboxConfig {
+    /** Label text displayed next to the checkbox. */
+    label: string;
+    /** Initial checked state. Defaults to false. */
+    checked?: boolean;
+    /** Callback when checked state changes. */
+    onChange: (checked: boolean) => void;
+}
+/**
+ * Configuration for a color picker control.
+ */
+export interface ColorPickerConfig {
+    /** Label text displayed above the color picker. */
+    label: string;
+    /** Initial color value. Defaults to '#ffffff'. */
+    value?: string;
+    /** Callback when color changes. */
+    onChange: (color: string) => void;
+}
+/**
+ * Controls panel for interactive scene manipulation.
+ * Creates a DOM-based UI overlay positioned over the scene canvas.
+ */
+export declare class Controls {
+    protected _scene: Scene;
+    protected _panel: HTMLElement;
+    protected _options: Required<ControlsOptions>;
+    /**
+     * Create a new Controls panel.
+     * @param scene - The scene to attach controls to
+     * @param options - Configuration options
+     */
+    constructor(scene: Scene, options?: ControlsOptions);
+    /**
+     * Get the underlying HTML panel element.
+     */
+    get panel(): HTMLElement;
+    /**
+     * Get the scene this controls panel is attached to.
+     */
+    get scene(): Scene;
+    /**
+     * Create the controls panel and attach it to the scene container.
+     */
+    private _createPanel;
+    /**
+     * Get CSS position styles based on the configured position.
+     */
+    private _getPositionStyles;
+    /**
+     * Get the accent color based on theme.
+     */
+    protected _getAccentColor(): string;
+    /**
+     * Get the hover color based on theme.
+     */
+    protected _getHoverColor(): string;
+    /**
+     * Get the border color based on theme.
+     */
+    protected _getBorderColor(): string;
+    /**
+     * Add a slider control.
+     * @param config - Slider configuration
+     * @returns The created wrapper element
+     */
+    addSlider(config: SliderConfig): HTMLElement;
+    /**
+     * Style the slider thumb for cross-browser compatibility.
+     */
+    private _styleSliderThumb;
+    /**
+     * Format a number for display.
+     */
+    private _formatNumber;
+    /**
+     * Add a button control.
+     * @param config - Button configuration
+     * @returns The created button element
+     */
+    addButton(config: ButtonConfig): HTMLElement;
+    /**
+     * Add a checkbox control.
+     * @param config - Checkbox configuration
+     * @returns The created wrapper element
+     */
+    addCheckbox(config: CheckboxConfig): HTMLElement;
+    /**
+     * Add a color picker control.
+     * @param config - Color picker configuration
+     * @returns The created wrapper element
+     */
+    addColorPicker(config: ColorPickerConfig): HTMLElement;
+    /**
+     * Add a horizontal separator line.
+     */
+    addSeparator(): void;
+    /**
+     * Add a section label.
+     * @param text - Label text
+     * @returns The created label element
+     */
+    addLabel(text: string): HTMLElement;
+    /**
+     * Show the controls panel.
+     */
+    show(): void;
+    /**
+     * Hide the controls panel.
+     */
+    hide(): void;
+    /**
+     * Toggle the controls panel visibility.
+     */
+    toggle(): void;
+    /**
+     * Check if the controls panel is visible.
+     */
+    isVisible(): boolean;
+    /**
+     * Clean up and remove the controls panel from the DOM.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=Controls.d.ts.map

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

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

package/dist/interaction/Draggable.d.ts

@@ -0,0 +1,88 @@
+import { Mobject, Vector3Tuple } from '../core/Mobject';
+import { Scene } from '../core/Scene';
+/**
+ * Options for configuring draggable behavior.
+ */
+export interface DraggableOptions {
+    /** X-axis constraints as [min, max] or null for no constraint */
+    constrainX?: [number, number] | null;
+    /** Y-axis constraints as [min, max] or null for no constraint */
+    constrainY?: [number, number] | null;
+    /** Callback when drag starts */
+    onDragStart?: (mobject: Mobject, position: Vector3Tuple) => void;
+    /** Callback during drag with position and delta */
+    onDrag?: (mobject: Mobject, position: Vector3Tuple, delta: Vector3Tuple) => void;
+    /** Callback when drag ends */
+    onDragEnd?: (mobject: Mobject, position: Vector3Tuple) => void;
+    /** Grid size for snapping, or null for no snapping */
+    snapToGrid?: number | null;
+}
+/**
+ * Makes a mobject draggable with mouse and touch support.
+ */
+export declare class Draggable {
+    private _mobject;
+    private _scene;
+    private _options;
+    private _isDragging;
+    private _lastPosition;
+    private _enabled;
+    private _onMouseDown;
+    private _onMouseMove;
+    private _onMouseUp;
+    private _onTouchStart;
+    private _onTouchMove;
+    private _onTouchEnd;
+    /**
+     * Create a new Draggable behavior.
+     * @param mobject - The mobject to make draggable
+     * @param scene - The scene containing the mobject
+     * @param options - Draggable configuration options
+     */
+    constructor(mobject: Mobject, scene: Scene, options?: DraggableOptions);
+    /**
+     * Get whether the mobject is currently being dragged.
+     */
+    get isDragging(): boolean;
+    /**
+     * Get whether dragging is enabled.
+     */
+    get isEnabled(): boolean;
+    /**
+     * Get the mobject this draggable is attached to.
+     */
+    get mobject(): Mobject;
+    private _setupEventListeners;
+    private _handleMouseDown;
+    private _handleMouseMove;
+    private _handleMouseUp;
+    private _handleTouchStart;
+    private _handleTouchMove;
+    private _handleTouchEnd;
+    private _screenToWorld;
+    private _hitTest;
+    private _startDrag;
+    private _updateDrag;
+    private _endDrag;
+    /**
+     * Enable dragging.
+     */
+    enable(): void;
+    /**
+     * Disable dragging.
+     */
+    disable(): void;
+    /**
+     * Clean up event listeners.
+     */
+    dispose(): void;
+}
+/**
+ * Factory function to make a mobject draggable.
+ * @param mobject - The mobject to make draggable
+ * @param scene - The scene containing the mobject
+ * @param options - Draggable configuration options
+ * @returns A new Draggable instance
+ */
+export declare function makeDraggable(mobject: Mobject, scene: Scene, options?: DraggableOptions): Draggable;
+//# sourceMappingURL=Draggable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Draggable.d.ts","sourceRoot":"","sources":["../../src/interaction/Draggable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,gCAAgC;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACjE,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjF,8BAA8B;IAC9B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAiB;IAGjC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,WAAW,CAA0B;IAE7C;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAgBtE;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,OAAO,IAAI,IAAI;CAShB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEnG"}

package/dist/interaction/Hoverable.d.ts

@@ -0,0 +1,82 @@
+import { Mobject } from '../core/Mobject';
+import { Scene } from '../core/Scene';
+/**
+ * Options for configuring hoverable behavior.
+ */
+export interface HoverableOptions {
+    /** Callback when hover starts */
+    onHoverStart?: (mobject: Mobject) => void;
+    /** Callback when hover ends */
+    onHoverEnd?: (mobject: Mobject) => void;
+    /** Scale factor on hover, default 1.1 */
+    hoverScale?: number;
+    /** Color change on hover, or null for no change */
+    hoverColor?: string | null;
+    /** Opacity change on hover, or null for no change */
+    hoverOpacity?: number | null;
+    /** CSS cursor on hover, default 'pointer' */
+    cursor?: string;
+}
+/**
+ * Adds hover effects to a mobject.
+ */
+export declare class Hoverable {
+    private _mobject;
+    private _scene;
+    private _options;
+    private _isHovering;
+    private _originalScale;
+    private _originalColor;
+    private _originalOpacity;
+    private _enabled;
+    private _onMouseMove;
+    private _onMouseLeave;
+    /**
+     * Create a new Hoverable behavior.
+     * @param mobject - The mobject to add hover effects to
+     * @param scene - The scene containing the mobject
+     * @param options - Hoverable configuration options
+     */
+    constructor(mobject: Mobject, scene: Scene, options?: HoverableOptions);
+    /**
+     * Get whether the mobject is currently being hovered.
+     */
+    get isHovering(): boolean;
+    /**
+     * Get whether hovering is enabled.
+     */
+    get isEnabled(): boolean;
+    /**
+     * Get the mobject this hoverable is attached to.
+     */
+    get mobject(): Mobject;
+    private _storeOriginalValues;
+    private _setupEventListeners;
+    private _handleMouseMove;
+    private _handleMouseLeave;
+    private _screenToWorld;
+    private _hitTest;
+    private _startHover;
+    private _endHover;
+    /**
+     * Enable hovering.
+     */
+    enable(): void;
+    /**
+     * Disable hovering and reset to original state.
+     */
+    disable(): void;
+    /**
+     * Clean up event listeners.
+     */
+    dispose(): void;
+}
+/**
+ * Factory function to make a mobject hoverable.
+ * @param mobject - The mobject to add hover effects to
+ * @param scene - The scene containing the mobject
+ * @param options - Hoverable configuration options
+ * @returns A new Hoverable instance
+ */
+export declare function makeHoverable(mobject: Mobject, scene: Scene, options?: HoverableOptions): Hoverable;
+//# sourceMappingURL=Hoverable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Hoverable.d.ts","sourceRoot":"","sources":["../../src/interaction/Hoverable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAiB;IAGjC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,aAAa,CAA0B;IAE/C;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAoBtE;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,SAAS;IAkBjB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEnG"}

package/dist/interaction/OrbitControls.d.ts

@@ -0,0 +1,139 @@
+import { OrbitControls as ThreeOrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+import * as THREE from 'three';
+/**
+ * Options for configuring OrbitControls.
+ */
+export interface OrbitControlsOptions {
+    /** Enable smooth motion damping. Defaults to true. */
+    enableDamping?: boolean;
+    /** Damping factor for smooth motion. Defaults to 0.05. */
+    dampingFactor?: number;
+    /** Enable zoom with scroll wheel. Defaults to true. */
+    enableZoom?: boolean;
+    /** Enable panning (right-click drag). Defaults to true. */
+    enablePan?: boolean;
+    /** Enable rotation (left-click drag). Defaults to true. */
+    enableRotate?: boolean;
+    /** Minimum zoom distance. */
+    minDistance?: number;
+    /** Maximum zoom distance. */
+    maxDistance?: number;
+    /** Minimum vertical angle in radians (0 = looking down). */
+    minPolarAngle?: number;
+    /** Maximum vertical angle in radians (PI = looking up). */
+    maxPolarAngle?: number;
+    /** Minimum horizontal angle in radians. */
+    minAzimuthAngle?: number;
+    /** Maximum horizontal angle in radians. */
+    maxAzimuthAngle?: number;
+    /** Enable auto-rotation. Defaults to false. */
+    autoRotate?: boolean;
+    /** Auto-rotation speed in degrees per second. Defaults to 2. */
+    autoRotateSpeed?: number;
+}
+/**
+ * Wrapper for Three.js OrbitControls providing camera orbit interaction.
+ * Allows users to rotate, zoom, and pan the camera around a target point.
+ */
+export declare class OrbitControls {
+    private _controls;
+    private _enabled;
+    /**
+     * Create new OrbitControls.
+     * @param camera - The Three.js camera to control
+     * @param canvas - The HTML canvas element for mouse events
+     * @param options - Controls configuration options
+     */
+    constructor(camera: THREE.Camera, canvas: HTMLCanvasElement, options?: OrbitControlsOptions);
+    /**
+     * Update the controls. Must be called in the animation loop when damping is enabled.
+     */
+    update(): void;
+    /**
+     * Enable the controls.
+     */
+    enable(): void;
+    /**
+     * Disable the controls.
+     */
+    disable(): void;
+    /**
+     * Check if controls are enabled.
+     * @returns true if controls are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Set the target point for the camera to orbit around.
+     * @param target - Target position [x, y, z]
+     */
+    setTarget(target: [number, number, number]): void;
+    /**
+     * Get the current target point.
+     * @returns The target position as a Vector3
+     */
+    getTarget(): THREE.Vector3;
+    /**
+     * Enable or disable damping (smooth motion).
+     * @param enabled - Whether damping should be enabled
+     */
+    setDamping(enabled: boolean): void;
+    /**
+     * Set the damping factor.
+     * @param factor - Damping factor (0 = no damping, 1 = full damping)
+     */
+    setDampingFactor(factor: number): void;
+    /**
+     * Enable or disable auto-rotation.
+     * @param enabled - Whether auto-rotation should be enabled
+     */
+    setAutoRotate(enabled: boolean): void;
+    /**
+     * Set the auto-rotation speed.
+     * @param speed - Rotation speed in degrees per second
+     */
+    setAutoRotateSpeed(speed: number): void;
+    /**
+     * Set zoom distance limits.
+     * @param min - Minimum zoom distance
+     * @param max - Maximum zoom distance
+     */
+    setZoomLimits(min: number, max: number): void;
+    /**
+     * Set polar angle limits (vertical rotation).
+     * @param min - Minimum angle in radians (0 = looking down)
+     * @param max - Maximum angle in radians (PI = looking up)
+     */
+    setPolarLimits(min: number, max: number): void;
+    /**
+     * Set azimuth angle limits (horizontal rotation).
+     * @param min - Minimum angle in radians
+     * @param max - Maximum angle in radians
+     */
+    setAzimuthLimits(min: number, max: number): void;
+    /**
+     * Reset the camera to its default position and target.
+     */
+    reset(): void;
+    /**
+     * Get the underlying Three.js OrbitControls.
+     * @returns The ThreeOrbitControls instance
+     */
+    getControls(): ThreeOrbitControls;
+    /**
+     * Add an event listener for control changes.
+     * @param event - Event type ('change', 'start', 'end')
+     * @param callback - Callback function
+     */
+    addEventListener(event: 'change' | 'start' | 'end', callback: () => void): void;
+    /**
+     * Remove an event listener.
+     * @param event - Event type ('change', 'start', 'end')
+     * @param callback - Callback function to remove
+     */
+    removeEventListener(event: 'change' | 'start' | 'end', callback: () => void): void;
+    /**
+     * Dispose of the controls and clean up event listeners.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=OrbitControls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitControls.d.ts","sourceRoot":"","sources":["../../src/interaction/OrbitControls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;;;OAKG;gBAED,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,oBAAoB;IAiChC;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD;;;OAGG;IACH,SAAS,IAAI,KAAK,CAAC,OAAO;IAI1B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIrC;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7C;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAK9C;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,WAAW,IAAI,kBAAkB;IAIjC;;;;OAIG;IACH,gBAAgB,CACd,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,EACjC,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI;IAIP;;;;OAIG;IACH,mBAAmB,CACjB,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,EACjC,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI;IAIP;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/interaction/PlaybackControls.d.ts

@@ -0,0 +1,113 @@
+import { Scene } from '../core/Scene';
+import { Controls, ControlsOptions } from './Controls';
+/**
+ * Options for configuring PlaybackControls.
+ */
+export interface PlaybackControlsOptions extends ControlsOptions {
+    /** Show timeline scrubber. Defaults to true. */
+    showTimeline?: boolean;
+    /** Show play/pause button. Defaults to true. */
+    showPlayPause?: boolean;
+    /** Show playback speed control. Defaults to true. */
+    showSpeed?: boolean;
+}
+/**
+ * Callback for playback time updates.
+ */
+export type TimeUpdateCallback = (currentTime: number, duration: number) => void;
+/**
+ * PlaybackControls for timeline manipulation.
+ * Extends Controls to add playback-specific UI elements.
+ */
+export declare class PlaybackControls extends Controls {
+    private _timeline;
+    private _playPauseBtn;
+    private _speedSelect;
+    private _timeDisplay;
+    private _isPlaying;
+    private _playbackRate;
+    private _updateInterval;
+    private _onTimeUpdate;
+    /**
+     * Create new PlaybackControls.
+     * @param scene - The scene to control
+     * @param options - Configuration options
+     */
+    constructor(scene: Scene, options?: PlaybackControlsOptions);
+    /**
+     * Set callback for time updates.
+     * @param callback - Function called when time changes
+     */
+    onTimeUpdate(callback: TimeUpdateCallback): void;
+    /**
+     * Get the current playback rate.
+     */
+    get playbackRate(): number;
+    /**
+     * Set the playback rate.
+     */
+    set playbackRate(rate: number);
+    /**
+     * Create the playback-specific UI elements.
+     */
+    private _createPlaybackUI;
+    /**
+     * Create the play/pause toggle button.
+     */
+    private _createPlayPauseButton;
+    /**
+     * Toggle between play and pause states.
+     */
+    private _togglePlayPause;
+    /**
+     * Update the play/pause button icon.
+     */
+    private _updatePlayPauseButton;
+    /**
+     * Create the timeline scrubber.
+     */
+    private _createTimelineScrubber;
+    /**
+     * Create the playback speed control.
+     */
+    private _createSpeedControl;
+    /**
+     * Update the time display.
+     * @param currentTime - Current playback time in seconds
+     * @param duration - Total duration in seconds
+     */
+    updateTime(currentTime: number, duration: number): void;
+    /**
+     * Update the time display text.
+     */
+    private _updateTimeDisplay;
+    /**
+     * Update the timeline slider position.
+     */
+    private _updateTimelineSlider;
+    /**
+     * Format time in M:SS.mm format.
+     */
+    private _formatTime;
+    /**
+     * Start the update loop to sync UI with scene state.
+     */
+    private _startUpdateLoop;
+    /**
+     * Get play icon SVG.
+     */
+    private _getPlayIcon;
+    /**
+     * Get pause icon SVG.
+     */
+    private _getPauseIcon;
+    /**
+     * Get stop icon SVG.
+     */
+    private _getStopIcon;
+    /**
+     * Clean up resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=PlaybackControls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaybackControls.d.ts","sourceRoot":"","sources":["../../src/interaction/PlaybackControls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjF;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAmC;IAExD;;;;OAIG;gBACS,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,uBAA4B;IAM/D;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIhD;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,EAK5B;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiF9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiE/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyE3B;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IASvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACM,OAAO,IAAI,IAAI;CAOzB"}