manim-web 0.28.0 → 0.30.0

package/dist/mobjects/chemistry/MoleculeMobject.d.ts

@@ -0,0 +1,64 @@
+import { VGroup } from '../../core/VGroup';
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import { AtomSpec, BondSpec, BondOrder, BondStyle, MoleculeOptions, AtomRender, BondRender } from './chemistryTypes';
+export declare class MoleculeMobject extends VGroup {
+    /** The atom specs as given, scaled to world coordinates. */
+    protected _atomSpecs: AtomSpec[];
+    /** The bond specs as given. */
+    protected _bondSpecs: BondSpec[];
+    /** Resolved atoms, parallel to _atomSpecs. */
+    protected _atoms: AtomRender[];
+    /** Resolved bonds, parallel to _bondSpecs. */
+    protected _bonds: BondRender[];
+    protected _bondLength: number;
+    protected _colors: Record<string, string>;
+    protected _showCarbonLabels: boolean;
+    protected _labelFontSize: number;
+    protected _bondColor: string;
+    protected _bondSpacing: number;
+    /** The bond line mobjects, drawn behind the atoms. */
+    readonly bondsGroup: VGroup;
+    /** The atom label mobjects, drawn in front of the bonds. */
+    readonly atomsGroup: VGroup;
+    constructor(options: MoleculeOptions);
+    /** World position of an atom spec after the bond-length scale. */
+    protected _atomPosition(spec: AtomSpec): Vector3Tuple;
+    /** Whether an element should carry a label. Carbons are implicit by default. */
+    protected _hasLabel(element: string): boolean;
+    /** Resolve each atom spec into an AtomRender (position and color; label added later). */
+    protected _resolveAtoms(): void;
+    /** Create a label Text for every atom that needs one, and add it to atomsGroup. */
+    protected _buildAtomLabels(): void;
+    /** Build every bond and add its line mobjects to bondsGroup. */
+    protected _buildBonds(): void;
+    /**
+     * Build the line mobjects for one bond.
+     *
+     * A bond that references a missing atom produces no lines (handled
+     * gracefully, no throw). A wedge or dash bond produces one mobject. A normal
+     * bond produces `order` parallel lines.
+     */
+    protected _buildBondLines(spec: BondSpec, order: BondOrder, type: BondStyle): Mobject[];
+    /** Trim the bond endpoints inward at labeled atoms so the line clears the label. */
+    protected _trimForLabels(fromAtom: AtomRender, toAtom: AtomRender): [Vector3Tuple, Vector3Tuple];
+    /** Unit perpendicular to the segment, in the XY plane. */
+    protected _perpendicular(start: Vector3Tuple, end: Vector3Tuple): Vector3Tuple;
+    /** Build `order` parallel lines, evenly offset about the bond axis. */
+    protected _buildParallelLines(start: Vector3Tuple, end: Vector3Tuple, order: BondOrder): Mobject[];
+    /** Build a filled triangle wedge from `start` (point) to `end` (wide base). */
+    protected _buildWedge(start: Vector3Tuple, end: Vector3Tuple): Mobject;
+    /** Get all resolved atoms, in input order. */
+    getAtoms(): AtomRender[];
+    /** Get all resolved bonds, in input order. */
+    getBonds(): BondRender[];
+    /** Get the resolved atom at an index, or undefined. */
+    getAtom(index: number): AtomRender | undefined;
+    /** Get the resolved bond at an index, or undefined. */
+    getBond(index: number): BondRender | undefined;
+    /** The number of atoms. */
+    get numAtoms(): number;
+    /** The number of bonds. */
+    get numBonds(): number;
+    copy(): MoleculeMobject;
+}
+//# sourceMappingURL=MoleculeMobject.d.ts.map

package/dist/mobjects/chemistry/MoleculeMobject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoleculeMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/chemistry/MoleculeMobject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQ3D,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,EACf,UAAU,EACV,UAAU,EACX,MAAM,kBAAkB,CAAC;AAK1B,qBAAa,eAAgB,SAAQ,MAAM;IACzC,4DAA4D;IAC5D,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IACjC,+BAA+B;IAC/B,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IACjC,8CAA8C;IAC9C,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IACpC,8CAA8C;IAC9C,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IAEpC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACrC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,eAAe;IAoCpC,kEAAkE;IAClE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY;IAIrD,gFAAgF;IAChF,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAO7C,yFAAyF;IACzF,SAAS,CAAC,aAAa,IAAI,IAAI;IAS/B,mFAAmF;IACnF,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAgBlC,gEAAgE;IAChE,SAAS,CAAC,WAAW,IAAI,IAAI;IAY7B;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE;IAkBvF,oFAAoF;IACpF,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;IAwBhG,0DAA0D;IAC1D,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY;IAU9E,uEAAuE;IACvE,SAAS,CAAC,mBAAmB,CAC3B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,SAAS,GACf,OAAO,EAAE;IAwBZ,+EAA+E;IAC/E,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IAetE,8CAA8C;IAC9C,QAAQ,IAAI,UAAU,EAAE;IAIxB,8CAA8C;IAC9C,QAAQ,IAAI,UAAU,EAAE;IAIxB,uDAAuD;IACvD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,uDAAuD;IACvD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,2BAA2B;IAC3B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,2BAA2B;IAC3B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEQ,IAAI,IAAI,eAAe;CAcjC"}

package/dist/mobjects/chemistry/chemistryTypes.d.ts

@@ -0,0 +1,79 @@
+import { Vector3Tuple, Mobject } from '../../core/Mobject';
+import { Text } from '../text/Text';
+/** Bond multiplicity. 1 = single, 2 = double, 3 = triple. */
+export type BondOrder = 1 | 2 | 3;
+/**
+ * Bond drawing style.
+ * - 'normal' draws plain parallel lines by order.
+ * - 'wedge' draws a filled triangle (a bond toward the viewer).
+ * - 'dash' draws a dashed line (a bond away from the viewer).
+ */
+export type BondStyle = 'normal' | 'wedge' | 'dash';
+/** One atom in the input: an element symbol and 2D coordinates. */
+export interface AtomSpec {
+    /** Element symbol, e.g. 'C', 'O', 'Cl'. */
+    element: string;
+    /** X coordinate in bond-length units. */
+    x: number;
+    /** Y coordinate in bond-length units. */
+    y: number;
+}
+/** One bond in the input: two atom indices and an optional order/style. */
+export interface BondSpec {
+    /** Index of the first atom in the atoms array. */
+    from: number;
+    /** Index of the second atom in the atoms array. */
+    to: number;
+    /** Bond order. Default: 1. */
+    order?: BondOrder;
+    /** Bond style. Default: 'normal'. */
+    type?: BondStyle;
+}
+/** Options for a {@link MoleculeMobject}. */
+export interface MoleculeOptions {
+    /** The atoms of the molecule. */
+    atoms: AtomSpec[];
+    /** The bonds between atoms. Default: []. */
+    bonds?: BondSpec[];
+    /** Scale applied to every atom coordinate. Default: 1. */
+    bondLength?: number;
+    /** Per-element color overrides, e.g. { C: '#000000' }. Merged over the CPK palette. */
+    colors?: Record<string, string>;
+    /** Whether to draw a label on carbon atoms. Default: false (skeletal convention). */
+    showCarbonLabels?: boolean;
+    /** Font size for atom labels. Default: 28. */
+    labelFontSize?: number;
+    /** Color of the bond lines. Default: white. */
+    bondColor?: string;
+    /** Distance between the parallel lines of a double or triple bond. Default: 0.08. */
+    bondSpacing?: number;
+}
+/** A resolved atom: its element, world position, color and optional label. */
+export interface AtomRender {
+    /** Element symbol. */
+    element: string;
+    /** Position after the bond-length scale. */
+    position: Vector3Tuple;
+    /** Resolved CPK (or overridden) color. */
+    color: string;
+    /** The label mobject, or null for an implicit (unlabeled) carbon. */
+    label: Text | null;
+}
+/** A resolved bond: its endpoints, order, style and line mobjects. */
+export interface BondRender {
+    /** Index of the first atom. */
+    from: number;
+    /** Index of the second atom. */
+    to: number;
+    /** Bond order. */
+    order: BondOrder;
+    /** Bond style. */
+    type: BondStyle;
+    /**
+     * The mobjects that draw this bond. A normal bond of order N has N line
+     * mobjects; a wedge or dash bond has one. A bond that references a missing
+     * atom has none.
+     */
+    lines: Mobject[];
+}
+//# sourceMappingURL=chemistryTypes.d.ts.map

package/dist/mobjects/chemistry/chemistryTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chemistryTypes.d.ts","sourceRoot":"","sources":["../../../src/mobjects/chemistry/chemistryTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;IACV,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qCAAqC;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,kBAAkB;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB"}

package/dist/mobjects/chemistry/cpkColors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CPK / Jmol color palette for chemical elements.
+ *
+ * The CPK coloring convention assigns a standard color to each element
+ * (oxygen red, nitrogen blue, and so on). These hex values follow the Jmol
+ * palette, which is the de-facto standard used by most molecular viewers.
+ */
+/** Fallback color for an element that is not in the palette. */
+export declare const DEFAULT_ELEMENT_COLOR = "#DDDDDD";
+/**
+ * Element symbol to hex color (CPK / Jmol convention).
+ *
+ * Carbon uses a visible mid-gray rather than pure black so it reads on a dark
+ * background; callers can override any element through MoleculeOptions.colors.
+ */
+export declare const CPK_COLORS: Readonly<Record<string, string>>;
+/**
+ * Normalize an element symbol to its canonical case.
+ *
+ * A symbol is an uppercase first letter and a lowercase second letter, so
+ * 'cl', 'CL' and 'Cl' all resolve to 'Cl'. The input is trimmed first.
+ * @param element - The raw element symbol.
+ * @returns The canonical symbol.
+ */
+export declare function normalizeElement(element: string): string;
+/**
+ * Resolve the color for an element.
+ *
+ * The lookup order is: caller overrides, then the CPK palette, then the
+ * default color. Overrides are matched on the canonical symbol.
+ * @param element - The element symbol (any case).
+ * @param overrides - Optional per-element color overrides.
+ * @returns The hex color string.
+ */
+export declare function cpkColor(element: string, overrides?: Record<string, string>): string;
+//# sourceMappingURL=cpkColors.d.ts.map

package/dist/mobjects/chemistry/cpkColors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpkColors.d.ts","sourceRoot":"","sources":["../../../src/mobjects/chemistry/cpkColors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBvD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWpF"}

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

@@ -0,0 +1,12 @@
+/**
+ * Chemistry mobjects for manim-web.
+ *
+ * 2D skeletal molecule structures: atoms as element labels, bonds as
+ * single/double/triple lines with optional wedge/dash stereochemistry, plus
+ * prebuilt example molecules and the CPK color palette.
+ */
+export { MoleculeMobject } from './MoleculeMobject';
+export { water, methane, benzene, ethanol, type MoleculeBuilderOptions } from './molecules';
+export { cpkColor, normalizeElement, CPK_COLORS, DEFAULT_ELEMENT_COLOR } from './cpkColors';
+export { type AtomSpec, type BondSpec, type BondOrder, type BondStyle, type MoleculeOptions, type AtomRender, type BondRender, } from './chemistryTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/chemistry/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/mobjects/chemistry/molecules.d.ts

@@ -0,0 +1,19 @@
+import { MoleculeMobject } from './MoleculeMobject';
+import { MoleculeOptions } from './chemistryTypes';
+/** Style overrides a builder forwards to the MoleculeMobject (no atoms/bonds). */
+export type MoleculeBuilderOptions = Partial<Omit<MoleculeOptions, 'atoms' | 'bonds'>>;
+/** Water, H2O. An oxygen with two hydrogens at the bent 104.5 degree angle. */
+export declare function water(options?: MoleculeBuilderOptions): MoleculeMobject;
+/** Methane, CH4. A central carbon with four hydrogens; the carbon is labeled. */
+export declare function methane(options?: MoleculeBuilderOptions): MoleculeMobject;
+/**
+ * Benzene, C6H6. Six carbons in a regular hexagon ring with alternating single
+ * and double bonds (Kekule structure). Carbons stay implicit (skeletal).
+ */
+export declare function benzene(options?: MoleculeBuilderOptions): MoleculeMobject;
+/**
+ * Ethanol, C2H5OH. Two carbons and a hydroxyl group, drawn skeletal: the
+ * carbons are implicit, the oxygen and its hydrogen are labeled.
+ */
+export declare function ethanol(options?: MoleculeBuilderOptions): MoleculeMobject;
+//# sourceMappingURL=molecules.d.ts.map

package/dist/mobjects/chemistry/molecules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"molecules.d.ts","sourceRoot":"","sources":["../../../src/mobjects/chemistry/molecules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;AAEvF,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAa3E;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAkB7E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAW7E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAe7E"}

package/dist/mobjects/effects/dropShadow.d.ts

@@ -0,0 +1,30 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+/** Options for {@link withDropShadow}. */
+export interface DropShadowOptions {
+    /** Shadow offset `[dx, dy]` in scene units. Default `[0.1, -0.1]` (down-right). */
+    offset?: [number, number];
+    /** Shadow color. Default black `#000000`. */
+    color?: string;
+    /** Shadow opacity of the strongest layer (0..1). Default `0.5`. */
+    opacity?: number;
+    /** Number of shadow copies. More copies fake a softer edge. Default `1`. */
+    layers?: number;
+    /** Extra outward spread of the outer layers, as a fraction of `offset`. */
+    blur?: number;
+    /** Uniform scale of each shadow copy about its center. Default `1`. */
+    scale?: number;
+}
+/**
+ * Return a VGroup with a drop shadow behind `mobject`.
+ *
+ * The source is copied for every shadow layer, so it is never recolored,
+ * moved, or scaled. The returned group holds the shadow layers first (drawn
+ * behind) and the original last (drawn in front).
+ *
+ * @param mobject - Source VMobject (shape, text, group, ...)
+ * @param options - Shadow options; see {@link DropShadowOptions}
+ * @returns A VGroup = `[shadow layers..., original]`
+ */
+export declare function withDropShadow<T extends VMobject>(mobject: T, options?: DropShadowOptions): VGroup;
+//# sourceMappingURL=dropShadow.d.ts.map

package/dist/mobjects/effects/dropShadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropShadow.d.ts","sourceRoot":"","sources":["../../../src/mobjects/effects/dropShadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,OAAO,EAAE,CAAC,EACV,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CA4BR"}

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

@@ -0,0 +1,5 @@
+/**
+ * Visual effects that wrap a mobject into a styled derivative.
+ */
+export { withDropShadow, type DropShadowOptions } from './dropShadow';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/serialization/index.d.ts

@@ -14,4 +14,5 @@ export { registerSerializableMobject, unregisterSerializableMobject, getSerializ
 export type { SerializedScene, SerializedMobject, SerializedTransform, SerializedStyle, MobjectSerializer, SceneLike, ContainerLike, Vec3, } from './types';
 export { encodeStateToHash, decodeStateFromHash, writeStateToUrl, readStateFromUrl, onUrlStateChange, bindStateToUrl, } from './urlState';
 export type { WriteStateOptions, BindUrlStateOptions, UrlStateBinding, UrlStateController, } from './urlState';
+export { defineParametrizedScene, resolveProps, renderParametrized, propsFromUrl, type PropsRecord, type PropTypeTag, type PropsSchema, type DataFetcher, type SceneMetadata, type MetadataContext, type CalculateMetadataResult, type CalculateMetadata, type SceneBuilder, type ParametrizedSceneDefinition, type ResolvedMetadata, type ParametrizedRenderResult, type RenderParametrizedOptions, } from './parametrized';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AAEjB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"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;AAEjB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/serialization/parametrized.d.ts

@@ -0,0 +1,152 @@
+import { Scene, SceneOptions } from '../core/Scene';
+/** A JSON-safe props bag. Each definition owns the shape of its own props. */
+export type PropsRecord = Record<string, unknown>;
+/** The runtime type tag a prop is validated and coerced against. */
+export type PropTypeTag = 'number' | 'string' | 'boolean' | 'vec3' | 'array' | 'object';
+/**
+ * Optional explicit schema: a type tag per prop key. When omitted, the tag of
+ * each prop is inferred from the type of its default value.
+ */
+export type PropsSchema<P extends object> = Partial<Record<keyof P, PropTypeTag>>;
+/**
+ * Fetches render-time data. The default implementation calls the global
+ * `fetch` and returns parsed JSON; tests inject a stub so they never touch the
+ * network. This is the dependency-injection seam for {@link renderParametrized}.
+ */
+export type DataFetcher = (url: string, init?: RequestInit) => Promise<unknown>;
+/** Scene config a {@link CalculateMetadata} hook may override before render. */
+export interface SceneMetadata {
+    /** Clip duration in seconds, for downstream export. Carried through as-is. */
+    duration?: number;
+    /** Render width in pixels. */
+    width?: number;
+    /** Render height in pixels. */
+    height?: number;
+    /** Target frame rate in fps. */
+    fps?: number;
+}
+/** Context passed to {@link CalculateMetadata}: resolved props and the fetcher. */
+export interface MetadataContext<P extends object> {
+    /** The props resolved from defaults + input (input wins). */
+    props: P;
+    /** The injected data fetcher (see {@link DataFetcher}). */
+    fetch: DataFetcher;
+}
+/**
+ * What {@link CalculateMetadata} returns: optional scene-config overrides, an
+ * optional patch of props (which wins over the input props), and the fetched
+ * `data` that reaches {@link SceneBuilder}.
+ */
+export interface CalculateMetadataResult<P extends object, D> extends SceneMetadata {
+    /** Props to override after the fetch (e.g. values computed from the data). */
+    props?: Partial<P>;
+    /** Data to pass to the build step. */
+    data?: D;
+}
+/** The async pre-render hook. Runs once, before the scene is built. */
+export type CalculateMetadata<P extends object, D> = (context: MetadataContext<P>) => CalculateMetadataResult<P, D> | Promise<CalculateMetadataResult<P, D>>;
+/** Builds the scene from the resolved props and the fetched data. */
+export type SceneBuilder<P extends object, D> = (scene: Scene, props: P, data: D | undefined) => void | Promise<void>;
+/** A parametrized scene definition. See {@link defineParametrizedScene}. */
+export interface ParametrizedSceneDefinition<P extends object, D = unknown> {
+    /** Optional stable id for logging or registry use. */
+    id?: string;
+    /** The default props. Also the source of the inferred prop schema. */
+    defaultProps: P;
+    /** Optional explicit per-prop type tags; inferred from defaults when absent. */
+    schema?: PropsSchema<P>;
+    /** Optional async hook that fetches data and overrides scene config. */
+    calculateMetadata?: CalculateMetadata<P, D>;
+    /** Builds the scene from resolved props + data. */
+    build: SceneBuilder<P, D>;
+}
+/** The resolved render metadata reported by {@link renderParametrized}. */
+export interface ResolvedMetadata {
+    /** Duration in seconds, as returned by the metadata hook (may be undefined). */
+    duration?: number;
+    /** The scene's actual render width in pixels. */
+    width: number;
+    /** The scene's actual render height in pixels. */
+    height: number;
+    /** The scene's actual target fps. */
+    fps: number;
+}
+/** The result of {@link renderParametrized}. */
+export interface ParametrizedRenderResult<P extends object, D> {
+    /** The built scene. */
+    scene: Scene;
+    /** The fully resolved props (defaults + input + metadata patch). */
+    props: P;
+    /** The data returned by the metadata hook, or undefined. */
+    data: D | undefined;
+    /** The resolved render metadata. */
+    metadata: ResolvedMetadata;
+    /** A shareable, URL-safe hash of the resolved props (reuses the URL codec). */
+    url: string;
+}
+/** Options for {@link renderParametrized}. */
+export interface RenderParametrizedOptions {
+    /** Build into this scene instead of a fresh headless one. */
+    scene?: Scene;
+    /** Scene options for the created scene when `scene` is not supplied. */
+    sceneOptions?: SceneOptions;
+    /** Injected data fetcher. Defaults to the global `fetch` + JSON parse. */
+    fetch?: DataFetcher;
+    /** Write the resolved props to the URL hash (no-op headless). Default false. */
+    writeUrl?: boolean;
+    /** Use `history.replaceState` when writing the URL. Default true. */
+    urlReplace?: boolean;
+}
+/**
+ * Define a parametrized scene. This is a typed identity helper: it infers the
+ * props and data generics from the definition and returns it unchanged.
+ *
+ * @param definition - The scene definition (defaults, optional schema, optional
+ *   metadata hook, build function).
+ * @returns The same definition, typed.
+ *
+ * @example
+ * ```ts
+ * const bar = defineParametrizedScene({
+ *   defaultProps: { label: 'A', value: 1, color: '#58C4DD' },
+ *   calculateMetadata: async ({ props, fetch }) => {
+ *     const data = await fetch(`/api/series/${props.label}`);
+ *     return { data, duration: 3, width: 1920, height: 1080, fps: 60 };
+ *   },
+ *   build: (scene, props, data) => {
+ *     // ...assemble the scene from props + data
+ *   },
+ * });
+ * ```
+ */
+export declare function defineParametrizedScene<P extends object, D = unknown>(definition: ParametrizedSceneDefinition<P, D>): ParametrizedSceneDefinition<P, D>;
+/**
+ * Resolve the effective props for a definition: a clone of the defaults with
+ * the input props merged over them (input wins). Each input value is coerced to
+ * the type of its default; an uncoercible or unknown key falls back to the
+ * default. Reused by {@link renderParametrized} and {@link propsFromUrl}.
+ *
+ * @param definition - The parametrized scene definition.
+ * @param inputProps - Partial input props (unknown keys are ignored).
+ * @returns The fully resolved props.
+ */
+export declare function resolveProps<P extends object, D>(definition: ParametrizedSceneDefinition<P, D>, inputProps?: PropsRecord): P;
+/** Read props from the current URL hash and resolve them against the defaults. */
+export declare function propsFromUrl<P extends object, D>(definition: ParametrizedSceneDefinition<P, D>): P;
+/**
+ * Render a parametrized scene: merge input props over defaults (input wins),
+ * run `calculateMetadata` (which may fetch data and override size/fps/duration),
+ * apply the metadata to the scene, build the scene, and expose the resolved
+ * props as a shareable URL hash.
+ *
+ * Headless-safe: with no `scene` and no DOM it builds a headless scene and the
+ * URL write is a no-op. The data fetch goes through the injectable
+ * {@link DataFetcher} seam, so tests never touch the network.
+ *
+ * @param definition - The parametrized scene definition.
+ * @param inputProps - Partial input props (merged over the defaults).
+ * @param options - Scene, fetcher and URL-write options.
+ * @returns The built scene, resolved props, data, metadata and shareable URL.
+ */
+export declare function renderParametrized<P extends object, D = unknown>(definition: ParametrizedSceneDefinition<P, D>, inputProps?: PropsRecord, options?: RenderParametrizedOptions): Promise<ParametrizedRenderResult<P, D>>;
+//# sourceMappingURL=parametrized.d.ts.map

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

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