manim-web 0.13.0 → 0.15.0

package/dist/player/SlideInteractionRenderer.d.ts

@@ -0,0 +1,32 @@
+import { Scene } from '../core/Scene';
+export declare class SlideInteractionRenderer {
+    private _target;
+    private _scene;
+    private _isIdle;
+    private _onEvent;
+    private _attached;
+    private _renderScheduled;
+    private _renderCount;
+    /**
+     * @param target - Element that pointer events bubble to (the Player
+     *   container). The canvas is a child of this element, so canvas events reach
+     *   it. The container exists even for a headless Scene, where `getCanvas()`
+     *   throws.
+     * @param scene - The scene to render.
+     * @param isIdle - Returns true when the Player is paused (no render loop
+     *   running). A render is requested only then; during playback the Player
+     *   loop already draws every frame.
+     */
+    constructor(target: HTMLElement, scene: Scene, isIdle: () => boolean);
+    /** Whether listeners are currently attached. */
+    get isAttached(): boolean;
+    /** Number of idle renders performed. Exposed for tests and introspection. */
+    get renderCount(): number;
+    /** Start listening for pointer events. Idempotent. */
+    attach(): void;
+    /** Stop listening and drop any pending render. */
+    dispose(): void;
+    private _handleEvent;
+    private _scheduleRender;
+}
+//# sourceMappingURL=SlideInteractionRenderer.d.ts.map

package/dist/player/SlideInteractionRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlideInteractionRenderer.d.ts","sourceRoot":"","sources":["../../src/player/SlideInteractionRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAgBtC,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;;;;;;OASG;gBACS,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO;IAOpE,gDAAgD;IAChD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,6EAA6E;IAC7E,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAQd,kDAAkD;IAClD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,eAAe;CAYxB"}

package/dist/player/index.d.ts

@@ -1,4 +1,5 @@
 export { Player, type PlayerOptions } from './Player';
 export { PlayerUI, type PlayerUIOptions, type PlayerUICallbacks } from './PlayerUI';
 export { PlayerController, type PlayerControllerCallbacks } from './PlayerController';
+export { ExportSettingsPanel, resolveResolution, qualityToBitrate, RESOLUTION_PRESETS, FPS_PRESETS, QUALITY_PRESETS, type ExportSettings, type ResolutionPreset, type QualityPreset, type ExportDefaults, } from './ExportSettingsUI';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/rate-functions/spring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/rate-functions/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6ED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,GAAI,UAAS,aAAkB,KAAG,YAapD,CAAC"}
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/rate-functions/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgFD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,GAAI,UAAS,aAAkB,KAAG,YAapD,CAAC"}

package/dist/serialization/defaults.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Default serializers for the common mobjects.
+ *
+ * Each serializer captures only the type-specific, constructor-relevant
+ * (unscaled) props. The framework (`serialize.ts`) captures transform, style,
+ * and children generically, so these never repeat them. Reading an unscaled
+ * base value (e.g. `_radius`, not `getRadius()`) keeps scale in the transform
+ * only, which is what makes serialize→deserialize→serialize stable.
+ *
+ * Registering runs once as an import side effect from the folder entry point.
+ */
+export declare function registerDefaultSerializers(): void;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/serialization/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/serialization/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsDH,wBAAgB,0BAA0B,IAAI,IAAI,CAuHjD"}

package/dist/serialization/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scene serialization (best-manim).
+ *
+ * Serialize a scene or a single mobject to a plain, JSON-safe document, store
+ * or deep-link it, and reload it in another session. The format is open: new
+ * mobject types register their own serializer, so the schema grows without a
+ * central union to edit.
+ *
+ * Importing this module registers the default serializers (common geometry,
+ * groups, and text) as a side effect.
+ */
+export { serializeScene, deserializeScene, serializeMobject, deserializeMobject, } from './serialize';
+export { registerSerializableMobject, unregisterSerializableMobject, getSerializer, getSerializableTypes, } from './registry';
+export type { SerializedScene, SerializedMobject, SerializedTransform, SerializedStyle, MobjectSerializer, SceneLike, ContainerLike, Vec3, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,IAAI,GACL,MAAM,SAAS,CAAC"}

package/dist/serialization/props.d.ts

@@ -0,0 +1,16 @@
+import { Vec3 } from './types';
+/** Read a number, or `fallback` when the value is not a finite number. */
+export declare function readNumber(value: unknown, fallback: number): number;
+/** Read a string, or `fallback` when the value is not a string. */
+export declare function readString(value: unknown, fallback: string): string;
+/** Read a boolean, or `fallback` when the value is not a boolean. */
+export declare function readBoolean(value: unknown, fallback: boolean): boolean;
+/** Read an optional string: a string, or `undefined`. */
+export declare function readOptionalString(value: unknown): string | undefined;
+/** Read a `[x, y, z]` triple, or `fallback` when the value is not one. */
+export declare function readVec3(value: unknown, fallback: Vec3): Vec3;
+/** Read an array of `[x, y, z]` triples, dropping any malformed entries. */
+export declare function readVec3Array(value: unknown): Vec3[];
+/** True when `value` is a non-null, non-array object (a props/record bag). */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=props.d.ts.map

package/dist/serialization/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/serialization/props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAErE;AAWD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE7D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAOpD;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/serialization/registry.d.ts

@@ -0,0 +1,17 @@
+import { Mobject } from '../core/Mobject';
+import { MobjectSerializer } from './types';
+/**
+ * Register a serializer for a mobject type.
+ *
+ * @param name - The type name, which must match the mobject's class name
+ *   (`mobject.constructor.name`) so instances can be looked up at capture time.
+ * @param serializer - The serialize/deserialize pair for this type.
+ */
+export declare function registerSerializableMobject<T extends Mobject>(name: string, serializer: MobjectSerializer<T>): void;
+/** Remove a registration. Mainly for tests and hot-swapping. */
+export declare function unregisterSerializableMobject(name: string): void;
+/** Look up a serializer by type name, or `undefined` when none is registered. */
+export declare function getSerializer(name: string): MobjectSerializer | undefined;
+/** The names of every registered type, sorted for stable output. */
+export declare function getSerializableTypes(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/serialization/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIjD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAIN;AAED,gEAAgE;AAChE,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEzE;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/serialization/serialize.d.ts

@@ -0,0 +1,24 @@
+import { Mobject } from '../core/Mobject';
+import { ContainerLike, SceneLike, SerializedMobject, SerializedScene } from './types';
+/**
+ * Capture a single mobject (and its submobject tree) as a JSON-safe object.
+ *
+ * An unregistered type is captured with `unknown: true` and empty `props`, so
+ * the document still records its position in the tree for debugging, while a
+ * restore skips it.
+ */
+export declare function serializeMobject(mob: Mobject): SerializedMobject;
+/**
+ * Reconstruct a single mobject from a serialized node, or `null` when the type
+ * is unknown (unregistered or marked `unknown`). Known children are attached;
+ * unknown children are dropped.
+ */
+export declare function deserializeMobject(json: unknown): Mobject | null;
+/** Capture a whole scene (its top-level mobjects) as a JSON document. */
+export declare function serializeScene(scene: SceneLike): SerializedScene;
+/**
+ * Reconstruct the mobjects of a document and add each one to `container`.
+ * Returns the created top-level mobjects. A malformed document yields `[]`.
+ */
+export declare function deserializeScene(json: unknown, container: ContainerLike): Mobject[];
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialization/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialization/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,SAAS,CAAC;AAmDjB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAYhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAqBhE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAIhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,EAAE,CAWnF"}

package/dist/serialization/types.d.ts

@@ -0,0 +1,70 @@
+import { Mobject } from '../core/Mobject';
+/** A plain, JSON-safe triple. */
+export type Vec3 = [number, number, number];
+/** Position, rotation (Euler XYZ, radians), and scale of a mobject. */
+export interface SerializedTransform {
+    position: Vec3;
+    rotation: Vec3;
+    scale: Vec3;
+}
+/** Stroke and fill of a mobject. Only defined fields are written. */
+export interface SerializedStyle {
+    strokeColor?: string;
+    fillColor?: string;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    strokeWidth?: number;
+}
+/**
+ * One serialized mobject.
+ *
+ * `props` is `Record<string, unknown>` on purpose: each registered type owns
+ * the shape of its own props and narrows them on restore, so the schema stays
+ * open for new types without a central union to edit.
+ */
+export interface SerializedMobject {
+    /** Registered type name (its class name), e.g. `Circle`. */
+    type: string;
+    /** Constructor-relevant, unscaled properties for this type. */
+    props: Record<string, unknown>;
+    /** Position/rotation/scale, applied after construction. */
+    transform: SerializedTransform;
+    /** Stroke/fill, applied after construction. */
+    style: SerializedStyle;
+    /** Submobject tree. */
+    children: SerializedMobject[];
+    /**
+     * Present and `true` when the type had no registered serializer at capture
+     * time. Such a node is skipped (not reconstructed) on restore.
+     */
+    unknown?: boolean;
+}
+/** Current document version. Bump when the schema changes incompatibly. */
+export declare const SCENE_FORMAT = "manim-web-scene";
+export declare const SCENE_VERSION = 1;
+/** A full serialized scene document. */
+export interface SerializedScene {
+    format: typeof SCENE_FORMAT;
+    version: number;
+    mobjects: SerializedMobject[];
+}
+/**
+ * A pair of functions that convert between a concrete mobject and its `props`.
+ *
+ * `serialize` returns only the type-specific, constructor-relevant props. The
+ * transform, style, and children are captured generically by the framework, so
+ * a serializer never repeats them.
+ */
+export interface MobjectSerializer<T extends Mobject = Mobject> {
+    serialize: (mobject: T) => Record<string, unknown>;
+    deserialize: (props: Record<string, unknown>) => T;
+}
+/** Anything the framework can read top-level mobjects from (e.g. a Scene). */
+export interface SceneLike {
+    mobjects: Iterable<Mobject>;
+}
+/** Anything the framework can add reconstructed mobjects to (e.g. a Scene). */
+export interface ContainerLike {
+    add: (...mobjects: Mobject[]) => unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/serialization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/serialization/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,iCAAiC;AACjC,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;CACb;AAED,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,uBAAuB;IACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAC9C,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC5D,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACpD;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC1C"}