@downdraft/engine 0.1.1 → 0.1.2-alpha.5

package/libraries/models/test-fixtures/fbx/LICENSE-notice.txt

@@ -1,24 +0,0 @@
-FBX test fixtures (m01-m16) are from the BabylonJS/Assets repository:
-https://github.com/BabylonJS/Assets/tree/master/meshes/fbx/loaderTests
-
-License: MIT (https://github.com/BabylonJS/Assets/blob/master/LICENSE.md)
-
-Copyright (c) 2014-2024 Babylon.js contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/libraries/models/test-fixtures/fbx/README.md

@@ -1,46 +0,0 @@
-# FBX loader visual-test models
-
-A deterministic suite of small FBX files exercising the Babylon.js FBX loader's feature surface.
-Each file is authored programmatically (binary FBX, v7500) and validated against the real Autodesk
-FBX SDK, so it opens correctly in Maya as well as the Babylon loader.
-
-Generator (not in this repo): `babylon-fbx/tools/fbx-test-generator`.
-
-`fbxVisualTests.js` is the scene-creation script for the Babylon.js visual-regression suite: it loads
-each model here, frames it with the validated per-model camera + a neutral light rig, renders
-single-sided, and pins animations to a deterministic frame. The Babylon.js FBX loader PR references
-its functions via the visualization `config.json` (`scriptToRun` + `functionToCall`). NOTE: fbx2gltf
-drops FBX skeletal animation, so the SDK/Maya-proxy render of `m12_skeletal_anim` shows the rest pose
-(straight); the Babylon loader (and real Maya, when scrubbed) shows the bend.
-
-## Conventions / expectations
-- **Single-sided**: meshes are wound so the outward face is front-facing. Render with backface
-  culling on; a regression that flips winding/normals will show backfaces (inside-out).
-- **Axis**: M16 includes genuinely Z-up and Y-up authorings. The Babylon loader converts both to the
-  engine's Y-up space, so all three M16 files load identically. (Maya does NOT convert on import, so
-  the Z-up file looks rotated there — that is the proof it is genuinely Z-up.)
-- **Cameras/lights** (M15): FBX cameras look down local +X, lights down local -Z; both are aimed at
-  the subject. View M15 through its own perspective camera.
-
-## Models
-| File | Exercises | Expected |
-| --- | --- | --- |
-| m01_cube_phong | basic mesh, Phong material, per-face normals/UVs | lit cube |
-| m02_geo_ngons | n-gon triangulation (tri/quad/hex/concave arrow), vertex colors | flat panel of colored polygons (enable vertex-color display in Maya) |
-| m03_normals | smooth vs flat (hard-edged) shading on two spheres | left smooth, right faceted; no pole holes |
-| m04_material_properties | Lambert/Phong, specular, emissive, ambient, opacity | row of spheres with distinct shading |
-| m05_textures | texture slots: diffuse, normal (debossed F), emissive, opacity (holes), external sidecar | row of textured quads (needs `m05_external_diffuse.png`) |
-| m06_uv_transform | per-texture UV translation + scaling | tiled/offset checker on a plane |
-| m07_multimaterial | per-polygon material indices → submesh splitting | cube with 3 colored face-pairs (red/green/blue) |
-| m08_transforms | TRS chain, pre/post-rotation, pivots/offsets, geometric transform | scattered colored cubes |
-| m09_skinning | skeleton + clusters + weights + bind pose (static bent rest) | smoothly bent cylinder |
-| m10_morph | morph targets + in-between shapes (static deform) | flat plane with a raised central hill |
-| m11_node_anim | node animation (const/linear/cubic keys) | three posed cubes at the sampled frame |
-| m12_skeletal_anim | skeletal animation over time | cylinder bent at the sampled frame |
-| m13_morph_anim | DeformPercent animation | plane hill at the sampled frame |
-| m14_multiclip | multiple AnimationStacks → two clips ("Spin", "Bounce") | one cube; two animation groups |
-| m15_camera_lights | point/spot/directional lights + perspective/orthographic cameras, all aimed at the subject | lit sphere + ground, green spot pool, viewed through the FBX camera |
-| m16_axis_yup / m16_axis_zup / m16_units_254 | GlobalSettings axis conversion + unit scale | all three load identically (RGB gizmo, green up) |
-
-`.fbm` folders are texture-extraction artifacts created by SDK tools (Maya/fbx2gltf) when loading
-embedded-texture files; they are gitignored.

package/libraries/physics-native/src/ffi-spike-worker.ts

@@ -1,71 +0,0 @@
-// ffi-spike-worker.ts — Phase 0 spike worker: proves bun:ffi dlopen() works
-// inside a Bun Worker and that pointers to SharedArrayBuffer-backed typed
-// arrays can be passed to native Rust code in both directions.
-
-import { dlopen, FFIType, ptr } from "bun:ffi";
-
-declare const self: Worker;
-
-self.onmessage = (e: MessageEvent) => {
-    const { libPath, sab, velSab } = e.data;
-    try {
-        const lib = dlopen(libPath, {
-            dd_create_realm: { args: [FFIType.i32, FFIType.f32, FFIType.f32, FFIType.f32], returns: FFIType.i32 },
-            dd_destroy_realm: { args: [FFIType.i32], returns: FFIType.i32 },
-            dd_create_body: { args: [FFIType.i32, FFIType.i32, FFIType.ptr, FFIType.ptr], returns: FFIType.i32 },
-            dd_step: { args: [FFIType.i32, FFIType.f32], returns: FFIType.i32 },
-            dd_step_and_read_awake: { args: [FFIType.i32, FFIType.f32, FFIType.ptr, FFIType.ptr, FFIType.u64], returns: FFIType.i32 },
-            dd_destroy: { args: [], returns: FFIType.i32 },
-        });
-
-        // Views over the SABs shared by the main thread.
-        const transforms = new Float32Array(sab as SharedArrayBuffer);
-        const velocities = new Float32Array(velSab as SharedArrayBuffer);
-
-        // Body descriptor — layout per native/src/body.rs:
-        //   f[17] = [pos3, quat4(xyzw), linvel3, angvel3, mass, linDamp, angDamp, gravScale]
-        //   i[2]  = [bodyType (0=fixed,1=kinematic,2=dynamic), flags]
-        const bodyF = new Float32Array(17);
-        const bodyI = new Int32Array(2);
-        bodyF.set([0, 10, 0, 0, 0, 0, 1]); // pos + identity quat
-        bodyF[13] = 1; // mass — collider-less bodies have zero mass in Rapier (gravity = m*g)
-        bodyI[0] = 2; // dynamic
-        bodyI[1] = (1 << 1) | (1 << 9); // canSleep | hasMass
-
-        const createRealm = lib.symbols.dd_create_realm(0, 0, -9.81, 0);
-        const createBody = lib.symbols.dd_create_body(0, 7, ptr(bodyF), ptr(bodyI));
-
-        const step = lib.symbols.dd_step(0, 1 / 60);
-
-        // Awake readback: ids (i32) + [pos3, quat4, linvel3] per body.
-        const awakeSab = new SharedArrayBuffer(4 + 10 * 4);
-        const idsView = new Int32Array(awakeSab, 0, 1);
-        const statesView = new Float32Array(awakeSab, 4, 10);
-
-        const stepBatched = lib.symbols.dd_step_and_read_awake(
-            0, 1 / 60, ptr(idsView), ptr(statesView), 1,
-        );
-
-        // Copy linvel into velSab so the main thread sees the write-back.
-        velocities.set(statesView.subarray(7, 10));
-
-        const transformPtr = ptr(transforms);
-        const velocityPtr = ptr(velocities);
-
-        lib.symbols.dd_destroy();
-
-        self.postMessage({
-            ok: true,
-            createRealm,
-            createBody,
-            step,
-            stepBatched,
-            awakeId: idsView[0],
-            transformPtrNonZero: transformPtr !== 0,
-            velocityPtrNonZero: velocityPtr !== 0,
-            velocities: Array.from(velocities),
-        });
-    } catch (err) {
-        self.postMessage({ ok: false, error: String(err) });
-    }
-};

package/libraries/physics-rapier/bench/ffi-bench.ts

@@ -1,79 +0,0 @@
-// ffi-bench.ts — native Rapier cdylib counterpart to wasm-baseline.ts.
-// Measures the same hot loop (step + awake-body sync) plus the fused
-// stepAndReadAwake fast path the FFI backend adds.
-//
-// Run: bun run packages/engine/libraries/physics-rapier/bench/ffi-bench.ts
-// Requires: cd packages/engine/libraries/physics-native/native && cargo build --release
-
-import { loadFfiPhysicsLib } from "../src/ffi-lib";
-
-const DT = 1 / 60;
-const WARMUP = 30;
-const STEPS = 180;
-const SIZES = [100, 500, 1000, 2000];
-
-async function bench(n: number, floor: boolean, fused: boolean) {
-    const lib = await loadFfiPhysicsLib();
-    lib.createRealm(0, [0, -9.81, 0]);
-    lib.setIntegrationDt?.(0, DT);
-
-    let nextId = 0;
-    if (floor) {
-        lib.createBody(0, nextId, { type: "static", position: [0, 0, 0], rotation: [0, 0, 0, 1] }, { index: nextId, generation: 0 });
-        lib.addCollider(0, nextId, nextId, { shape: { type: "box", halfExtents: [60, 0.5, 60] }, friction: 0.8 });
-        nextId++;
-    }
-
-    const cols = Math.ceil(Math.sqrt(n));
-    for (let i = 0; i < n; i++) {
-        const bodyId = nextId++;
-        const x = (i % cols) * 1.2 - cols * 0.6;
-        const z = Math.floor(i / cols) % cols * 1.2 - cols * 0.6;
-        const y = 2 + Math.floor(i / (cols * cols)) * 1.3 + (i % 7) * 0.02;
-        lib.createBody(0, bodyId, { type: "dynamic", position: [x, y, z], rotation: [0, 0, 0, 1], mass: 1 }, { index: bodyId, generation: 0 });
-        lib.addCollider(0, bodyId, bodyId, { shape: { type: "sphere", radius: 0.5 }, friction: 0.6 });
-    }
-
-    const idsOut = new Uint32Array(nextId);
-    const states = new Float32Array(nextId * 10);
-
-    for (let i = 0; i < WARMUP; i++) lib.step(0, DT);
-
-    let stepMs = 0;
-    let syncMs = 0;
-    let awake = 0;
-    for (let i = 0; i < STEPS; i++) {
-        const t0 = performance.now();
-        if (fused) {
-            awake = lib.stepAndReadAwake(0, DT, idsOut, states, nextId);
-            stepMs += performance.now() - t0;
-        } else {
-            lib.step(0, DT);
-            const t1 = performance.now();
-            awake = lib.readAwakeBodyStates!(0, idsOut, states, nextId);
-            const t2 = performance.now();
-            stepMs += t1 - t0;
-            syncMs += t2 - t1;
-        }
-    }
-
-    lib.destroyRealm(0);
-    return { stepAvg: stepMs / STEPS, syncAvg: syncMs / STEPS, totalAvg: (stepMs + syncMs) / STEPS, awake };
-}
-
-console.log(`FFI Rapier (native cdylib) — Bun ${Bun.version}`);
-console.log(`${"scenario".padEnd(40)} ${"N".padStart(5)} ${"step ms".padStart(9)} ${"sync ms".padStart(9)} ${"total ms".padStart(9)} ${"awake".padStart(7)}`);
-
-for (let _i = 0, _it = [false, true], _n = _it.length; _i < _n; _i++) { const floor = _it[_i];
-    for (let _i = 0, _it = [false, true], _n = _it.length; _i < _n; _i++) { const fused = _it[_i];
-        for (let _i = 0, _it = SIZES, _n = _it.length; _i < _n; _i++) { const n = _it[_i];
-            const r = await bench(n, floor, fused);
-            const name = `${floor ? "piled" : "freefall"}${fused ? " (fused)" : ""}`;
-            console.log(
-                `${name.padEnd(40)} ${String(n).padStart(5)} ` +
-                `${r.stepAvg.toFixed(3).padStart(9)} ${r.syncAvg.toFixed(3).padStart(9)} ` +
-                `${r.totalAvg.toFixed(3).padStart(9)} ${String(r.awake).padStart(7)}`
-            );
-        }
-    }
-}

package/libraries/physics-rapier/bench/wasm-baseline.ts

@@ -1,90 +0,0 @@
-// wasm-baseline.ts — Phase 0 baseline: WASM Rapier (@dimforge/rapier3d-compat)
-// step + awake-body sync throughput under Bun/JSC.
-//
-// Run: bun run packages/engine/libraries/physics-rapier/bench/wasm-baseline.ts
-//
-// This is the number RapierFfiBackend must beat. It measures the exact hot
-// loop the engine uses today: lib.step() + lib.readAwakeBodyStates().
-
-import { loadPhysicsLib } from "../src/rapier-backend";
-
-const DT = 1 / 60;
-const WARMUP = 30;
-const STEPS = 180;
-const SIZES = [100, 500, 1000, 2000];
-
-interface Scenario {
-    name: string;
-    floor: boolean;
-}
-
-const SCENARIOS: Scenario[] = [
-    { name: "freefall (no contacts, all awake)", floor: false },
-    { name: "piled (contacts + sleep)", floor: true },
-];
-
-async function bench(lib: any, n: number, floor: boolean) {
-    lib.createRealm(0, [0, -9.81, 0]);
-    lib.setIntegrationDt?.(0, DT);
-
-    let nextId = 0;
-    if (floor) {
-        lib.createBody(0, nextId, { type: "static", position: [0, 0, 0], rotation: [0, 0, 0, 1] }, { index: nextId, generation: 0 });
-        lib.addCollider(0, nextId, nextId, { shape: { type: "box", halfExtents: [60, 0.5, 60] }, friction: 0.8 });
-        nextId++;
-    }
-
-    // Sphere grid: ~1.2m spacing, stacked layers so bodies stay agitated.
-    const cols = Math.ceil(Math.sqrt(n));
-    for (let i = 0; i < n; i++) {
-        const bodyId = nextId++;
-        const x = (i % cols) * 1.2 - cols * 0.6;
-        const z = Math.floor(i / cols) % cols * 1.2 - cols * 0.6;
-        const y = 2 + Math.floor(i / (cols * cols)) * 1.3 + (i % 7) * 0.02;
-        lib.createBody(0, bodyId, { type: "dynamic", position: [x, y, z], rotation: [0, 0, 0, 1], mass: 1 }, { index: bodyId, generation: 0 });
-        lib.addCollider(0, bodyId, bodyId, { shape: { type: "sphere", radius: 0.5 }, friction: 0.6 });
-    }
-
-    const idsOut = new Uint32Array(nextId);
-    const states = new Float32Array(nextId * 10);
-
-    for (let i = 0; i < WARMUP; i++) lib.step(0, DT);
-
-    let stepMs = 0;
-    let syncMs = 0;
-    let awake = 0;
-    for (let i = 0; i < STEPS; i++) {
-        const t0 = performance.now();
-        lib.step(0, DT);
-        const t1 = performance.now();
-        awake = lib.readAwakeBodyStates!(0, idsOut, states, nextId);
-        const t2 = performance.now();
-        stepMs += t1 - t0;
-        syncMs += t2 - t1;
-    }
-
-    lib.destroyRealm(0);
-
-    return {
-        stepAvg: stepMs / STEPS,
-        syncAvg: syncMs / STEPS,
-        totalAvg: (stepMs + syncMs) / STEPS,
-        awake,
-    };
-}
-
-const lib = await loadPhysicsLib();
-
-console.log(`WASM Rapier baseline — Bun ${Bun.version} (JSC)`);
-console.log(`${"scenario".padEnd(40)} ${"N".padStart(5)} ${"step ms".padStart(9)} ${"sync ms".padStart(9)} ${"total ms".padStart(9)} ${"awake".padStart(7)}`);
-
-for (let _i = 0, _it = SCENARIOS, _n = _it.length; _i < _n; _i++) { const scenario = _it[_i];
-    for (let _i = 0, _it = SIZES, _n = _it.length; _i < _n; _i++) { const n = _it[_i];
-        const r = await bench(lib, n, scenario.floor);
-        console.log(
-            `${scenario.name.padEnd(40)} ${String(n).padStart(5)} ` +
-            `${r.stepAvg.toFixed(3).padStart(9)} ${r.syncAvg.toFixed(3).padStart(9)} ` +
-            `${r.totalAvg.toFixed(3).padStart(9)} ${String(r.awake).padStart(7)}`
-        );
-    }
-}