@needle-tools/engine 4.8.8-next.857d744 → 4.8.8-next.937fc15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/CHANGELOG.md +4 -5
  2. package/README.md +31 -23
  3. package/dist/{needle-engine.bundle-C0MpXHGe.min.js → needle-engine.bundle--r19rtjt.min.js} +82 -82
  4. package/dist/{needle-engine.bundle-gnU2UVys.umd.cjs → needle-engine.bundle-CAvlLwYK.umd.cjs} +104 -104
  5. package/dist/{needle-engine.bundle-BATGweff.js → needle-engine.bundle-Dao6Iztd.js} +690 -692
  6. package/dist/needle-engine.js +2 -2
  7. package/dist/needle-engine.min.js +1 -1
  8. package/dist/needle-engine.umd.cjs +1 -1
  9. package/lib/engine/engine_camera.js +3 -3
  10. package/lib/engine/engine_camera.js.map +1 -1
  11. package/lib/engine/engine_context.d.ts +1 -1
  12. package/lib/engine/engine_context.js +1 -1
  13. package/lib/engine/engine_context.js.map +1 -1
  14. package/lib/engine/engine_loaders.callbacks.d.ts +1 -0
  15. package/lib/engine/engine_loaders.callbacks.js +1 -0
  16. package/lib/engine/engine_loaders.callbacks.js.map +1 -1
  17. package/lib/engine/webcomponents/needle-engine.d.ts +2 -2
  18. package/lib/engine/webcomponents/needle-engine.js +11 -18
  19. package/lib/engine/webcomponents/needle-engine.js.map +1 -1
  20. package/lib/engine-components/Camera.d.ts +2 -0
  21. package/lib/engine-components/Camera.js +5 -1
  22. package/lib/engine-components/Camera.js.map +1 -1
  23. package/lib/engine-components/DropListener.d.ts +4 -3
  24. package/lib/engine-components/DropListener.js +4 -3
  25. package/lib/engine-components/DropListener.js.map +1 -1
  26. package/lib/engine-components/OrbitControls.d.ts +29 -6
  27. package/lib/engine-components/OrbitControls.js +41 -3
  28. package/lib/engine-components/OrbitControls.js.map +1 -1
  29. package/lib/engine-components/Skybox.js +8 -9
  30. package/lib/engine-components/Skybox.js.map +1 -1
  31. package/lib/engine-components/api.d.ts +1 -0
  32. package/lib/engine-components/api.js.map +1 -1
  33. package/lib/engine-components/export/usdz/USDZExporter.d.ts +1 -1
  34. package/lib/engine-components/export/usdz/USDZExporter.js +1 -1
  35. package/lib/engine-components/export/usdz/USDZExporter.js.map +1 -1
  36. package/lib/engine-components/webxr/WebXRImageTracking.js.map +1 -1
  37. package/package.json +1 -1
  38. package/plugins/common/files.js +6 -3
  39. package/plugins/vite/editor-connection.js +4 -4
  40. package/src/engine/engine_camera.ts +4 -4
  41. package/src/engine/engine_context.ts +1 -1
  42. package/src/engine/engine_loaders.callbacks.ts +1 -0
  43. package/src/engine/webcomponents/needle-engine.ts +10 -17
  44. package/src/engine-components/Camera.ts +7 -1
  45. package/src/engine-components/DropListener.ts +4 -3
  46. package/src/engine-components/OrbitControls.ts +63 -10
  47. package/src/engine-components/Skybox.ts +9 -10
  48. package/src/engine-components/api.ts +2 -1
  49. package/src/engine-components/export/usdz/USDZExporter.ts +1 -1
  50. package/src/engine-components/webxr/WebXRImageTracking.ts +1 -1
package/CHANGELOG.md CHANGED
@@ -12,11 +12,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
12
12
  - Change: OrbitControls with locked target constraint is now updating the constraint position when calling e.g. `setTargetPosition`
13
13
  - Add: `setCameraFocusRect` method on Needle Context for easier responsive layouting.
14
14
  With this you can e.g. overlay the webgl scene with HTML elements and pass in a div element for keeping important elements visible.
15
- [Example 1 Website](https://responsive-layout-z23hmxb22no6t.needle.run/) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect?file=src%2Fsidebar.ts,index.html,src%2Fmain.ts>)
16
- [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-thumbnail.jpg)](https://responsive-layout-z23hmxb22no6t.needle.run/)
17
- [Example 2 Website](https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect-click-to-move?file=index.html,src%2Fmain.ts>)
18
- [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-2-thumbnail.jpg?)](https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/)
19
-
15
+ [Example 1 Website](<https://responsive-layout-z23hmxb22no6t.needle.run/>) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect?file=src%2Fsidebar.ts,index.html,src%2Fmain.ts>)
16
+ [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-thumbnail.jpg)](<https://responsive-layout-z23hmxb22no6t.needle.run/>)
17
+ [Example 2 Website](<https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/>) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect-click-to-move?file=index.html,src%2Fmain.ts>)
18
+ [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-2-thumbnail.jpg?)](<https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/>)
20
19
 
21
20
  ## [4.8.7] - 2025-08-27
22
21
  - Add: New [@needle-tools/three-animation-pointer](<https://www.npmjs.com/package/@needle-tools/three-animation-pointer>) package
package/README.md CHANGED
@@ -1,61 +1,69 @@
1
1
  # Needle Engine
2
2
 
3
- <img src="https://engine.needle.tools/docs/imgs/banner.webp" />
3
+ <!-- <img src="https://engine.needle.tools/docs/imgs/banner.webp" /> -->
4
4
 
5
5
  **[Needle Engine](https://needle.tools)** is a fast web engine for complex and simple 3D applications alike.
6
- It is flexible, extensible and has built-in support for collaboration and XR! It is built around the **glTF standard** for 3D assets.
7
-
6
+ It is flexible, extensible and has built-in support for collaboration and XR! It is built around the **glTF standard** for 3D assets and is using three.js under the hood - so all your existing knowledge applies.
8
7
 
8
+ → 📑 [Documentation](https://docs.needle.tools)
9
+ → 💎 [Samples](https://samples.needle.tools)
10
+ → 🏓 [Changelog](https://github.com/needle-tools/needle-engine-support/releases)
9
11
 
10
12
  ## Features
11
- - Powered by three.js
13
+ - Components System: Add your custom components with easy
12
14
  - WebXR support & iOS Quicklook support for interactive AR
13
- - Builtin Networking
15
+ - Networking is built-in
14
16
  - Advanced PBR Rendering
15
17
  - Animate Everything
16
18
  - Animation Statemachines & Timeline Animations
17
19
  - Lightmaps
18
20
  - Physics
19
21
  - Postprocessing
20
- - Custom Components and Scripting
21
- - Automatic Texture & Mesh LOD Generation
22
+ - Texture & Mesh LOD Generation
22
23
  - Progressive Texture and Mesh Loading
23
24
  *Higher resolution assets are loaded on demand*
24
25
  - Dynamic Content Loading & Multi-Scene support
25
26
  - Integrations for Unity or Blender
26
27
  - Commercial & Educational Licenses
27
- - [Hosting and asset optimization](https://cloud.needle.tools)
28
- - [More features](https://docs.needle.tools/features)
28
+ - [↪ more features](https://docs.needle.tools/features)
29
29
 
30
30
 
31
31
  <br />
32
32
 
33
- [Needle Engine Changelog](https://github.com/needle-tools/needle-engine-support/releases)
34
33
 
35
34
 
36
35
  ## Editor Integrations
37
36
 
38
- **Powerful integrations for Unity and Blender** allow artists and developers to collaborate and manage web applications inside battle-tested 3d editors. Needle Engine integrations allow you to use editor features for exporting models, author materials, animate and sequence animations, bake lightmaps and more.
37
+ **Powerful integrations for Unity and Blender** allow artists and developers to collaborate and manage web applications inside battle-tested 3d editors. Needle Engine integrations allow you to use editor features for exporting models, author materials, animate and sequence animations, bake lightmaps and more.
38
+ - 🎲 [Download Unity Integration](https://engine.needle.tools/downloads/unity)
39
+ - 🐵 [Download Blender Integration](https://engine.needle.tools/downloads/blender)
40
+ - 📜 [Code only](https://engine.needle.tools/docs/three/)
39
41
 
40
- - [Download Unity Integration](https://engine.needle.tools/downloads/unity)
41
42
 
42
- - [Download Blender Integration](https://engine.needle.tools/downloads/blender)
43
+ ## Getting Started
43
44
 
44
- - [Try on Stackblitz](https://stackblitz.com/@marwie/collections/needle-engine)
45
+ Follow the [Getting Started Guide](https://docs.needle.tools/getting-started) to download and install Needle Engine or [try one of our samples](https://engine.needle.tools/samples) ⚡
45
46
 
46
47
 
47
- ## Getting Started
48
+ ## Examples
48
49
 
49
- Follow the [Getting Started Guide](https://docs.needle.tools/getting-started) to download and install Needle Engine.
50
- You can also find a [list of sample projects](https://engine.needle.tools/samples) that you can try live in the browser and download to give your project a headstart.
51
- For writing custom components read the [Scripting Guide](https://docs.needle.tools/scripting) or try [Needle Engine on StackBlitz](https://stackblitz.com/@marwie/collections/needle-engine) ⚡
50
+ ### [Custom loading overlay & wait for LODs](https://lods-loading-overlay-z23hmxbz29h8vr.needle.run/) | [Code on Stackblitz](https://stackblitz.com/edit/needle-engine-wait-for-lods?file=README.md)
52
51
 
52
+ ### [Motors & More Shop Example with React](https://reactshoppingcart-z23hmxbzcfkmf.needle.run/) | [Code on Stackblitz](https://stackblitz.com/edit/needle-react-shopping-cart-2)
53
53
 
54
- ## Examples
55
- - [Needle Engine Stackblitz Collection](https://stackblitz.com/@marwie/collections/needle-engine)
56
- - [Custom loading overlay & wait for LODs](https://lods-loading-overlay-z23hmxbz29h8vr.needle.run/), [Stackblitz](https://stackblitz.com/edit/needle-engine-wait-for-lods?file=README.md)
57
- - [Motors & More Shop Example with React](https://reactshoppingcart-z23hmxbzcfkmf.needle.run/), [Stackblitz](https://stackblitz.com/edit/needle-react-shopping-cart-2)
58
- - [Postprocessing Effects with custom Magnifier effect](https://antialiasing-and-postprocessing-zubcksz1o8daw.needle.run/), [Stackblitz](https://stackblitz.com/edit/needle-engine-postprocessing?file=README.md)
54
+ ### [Postprocessing Effects with custom Magnifier effect](https://antialiasing-and-postprocessing-zubcksz1o8daw.needle.run/) | [Code on Stackblitz](https://stackblitz.com/edit/needle-engine-postprocessing?file=README.md)
55
+ [![](https://cdn.needle.tools/static/images/changelog/magnifier-postprocessing-example-thumbnail.jpg)](https://antialiasing-and-postprocessing-zubcksz1o8daw.needle.run/)
56
+
57
+ ### [AR Restaurant Example](https://ar-restaurant-example-zubcks1t14le.needle.run/) | [Code on Github](https://github.com/needle-engine/ar-restaurant-example)
58
+
59
+ ### [Camera Focus DIV Example 1](https://responsive-layout-z23hmxb22no6t.needle.run/) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect?file=src%2Fsidebar.ts,index.html,src%2Fmain.ts>)
60
+ [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-thumbnail.jpg)](https://responsive-layout-z23hmxb22no6t.needle.run/)
61
+
62
+ ### [Camera Focus DIV Example 2](https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/) | [Code on Stackblitz](<https://stackblitz.com/edit/needle-engine-camera-focus-rect-click-to-move?file=index.html,src%2Fmain.ts>)
63
+ [![](https://cdn.needle.tools/static/images/changelog/4.8.8-focus-2-thumbnail.jpg?)](https://responsive-layout-click-example-z23hmxbzuyk6y.needle.run/)
64
+
65
+
66
+ 👋 Find more examples on [samples.needle.tools](https://samples.needle.tools/), [docs.needle.tools](https://docs.needle.tools) and in the [Needle Engine Stackblitz Collection](https://stackblitz.com/@marwie/collections/needle-engine)
59
67
 
60
68
  <br />
61
69