@babylonjs/lite 1.7.0 → 1.8.0

package/README.md

@@ -37,6 +37,29 @@ main().catch(console.error);
 Full documentation is available at
 [https://doc.babylonjs.com/lite/](https://doc.babylonjs.com/lite/).
 
+## Headless simulation (null engine)
+
+Babylon Lite can run **without a GPU or canvas** for server-side physics,
+deterministic simulation, or CI — the Lite analogue of Babylon.js `NullEngine`.
+Use `createNullEngine()` instead of `createEngine()`, and drive the loop
+yourself with `stepScene()`:
+
+```ts
+import { createNullEngine, stepScene, createSceneContext } from "@babylonjs/lite";
+
+const engine = createNullEngine(); // no device, no canvas — synchronous
+const scene = createSceneContext(engine, { defaultRenderTask: false });
+
+// ...add physics bodies / onBeforeRender callbacks...
+
+for (let i = 0; i < 180; i++) stepScene(engine, scene, 1000 / 60); // simulate 3s
+```
+
+It needs no WebGPU and runs on plain Node (recommended), Deno, Web Workers, or
+CI. Rendering is out of scope. See the
+[Headless (Null Engine) guide](https://doc.babylonjs.com/lite/05-headless-null-engine) for details,
+supported runtimes, and limitations.
+
 ## License
 
 [Apache-2.0](./LICENSE)
@@ -44,7 +67,9 @@ Full documentation is available at
 `@babylonjs/lite` is a derivative of [Babylon.js](https://www.babylonjs.com/)
 (Apache-2.0). It bundles a small number of third-party runtime libraries
 (`manifold-3d`, `@recast-navigation/*`, `text-shaper`) whose code ships inside
-the published package. Their license texts are reproduced in
+the published package. Their license texts — together with those of the
+upstream native components embedded in their WebAssembly (Recast &amp; Detour and
+the Emscripten runtime) — are reproduced in
 [THIRD_PARTY_NOTICES.txt](./THIRD_PARTY_NOTICES.txt).
 
 Development-only tooling (build, test, and lint frameworks) is **not** part of

package/THIRD_PARTY_NOTICES.txt

@@ -316,3 +316,142 @@ SOFTWARE.
 
 Portions of the rasterizer are based on FreeType (https://freetype.org).
 FreeType is copyright (c) 1996-2024 The FreeType Project.
+
+==============================================================================
+Bundled upstream components
+==============================================================================
+
+The following native/runtime components are compiled into the WebAssembly
+artifacts of the packages above. Their upstream licenses are reproduced here.
+
+==============================================================================
+Recast & Detour (recastnavigation)
+Embedded by: @recast-navigation/wasm
+Source: https://github.com/recastnavigation/recastnavigation
+==============================================================================
+
+Copyright (c) 2009 Mikko Mononen memon@inside.org
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+claim that you wrote the original software. If you use this software
+in a product, an acknowledgment in the product documentation would be
+appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+
+==============================================================================
+Emscripten runtime
+Embedded by: @recast-navigation/wasm, manifold-3d
+Source: https://github.com/emscripten-core/emscripten
+==============================================================================
+
+Emscripten is available under 2 licenses, the MIT license and the
+University of Illinois/NCSA Open Source License.
+
+Both are permissive open source licenses, with little if any
+practical difference between them.
+
+The reason for offering both is that (1) the MIT license is
+well-known, while (2) the University of Illinois/NCSA Open Source
+License allows Emscripten's code to be integrated upstream into
+LLVM, which uses that license, should the opportunity arise.
+
+The full text of both licenses follows.
+
+==============================================================================
+
+Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
+
+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.
+
+==============================================================================
+
+Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal with 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:
+
+    Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimers.
+
+    Redistributions in binary form must reproduce the above
+    copyright notice, this list of conditions and the following disclaimers
+    in the documentation and/or other materials provided with the
+    distribution.
+
+    Neither the names of Mozilla,
+    nor the names of its contributors may be used to endorse
+    or promote products derived from this Software without specific prior
+    written permission. 
+
+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 CONTRIBUTORS 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 WITH THE SOFTWARE.
+
+==============================================================================
+
+This program uses portions of Node.js source code located in src/library_path.js,
+in accordance with the terms of the MIT license. Node's license follows:
+
+    """
+        Copyright Joyent, Inc. and other Node contributors. All rights reserved.
+        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.
+    """
+
+The musl libc project is bundled in this repo, and it has the MIT license, see
+system/lib/libc/musl/COPYRIGHT
+
+The third_party/ subdirectory contains code with other licenses. None of it is
+used by default, but certain options use it (e.g., the optional closure compiler
+flag will run closure compiler from third_party/).