Version Packages (#183)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

apps/examples/package.json

@@ -30,8 +30,8 @@
     "three": "^0.143.0",
     "three-stdlib": "^2.14.3",
     "timeline-composer": "^0.1.5",
-    "vfx-composer": "^0.2.0-next.4",
-    "vfx-composer-r3f": "^0.2.0-next.4",
+    "vfx-composer": "^0.2.0",
+    "vfx-composer-r3f": "^0.2.0",
     "wouter": "^2.8.0-alpha.2"
   },
   "devDependencies": {

packages/vfx-composer-r3f/CHANGELOG.md

@@ -1,5 +1,59 @@
 # vfx-composer-r3f
 
+## 0.2.0
+
+### Minor Changes
+
+- 85f851f: **Breaking Change:** `<Emitter>` received a big overhaul and now supports `rate` and `limit` props, next to the `setup` callback prop that was already there. Together with the helper components from Timeline Composer, this should now allow for all typical particle emission workloads.
+- ea13985: **Breaking Change:** Upgrade to the latest Shader Composer and Material Composer. Lots of new APIs! Aaaah! Please refer to the examples for guidance.
+- dc04f03: `VFXMaterial` and the animation modules have been extracted into a new package, **Material Composer**, that this library now uses as a dependency.
+- c09304e: All the react-three-fiber specific bits that were formerly available at `vfx-composer/fiber` now live in a separate `vfx-composer-r3f` package.
+- a11c4b7: Added `useParticles`, a high-level hook that will set up the most important variables needed for typical particle systems.
+
+  Added `useParticleAttribute`, a simple hook to quickly create a memoized particle attribute.
+
+  A typical (minimal) particles effect now looks like this:
+
+  ```tsx
+  const Effect = () => {
+    const particles = useParticles()
+    const velocity = useParticleAttribute(() => new Vector3())
+
+    return (
+      <Particles maxParticles={1_000} safetyBuffer={1_000}>
+        <planeGeometry args={[0.2, 0.2]} />
+
+        <composable.MeshStandardMaterial>
+          <modules.Billboard />
+          <modules.Scale scale={OneMinus(particles.Progress)} />
+          <modules.Velocity velocity={velocity} time={particles.Age} />
+          <modules.Lifetime {...particles} />
+        </composable.MeshStandardMaterial>
+
+        <Emitter
+          rate={20}
+          setup={() => {
+            particles.setLifetime(between(1, 3))
+            velocity.value.set(plusMinus(1), between(1, 3), plusMinus(1))
+          }}
+        />
+      </Particles>
+    )
+  }
+  ```
+
+### Patch Changes
+
+- Updated dependencies [c4ef849]
+- Updated dependencies [2d867ec]
+- Updated dependencies [ea13985]
+- Updated dependencies [cd19781]
+- Updated dependencies [f8b4c05]
+- Updated dependencies [dc04f03]
+- Updated dependencies [bfd1588]
+- Updated dependencies [c09304e]
+  - [email protected]
+
 ## 0.2.0-next.4
 
 ### Minor Changes

packages/vfx-composer-r3f/package.json

@@ -6,7 +6,7 @@
     "url": "https://hendrik.mans.de"
   },
   "description": "React-Three-Fiber bindings for VFX Composer.",
-  "version": "0.2.0-next.4",
+  "version": "0.2.0",
   "main": "dist/vfx-composer-r3f.cjs.js",
   "module": "dist/vfx-composer-r3f.esm.js",
   "files": [
@@ -29,7 +29,7 @@
     "material-composer-r3f": "^0.1.1",
     "shader-composer": "0.3.3",
     "shader-composer-r3f": "0.2.0",
-    "vfx-composer": "^0.2.0-next.4"
+    "vfx-composer": "^0.2.0"
   },
   "peerDependencies": {
     "@react-three/fiber": ">=8.0.27",

packages/vfx-composer/CHANGELOG.md

@@ -1,5 +1,21 @@
 # vfx-composer
 
+## 0.2.0
+
+### Minor Changes
+
+- c4ef849: **Added:** Partial attribute buffer uploads! Now only the parts of the buffers that have been used for newly spawned particles are actually uploaded to the GPU.
+- ea13985: **Breaking Change:** Upgrade to the latest Shader Composer and Material Composer. Lots of new APIs! Aaaah! Please refer to the examples for guidance.
+- cd19781: **Changed:** `<Emitter>` now applies its world transform to spawned particles, meaning you can parent it to other scene objects for easy-peasy particle trails.
+- f8b4c05: **Changed:** A complete refactoring around a new imperative/vanilla core. Enjoy!
+- dc04f03: `VFXMaterial` and the animation modules have been extracted into a new package, **Material Composer**, that this library now uses as a dependency.
+- c09304e: All the react-three-fiber specific bits that were formerly available at `vfx-composer/fiber` now live in a separate `vfx-composer-r3f` package.
+
+### Patch Changes
+
+- 2d867ec: **Added:** `<Emitter>` will now retrieve the parent `<Particles>` via context if none is specified explicitly.
+- bfd1588: **Fixed:** `<Emitter>` could no longer work with `<Particles>` refs passed into its `particles` prop. Woops!
+
 ## 0.2.0-next.4
 
 ### Minor Changes

packages/vfx-composer/package.json

@@ -6,7 +6,7 @@
     "url": "https://hendrik.mans.de"
   },
   "description": "Composable, GPU-driven Visual Effects for Three.js and React-Three-Fiber.",
-  "version": "0.2.0-next.4",
+  "version": "0.2.0",
   "main": "dist/vfx-composer.cjs.js",
   "module": "dist/vfx-composer.esm.js",
   "files": [