samengine 1.9.1 → 1.10.1

package/dist/types/vector3d.js

@@ -1,6 +1,8 @@
 // 3d Vector
 import { clamp, lerp, map } from "../utils/math.js";
-// Function to create an Object of Type Vector3D
+/**
+ * Creates a new 3D vector.
+ */
 export function makeVector3d(x, y, z) {
     return {
         x: x,
@@ -8,7 +10,9 @@ export function makeVector3d(x, y, z) {
         z: z
     };
 }
-// Function to add 2 Vectors together
+/**
+ * Adds two vectors and returns a new vector.
+ */
 export function add3d(vector1, vector2) {
     return {
         x: vector1.x + vector2.x,
@@ -16,7 +20,9 @@ export function add3d(vector1, vector2) {
         z: vector1.z + vector2.z,
     };
 }
-// Function to subtract 2 Vectors from each other
+/**
+ * Subtracts `vector2` from `vector1` and returns a new vector.
+ */
 export function subtract3d(vector1, vector2) {
     return {
         x: vector1.x - vector2.x,
@@ -24,13 +30,19 @@ export function subtract3d(vector1, vector2) {
         z: vector1.z - vector2.z,
     };
 }
-// Function to get the length from an Vector
+/**
+ * Returns the Euclidean length/magnitude of a 3D vector.
+ */
 export function length3d(vector) {
     let produkt = vector.x * vector.x + vector.y * vector.y + vector.z * vector.z;
     let root = Math.sqrt(produkt);
     return root;
 }
-// Function to normalize a Vector 2d
+/**
+ * Normalizes a vector to length `1`.
+ *
+ * Important: this function mutates and returns the original vector object.
+ */
 export function normalize3d(vector) {
     // Check if the Vector is zero because then you dont need to
     // calculate sth
@@ -43,11 +55,15 @@ export function normalize3d(vector) {
     vector.z = vector.z / root;
     return vector;
 }
-// Function to make scalar produkt from an Vector
+/**
+ * Returns the dot product of two vectors.
+ */
 export function dot3d(v1, v2) {
     return (v1.x * v2.x + v1.y * v2.y + v1.z * v2.z);
 }
-// Function to calculate the cross produkt
+/**
+ * Returns the cross product of two 3D vectors.
+ */
 export function crossprodukt3d(v1, v2) {
     return {
         x: (v1.y * v2.z - v1.z * v2.y),
@@ -55,12 +71,16 @@ export function crossprodukt3d(v1, v2) {
         z: (v1.x * v2.y - v1.y * v2.x),
     };
 }
-// Calculate the Distance between 2 Vectors
+/**
+ * Returns the distance between two 3D vector positions.
+ */
 export function distance3d(v1, v2) {
     let tmp = subtract3d(v1, v2);
     return length3d(tmp);
 }
-// Function to clamp a Vector 3d
+/**
+ * Clamps vector components between the matching `min` and `max` components.
+ */
 export function clamp3d(vector, min, max) {
     return {
         x: clamp(vector.x, min.x, max.x),
@@ -68,7 +88,9 @@ export function clamp3d(vector, min, max) {
         z: clamp(vector.y, min.y, max.y),
     };
 }
-// Lerp for a 3d Vector
+/**
+ * Linearly interpolates each component from `start` to `end`.
+ */
 export function lerp3d(start, end, t) {
     return {
         x: lerp(start.x, end.x, t.x),
@@ -76,7 +98,9 @@ export function lerp3d(start, end, t) {
         z: lerp(start.y, end.y, t.y),
     };
 }
-// Map Function for a 3d Vector
+/**
+ * Maps each vector component from one numeric range into another range.
+ */
 export function map3d(value, inMin, inMax, outMin, outMax) {
     return {
         x: map(value.x, inMin.x, inMax.x, outMin.x, outMax.x),

package/dist/utils/index.d.ts

@@ -1,7 +1,14 @@
 export { clamp, lerp, map, scale } from "./math.js";
-export type { ParseOptions as MarkdownParseOptions } from "./markdown.js";
-export { parse as parseMarkdown, parseToDocument as parseMarkdownToDocument, exportcss as exportMarkdownCSS } from "./markdown.js";
-export type { JSONValue } from "./jsonc-parser.js";
-export { parseJSONC } from "./jsonc-parser.js";
+/**
+ * Creates a small deterministic 32-bit hash from a string.
+ *
+ * Used internally by the immediate-mode HTML UI to turn labels into stable
+ * numeric ids. This is not a cryptographic hash.
+ */
 export declare function hash(str: string): number;
+/**
+ * Shuffles an array in place using the Fisher-Yates algorithm.
+ *
+ * The same array instance is returned for convenient chaining.
+ */
 export declare function shuffle<T>(array: T[]): T[];

package/dist/utils/index.js

@@ -1,9 +1,12 @@
 // Utils Package
 // Math Utilities
 export { clamp, lerp, map, scale } from "./math.js";
-export { parse as parseMarkdown, parseToDocument as parseMarkdownToDocument, exportcss as exportMarkdownCSS } from "./markdown.js";
-export { parseJSONC } from "./jsonc-parser.js";
-// Tiny Hash function
+/**
+ * Creates a small deterministic 32-bit hash from a string.
+ *
+ * Used internally by the immediate-mode HTML UI to turn labels into stable
+ * numeric ids. This is not a cryptographic hash.
+ */
 export function hash(str) {
     let h = 0;
     for (let i = 0; i < str.length; i++) {
@@ -12,7 +15,11 @@ export function hash(str) {
     }
     return h;
 }
-// Make an array random
+/**
+ * Shuffles an array in place using the Fisher-Yates algorithm.
+ *
+ * The same array instance is returned for convenient chaining.
+ */
 export function shuffle(array) {
     for (let i = array.length - 1; i > 0; i--) {
         const j = Math.floor(Math.random() * (i + 1));

package/dist/utils/logger/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Function to get the Date for the Logger
+ * @returns String for the current Date
+ */
+export declare function getDate(): string;
+/**
+ * Logger Class for samengine
+ */
+export declare class Logger {
+    constructor();
+    log(input: string): void;
+    warn(input: string): void;
+    error(input: string): void;
+}
+/**
+ * Logger Class with the same functions but they are doing nothing
+ * to remove the console logs in the export
+ */
+export declare class ExportLogger {
+    constructor();
+    log(input: string): void;
+    warn(input: string): void;
+    error(input: string): void;
+}

package/dist/utils/logger/index.js

@@ -0,0 +1,44 @@
+// Logger
+/**
+ * Function to get the Date for the Logger
+ * @returns String for the current Date
+ */
+export function getDate() {
+    const now = new Date();
+    const time = `[${now.getHours().toString().padStart(2, "0")}:` +
+        `${now.getMinutes().toString().padStart(2, "0")}:` +
+        `${now.getSeconds().toString().padStart(2, "0")}.` +
+        `${now.getMilliseconds().toString().padStart(3, "0")}]`;
+    return time;
+}
+/**
+ * Logger Class for samengine
+ */
+export class Logger {
+    constructor() { }
+    log(input) {
+        console.log(`${getDate()} ${input}`);
+    }
+    warn(input) {
+        console.warn(`${getDate()} ${input}`);
+    }
+    error(input) {
+        console.error(`${getDate()} ${input}`);
+    }
+}
+/**
+ * Logger Class with the same functions but they are doing nothing
+ * to remove the console logs in the export
+ */
+export class ExportLogger {
+    constructor() { }
+    log(input) {
+        // Empty
+    }
+    warn(input) {
+        // Empty
+    }
+    error(input) {
+        // Empty
+    }
+}

package/dist/utils/math.d.ts

@@ -1,4 +1,22 @@
+/**
+ * Restricts a number to the inclusive range between `min` and `max`.
+ */
 export declare function clamp(input: number, min: number, max: number): number;
+/**
+ * Linear interpolation between `start` and `end`.
+ *
+ * `t = 0` returns `start`, `t = 1` returns `end`, and values between them blend.
+ */
 export declare function lerp(start: number, end: number, t: number): number;
+/**
+ * Maps a number from one range into another range.
+ *
+ * Example: `map(5, 0, 10, 0, 100)` returns `50`.
+ */
 export declare function map(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+/**
+ * Multiplies two numbers.
+ *
+ * Kept as a tiny utility so vector helpers can use the same naming style.
+ */
 export declare function scale(n1: number, n2: number): number;

package/dist/utils/math.js

@@ -1,16 +1,30 @@
-// Clamp
+/**
+ * Restricts a number to the inclusive range between `min` and `max`.
+ */
 export function clamp(input, min, max) {
     return Math.min(Math.max(input, min), max);
 }
-// Lerp
+/**
+ * Linear interpolation between `start` and `end`.
+ *
+ * `t = 0` returns `start`, `t = 1` returns `end`, and values between them blend.
+ */
 export function lerp(start, end, t) {
     return (start + (end - start) * t);
 }
-// Map
+/**
+ * Maps a number from one range into another range.
+ *
+ * Example: `map(5, 0, 10, 0, 100)` returns `50`.
+ */
 export function map(value, inMin, inMax, outMin, outMax) {
     return (outMax - outMin) * ((value - inMin) / (inMax - inMin)) + outMin;
 }
-// Scale
+/**
+ * Multiplies two numbers.
+ *
+ * Kept as a tiny utility so vector helpers can use the same naming style.
+ */
 export function scale(n1, n2) {
     return n1 * n2;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samengine",
-  "version": "1.9.1",
+  "version": "1.10.1",
   "description": "A TypeScript game library to make HTML Games",
   "sideEffects": false,
   "files": [
@@ -12,35 +12,53 @@
     "pack": "node ../../scripts/clean.js && npm run build && npm pack && git push --follow-tags && npm run up",
     "test": "bun test"
   },
+  "bin": {
+    "samengine": "dist/nonbrowser/internal/cli/main.js",
+    "samengine-proj": "dist/nonbrowser/internal/projcreator/main.js"
+  },
   "exports": {
     ".": "./dist/index.js",
     "./types": "./dist/types/index.js",
     "./sound": "./dist/sound/index.js",
     "./utils": "./dist/utils/index.js",
-    "./utils/csv": "./dist/utils/csv/index.js",
+    "./utils/logger": "./dist/utils/logger/index.js",
     "./build": "./dist/build/index.js",
     "./physics": "./dist/physics/index.js",
     "./samegui": "./dist/samegui/index.js",
-    "./storage": "./dist/storage/index.js"
+    "./storage": "./dist/storage/index.js",
+    "./text": "./dist/text/index.js",
+    "./config": "./dist/config/index.js",
+    "./nonbrowser": "./dist/nonbrowser/index.js"
   },
   "keywords": [
     "game",
-    "typescript"
+    "typescript",
+    "gamelib"
   ],
   "author": "Shadowdara",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
-    "chalk": "^5.6.2",
-    "@types/node": "^25.6.0",
-    "typescript": "^6.0.3",
-    "automatic-md-index": "^1.3.6"
+    "@types/html-minifier-terser": "^7.0.2",
+    "@types/node": "^25.9.4",
+    "@types/ws": "^8.18.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/shadowdara/samengine"
+    "url": "https://github.com/shadowdara/samengine",
+    "directory": "packages/samengine"
   },
   "bugs": {
     "url": "https://github.com/shadowdara/samengine/issues"
   },
-  "type": "module"
+  "type": "module",
+  "dependencies": {
+    "esbuild": "^0.28.0",
+    "html-minifier-terser": "^7.2.0",
+    "mime": "^4.1.0",
+    "ws": "^8.20.0",
+    "chalk": "^5.6.2",
+    "samengine-cli": "2.0.4"
+  }
 }

package/dist/utils/csv/index.d.ts

@@ -1,3 +0,0 @@
-export { CSVParser } from "./parser.js";
-export { CSVStringifier } from "./stringifier.js";
-export type { CSVParserOptions, CSVStringifierOptions, EscapeRules, ParseResult } from "./types.js";

package/dist/utils/csv/index.js

@@ -1,2 +0,0 @@
-export { CSVParser } from "./parser.js";
-export { CSVStringifier } from "./stringifier.js";

package/dist/utils/csv/parser.d.ts

@@ -1,25 +0,0 @@
-import type { CSVParserOptions, ParseResult } from "./types";
-/**
- * RFC 4180-konformer CSV-Parser mit erweitertem Escaping.
- *
- * Unterstützt:
- *  - Gequotete Felder mit eingebetteten Zeilenumbrüchen, Trennzeichen und Anführungszeichen
- *  - Doppelt-Anführungszeichen-Escaping: "" → "
- *  - Optionales Backslash-Escaping: \" → "
- *  - Konfigurierbare Trennzeichen, Anführungszeichen, Kommentar-Zeilen
- *  - Warnung bei ungleicher Feldanzahl
- */
-export declare class CSVParser {
-    private readonly opts;
-    constructor(options?: CSVParserOptions);
-    /**
-     * Parst einen CSV-String und gibt strukturierte Daten zurück.
-     */
-    parse<T = Record<string, string>>(text: string): ParseResult<T>;
-    /**
-     * Parst einen CSV-String und gibt ausschließlich die Records zurück.
-     * Kurzform für einfache Anwendungsfälle.
-     */
-    parseRecords<T = Record<string, string>>(text: string): T[];
-    private tokenize;
-}

package/dist/utils/csv/parser.js

@@ -1,212 +0,0 @@
-const DEFAULT_OPTIONS = {
-    delimiter: ",",
-    quoteChar: '"',
-    escapeChar: "",
-    hasHeader: true,
-    trimFields: false,
-    skipEmptyLines: true,
-    commentChar: "",
-};
-/**
- * RFC 4180-konformer CSV-Parser mit erweitertem Escaping.
- *
- * Unterstützt:
- *  - Gequotete Felder mit eingebetteten Zeilenumbrüchen, Trennzeichen und Anführungszeichen
- *  - Doppelt-Anführungszeichen-Escaping: "" → "
- *  - Optionales Backslash-Escaping: \" → "
- *  - Konfigurierbare Trennzeichen, Anführungszeichen, Kommentar-Zeilen
- *  - Warnung bei ungleicher Feldanzahl
- */
-export class CSVParser {
-    constructor(options = {}) {
-        this.opts = { ...DEFAULT_OPTIONS, ...options };
-        if (this.opts.delimiter.length !== 1) {
-            throw new Error("delimiter muss genau ein Zeichen lang sein.");
-        }
-        if (this.opts.quoteChar.length !== 1) {
-            throw new Error("quoteChar muss genau ein Zeichen lang sein.");
-        }
-        if (this.opts.escapeChar && this.opts.escapeChar.length !== 1) {
-            throw new Error("escapeChar muss genau ein Zeichen lang sein.");
-        }
-    }
-    /**
-     * Parst einen CSV-String und gibt strukturierte Daten zurück.
-     */
-    parse(text) {
-        const rawRows = this.tokenize(text);
-        const warnings = [];
-        if (rawRows.length === 0) {
-            return { records: [], headers: [], rawRows: [], warnings };
-        }
-        let headers = [];
-        let dataRows;
-        if (this.opts.hasHeader) {
-            headers = rawRows[0].map((h) => this.opts.trimFields ? h.trim() : h);
-            dataRows = rawRows.slice(1);
-        }
-        else {
-            // Numerische Header generieren: "0", "1", "2", ...
-            const width = rawRows[0].length;
-            headers = Array.from({ length: width }, (_, i) => String(i));
-            dataRows = rawRows;
-        }
-        const records = [];
-        for (let i = 0; i < dataRows.length; i++) {
-            const row = dataRows[i];
-            if (row.length !== headers.length) {
-                warnings.push({
-                    row: i + (this.opts.hasHeader ? 2 : 1),
-                    message: `Zeile hat ${row.length} Felder, erwartet ${headers.length}.`,
-                });
-            }
-            const record = {};
-            for (let j = 0; j < headers.length; j++) {
-                let value = row[j] ?? "";
-                if (this.opts.trimFields)
-                    value = value.trim();
-                record[headers[j]] = value;
-            }
-            records.push(record);
-        }
-        return { records, headers, rawRows, warnings };
-    }
-    /**
-     * Parst einen CSV-String und gibt ausschließlich die Records zurück.
-     * Kurzform für einfache Anwendungsfälle.
-     */
-    parseRecords(text) {
-        return this.parse(text).records;
-    }
-    // ─────────────────────────────────────────────
-    // Privater Tokenizer (Zustandsmaschine)
-    // ─────────────────────────────────────────────
-    tokenize(text) {
-        const { delimiter, quoteChar, escapeChar, skipEmptyLines, commentChar } = this.opts;
-        const rows = [];
-        let row = [];
-        let field = "";
-        let inQuotes = false;
-        let i = 0;
-        const len = text.length;
-        const pushRow = () => {
-            const isEmpty = row.length === 1 && row[0] === "" && field === "";
-            if (skipEmptyLines && isEmpty)
-                return;
-            if (commentChar && row.length === 0 && field.startsWith(commentChar))
-                return;
-            row.push(field);
-            rows.push(row);
-            row = [];
-            field = "";
-        };
-        while (i < len) {
-            const ch = text[i];
-            const next = i + 1 < len ? text[i + 1] : "";
-            if (inQuotes) {
-                // Backslash-Escape innerhalb von Quotes
-                if (escapeChar && ch === escapeChar && next === quoteChar) {
-                    field += quoteChar;
-                    i += 2;
-                    continue;
-                }
-                // Doppeltes Anführungszeichen → ein literales Anführungszeichen
-                if (ch === quoteChar && next === quoteChar) {
-                    field += quoteChar;
-                    i += 2;
-                    continue;
-                }
-                // Schließendes Anführungszeichen
-                if (ch === quoteChar) {
-                    inQuotes = false;
-                    i++;
-                    continue;
-                }
-                field += ch;
-                i++;
-                continue;
-            }
-            // Außerhalb von Quotes:
-            // Kommentarzeile (nur am Zeilenanfang)
-            if (commentChar && ch === commentChar && row.length === 0 && field === "") {
-                // Rest der Zeile überspringen
-                while (i < len && text[i] !== "\n" && text[i] !== "\r")
-                    i++;
-                continue;
-            }
-            // Öffnendes Anführungszeichen
-            if (ch === quoteChar) {
-                inQuotes = true;
-                i++;
-                continue;
-            }
-            // Backslash-Escape außerhalb von Quotes (optionales Feature)
-            if (escapeChar && ch === escapeChar) {
-                if (next === "n") {
-                    field += "\n";
-                    i += 2;
-                    continue;
-                }
-                if (next === "r") {
-                    field += "\r";
-                    i += 2;
-                    continue;
-                }
-                if (next === "t") {
-                    field += "\t";
-                    i += 2;
-                    continue;
-                }
-                if (next === "0") {
-                    field += "\0";
-                    i += 2;
-                    continue;
-                }
-                if (next === escapeChar) {
-                    field += escapeChar;
-                    i += 2;
-                    continue;
-                }
-                if (next === delimiter) {
-                    field += delimiter;
-                    i += 2;
-                    continue;
-                }
-                // Unbekannte Escape-Sequenz: Backslash literal übernehmen
-                field += ch;
-                i++;
-                continue;
-            }
-            // Trennzeichen
-            if (ch === delimiter) {
-                row.push(field);
-                field = "";
-                i++;
-                continue;
-            }
-            // Zeilenumbruch \r\n
-            if (ch === "\r" && next === "\n") {
-                pushRow();
-                i += 2;
-                continue;
-            }
-            // Zeilenumbruch \r oder \n
-            if (ch === "\n" || ch === "\r") {
-                pushRow();
-                i++;
-                continue;
-            }
-            field += ch;
-            i++;
-        }
-        // Letzte Zeile (kein abschließendes Newline)
-        if (row.length > 0 || field !== "") {
-            row.push(field);
-            const isEmpty = row.length === 1 && row[0] === "";
-            if (!(skipEmptyLines && isEmpty)) {
-                rows.push(row);
-            }
-        }
-        return rows;
-    }
-}

package/dist/utils/csv/stringifier.d.ts

@@ -1,30 +0,0 @@
-import type { CSVStringifierOptions } from "./types";
-/**
- * Serialisiert JavaScript-Objekte zu einem validen CSV-String.
- *
- * Unterstützt:
- *  - RFC 4180 Doppelquote-Escaping: " → ""
- *  - Optionales Backslash-Escaping: \ → \\
- *  - Optionales Null-Byte-Escaping: \0 → \\0
- *  - Automatisches Quoting bei Sonderzeichen
- *  - Konfigurierbare Spaltenreihenfolge
- *  - Wahlweise immer quoten (alwaysQuote)
- */
-export declare class CSVStringifier {
-    private readonly opts;
-    private readonly escapeRules;
-    constructor(options?: CSVStringifierOptions);
-    /**
-     * Serialisiert ein Array von Objekten zu einem CSV-String.
-     */
-    stringify(records: Record<string, unknown>[]): string;
-    /**
-     * Serialisiert ein einzelnes Feld mit korrektem Escaping.
-     * Öffentlich, damit einzelne Werte unabhängig escaped werden können.
-     */
-    escapeField(raw: string): string;
-    /**
-     * Streamt Records zeilenweise als Generator (speicherschonend für große Dateien).
-     */
-    stream(records: Iterable<Record<string, unknown>>, columns: string[]): Generator<string>;
-}