hz-particles 1.2.0 → 1.3.0

package/dist-lib/hz-particles-r3f.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),Z=require("@react-three/fiber"),X=require("hz-particles"),K=require("react/jsx-runtime"),Q=require("three");function Y(n){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const a in n)if(a!=="default"){const e=Object.getOwnPropertyDescriptor(n,a);Object.defineProperty(t,a,e.get?e:{enumerable:!0,get:()=>n[a]})}}return t.default=n,Object.freeze(t)}const p=Y(Q);function J(n,t){if(t===1)return n;const a=(e,i)=>e!=null?e*t:i*t;return{...n,systems:n.systems.map(e=>({...e,particleSize:a(e.particleSize,.5),minSize:e.minSize!=null?e.minSize*t:void 0,maxSize:e.maxSize!=null?e.maxSize*t:void 0,particleSpeed:(e.particleSpeed??1)*t,minSpeed:e.minSpeed!=null?e.minSpeed*t:void 0,maxSpeed:e.maxSpeed!=null?e.maxSpeed*t:void 0,cubeLength:e.cubeLength!=null?e.cubeLength*t:void 0,outerLength:e.outerLength!=null?e.outerLength*t:void 0,innerLength:e.innerLength!=null?e.innerLength*t:void 0,outerRadius:e.outerRadius!=null?e.outerRadius*t:void 0,innerRadius:e.innerRadius!=null?e.innerRadius*t:void 0,squareSize:e.squareSize!=null?e.squareSize*t:void 0,squareInnerSize:e.squareInnerSize!=null?e.squareInnerSize*t:void 0,circleInnerRadius:e.circleInnerRadius!=null?e.circleInnerRadius*t:void 0,circleOuterRadius:e.circleOuterRadius!=null?e.circleOuterRadius*t:void 0,cylinderInnerRadius:e.cylinderInnerRadius!=null?e.cylinderInnerRadius*t:void 0,cylinderOuterRadius:e.cylinderOuterRadius!=null?e.cylinderOuterRadius*t:void 0,cylinderHeight:e.cylinderHeight!=null?e.cylinderHeight*t:void 0,emissionTrailWidth:(e.emissionTrailWidth??.3)*t,emissionTrailDuration:(e.emissionTrailDuration??1)*t,emissionTrailMinDistance:e.emissionTrailMinDistance!=null?e.emissionTrailMinDistance*t:void 0,emissionTrailShapeAmplitude:e.emissionTrailShapeAmplitude!=null?e.emissionTrailShapeAmplitude*t:void 0}))}}function $({preset:n,positionRef:t,position:a=[0,0,0],scale:e=1,active:i=!0,renderPriority:z=1,noOcclusion:A=!1}){const d=s.useRef(null),v=s.useRef(null),x=s.useRef(!1),I=s.useRef(0),C=s.useRef(i);C.current=i;const y=s.useRef(a);y.current=a;const D=s.useMemo(()=>e&&e!==1?J(n,e):n,[n,e]),E=l=>t?l.addMovingEmitter(D,{getPosition:()=>{const m=t.current;return C.current&&m?[m.x,m.y,m.z]:null}}):l.addEmitter(D,y.current);return s.useEffect(()=>{var f,u;const l=d.current;if(!l)return;let m=!1;return(u=(f=v.current)==null?void 0:f.remove)==null||u.call(f),v.current=null,E(l).then(c=>{var T;m?(T=c==null?void 0:c.remove)==null||T.call(c):v.current=c}),()=>{m=!0}},[D]),s.useEffect(()=>()=>{var l,m;(m=(l=d.current)==null?void 0:l.destroy)==null||m.call(l),d.current=null,v.current=null,x.current=!1},[]),Z.useFrame(l=>{l.gl.render(l.scene,l.camera);const m=performance.now(),f=I.current?Math.min(.05,(m-I.current)/1e3):.016;I.current=m;const u=l.gl,c=u.backend;!d.current&&!x.current&&(c!=null&&c.device)&&(c!=null&&c.context)&&(x.current=!0,X.initHzFxOverlay({device:c.device,context:c.context,canvas:u.domElement},{getSceneDepth:A?()=>null:X.makeThreeSceneDepth(u)}).then(R=>(d.current=R,E(R))).then(R=>{v.current=R}).catch(R=>console.error("[HZFaithfulFX] init failed:",R)));const T=d.current;if(T){const R=l.camera;T.setCamera(R.projectionMatrix.elements,R.matrixWorldInverse.elements,R.position),T.render(f)}},z),null}const ee=`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react"),Z=require("@react-three/fiber"),X=require("hz-particles"),K=require("react/jsx-runtime"),Q=require("three");function Y(n){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const s in n)if(s!=="default"){const e=Object.getOwnPropertyDescriptor(n,s);Object.defineProperty(t,s,e.get?e:{enumerable:!0,get:()=>n[s]})}}return t.default=n,Object.freeze(t)}const p=Y(Q);function J(n,t){if(t===1)return n;const s=(e,u)=>e!=null?e*t:u*t;return{...n,systems:n.systems.map(e=>({...e,particleSize:s(e.particleSize,.5),minSize:e.minSize!=null?e.minSize*t:void 0,maxSize:e.maxSize!=null?e.maxSize*t:void 0,particleSpeed:(e.particleSpeed??1)*t,minSpeed:e.minSpeed!=null?e.minSpeed*t:void 0,maxSpeed:e.maxSpeed!=null?e.maxSpeed*t:void 0,cubeLength:e.cubeLength!=null?e.cubeLength*t:void 0,outerLength:e.outerLength!=null?e.outerLength*t:void 0,innerLength:e.innerLength!=null?e.innerLength*t:void 0,outerRadius:e.outerRadius!=null?e.outerRadius*t:void 0,innerRadius:e.innerRadius!=null?e.innerRadius*t:void 0,squareSize:e.squareSize!=null?e.squareSize*t:void 0,squareInnerSize:e.squareInnerSize!=null?e.squareInnerSize*t:void 0,circleInnerRadius:e.circleInnerRadius!=null?e.circleInnerRadius*t:void 0,circleOuterRadius:e.circleOuterRadius!=null?e.circleOuterRadius*t:void 0,cylinderInnerRadius:e.cylinderInnerRadius!=null?e.cylinderInnerRadius*t:void 0,cylinderOuterRadius:e.cylinderOuterRadius!=null?e.cylinderOuterRadius*t:void 0,cylinderHeight:e.cylinderHeight!=null?e.cylinderHeight*t:void 0,emissionTrailWidth:(e.emissionTrailWidth??.3)*t,emissionTrailDuration:(e.emissionTrailDuration??1)*t,emissionTrailMinDistance:e.emissionTrailMinDistance!=null?e.emissionTrailMinDistance*t:void 0,emissionTrailShapeAmplitude:e.emissionTrailShapeAmplitude!=null?e.emissionTrailShapeAmplitude*t:void 0}))}}function $({preset:n,positionRef:t,position:s=[0,0,0],scale:e=1,active:u=!0,renderPriority:w=1,noOcclusion:I=!1,respectReducedMotion:z=!0}){const f=c.useRef(null),S=c.useRef(null),T=c.useRef(!1),F=c.useRef(0),y=c.useRef(u);y.current=u;const P=c.useRef(s);P.current=s;const C=c.useRef(!1),L=c.useMemo(()=>e&&e!==1?J(n,e):n,[n,e]),q=i=>t?i.addMovingEmitter(L,{getPosition:()=>{const o=t.current;return y.current&&o?[o.x,o.y,o.z]:null}}):i.addEmitter(L,P.current);return c.useEffect(()=>{var d,h;const i=f.current;if(!i)return;let o=!1;return(h=(d=S.current)==null?void 0:d.remove)==null||h.call(d),S.current=null,q(i).then(l=>{var x;o?(x=l==null?void 0:l.remove)==null||x.call(l):S.current=l}),()=>{o=!0}},[L]),c.useEffect(()=>{var d;if(typeof window>"u"||!window.matchMedia)return;const i=window.matchMedia("(prefers-reduced-motion: reduce)"),o=()=>{C.current=i.matches};return o(),(d=i.addEventListener)==null||d.call(i,"change",o),()=>{var h;return(h=i.removeEventListener)==null?void 0:h.call(i,"change",o)}},[]),c.useEffect(()=>()=>{var i,o,d,h;(o=(i=S.current)==null?void 0:i.remove)==null||o.call(i),(h=(d=f.current)==null?void 0:d.destroy)==null||h.call(d),f.current=null,S.current=null,T.current=!1},[]),Z.useFrame(i=>{i.gl.render(i.scene,i.camera);const o=performance.now(),d=F.current?Math.min(.05,(o-F.current)/1e3):.016;F.current=o;const h=i.gl,l=h.backend;!f.current&&!T.current&&(l!=null&&l.device)&&(l!=null&&l.context)&&(T.current=!0,X.initHzFxOverlay({device:l.device,context:l.context,canvas:h.domElement},{getSceneDepth:I?()=>null:X.makeThreeSceneDepth(h)}).then(v=>(f.current=v,q(v))).then(v=>{S.current=v}).catch(v=>console.error("[HZFaithfulFX] init failed:",v)));const x=f.current;if(x){const v=i.camera;x.setCamera(v.projectionMatrix.elements,v.matrixWorldInverse.elements,v.position),z&&C.current||x.render(d)}},w),null}const ee=`
 attribute vec4 aColor;
 varying vec4 vColor;
 void main() {
@@ -10,4 +10,4 @@ varying vec4 vColor;
 void main() {
   gl_FragColor = vColor;
 }
-`;function ne({positionRef:n,duration:t=1,width:a=.3,color:e=[1,1,1],maxPoints:i=256,minDistance:z=.05,opacity:A=1,blending:d=p.AdditiveBlending,visible:v=!0}){const{camera:x}=Z.useThree(),I=s.useRef(null),C=s.useRef({positions:new Float32Array(i*3),times:new Float32Array(i),head:0,count:0,lastPos:new p.Vector3(1/0,1/0,1/0),elapsed:0}),{geometry:y,posAttr:D,colorAttr:E,indexBuf:l}=s.useMemo(()=>{const B=i*2,U=new Float32Array(B*3),r=new Float32Array(B*4),M=new p.BufferGeometry,H=new p.BufferAttribute(U,3);H.setUsage(p.DynamicDrawUsage),M.setAttribute("position",H);const w=new p.BufferAttribute(r,4);w.setUsage(p.DynamicDrawUsage),M.setAttribute("aColor",w);const b=(i-1)*6,h=new Uint32Array(b);for(let F=0;F<i-1;F++){const o=F*2,g=F*6;h[g]=o,h[g+1]=o+1,h[g+2]=o+2,h[g+3]=o+1,h[g+4]=o+3,h[g+5]=o+2}const O=new p.BufferAttribute(h,1);return M.setIndex(O),M.setDrawRange(0,0),{geometry:M,posAttr:H,colorAttr:w,indexBuf:O}},[i]),m=s.useMemo(()=>new p.ShaderMaterial({vertexShader:ee,fragmentShader:te,transparent:!0,depthWrite:!1,side:p.DoubleSide,blending:d}),[d]),f=s.useMemo(()=>new p.Vector3,[]),u=s.useMemo(()=>new p.Vector3,[]),c=s.useMemo(()=>new p.Vector3,[]),T=s.useMemo(()=>new p.Vector3(0,1,0),[]),R=s.useMemo(()=>new p.Vector3,[]);return Z.useFrame((B,U)=>{if(!I.current)return;const r=C.current;if(r.elapsed+=U,!v){r.count=0,r.head=0,r.lastPos.set(1/0,1/0,1/0),y.setDrawRange(0,0);return}const M=n.current;if(!M)return;if(r.lastPos.distanceTo(M)>=z){const o=(r.head+r.count)%i;r.positions[o*3]=M.x,r.positions[o*3+1]=M.y,r.positions[o*3+2]=M.z,r.times[o]=r.elapsed,r.count<i?r.count++:r.head=(r.head+1)%i,r.lastPos.copy(M)}for(;r.count>0;){const o=r.head;if(r.elapsed-r.times[o]>t)r.head=(r.head+1)%i,r.count--;else break}if(r.count<2){y.setDrawRange(0,0);return}const w=D.array,b=E.array;let h=null;const O=r.count;for(let o=0;o<O;o++){const g=(r.head+o)%i,L=r.positions[g*3],V=r.positions[g*3+1],j=r.positions[g*3+2],_=1-(r.elapsed-r.times[g])/t;if(o<O-1){const W=(r.head+o+1)%i;f.set(r.positions[W*3]-L,r.positions[W*3+1]-V,r.positions[W*3+2]-j);const N=f.length();N>1e-6?f.divideScalar(N):h&&f.copy(h)}else h&&f.copy(h);c.set(x.position.x-L,x.position.y-V,x.position.z-j),u.crossVectors(f,c);let P=u.length();P<1e-6&&(R.crossVectors(f,T),u.copy(R),P=u.length(),P<1e-6&&(u.set(1,0,0),P=1)),u.divideScalar(P);const q=a*_,G=A*_*_,S=o*2;w[S*3]=L+u.x*q,w[S*3+1]=V+u.y*q,w[S*3+2]=j+u.z*q,w[(S+1)*3]=L-u.x*q,w[(S+1)*3+1]=V-u.y*q,w[(S+1)*3+2]=j-u.z*q,b[S*4]=e[0],b[S*4+1]=e[1],b[S*4+2]=e[2],b[S*4+3]=G,b[(S+1)*4]=e[0],b[(S+1)*4+1]=e[1],b[(S+1)*4+2]=e[2],b[(S+1)*4+3]=G,h=h||new p.Vector3,h.copy(f)}const F=(O-1)*6;y.setDrawRange(0,F),D.needsUpdate=!0,E.needsUpdate=!0}),K.jsx("mesh",{ref:I,geometry:y,material:m,frustumCulled:!1,renderOrder:101,visible:v})}function k(n){return Math.abs(Math.sin(n*12.9898)*43758.5453)%1}function re(n){const t=Math.sin(n*54321.67)*43758.5453%1;return t<0?t+1:t}function ie(n,t,a,e){if(a<=0)return 0;const i=t/a;let z=n.particleSize??.5;if(n.randomSize){const d=n.minSize??.1,v=n.maxSize??.5;z=d+(v-d)*re(a)}const A=Math.max(.01,Math.min(10,n.sizeLifetimeSpeed??1));if(n.fadeSizeEnabled&&(z*=1-Math.pow(i,1/A)),n.increaseSizeEnabled&&(z*=1+Math.pow(i,1/A)),n.pulseEnabled){const d=n.pulseAmplitude??.5,v=n.pulseFrequency??1,I=(n.pulsePhaseRandom??0)*k(e)*Math.PI*2;z*=1+d*Math.sin(t*v*Math.PI*2+I)}return Math.max(0,z)}function oe(n,t,a,e){if(a<=0)return 0;let i=n.opacity??1;const z=t/a;if(n.fadeEnabled&&(i*=Math.max(0,1-z)),n.pulseEnabled&&n.pulseOpacity){const A=n.pulseAmplitude??.5,d=n.pulseFrequency??1,x=(n.pulsePhaseRandom??0)*k(e)*Math.PI*2;i*=Math.max(0,1+A*Math.sin(t*d*Math.PI*2+x))}return Math.max(0,Math.min(1,i))}Object.defineProperty(exports,"fetchPreset",{enumerable:!0,get:()=>X.fetchPreset});exports.HZFaithfulFX=$;exports.HZTrailRibbon=ne;exports.computeParticleOpacity=oe;exports.computeParticleSize=ie;exports.particleHash=k;exports.scalePreset=J;
+`;function ne({positionRef:n,duration:t=1,width:s=.3,color:e=[1,1,1],maxPoints:u=256,minDistance:w=.05,opacity:I=1,blending:z=p.AdditiveBlending,visible:f=!0}){const{camera:S}=Z.useThree(),T=c.useRef(null),F=c.useRef({positions:new Float32Array(u*3),times:new Float32Array(u),head:0,count:0,lastPos:new p.Vector3(1/0,1/0,1/0),elapsed:0}),{geometry:y,posAttr:P,colorAttr:C,indexBuf:L}=c.useMemo(()=>{const x=u*2,v=new Float32Array(x*3),r=new Float32Array(x*4),M=new p.BufferGeometry,V=new p.BufferAttribute(v,3);V.setUsage(p.DynamicDrawUsage),M.setAttribute("position",V);const b=new p.BufferAttribute(r,4);b.setUsage(p.DynamicDrawUsage),M.setAttribute("aColor",b);const A=(u-1)*6,m=new Uint32Array(A);for(let E=0;E<u-1;E++){const a=E*2,g=E*6;m[g]=a,m[g+1]=a+1,m[g+2]=a+2,m[g+3]=a+1,m[g+4]=a+3,m[g+5]=a+2}const D=new p.BufferAttribute(m,1);return M.setIndex(D),M.setDrawRange(0,0),{geometry:M,posAttr:V,colorAttr:b,indexBuf:D}},[u]),q=c.useMemo(()=>new p.ShaderMaterial({vertexShader:ee,fragmentShader:te,transparent:!0,depthWrite:!1,side:p.DoubleSide,blending:z}),[z]),i=c.useMemo(()=>new p.Vector3,[]),o=c.useMemo(()=>new p.Vector3,[]),d=c.useMemo(()=>new p.Vector3,[]),h=c.useMemo(()=>new p.Vector3(0,1,0),[]),l=c.useMemo(()=>new p.Vector3,[]);return Z.useFrame((x,v)=>{if(!T.current)return;const r=F.current;if(r.elapsed+=v,!f){r.count=0,r.head=0,r.lastPos.set(1/0,1/0,1/0),y.setDrawRange(0,0);return}const M=n.current;if(!M)return;if(r.lastPos.distanceTo(M)>=w){const a=(r.head+r.count)%u;r.positions[a*3]=M.x,r.positions[a*3+1]=M.y,r.positions[a*3+2]=M.z,r.times[a]=r.elapsed,r.count<u?r.count++:r.head=(r.head+1)%u,r.lastPos.copy(M)}for(;r.count>0;){const a=r.head;if(r.elapsed-r.times[a]>t)r.head=(r.head+1)%u,r.count--;else break}if(r.count<2){y.setDrawRange(0,0);return}const b=P.array,A=C.array;let m=null;const D=r.count;for(let a=0;a<D;a++){const g=(r.head+a)%u,j=r.positions[g*3],B=r.positions[g*3+1],U=r.positions[g*3+2],_=1-(r.elapsed-r.times[g])/t;if(a<D-1){const W=(r.head+a+1)%u;i.set(r.positions[W*3]-j,r.positions[W*3+1]-B,r.positions[W*3+2]-U);const N=i.length();N>1e-6?i.divideScalar(N):m&&i.copy(m)}else m&&i.copy(m);d.set(S.position.x-j,S.position.y-B,S.position.z-U),o.crossVectors(i,d);let H=o.length();H<1e-6&&(l.crossVectors(i,h),o.copy(l),H=o.length(),H<1e-6&&(o.set(1,0,0),H=1)),o.divideScalar(H);const O=s*_,G=I*_*_,R=a*2;b[R*3]=j+o.x*O,b[R*3+1]=B+o.y*O,b[R*3+2]=U+o.z*O,b[(R+1)*3]=j-o.x*O,b[(R+1)*3+1]=B-o.y*O,b[(R+1)*3+2]=U-o.z*O,A[R*4]=e[0],A[R*4+1]=e[1],A[R*4+2]=e[2],A[R*4+3]=G,A[(R+1)*4]=e[0],A[(R+1)*4+1]=e[1],A[(R+1)*4+2]=e[2],A[(R+1)*4+3]=G,m=m||new p.Vector3,m.copy(i)}const E=(D-1)*6;y.setDrawRange(0,E),P.needsUpdate=!0,C.needsUpdate=!0}),K.jsx("mesh",{ref:T,geometry:y,material:q,frustumCulled:!1,renderOrder:101,visible:f})}function k(n){return Math.abs(Math.sin(n*12.9898)*43758.5453)%1}function re(n){const t=Math.sin(n*54321.67)*43758.5453%1;return t<0?t+1:t}function ie(n,t,s,e){if(s<=0)return 0;const u=t/s;let w=n.particleSize??.5;if(n.randomSize){const z=n.minSize??.1,f=n.maxSize??.5;w=z+(f-z)*re(s)}const I=Math.max(.01,Math.min(10,n.sizeLifetimeSpeed??1));if(n.fadeSizeEnabled&&(w*=1-Math.pow(u,1/I)),n.increaseSizeEnabled&&(w*=1+Math.pow(u,1/I)),n.pulseEnabled){const z=n.pulseAmplitude??.5,f=n.pulseFrequency??1,T=(n.pulsePhaseRandom??0)*k(e)*Math.PI*2;w*=1+z*Math.sin(t*f*Math.PI*2+T)}return Math.max(0,w)}function oe(n,t,s,e){if(s<=0)return 0;let u=n.opacity??1;const w=t/s;if(n.fadeEnabled&&(u*=Math.max(0,1-w)),n.pulseEnabled&&n.pulseOpacity){const I=n.pulseAmplitude??.5,z=n.pulseFrequency??1,S=(n.pulsePhaseRandom??0)*k(e)*Math.PI*2;u*=Math.max(0,1+I*Math.sin(t*z*Math.PI*2+S))}return Math.max(0,Math.min(1,u))}Object.defineProperty(exports,"fetchPreset",{enumerable:!0,get:()=>X.fetchPreset});exports.HZFaithfulFX=$;exports.HZTrailRibbon=ne;exports.computeParticleOpacity=oe;exports.computeParticleSize=ie;exports.particleHash=k;exports.scalePreset=J;

package/dist-lib/hz-particles-r3f.d.ts

@@ -17,6 +17,8 @@ export interface HZFaithfulFXProps {
   renderPriority?: number;
   /** Skip scene-depth occlusion (particles never hidden behind geometry). */
   noOcclusion?: boolean;
+  /** Respect the user's `prefers-reduced-motion` setting by freezing the FX. Default true. */
+  respectReducedMotion?: boolean;
 }
 
 /**

package/dist-lib/hz-particles-r3f.mjs

@@ -1,4 +1,4 @@
-import { useRef as b, useMemo as D, useEffect as k } from "react";
+import { useRef as I, useMemo as b, useEffect as X } from "react";
 import { useFrame as J, useThree as N } from "@react-three/fiber";
 import { initHzFxOverlay as Q, makeThreeSceneDepth as Y } from "hz-particles";
 import { fetchPreset as he } from "hz-particles";
@@ -6,13 +6,13 @@ import { jsx as $ } from "react/jsx-runtime";
 import * as s from "three";
 function ee(r, t) {
   if (t === 1) return r;
-  const h = (e, i) => e != null ? e * t : i * t;
+  const v = (e, a) => e != null ? e * t : a * t;
   return {
     ...r,
     systems: r.systems.map((e) => ({
       ...e,
       // Particle visual size
-      particleSize: h(e.particleSize, 0.5),
+      particleSize: v(e.particleSize, 0.5),
       minSize: e.minSize != null ? e.minSize * t : void 0,
       maxSize: e.maxSize != null ? e.maxSize * t : void 0,
       // Speed
@@ -40,59 +40,70 @@ function ee(r, t) {
     }))
   };
 }
-function le({
+function de({
   preset: r,
   positionRef: t,
-  position: h = [0, 0, 0],
+  position: v = [0, 0, 0],
   scale: e = 1,
-  active: i = !0,
-  renderPriority: z = 1,
-  noOcclusion: A = !1
+  active: a = !0,
+  renderPriority: x = 1,
+  noOcclusion: T = !1,
+  respectReducedMotion: z = !0
 }) {
-  const l = b(null), v = b(null), w = b(!1), I = b(0), H = b(i);
-  H.current = i;
-  const C = b(h);
-  C.current = h;
-  const F = D(
+  const p = I(null), S = I(null), D = I(!1), L = I(0), C = I(a);
+  C.current = a;
+  const V = I(v);
+  V.current = v;
+  const H = I(!1), B = b(
     () => e && e !== 1 ? ee(r, e) : r,
     [r, e]
-  ), V = (c) => t ? c.addMovingEmitter(F, {
+  ), U = (i) => t ? i.addMovingEmitter(B, {
     getPosition: () => {
-      const d = t.current;
-      return H.current && d ? [d.x, d.y, d.z] : null;
+      const o = t.current;
+      return C.current && o ? [o.x, o.y, o.z] : null;
     }
-  }) : c.addEmitter(F, C.current);
-  return k(() => {
-    var p, a;
-    const c = l.current;
-    if (!c) return;
-    let d = !1;
-    return (a = (p = v.current) == null ? void 0 : p.remove) == null || a.call(p), v.current = null, V(c).then((u) => {
-      var T;
-      d ? (T = u == null ? void 0 : u.remove) == null || T.call(u) : v.current = u;
+  }) : i.addEmitter(B, V.current);
+  return X(() => {
+    var d, m;
+    const i = p.current;
+    if (!i) return;
+    let o = !1;
+    return (m = (d = S.current) == null ? void 0 : d.remove) == null || m.call(d), S.current = null, U(i).then((c) => {
+      var M;
+      o ? (M = c == null ? void 0 : c.remove) == null || M.call(c) : S.current = c;
     }), () => {
-      d = !0;
+      o = !0;
     };
-  }, [F]), k(() => () => {
-    var c, d;
-    (d = (c = l.current) == null ? void 0 : c.destroy) == null || d.call(c), l.current = null, v.current = null, w.current = !1;
-  }, []), J((c) => {
-    c.gl.render(c.scene, c.camera);
-    const d = performance.now(), p = I.current ? Math.min(0.05, (d - I.current) / 1e3) : 0.016;
-    I.current = d;
-    const a = c.gl, u = a.backend;
-    !l.current && !w.current && (u != null && u.device) && (u != null && u.context) && (w.current = !0, Q(
-      { device: u.device, context: u.context, canvas: a.domElement },
-      { getSceneDepth: A ? () => null : Y(a) }
-    ).then((S) => (l.current = S, V(S))).then((S) => {
-      v.current = S;
-    }).catch((S) => console.error("[HZFaithfulFX] init failed:", S)));
-    const T = l.current;
-    if (T) {
-      const S = c.camera;
-      T.setCamera(S.projectionMatrix.elements, S.matrixWorldInverse.elements, S.position), T.render(p);
+  }, [B]), X(() => {
+    var d;
+    if (typeof window > "u" || !window.matchMedia) return;
+    const i = window.matchMedia("(prefers-reduced-motion: reduce)"), o = () => {
+      H.current = i.matches;
+    };
+    return o(), (d = i.addEventListener) == null || d.call(i, "change", o), () => {
+      var m;
+      return (m = i.removeEventListener) == null ? void 0 : m.call(i, "change", o);
+    };
+  }, []), X(() => () => {
+    var i, o, d, m;
+    (o = (i = S.current) == null ? void 0 : i.remove) == null || o.call(i), (m = (d = p.current) == null ? void 0 : d.destroy) == null || m.call(d), p.current = null, S.current = null, D.current = !1;
+  }, []), J((i) => {
+    i.gl.render(i.scene, i.camera);
+    const o = performance.now(), d = L.current ? Math.min(0.05, (o - L.current) / 1e3) : 0.016;
+    L.current = o;
+    const m = i.gl, c = m.backend;
+    !p.current && !D.current && (c != null && c.device) && (c != null && c.context) && (D.current = !0, Q(
+      { device: c.device, context: c.context, canvas: m.domElement },
+      { getSceneDepth: T ? () => null : Y(m) }
+    ).then((f) => (p.current = f, U(f))).then((f) => {
+      S.current = f;
+    }).catch((f) => console.error("[HZFaithfulFX] init failed:", f)));
+    const M = p.current;
+    if (M) {
+      const f = i.camera;
+      M.setCamera(f.projectionMatrix.elements, f.matrixWorldInverse.elements, f.position), z && H.current || M.render(d);
     }
-  }, z), null;
+  }, x), null;
 }
 const te = (
   /* glsl */
@@ -116,58 +127,58 @@ void main() {
 function se({
   positionRef: r,
   duration: t = 1,
-  width: h = 0.3,
+  width: v = 0.3,
   color: e = [1, 1, 1],
-  maxPoints: i = 256,
-  minDistance: z = 0.05,
-  opacity: A = 1,
-  blending: l = s.AdditiveBlending,
-  visible: v = !0
+  maxPoints: a = 256,
+  minDistance: x = 0.05,
+  opacity: T = 1,
+  blending: z = s.AdditiveBlending,
+  visible: p = !0
 }) {
-  const { camera: w } = N(), I = b(null), H = b({
-    positions: new Float32Array(i * 3),
-    times: new Float32Array(i),
+  const { camera: S } = N(), D = I(null), L = I({
+    positions: new Float32Array(a * 3),
+    times: new Float32Array(a),
     head: 0,
     count: 0,
     lastPos: new s.Vector3(1 / 0, 1 / 0, 1 / 0),
     elapsed: 0
-  }), { geometry: C, posAttr: F, colorAttr: V, indexBuf: c } = D(() => {
-    const W = i * 2, j = new Float32Array(W * 3), n = new Float32Array(W * 4), R = new s.BufferGeometry(), O = new s.BufferAttribute(j, 3);
-    O.setUsage(s.DynamicDrawUsage), R.setAttribute("position", O);
+  }), { geometry: C, posAttr: V, colorAttr: H, indexBuf: B } = b(() => {
+    const M = a * 2, f = new Float32Array(M * 3), n = new Float32Array(M * 4), R = new s.BufferGeometry(), q = new s.BufferAttribute(f, 3);
+    q.setUsage(s.DynamicDrawUsage), R.setAttribute("position", q);
     const g = new s.BufferAttribute(n, 4);
     g.setUsage(s.DynamicDrawUsage), R.setAttribute("aColor", g);
-    const M = (i - 1) * 6, m = new Uint32Array(M);
-    for (let E = 0; E < i - 1; E++) {
-      const o = E * 2, x = E * 6;
-      m[x] = o, m[x + 1] = o + 1, m[x + 2] = o + 2, m[x + 3] = o + 1, m[x + 4] = o + 3, m[x + 5] = o + 2;
+    const A = (a - 1) * 6, l = new Uint32Array(A);
+    for (let F = 0; F < a - 1; F++) {
+      const u = F * 2, w = F * 6;
+      l[w] = u, l[w + 1] = u + 1, l[w + 2] = u + 2, l[w + 3] = u + 1, l[w + 4] = u + 3, l[w + 5] = u + 2;
     }
-    const y = new s.BufferAttribute(m, 1);
-    return R.setIndex(y), R.setDrawRange(0, 0), { geometry: R, posAttr: O, colorAttr: g, indexBuf: y };
-  }, [i]), d = D(() => new s.ShaderMaterial({
+    const E = new s.BufferAttribute(l, 1);
+    return R.setIndex(E), R.setDrawRange(0, 0), { geometry: R, posAttr: q, colorAttr: g, indexBuf: E };
+  }, [a]), U = b(() => new s.ShaderMaterial({
     vertexShader: te,
     fragmentShader: ne,
     transparent: !0,
     depthWrite: !1,
     side: s.DoubleSide,
-    blending: l
-  }), [l]), p = D(() => new s.Vector3(), []), a = D(() => new s.Vector3(), []), u = D(() => new s.Vector3(), []), T = D(() => new s.Vector3(0, 1, 0), []), S = D(() => new s.Vector3(), []);
-  return J((W, j) => {
-    if (!I.current) return;
-    const n = H.current;
-    if (n.elapsed += j, !v) {
+    blending: z
+  }), [z]), i = b(() => new s.Vector3(), []), o = b(() => new s.Vector3(), []), d = b(() => new s.Vector3(), []), m = b(() => new s.Vector3(0, 1, 0), []), c = b(() => new s.Vector3(), []);
+  return J((M, f) => {
+    if (!D.current) return;
+    const n = L.current;
+    if (n.elapsed += f, !p) {
       n.count = 0, n.head = 0, n.lastPos.set(1 / 0, 1 / 0, 1 / 0), C.setDrawRange(0, 0);
       return;
     }
     const R = r.current;
     if (!R) return;
-    if (n.lastPos.distanceTo(R) >= z) {
-      const o = (n.head + n.count) % i;
-      n.positions[o * 3] = R.x, n.positions[o * 3 + 1] = R.y, n.positions[o * 3 + 2] = R.z, n.times[o] = n.elapsed, n.count < i ? n.count++ : n.head = (n.head + 1) % i, n.lastPos.copy(R);
+    if (n.lastPos.distanceTo(R) >= x) {
+      const u = (n.head + n.count) % a;
+      n.positions[u * 3] = R.x, n.positions[u * 3 + 1] = R.y, n.positions[u * 3 + 2] = R.z, n.times[u] = n.elapsed, n.count < a ? n.count++ : n.head = (n.head + 1) % a, n.lastPos.copy(R);
     }
     for (; n.count > 0; ) {
-      const o = n.head;
-      if (n.elapsed - n.times[o] > t)
-        n.head = (n.head + 1) % i, n.count--;
+      const u = n.head;
+      if (n.elapsed - n.times[u] > t)
+        n.head = (n.head + 1) % a, n.count--;
       else
         break;
     }
@@ -175,42 +186,42 @@ function se({
       C.setDrawRange(0, 0);
       return;
     }
-    const g = F.array, M = V.array;
-    let m = null;
-    const y = n.count;
-    for (let o = 0; o < y; o++) {
-      const x = (n.head + o) % i, B = n.positions[x * 3], U = n.positions[x * 3 + 1], P = n.positions[x * 3 + 2], Z = 1 - (n.elapsed - n.times[x]) / t;
-      if (o < y - 1) {
-        const _ = (n.head + o + 1) % i;
-        p.set(
-          n.positions[_ * 3] - B,
-          n.positions[_ * 3 + 1] - U,
-          n.positions[_ * 3 + 2] - P
+    const g = V.array, A = H.array;
+    let l = null;
+    const E = n.count;
+    for (let u = 0; u < E; u++) {
+      const w = (n.head + u) % a, P = n.positions[w * 3], W = n.positions[w * 3 + 1], j = n.positions[w * 3 + 2], Z = 1 - (n.elapsed - n.times[w]) / t;
+      if (u < E - 1) {
+        const _ = (n.head + u + 1) % a;
+        i.set(
+          n.positions[_ * 3] - P,
+          n.positions[_ * 3 + 1] - W,
+          n.positions[_ * 3 + 2] - j
         );
-        const G = p.length();
-        G > 1e-6 ? p.divideScalar(G) : m && p.copy(m);
-      } else m && p.copy(m);
-      u.set(
-        w.position.x - B,
-        w.position.y - U,
-        w.position.z - P
-      ), a.crossVectors(p, u);
-      let q = a.length();
-      q < 1e-6 && (S.crossVectors(p, T), a.copy(S), q = a.length(), q < 1e-6 && (a.set(1, 0, 0), q = 1)), a.divideScalar(q);
-      const L = h * Z, X = A * Z * Z, f = o * 2;
-      g[f * 3] = B + a.x * L, g[f * 3 + 1] = U + a.y * L, g[f * 3 + 2] = P + a.z * L, g[(f + 1) * 3] = B - a.x * L, g[(f + 1) * 3 + 1] = U - a.y * L, g[(f + 1) * 3 + 2] = P - a.z * L, M[f * 4] = e[0], M[f * 4 + 1] = e[1], M[f * 4 + 2] = e[2], M[f * 4 + 3] = X, M[(f + 1) * 4] = e[0], M[(f + 1) * 4 + 1] = e[1], M[(f + 1) * 4 + 2] = e[2], M[(f + 1) * 4 + 3] = X, m = m || new s.Vector3(), m.copy(p);
+        const k = i.length();
+        k > 1e-6 ? i.divideScalar(k) : l && i.copy(l);
+      } else l && i.copy(l);
+      d.set(
+        S.position.x - P,
+        S.position.y - W,
+        S.position.z - j
+      ), o.crossVectors(i, d);
+      let O = o.length();
+      O < 1e-6 && (c.crossVectors(i, m), o.copy(c), O = o.length(), O < 1e-6 && (o.set(1, 0, 0), O = 1)), o.divideScalar(O);
+      const y = v * Z, G = T * Z * Z, h = u * 2;
+      g[h * 3] = P + o.x * y, g[h * 3 + 1] = W + o.y * y, g[h * 3 + 2] = j + o.z * y, g[(h + 1) * 3] = P - o.x * y, g[(h + 1) * 3 + 1] = W - o.y * y, g[(h + 1) * 3 + 2] = j - o.z * y, A[h * 4] = e[0], A[h * 4 + 1] = e[1], A[h * 4 + 2] = e[2], A[h * 4 + 3] = G, A[(h + 1) * 4] = e[0], A[(h + 1) * 4 + 1] = e[1], A[(h + 1) * 4 + 2] = e[2], A[(h + 1) * 4 + 3] = G, l = l || new s.Vector3(), l.copy(i);
     }
-    const E = (y - 1) * 6;
-    C.setDrawRange(0, E), F.needsUpdate = !0, V.needsUpdate = !0;
+    const F = (E - 1) * 6;
+    C.setDrawRange(0, F), V.needsUpdate = !0, H.needsUpdate = !0;
   }), /* @__PURE__ */ $(
     "mesh",
     {
-      ref: I,
+      ref: D,
       geometry: C,
-      material: d,
+      material: U,
       frustumCulled: !1,
       renderOrder: 101,
-      visible: v
+      visible: p
     }
   );
 }
@@ -221,36 +232,36 @@ function re(r) {
   const t = Math.sin(r * 54321.67) * 43758.5453 % 1;
   return t < 0 ? t + 1 : t;
 }
-function de(r, t, h, e) {
-  if (h <= 0) return 0;
-  const i = t / h;
-  let z = r.particleSize ?? 0.5;
+function le(r, t, v, e) {
+  if (v <= 0) return 0;
+  const a = t / v;
+  let x = r.particleSize ?? 0.5;
   if (r.randomSize) {
-    const l = r.minSize ?? 0.1, v = r.maxSize ?? 0.5;
-    z = l + (v - l) * re(h);
+    const z = r.minSize ?? 0.1, p = r.maxSize ?? 0.5;
+    x = z + (p - z) * re(v);
   }
-  const A = Math.max(0.01, Math.min(10, r.sizeLifetimeSpeed ?? 1));
-  if (r.fadeSizeEnabled && (z *= 1 - Math.pow(i, 1 / A)), r.increaseSizeEnabled && (z *= 1 + Math.pow(i, 1 / A)), r.pulseEnabled) {
-    const l = r.pulseAmplitude ?? 0.5, v = r.pulseFrequency ?? 1, I = (r.pulsePhaseRandom ?? 0) * K(e) * Math.PI * 2;
-    z *= 1 + l * Math.sin(t * v * Math.PI * 2 + I);
+  const T = Math.max(0.01, Math.min(10, r.sizeLifetimeSpeed ?? 1));
+  if (r.fadeSizeEnabled && (x *= 1 - Math.pow(a, 1 / T)), r.increaseSizeEnabled && (x *= 1 + Math.pow(a, 1 / T)), r.pulseEnabled) {
+    const z = r.pulseAmplitude ?? 0.5, p = r.pulseFrequency ?? 1, D = (r.pulsePhaseRandom ?? 0) * K(e) * Math.PI * 2;
+    x *= 1 + z * Math.sin(t * p * Math.PI * 2 + D);
   }
-  return Math.max(0, z);
+  return Math.max(0, x);
 }
-function pe(r, t, h, e) {
-  if (h <= 0) return 0;
-  let i = r.opacity ?? 1;
-  const z = t / h;
-  if (r.fadeEnabled && (i *= Math.max(0, 1 - z)), r.pulseEnabled && r.pulseOpacity) {
-    const A = r.pulseAmplitude ?? 0.5, l = r.pulseFrequency ?? 1, w = (r.pulsePhaseRandom ?? 0) * K(e) * Math.PI * 2;
-    i *= Math.max(0, 1 + A * Math.sin(t * l * Math.PI * 2 + w));
+function pe(r, t, v, e) {
+  if (v <= 0) return 0;
+  let a = r.opacity ?? 1;
+  const x = t / v;
+  if (r.fadeEnabled && (a *= Math.max(0, 1 - x)), r.pulseEnabled && r.pulseOpacity) {
+    const T = r.pulseAmplitude ?? 0.5, z = r.pulseFrequency ?? 1, S = (r.pulsePhaseRandom ?? 0) * K(e) * Math.PI * 2;
+    a *= Math.max(0, 1 + T * Math.sin(t * z * Math.PI * 2 + S));
   }
-  return Math.max(0, Math.min(1, i));
+  return Math.max(0, Math.min(1, a));
 }
 export {
-  le as HZFaithfulFX,
+  de as HZFaithfulFX,
   se as HZTrailRibbon,
   pe as computeParticleOpacity,
-  de as computeParticleSize,
+  le as computeParticleSize,
   he as fetchPreset,
   K as particleHash,
   ee as scalePreset