orbix-engine 1.0.2 → 1.0.4

package/dist/orbix.d.ts

@@ -546,7 +546,8 @@ declare namespace Orbix {
         CAMERA: PerspectiveCamera;
         RENDERER: Renderer;
         NUKE: Nuke;
-        ELEMENT: HTMLCanvasElement;
+        ELEMENT: any;
+        CANVAS: HTMLCanvasElement;
         instance(): typeof World;
         init(): void;
     };

package/dist/orbix.js

@@ -27967,6 +27967,20 @@ Class((function AppStateOperators(_default) {
     lastChange: "2025-05-11T21:43:09.306Z"
 }], Class((function Antimatter(_num, _config, _renderer = World.RENDERER, _pointData = null) {
     Inherit(this, AntimatterFBO);
+    // Options-style API: new Antimatter({ count, width, height, depth, ... })
+    if (typeof _num === 'object' && _num !== null) {
+        var _opts = _num;
+        _num = _opts.count || _opts.num || _opts.particleCount || 1000;
+        _config = {
+            w: _opts.width || [-1, 1],
+            h: _opts.height || [-1, 1],
+            d: _opts.depth || [-1, 1],
+            pot: _opts.pot || false
+        };
+        _renderer = _opts.renderer || World.RENDERER;
+        _pointData = _opts.pointData || null;
+    }
+    if (!_config) _config = { w: [-1, 1], h: [-1, 1], d: [-1, 1] };
     var _geometry, _this = this,
         _drawLimit = _num,
         _size = function findSize() {
@@ -27979,7 +27993,9 @@ Class((function AppStateOperators(_default) {
             attribs: attribs,
             usedDepth: usedDepth
         } = await AntimatterUtil.createBufferArray(_size, _num, _config, _pointData);
-        _this.vertices = _this.cloneVertices ? vertices.clone() : vertices, (_geometry = geometry.clone(!0)).drawRange.end = _drawLimit, _this.vertices.geometry = _geometry, _this.attribs = _this.random = attribs, _this.textureUsedDepth = usedDepth, _this.init(_geometry, _renderer, _size)
+        _this.vertices = _this.cloneVertices ? vertices.clone() : vertices, (_geometry = geometry.clone(!0)).drawRange.end = _drawLimit, _this.vertices.geometry = _geometry, _this.attribs = _this.random = attribs, _this.textureUsedDepth = usedDepth, _this.init(_geometry, _renderer, _size);
+        // Auto-create mesh for standalone usage (CDN users)
+        if (!_this.mesh) { try { _this.mesh = _this.getMesh(); } catch(e){} }
     }
     defer(createBuffer), this.createFloatArray = function(components = 3) {
         return new Float32Array(_size * _size * components)
@@ -28288,6 +28304,15 @@ Class((function AppStateOperators(_default) {
         }
 })), Class((function AntimatterSpawn(_proton, _group, _input) {
     Inherit(this, Component);
+    // Guard: AntimatterSpawn requires a valid Proton parent with .antimatter
+    if (!_proton || !_proton.antimatter || typeof _proton.antimatter.createFloatArrayAsync !== 'function') {
+        console.warn('AntimatterSpawn: requires a Proton parent instance. Cannot be created standalone.');
+        this.canEmit = false;
+        this.emit = function(){};
+        this.release = function(){};
+        this.ready = function(){ return Promise.resolve(); };
+        return;
+    }
     const _this = this;
     var _life, _pass, _velocity, _color, _index = -1,
         _total = _proton.particleCount,
@@ -61259,6 +61284,9 @@ Class((function Main() {
             // Add the WebGL canvas to the page
             Stage.add(World.ELEMENT);
 
+            // Expose raw canvas DOM node for CDN users (World.ELEMENT is a Hydra wrapper)
+            World.CANVAS = (World.ELEMENT && World.ELEMENT.div) ? World.ELEMENT.div : World.ELEMENT;
+
             // Signal engine ready
             window.ORBIX_ENGINE._world = World;
             window.ORBIX_ENGINE._ready = true;
@@ -61339,7 +61367,22 @@ window._BUILT_ = false;
     HE.Frustum       = window.Frustum;
     HE.MathTween     = window.MathTween;
     HE.MatrixWasm    = window.MatrixWasm;
-    HE.MathUtils     = { radians: Math.radians, lerp: Math.lerp, clamp: Math.clamp, range: Math.range, smoothStep: Math.smoothStep };
+    HE.MathUtils     = {
+        radians: Math.radians,
+        degrees: Math.degrees,
+        lerp: Math.lerp,
+        clamp: Math.clamp,
+        range: Math.range,
+        map: Math.map,
+        mix: Math.mix,
+        step: Math.step,
+        smoothStep: Math.smoothStep,
+        fract: Math.fract,
+        randFloat: function(min, max) { return Math.random(min, max, 10); },
+        randInt: function(min, max) { return Math.random(min, max, 0); },
+        random: function(min, max, precision) { return Math.random(min, max, precision); }
+    };
+    window.MathUtils = HE.MathUtils;
 
     // ── 3D OBJECTS ──────────────────────────────────────────────────────────
     HE.Object3D      = window.Object3D;
@@ -61634,7 +61677,7 @@ window._BUILT_ = false;
             camera:   World.CAMERA,
             nuke:     World.NUKE,
             renderer: World.RENDERER,
-            element:  World.ELEMENT
+            element:  World.CANVAS || World.ELEMENT
         };
     };