Documentation/Core Engine & Primitives

Micro-Primitives & Physics Engine

Low-level building blocks powering all 25 transitions and 14 typography effects. Zero dependencies, pure mathematical springs, Fourier liquid splines, and Web Audio.

class SpringPhysics

A continuous analytical spring solver using Euler integration:

typescript
1import { Spring } from 'motion-organic';
2
3const spring = new Spring({
4 stiffness: 180,
5 damping: 20,
6 mass: 1.0,
7});
8
9spring.setTarget(100);
class ShapeMorphSVG Splines

Sub-samples SVG paths into equal Fourier points and generates continuous cubic bezier curves:

typescript
1import { ShapeMorph } from 'motion-organic';
2
3const morph = new ShapeMorph(pathA, pathB, { points: 64, smooth: true });
4const midPath = morph.to(0.5);
MoAudioWeb Audio
typescript
1import { MoAudio } from 'motion-organic';
2
3// Play sound profile: 'liquid' | 'whoosh' | 'fabric' | 'portal' | 'shutter' | 'subtle'
4MoAudio.play('liquid', { velocity: 1.2, volume: 0.3 });
SpatialHorizon & spatialHorizonMoHorizon 3D Engine

Cinema-grade 3D Cylindrical Horizon Roll & Spatial Perspective Depth engine. Computes trigonometric drum pitch ($\theta = \arcsin(\Delta y / R)$) and receding Z-depth ($Z = -R(1 - \cos\theta)$):

typescript
1import { spatialHorizon, scrollTracker } from 'motion-organic';
2
3// Project element onto virtual 3D cylindrical horizon
4const unbind = spatialHorizon.add(document.getElementById('card'), {
5 radius: 1200,
6 perspective: 1000,
7 pitchFactor: 1.0,
8 depthFactor: 1.2,
9 shading: true,
10 onUpdate: ({ theta, z, opacity }) => {
11 // Real-time 3D telemetry
12 },
13});