r3f-vfx 0.1.3 → 0.1.6

package/README.md

@@ -389,7 +389,6 @@ store.clear('sparks')
 
 ```tsx
 import { BoxGeometry } from 'three/webgpu'
-
 ;<VFXParticles
   geometry={new BoxGeometry(1, 1, 1)}
   maxParticles={500}

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { RefObject, ReactNode } from 'react';
 import * as THREE from 'three/webgpu';
 import { CurveData, Rotation3DInput, Appearance, Lighting, ParticleData, EmitterShape, CoreState } from 'core-vfx';
-export { Appearance, AttractorConfig, AttractorType, BaseParticleProps, Blending, CollisionConfig, CurveData, CurvePoint, Easing, EmitterShape, FlipbookConfig, FrictionConfig, Lighting, ParticleData, Rotation3DInput, StretchConfig, TurbulenceConfig, bakeCurveToArray, createCombinedCurveTexture } from 'core-vfx';
+export { Appearance, AttractorConfig, AttractorType, BaseParticleProps, Blending, CollisionConfig, CurveChannel, CurveData, CurvePoint, CurveTextureResult, Easing, EmitterShape, FlipbookConfig, FrictionConfig, Lighting, ParticleData, Rotation3DInput, StretchConfig, TurbulenceConfig, bakeCurveToArray, buildCurveTextureBin, createCombinedCurveTexture } from 'core-vfx';
 
 type VFXParticlesProps = {
     /** Optional name for registering with useVFXStore (enables VFXEmitter linking) */
@@ -264,14 +264,24 @@ declare const useVFXStore: typeof useVFXStoreImpl & {
     getInitialState: () => CoreState;
 };
 
+type CurveTextureHookResult = {
+    texture: THREE.DataTexture;
+    /** Per-channel enabled state, combining curve props and loaded .bin channels */
+    sizeEnabled: boolean;
+    opacityEnabled: boolean;
+    velocityEnabled: boolean;
+    rotationSpeedEnabled: boolean;
+};
 /**
- * Hook for curve texture loading/baking
- * Returns a STABLE texture reference that updates in place
+ * Hook for curve texture loading/baking.
+ *
+ * If curveTexturePath is provided, loads pre-baked texture from file.
+ * The .bin file contains a header with a bitmask of which channels are active.
+ * Only those channels override the curve props; the rest use curve props or defaults.
  *
- * If curveTexturePath is provided, loads pre-baked texture from file
- * If curves are defined, bakes them synchronously on the main thread
- * If no curves AND no path, returns default texture (no baking needed)
+ * If curves are defined (no path), bakes them synchronously on the main thread.
+ * If no curves AND no path, returns default texture (no baking needed).
  */
-declare const useCurveTextureAsync: (sizeCurve: CurveData | null, opacityCurve: CurveData | null, velocityCurve: CurveData | null, rotationSpeedCurve: CurveData | null, curveTexturePath?: string | null) => THREE.DataTexture;
+declare const useCurveTextureAsync: (sizeCurve: CurveData | null, opacityCurve: CurveData | null, velocityCurve: CurveData | null, rotationSpeedCurve: CurveData | null, curveTexturePath?: string | null) => CurveTextureHookResult;
 
-export { VFXEmitter, VFXParticles, useCurveTextureAsync, useVFXEmitter, useVFXStore };
+export { type CurveTextureHookResult, VFXEmitter, VFXParticles, useCurveTextureAsync, useVFXEmitter, useVFXStore };