manim-web 0.27.0 → 0.29.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/mobjects/ml/ConvolutionalLayer.d.ts

@@ -0,0 +1,19 @@
+import { NeuralNetworkLayer } from './NeuralNetworkLayer';
+import { NodeStyleOptions } from './mlStyles';
+export interface ConvolutionalLayerOptions {
+    /** Number of feature-map squares in the stack. Default: 3. Must be >= 0. */
+    numFeatureMaps?: number;
+    /** Side length of each square feature map. Default: 0.5. */
+    mapSize?: number;
+    /** Diagonal offset between adjacent squares. Default: 0.15. */
+    offset?: number;
+    /** Node style overrides for the squares. */
+    nodeStyle?: NodeStyleOptions;
+}
+export declare class ConvolutionalLayer extends NeuralNetworkLayer {
+    private readonly _width;
+    constructor(options?: ConvolutionalLayerOptions);
+    /** Horizontal extent of the feature-map stack, used for spacing. */
+    layerWidth(): number;
+}
+//# sourceMappingURL=ConvolutionalLayer.d.ts.map

package/dist/mobjects/ml/ConvolutionalLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConvolutionalLayer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/ConvolutionalLayer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,yBAA8B;IAgBnD,oEAAoE;IAC3D,UAAU,IAAI,MAAM;CAG9B"}

package/dist/mobjects/ml/EdgePulse.d.ts

@@ -0,0 +1,30 @@
+import { VMobject } from '../../core/VMobject';
+import { Animation, AnimationOptions } from '../../animation/Animation';
+export interface EdgePulseOptions extends AnimationOptions {
+    /** Color the line takes when fully active. Default: white. */
+    activationColor?: string;
+    /** Peak stroke opacity at full activation. Default: 1. */
+    peakOpacity?: number;
+    /** When true, the line fades back to its resting look at alpha 1. Default: false. */
+    restore?: boolean;
+}
+export declare class EdgePulse extends Animation {
+    /** The activation level set on the most recent interpolate call, 0 to 1. */
+    activation: number;
+    private readonly _activationColor;
+    private readonly _peakOpacity;
+    private readonly _restore;
+    private _baseOpacity;
+    private _baseColor;
+    constructor(line: VMobject, options?: EdgePulseOptions);
+    begin(): void;
+    interpolate(alpha: number): void;
+    finish(): void;
+}
+/**
+ * Create an EdgePulse animation for one connection line.
+ * @param line - The connection line to animate.
+ * @param options - Activation color, peak opacity, restore and timing options.
+ */
+export declare function edgePulse(line: VMobject, options?: EdgePulseOptions): EdgePulse;
+//# sourceMappingURL=EdgePulse.d.ts.map

package/dist/mobjects/ml/EdgePulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgePulse.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/EdgePulse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIxE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,SAAU,SAAQ,SAAS;IACtC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAK;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,UAAU,CAAc;gBAEpB,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,gBAAqB;IAWjD,KAAK,IAAI,IAAI;IAOtB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYvB,MAAM,IAAI,IAAI;CAWxB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAE/E"}

package/dist/mobjects/ml/FeedForwardLayer.d.ts

@@ -0,0 +1,31 @@
+import { NeuralNetworkLayer } from './NeuralNetworkLayer';
+import { NodeStyleOptions } from './mlStyles';
+export interface FeedForwardLayerOptions {
+    /** Number of nodes (circles) in the column. Default: 3. Must be >= 0. */
+    numNodes?: number;
+    /** Radius of each node circle. Default: 0.25. */
+    nodeRadius?: number;
+    /** Vertical gap between the centers of adjacent nodes. Default: 0.7. */
+    nodeSpacing?: number;
+    /** Node style overrides. */
+    nodeStyle?: NodeStyleOptions;
+}
+export declare class FeedForwardLayer extends NeuralNetworkLayer {
+    private readonly _nodeRadius;
+    private readonly _nodeSpacing;
+    private readonly _nodeStyle;
+    constructor(options?: FeedForwardLayerOptions);
+    /**
+     * Build `count` circles in a vertical column centered on the local origin.
+     * @param count - Number of circles to create (0 leaves the layer empty).
+     */
+    private _buildNodes;
+    /** Get the radius of each node circle. */
+    getNodeRadius(): number;
+    /**
+     * Horizontal extent of the column (one circle wide), used for spacing.
+     * Stays positive even with zero nodes so the network can place an empty layer.
+     */
+    layerWidth(): number;
+}
+//# sourceMappingURL=FeedForwardLayer.d.ts.map

package/dist/mobjects/ml/FeedForwardLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedForwardLayer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/FeedForwardLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,OAAO,GAAE,uBAA4B;IAYjD;;;OAGG;IACH,OAAO,CAAC,WAAW;IAoBnB,0CAA0C;IAC1C,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACM,UAAU,IAAI,MAAM;CAG9B"}

package/dist/mobjects/ml/ImageLayer.d.ts

@@ -0,0 +1,29 @@
+import { NeuralNetworkLayer } from './NeuralNetworkLayer';
+import { NodeStyleOptions } from './mlStyles';
+export interface ImageLayerOptions {
+    /** Number of pixel rows. Default: 3. Must be >= 0. */
+    rows?: number;
+    /** Number of pixel columns. Default: 3. Must be >= 0. */
+    cols?: number;
+    /** Side length of each pixel cell. Default: 0.25. */
+    cellSize?: number;
+    /** Cell style overrides. */
+    nodeStyle?: NodeStyleOptions;
+}
+export declare class ImageLayer extends NeuralNetworkLayer {
+    private readonly _cols;
+    private readonly _cellSize;
+    private readonly _grid;
+    constructor(options?: ImageLayerOptions);
+    /**
+     * Build the pixel grid centered on the local origin.
+     * @param rows - Number of rows.
+     * @param cols - Number of columns.
+     * @param style - Resolved cell style.
+     * @returns A VGroup of cell rectangles (empty when rows or cols is 0).
+     */
+    private _buildGrid;
+    /** Horizontal extent of the grid, always positive for spacing. */
+    layerWidth(): number;
+}
+//# sourceMappingURL=ImageLayer.d.ts.map

package/dist/mobjects/ml/ImageLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageLayer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/ImageLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,iBAAsB;IAiB3C;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAwBlB,kEAAkE;IACzD,UAAU,IAAI,MAAM;CAG9B"}

package/dist/mobjects/ml/NeuralNetwork.d.ts

@@ -0,0 +1,69 @@
+import { VGroup } from '../../core/VGroup';
+import { Line } from '../geometry/Line';
+import { NeuralNetworkLayer } from './NeuralNetworkLayer';
+import { ConnectionStyleOptions } from './mlStyles';
+/**
+ * NeuralNetwork - a diagram of stacked layers with connection lines between
+ * adjacent layers (a manim-ml NeuralNetwork analogue).
+ *
+ * The network is a VGroup built from a list of layers. It places the layers
+ * left to right and, for every adjacent pair, draws a dense set of connection
+ * lines between their node anchors (n_i x n_{i+1} lines). Connections are added
+ * before the layers so they render behind the nodes.
+ */
+import * as THREE from 'three';
+export interface NeuralNetworkOptions {
+    /** Horizontal gap between adjacent layers. Default: 1. */
+    layerSpacing?: number;
+    /** Connection line style overrides. */
+    edgeStyle?: ConnectionStyleOptions;
+    /** When false, no connection lines are drawn. Default: true. */
+    connectAdjacent?: boolean;
+}
+export declare class NeuralNetwork extends VGroup {
+    private readonly _layers;
+    private readonly _connections;
+    /** Connection lines grouped by the gap they cross (stage i joins layer i and i+1). */
+    private readonly _stages;
+    private readonly _edgeStyle;
+    /**
+     * @param layers - The layers, drawn left to right in array order.
+     * @param options - Spacing, edge style and whether to connect layers.
+     */
+    constructor(layers?: NeuralNetworkLayer[], options?: NeuralNetworkOptions);
+    /**
+     * A container flattens its transform into its children (layers and lines)
+     * rather than baking its own geometry, matching GenericGraph.
+     */
+    normalizeTransform(worldMatrix?: THREE.Matrix4): this;
+    /**
+     * Place each layer so its center sits on a strictly increasing x, spaced by
+     * the layers' own widths plus `layerSpacing`. Uses shift (not moveTo) so an
+     * empty layer is positioned without measuring absent geometry.
+     * @param layerSpacing - Horizontal gap between adjacent layer edges.
+     */
+    private _placeLayers;
+    /**
+     * Build dense connection lines between every adjacent pair of layers.
+     * A pair contributes n_i x n_{i+1} lines; a 0-node layer contributes none.
+     */
+    private _buildConnections;
+    /** Get the layers in left-to-right order. */
+    getLayers(): NeuralNetworkLayer[];
+    /**
+     * Get a single layer by index.
+     * @param index - Zero-based layer index.
+     * @returns The layer, or undefined when the index is out of range.
+     */
+    getLayer(index: number): NeuralNetworkLayer | undefined;
+    /** Get the number of layers. */
+    get numLayers(): number;
+    /** Get every connection line, flattened across all gaps. */
+    getConnections(): Line[];
+    /**
+     * Get the connection lines grouped by gap. Entry i holds the lines that join
+     * layer i and layer i+1.
+     */
+    getConnectionStages(): Line[][];
+}
+//# sourceMappingURL=NeuralNetwork.d.ts.map

package/dist/mobjects/ml/NeuralNetwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeuralNetwork.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/NeuralNetwork.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,aAAc,SAAQ,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,sFAAsF;IACtF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;gBACS,MAAM,GAAE,kBAAkB,EAAO,EAAE,OAAO,GAAE,oBAAyB;IAkBjF;;;OAGG;IACM,kBAAkB,CAAC,WAAW,GAAE,KAAK,CAAC,OAA2B,GAAG,IAAI;IAIjF;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsBzB,6CAA6C;IAC7C,SAAS,IAAI,kBAAkB,EAAE;IAIjC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIvD,gCAAgC;IAChC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,4DAA4D;IAC5D,cAAc,IAAI,IAAI,EAAE;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,IAAI,EAAE,EAAE;CAGhC"}

package/dist/mobjects/ml/NeuralNetworkLayer.d.ts

@@ -0,0 +1,54 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * NeuralNetworkLayer - abstract base for every layer in a NeuralNetwork.
+ *
+ * A layer is a VGroup of node mobjects (circles, feature-map squares, a pixel
+ * grid). The NeuralNetwork places layers left to right and draws connection
+ * lines between the anchor points of adjacent layers. Each concrete layer
+ * exposes the same small interface so the network can treat them uniformly.
+ */
+import * as THREE from 'three';
+export declare abstract class NeuralNetworkLayer extends VGroup {
+    /**
+     * The node mobjects of this layer, in top-to-bottom order.
+     *
+     * A connection attaches to a node's center, so this list defines how many
+     * edges the network draws to the next layer. It may be empty (a layer with
+     * zero nodes), which the network treats as "no connections".
+     */
+    protected _nodes: VMobject[];
+    /**
+     * A container flattens its own transform into its children instead of baking
+     * geometry, exactly like GenericGraph. This keeps node centers and the
+     * connection lines (which the network positions in world space) correct when
+     * a scene normalizes the family.
+     */
+    normalizeTransform(worldMatrix?: THREE.Matrix4): this;
+    /**
+     * Get the node mobjects of this layer.
+     * @returns The nodes in top-to-bottom order (an empty array for a 0-node layer).
+     */
+    getNodes(): VMobject[];
+    /**
+     * Get the number of nodes (connection anchors) in this layer.
+     */
+    get numNodes(): number;
+    /**
+     * Get the world-space anchor point of each node, in node order.
+     *
+     * The network calls this after it has positioned the layer, so the centers
+     * already include the layer's placement offset.
+     * @returns One center per node (an empty array for a 0-node layer).
+     */
+    nodeAnchors(): Vector3Tuple[];
+    /**
+     * Get the horizontal extent used to space this layer from its neighbours.
+     *
+     * It must return a positive number even when the layer has zero nodes, so the
+     * network can lay out an empty layer without measuring absent geometry.
+     */
+    abstract layerWidth(): number;
+}
+//# sourceMappingURL=NeuralNetworkLayer.d.ts.map

package/dist/mobjects/ml/NeuralNetworkLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeuralNetworkLayer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/NeuralNetworkLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,8BAAsB,kBAAmB,SAAQ,MAAM;IACrD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAM;IAElC;;;;;OAKG;IACM,kBAAkB,CAAC,WAAW,GAAE,KAAK,CAAC,OAA2B,GAAG,IAAI;IAIjF;;;OAGG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAItB;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;OAMG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,IAAI,MAAM;CAC9B"}

package/dist/mobjects/ml/PoolingLayer.d.ts

@@ -0,0 +1,19 @@
+import { NeuralNetworkLayer } from './NeuralNetworkLayer';
+import { NodeStyleOptions } from './mlStyles';
+export interface PoolingLayerOptions {
+    /** Number of feature-map squares in the stack. Default: 3. Must be >= 0. */
+    numFeatureMaps?: number;
+    /** Side length of each square feature map. Default: 0.3. */
+    mapSize?: number;
+    /** Diagonal offset between adjacent squares. Default: 0.12. */
+    offset?: number;
+    /** Node style overrides for the squares. */
+    nodeStyle?: NodeStyleOptions;
+}
+export declare class PoolingLayer extends NeuralNetworkLayer {
+    private readonly _width;
+    constructor(options?: PoolingLayerOptions);
+    /** Horizontal extent of the feature-map stack, used for spacing. */
+    layerWidth(): number;
+}
+//# sourceMappingURL=PoolingLayer.d.ts.map

package/dist/mobjects/ml/PoolingLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolingLayer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/PoolingLayer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,mBAAwB;IAgB7C,oEAAoE;IAC3D,UAAU,IAAI,MAAM;CAG9B"}

package/dist/mobjects/ml/featureMapStack.d.ts

@@ -0,0 +1,25 @@
+import { VMobject } from '../../core/VMobject';
+import { ResolvedNodeStyle } from './mlStyles';
+export interface FeatureMapStackConfig {
+    /** Number of stacked feature-map squares. Must be >= 0. */
+    numFeatureMaps: number;
+    /** Side length of each square feature map. */
+    mapSize: number;
+    /** Diagonal offset between adjacent squares in the stack. */
+    offset: number;
+    /** Resolved node style for the squares. */
+    style: ResolvedNodeStyle;
+}
+export interface FeatureMapStackResult {
+    /** The feature-map squares, front (first) to back (last). */
+    nodes: VMobject[];
+    /** Horizontal extent of the stack, always positive. */
+    width: number;
+}
+/**
+ * Build a diagonal stack of square feature maps centered on the local origin.
+ * @param config - Count, size, offset and style of the stack.
+ * @returns The square nodes and the stack's horizontal extent.
+ */
+export declare function buildFeatureMapStack(config: FeatureMapStackConfig): FeatureMapStackResult;
+//# sourceMappingURL=featureMapStack.d.ts.map

package/dist/mobjects/ml/featureMapStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureMapStack.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/featureMapStack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAyBzF"}

package/dist/mobjects/ml/forwardPass.d.ts

@@ -0,0 +1,28 @@
+import { Animation } from '../../animation/Animation';
+import { NeuralNetwork } from './NeuralNetwork';
+import { EdgePulseOptions } from './EdgePulse';
+export interface ForwardPassOptions extends EdgePulseOptions {
+    /**
+     * Overlap between consecutive gaps. 1 is strictly sequential (one gap fully
+     * lit before the next starts), 0 is all gaps at once. Default: 1.
+     */
+    lagRatio?: number;
+    /** Duration of each gap's pulse in seconds. Default: 1. */
+    gapDuration?: number;
+}
+/**
+ * Animate a forward pass: light each gap's connections from input to output.
+ * @param network - The network to animate.
+ * @param options - Pulse color/opacity, lagRatio and per-gap duration.
+ * @returns A LaggedStart over the gaps (an empty, zero-duration one for a
+ *          network with fewer than two layers).
+ */
+export declare function forwardPass(network: NeuralNetwork, options?: ForwardPassOptions): Animation;
+/**
+ * Animate a backward pass: light each gap's connections from output to input.
+ * @param network - The network to animate.
+ * @param options - Pulse color/opacity, lagRatio and per-gap duration.
+ * @returns A LaggedStart over the gaps in reverse order.
+ */
+export declare function backwardPass(network: NeuralNetwork, options?: ForwardPassOptions): Animation;
+//# sourceMappingURL=forwardPass.d.ts.map