[Migration] NPM (#1266)

* chore: add npm + vite for progressive enhancement

* fix: update Dockerfile to copy only the dist folder contents

* fix: update Dockerfile to use multi-stage build for optimized production image

* fix: correct nginx config file copy command in Dockerfile

* chore: add netlify configuration for build and redirects

* fix: add NODE_VERSION to environment in Netlify configuration

* remove wrong dist folder

* Update package.json

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* chore: split public and src

* migrating all util files from js to ts

* feat: Implement HeightmapGenerator and Voronoi module

- Added HeightmapGenerator class for generating heightmaps with various tools (Hill, Pit, Range, Trough, Strait, etc.).
- Introduced Voronoi class for creating Voronoi diagrams using Delaunator.
- Updated index.html to include new modules.
- Created index.ts to manage module imports.
- Enhanced arrayUtils and graphUtils with type definitions and improved functionality.
- Added utility functions for generating grids and calculating Voronoi cells.

* chore: add GitHub Actions workflow for deploying to GitHub Pages

* fix: update branch name in GitHub Actions workflow from 'main' to 'master'

* chore: update package.json to specify Node.js engine version and remove unused launch.json

* Initial plan

* Update copilot guidelines to reflect NPM/Vite/TypeScript migration

Co-authored-by: Azgaar <26469650+Azgaar@users.noreply.github.com>

* Update src/modules/heightmap-generator.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/utils/graphUtils.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/modules/heightmap-generator.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* feat: Add TIME and ERROR variables to global scope in HeightmapGenerator

* fix: Update base path in vite.config.ts for Netlify deployment

* fix: Update Node.js version in Dockerfile to 24-alpine

---------

Co-authored-by: Marc Emmanuel <marc.emmanuel@tado.com>
Co-authored-by: Marc Emmanuel <marcwissler@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Azgaar <26469650+Azgaar@users.noreply.github.com>

src/utils/numberUtils.ts

@@ -0,0 +1,62 @@
+/**
+ * Rounds a number to a specified number of decimal places.
+ * @param v - The number to be rounded.
+ * @param d - The number of decimal places to round to (default is 0).
+ * @returns The rounded number.
+ */
+export const rn = (v: number, d: number = 0) => {
+  const m = Math.pow(10, d);
+  return Math.round(v * m) / m;
+}
+
+/**
+ * Clamps a number between a minimum and maximum value.
+ * @param value - The number to be clamped.
+ * @param min - The minimum value.
+ * @param max - The maximum value.
+ * @returns The clamped number.
+ */
+export const minmax = (value: number, min: number, max: number) => {
+  return Math.min(Math.max(value, min), max);
+}
+
+/**
+ * Clamps a number between 0 and 100.
+ * @param v - The number to be clamped.
+ * @returns The clamped number.
+ */
+export const lim = (v: number) => {
+  return minmax(v, 0, 100);
+}
+
+/**
+ * Normalizes a number within a specified range to a value between 0 and 1.
+ * @param val - The number to be normalized.
+ * @param min - The minimum value of the range.
+ * @param max - The maximum value of the range.
+ * @returns The normalized number.
+ */
+export const normalize = (val: number, min: number, max: number) => {
+  return minmax((val - min) / (max - min), 0, 1);
+}
+
+/**
+ * Performs linear interpolation between two values.
+ * @param a - The starting value.
+ * @param b - The ending value.
+ * @param t - The interpolation factor (between 0 and 1).
+ * @returns The interpolated value.
+ */
+export const lerp = (a: number, b: number, t: number) => {
+  return a + (b - a) * t;
+}
+
+declare global {
+  interface Window {
+    rn: typeof rn;
+    minmax: typeof minmax;
+    lim: typeof lim;
+    normalize: typeof normalize;
+    lerp: typeof lerp;
+  }
+}