manim-web 0.26.0 → 0.28.0

package/dist/mobjects/graphing/GanttChart.d.ts

@@ -0,0 +1,179 @@
+import { VGroup } from '../../core/VGroup';
+import { VMobject } from '../../core/VMobject';
+import { Rectangle } from '../geometry/Rectangle';
+import { Line } from '../geometry/Line';
+import { GanttTaskSpec } from './ganttLayout';
+/** A time value, given either as a number or a Date. */
+export type GanttTimeValue = number | Date;
+/**
+ * One task on the timeline.
+ */
+export interface GanttTask {
+    /** Unique task name, used for labels and as a dependency reference. */
+    name: string;
+    /** Start of the task (number or Date). */
+    start: GanttTimeValue;
+    /** End of the task (number or Date). */
+    end: GanttTimeValue;
+    /** Row key. Tasks that share a key share a row. Default: the task name. */
+    row?: string;
+    /** Explicit bar color. Default: cycled from the palette by row. */
+    color?: string;
+    /** Names of tasks this task depends on (for dependency arrows). */
+    dependencies?: string[];
+}
+/**
+ * Options for creating a GanttChart.
+ */
+export interface GanttChartOptions {
+    /** Tasks to render, top to bottom in row order. */
+    tasks: GanttTask[];
+    /** Visual width of the time axis. Default: 8 */
+    width?: number;
+    /** Height of each task bar. Default: 0.4 */
+    rowHeight?: number;
+    /** Vertical gap between rows. Default: 0.2 */
+    rowGap?: number;
+    /** Bar colors. Single color applies to all, array cycles by row. Default: palette. */
+    barColors?: string | readonly string[];
+    /** Fill opacity of the bars. Default: 0.9 */
+    barFillOpacity?: number;
+    /** Stroke width of the bar outline. Default: 1.5 */
+    barStrokeWidth?: number;
+    /** Color for the axis, ticks and labels. Default: WHITE */
+    axisColor?: string;
+    /** Whether to draw the time axis line and ticks. Default: true */
+    showTimeAxis?: boolean;
+    /** Explicit tick values on the time axis (overrides timeTickCount). */
+    timeTicks?: GanttTimeValue[];
+    /** Number of evenly spaced ticks when timeTicks is not given. Default: 5 */
+    timeTickCount?: number;
+    /** Formatter for a tick value. Default: ISO date for Date input, else the number. */
+    formatTime?: (value: number) => string;
+    /** Font size for the time-axis labels. Default: 18 */
+    timeLabelFontSize?: number;
+    /** Whether to draw the per-row task labels. Default: true */
+    showLabels?: boolean;
+    /** Font size for the task labels. Default: 18 */
+    labelFontSize?: number;
+    /** Whether to draw dependency arrows between tasks. Default: false */
+    showDependencies?: boolean;
+    /** Color for the dependency arrows. Default: WHITE */
+    dependencyColor?: string;
+    /** Stroke width of the dependency arrows. Default: 2 */
+    dependencyStrokeWidth?: number;
+    /** Optional "today" marker position (number or Date). */
+    today?: GanttTimeValue;
+    /** Color for the today marker. Default: RED */
+    todayColor?: string;
+    /** Stroke width of the today marker. Default: 2 */
+    todayStrokeWidth?: number;
+}
+/**
+ * GanttChart - A project-timeline chart mobject.
+ *
+ * Each task is a horizontal bar that spans its start to its end on a shared time
+ * x-axis. Each task sits on one row. Tasks that share a `row` key share a row and
+ * may overlap. Optional dependency arrows point from a predecessor's end to a
+ * dependent task's start. An optional "today" marker draws a vertical line.
+ *
+ * Time values are numbers or Dates; a Date is read through getTime(). A task
+ * whose end is at or before its start keeps a minimum-width bar anchored at its
+ * start, so the bar count always equals the task count.
+ *
+ * The chart is a VGroup, so Create and FadeIn animate it directly.
+ *
+ * @example
+ * ```typescript
+ * const chart = new GanttChart({
+ *   tasks: [
+ *     { name: 'Design', start: 0, end: 3 },
+ *     { name: 'Build', start: 3, end: 8, dependencies: ['Design'] },
+ *   ],
+ *   showDependencies: true,
+ *   today: 5,
+ * });
+ * scene.play(new Create(chart));
+ * ```
+ */
+export declare class GanttChart extends VGroup {
+    /** The task bars, one per task, in task order. */
+    bars: VGroup;
+    /** The per-row task labels. */
+    taskLabels: VGroup;
+    /** The dependency arrows (empty unless showDependencies is set). */
+    dependencyArrows: VGroup;
+    /** The time axis line. */
+    timeAxis: VMobject;
+    /** The time-axis tick labels. */
+    timeLabels: VGroup;
+    /** The today marker, when a today value is given; otherwise null. */
+    todayMarker: Line | null;
+    protected _tasks: GanttTask[];
+    protected _width: number;
+    protected _rowHeight: number;
+    protected _rowGap: number;
+    protected _barColors: string[];
+    protected _barFillOpacity: number;
+    protected _barStrokeWidth: number;
+    protected _axisColor: string;
+    protected _showTimeAxis: boolean;
+    protected _timeTicks: number[] | null;
+    protected _timeTickCount: number;
+    protected _formatTime: (value: number) => string;
+    protected _timeLabelFontSize: number;
+    protected _showLabels: boolean;
+    protected _labelFontSize: number;
+    protected _showDependencies: boolean;
+    protected _dependencyColor: string;
+    protected _dependencyStrokeWidth: number;
+    protected _today: number | null;
+    protected _todayColor: string;
+    protected _todayStrokeWidth: number;
+    protected _specs: GanttTaskSpec[];
+    protected _rowKeys: string[];
+    protected _timeRange: [number, number];
+    protected _indexByName: Map<string, number>;
+    private _usesDates;
+    constructor(options: GanttChartOptions);
+    /** Default tick formatter: ISO date for Date input, else a trimmed number. */
+    private _defaultFormat;
+    /** Convert a time value to its x-coordinate on the time axis. */
+    valueToX(value: GanttTimeValue): number;
+    /** Y-coordinate of the center of row `rowIndex` (row 0 is topmost). */
+    rowCenterY(rowIndex: number): number;
+    /** Top y-coordinate of the chart area (above the top row). */
+    private _chartTop;
+    /** Create the horizontal time axis line below the bottom row. */
+    private _createTimeAxis;
+    /** Build one bar per task spec. */
+    private _createBars;
+    /** Build the time-axis tick labels. */
+    private _createTimeLabels;
+    /** The tick values along the time axis. */
+    private _tickValues;
+    /** Build one label per row, placed to the left of the chart. */
+    private _createTaskLabels;
+    /** Build an arrow from each dependency's end to the dependent task's start. */
+    private _createDependencyArrows;
+    /** Build the vertical today marker. */
+    private _createTodayMarker;
+    /** Get the group of task bars. */
+    getBars(): VGroup;
+    /** Get the bar for a task by name, or undefined when there is no such task. */
+    getBar(name: string): Rectangle | undefined;
+    /** Get the group of dependency arrows (empty unless showDependencies is set). */
+    getDependencyArrows(): VGroup;
+    /** Get the today marker, or null when no today value was given. */
+    getTodayMarker(): Line | null;
+    /** Get the time range as [min start, max end]. */
+    getTimeRange(): [number, number];
+    /** Get the number of rows. */
+    getRowCount(): number;
+    /** Get the task definitions. */
+    getTasks(): GanttTask[];
+    /** Get the visual width of the time axis. */
+    getChartWidth(): number;
+    copy(): GanttChart;
+}
+//# sourceMappingURL=GanttChart.d.ts.map

package/dist/mobjects/graphing/GanttChart.d.ts.map

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

package/dist/mobjects/graphing/ganttLayout.d.ts

@@ -0,0 +1,36 @@
+import { GanttTask, GanttTimeValue } from './GanttChart';
+/** One resolved task, ready to render. */
+export interface GanttTaskSpec {
+    /** Task name. */
+    name: string;
+    /** Start time as a number. */
+    startValue: number;
+    /** End time as a number. */
+    endValue: number;
+    /** Index of the row the task sits on. */
+    rowIndex: number;
+    /** Resolved bar color. */
+    color: string;
+    /** Names of the tasks this task depends on. */
+    dependencies: string[];
+}
+/** The resolved specs plus the distinct row keys, in row order. */
+export interface GanttLayout {
+    /** One spec per task, in task order. */
+    specs: GanttTaskSpec[];
+    /** Distinct row keys, in first-appearance (top-to-bottom) order. */
+    rowKeys: string[];
+}
+/** Read a time value as a number. A Date is read through getTime(). */
+export declare function toTimeNumber(value: GanttTimeValue): number;
+/**
+ * Resolve tasks into render specs and the ordered list of rows.
+ *
+ * The row key of a task is its `row`, or its name when `row` is absent, so a
+ * task without a row key gets its own row. Colors come from the task's own
+ * color, or the palette cycled by row index.
+ */
+export declare function resolveGanttLayout(tasks: GanttTask[], palette: string[]): GanttLayout;
+/** Time range as [min start, max end] across all specs. */
+export declare function ganttTimeRange(specs: GanttTaskSpec[]): [number, number];
+//# sourceMappingURL=ganttLayout.d.ts.map

package/dist/mobjects/graphing/ganttLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ganttLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ganttLayout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAwBrF;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWvE"}

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

@@ -33,6 +33,7 @@ export { CalendarHeatmap, GITHUB_GREENS, type CalendarHeatmapOptions, type Calen
 export { CandlestickChart, type CandlestickChartOptions, type OHLC } from './CandlestickChart';
 export { RadarChart, type RadarChartOptions } from './RadarChart';
 export { WaterfallChart, type WaterfallChartOptions } from './WaterfallChart';
+export { GanttChart, type GanttChartOptions, type GanttTask, type GanttTimeValue, } from './GanttChart';
 export { PieChart, type PieChartOptions, DonutChart, type DonutChartOptions, computeSliceGeometry, type SliceGeometry, type LabelPosition, } from './PieChart';
 export { Treemap, type TreemapOptions, type TreemapColorBy } from './Treemap';
 export { computeTreemapLayout, squarify, treemapNodeValue, type TreemapNode, type TreemapRect, type TreemapTile, } from './treemapLayout';

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"forwardPass.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/forwardPass.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAa,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8BD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAGhG"}

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

@@ -0,0 +1,18 @@
+/**
+ * Neural-network / ML diagram toolkit for manim-web.
+ *
+ * A manim-ml analogue built purely by composition: layers are VGroups of
+ * geometry, the network arranges them and draws connections, and forward /
+ * backward passes animate a signal flowing through the connections.
+ */
+export { type NodeStyleOptions, type ConnectionStyleOptions, type ResolvedNodeStyle, type ResolvedEdgeStyle, DEFAULT_NODE_STYLE, DEFAULT_EDGE_STYLE, DEFAULT_ACTIVATION_COLOR, resolveNodeStyle, resolveEdgeStyle, } from './mlStyles';
+export { NeuralNetworkLayer } from './NeuralNetworkLayer';
+export { FeedForwardLayer, type FeedForwardLayerOptions } from './FeedForwardLayer';
+export { ConvolutionalLayer, type ConvolutionalLayerOptions } from './ConvolutionalLayer';
+export { PoolingLayer, type PoolingLayerOptions } from './PoolingLayer';
+export { ImageLayer, type ImageLayerOptions } from './ImageLayer';
+export { buildFeatureMapStack, type FeatureMapStackConfig, type FeatureMapStackResult, } from './featureMapStack';
+export { NeuralNetwork, type NeuralNetworkOptions } from './NeuralNetwork';
+export { EdgePulse, edgePulse, type EdgePulseOptions } from './EdgePulse';
+export { forwardPass, backwardPass, type ForwardPassOptions } from './forwardPass';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/ml/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC"}