@noctiluz/simulations

Interactive simulation components library for educational purposes.

Features

• 🎨 React + Motion - Beautiful animations with Framer Motion
• 🧮 Math & Physics - Ready-to-use educational components
• 🔄 Real-time Interactive - Change parameters on the fly
• 📦 Functional - Pure functions, no classes
• 🎯 TypeScript - Full type safety

Quick Start

import { LinearEquationVisualizer, createVector, calculateKineticEnergy } from "@noctiluz/simulations";

// Use a component
<LinearEquationVisualizer
  initialData={{ slope: 2, intercept: 1 }}
  onChange={(data) => console.log(data)}
  showGrid={true}
/>

// Use pure functions
const v1 = createVector(3, 4);
const v2 = { x: 1, y: 2 };  // Plain object!
const sum = addVectors(v1, v2);

const energy = calculateKineticEnergy(10, 5); // 125 J

Available Components

• LinearEquationVisualizer - Interactive y = mx + b graph
• ProjectileMotionSimulator - Physics trajectory simulation

Documentation

📖 Complete Guide - API reference, examples, and best practices

Development

# Build after changes
cd libs/simulations && pnpm build

Philosophy

Built with functional programming principles:

• Plain objects instead of classes
• Pure functions for calculations
• Real-time updates without lifecycle ceremony
• Immutable state for predictability

Perfect for educational platforms! 🎉