r3f-vfx 0.0.3 → 0.0.5

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-import * as zustand from 'zustand';
+import * as react from 'react';
+import * as THREE from 'three/webgpu';
+import { CoreState } from 'core-vfx';
 
 declare const Appearance: Readonly<{
     DEFAULT: "default";
@@ -6,10 +8,10 @@ declare const Appearance: Readonly<{
     CIRCULAR: "circular";
 }>;
 declare const Blending: Readonly<{
-    NORMAL: any;
-    ADDITIVE: any;
-    MULTIPLY: any;
-    SUBTRACTIVE: any;
+    NORMAL: 1;
+    ADDITIVE: 2;
+    MULTIPLY: 4;
+    SUBTRACTIVE: 3;
 }>;
 declare const EmitterShape: Readonly<{
     POINT: 0;
@@ -35,8 +37,8 @@ declare const Lighting: Readonly<{
     PHYSICAL: "physical";
 }>;
 declare function bakeCurveToArray(curveData: any, resolution?: number): Float32Array<ArrayBuffer>;
-declare function createCombinedCurveTexture(sizeCurve: any, opacityCurve: any, velocityCurve: any, rotationSpeedCurve: any): any;
-declare const VFXParticles: any;
+declare function createCombinedCurveTexture(sizeCurve: any, opacityCurve: any, velocityCurve: any, rotationSpeedCurve: any): THREE.DataTexture;
+declare const VFXParticles: react.ForwardRefExoticComponent<react.RefAttributes<any>>;
 
 /**
  * Higher-order hook for programmatic emitter control
@@ -51,14 +53,21 @@ declare const VFXParticles: any;
  * burst([0, 0, 0], 100, { colorStart: ["#ff0000"] });
  */
 declare function useVFXEmitter(name: any): {
-    emit: any;
-    burst: any;
-    start: any;
-    stop: any;
-    clear: any;
-    isEmitting: any;
-    getUniforms: any;
-    getParticles: () => any;
+    emit: (position?: number[], count?: number, overrides?: null) => boolean;
+    burst: (position?: number[], count?: number, overrides?: null) => boolean;
+    start: () => boolean;
+    stop: () => boolean;
+    clear: () => boolean;
+    isEmitting: () => boolean;
+    getUniforms: () => Record<string, unknown> | null;
+    getParticles: () => {
+        spawn: (x: number, y: number, z: number, count: number, overrides?: Record<string, unknown> | null) => void;
+        start: () => void;
+        stop: () => void;
+        clear: () => void;
+        isEmitting: boolean;
+        uniforms: Record<string, unknown>;
+    } | null;
 };
 /**
  * VFXEmitter - A reusable emitter component that links to a VFXParticles system
@@ -104,30 +113,9 @@ declare function useVFXEmitter(name: any): {
  * @param {object} [props.overrides] - Per-spawn overrides (size, speed, colors, etc.)
  * @param {function} [props.onEmit] - Callback fired after each emission
  */
-declare const VFXEmitter: any;
+declare const VFXEmitter: react.ForwardRefExoticComponent<react.RefAttributes<any>>;
 
-/**
- * VFX Store - Centralized management for VFX particle systems
- *
- * Allows multiple VFXEmitter components to share a single VFXParticles instance,
- * avoiding extra draw calls while enabling emission from multiple positions.
- *
- * Usage:
- *
- * // Register a particle system
- * <VFXParticles ref={(ref) => registerParticles("sparks", ref)} ... />
- *
- * // Or use the VFXParticles name prop with auto-registration
- * <VFXParticles name="sparks" ... />
- *
- * // Emit from anywhere using VFXEmitter (no extra draw calls!)
- * <VFXEmitter name="sparks" position={[1, 0, 0]} emitCount={10} />
- * <VFXEmitter name="sparks" position={[-1, 0, 0]} emitCount={5} />
- *
- * // Or emit programmatically
- * const emit = useVFXStore(s => s.emit);
- * emit("sparks", { x: 0, y: 1, z: 0, count: 20 });
- */
-declare const useVFXStore: zustand.UseBoundStore<zustand.StoreApi<any>>;
+declare function useVFXStore(): CoreState;
+declare function useVFXStore<T>(selector: (state: CoreState) => T): T;
 
 export { Appearance, AttractorType, Blending, Easing, EmitterShape, Lighting, VFXEmitter, VFXParticles, bakeCurveToArray, createCombinedCurveTexture, useVFXEmitter, useVFXStore };

package/dist/index.js

@@ -18,19 +18,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __restKey = (key) => typeof key === "symbol" ? key : key + "";
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -39,134 +26,15 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/useVFXStore.js
-import { create } from "zustand";
-var useVFXStore;
-var init_useVFXStore = __esm({
-  "src/useVFXStore.js"() {
+// src/react-store.ts
+import { coreStore } from "core-vfx";
+import { useStore } from "zustand";
+function useVFXStore(selector) {
+  return useStore(coreStore, selector);
+}
+var init_react_store = __esm({
+  "src/react-store.ts"() {
     "use strict";
-    useVFXStore = create((set, get) => ({
-      // Registered particle systems: { name: ref }
-      particles: {},
-      /**
-       * Register a VFXParticles instance by name
-       * @param {string} name - Unique identifier for this particle system
-       * @param {object} ref - The ref object from VFXParticles (with spawn, start, stop methods)
-       */
-      registerParticles: (name, ref) => {
-        if (!name || !ref) return;
-        set((state) => ({
-          particles: __spreadProps(__spreadValues({}, state.particles), { [name]: ref })
-        }));
-      },
-      /**
-       * Unregister a VFXParticles instance
-       * @param {string} name - Name of the particle system to unregister
-       */
-      unregisterParticles: (name) => {
-        set((state) => {
-          const _a = state.particles, { [name]: _ } = _a, rest = __objRest(_a, [__restKey(name)]);
-          return { particles: rest };
-        });
-      },
-      /**
-       * Get a registered particle system by name
-       * @param {string} name - Name of the particle system
-       * @returns {object|null} The particle system ref or null
-       */
-      getParticles: (name) => {
-        return get().particles[name] || null;
-      },
-      /**
-       * Emit particles from a registered system
-       * @param {string} name - Name of the particle system
-       * @param {object} options - Emission options
-       * @param {number} [options.x=0] - X position offset
-       * @param {number} [options.y=0] - Y position offset
-       * @param {number} [options.z=0] - Z position offset
-       * @param {number} [options.count=20] - Number of particles to emit
-       * @param {object} [options.overrides] - Spawn parameter overrides
-       * @returns {boolean} True if emission was successful
-       */
-      emit: (name, { x = 0, y = 0, z = 0, count = 20, overrides = null } = {}) => {
-        const particles = get().particles[name];
-        if (!(particles == null ? void 0 : particles.spawn)) {
-          console.warn(
-            `VFXStore: No particle system registered with name "${name}"`
-          );
-          return false;
-        }
-        particles.spawn(x, y, z, count, overrides);
-        return true;
-      },
-      /**
-       * Start auto-emission on a registered particle system
-       * @param {string} name - Name of the particle system
-       * @returns {boolean} True if successful
-       */
-      start: (name) => {
-        const particles = get().particles[name];
-        if (!(particles == null ? void 0 : particles.start)) {
-          console.warn(
-            `VFXStore: No particle system registered with name "${name}"`
-          );
-          return false;
-        }
-        particles.start();
-        return true;
-      },
-      /**
-       * Stop auto-emission on a registered particle system
-       * @param {string} name - Name of the particle system
-       * @returns {boolean} True if successful
-       */
-      stop: (name) => {
-        const particles = get().particles[name];
-        if (!(particles == null ? void 0 : particles.stop)) {
-          console.warn(
-            `VFXStore: No particle system registered with name "${name}"`
-          );
-          return false;
-        }
-        particles.stop();
-        return true;
-      },
-      /**
-       * Clear all particles from a registered system
-       * @param {string} name - Name of the particle system
-       * @returns {boolean} True if successful
-       */
-      clear: (name) => {
-        const particles = get().particles[name];
-        if (!(particles == null ? void 0 : particles.clear)) {
-          console.warn(
-            `VFXStore: No particle system registered with name "${name}"`
-          );
-          return false;
-        }
-        particles.clear();
-        return true;
-      },
-      /**
-       * Check if a particle system is currently emitting
-       * @param {string} name - Name of the particle system
-       * @returns {boolean} True if emitting
-       */
-      isEmitting: (name) => {
-        var _a;
-        const particles = get().particles[name];
-        return (_a = particles == null ? void 0 : particles.isEmitting) != null ? _a : false;
-      },
-      /**
-       * Get the uniforms object for direct manipulation
-       * @param {string} name - Name of the particle system
-       * @returns {object|null} The uniforms object or null
-       */
-      getUniforms: (name) => {
-        const particles = get().particles[name];
-        return (particles == null ? void 0 : particles.uniforms) || null;
-      }
-    }));
   }
 });
 
@@ -184,7 +52,7 @@ __export(VFXParticlesDebugPanel_exports, {
 import { createRoot } from "react-dom/client";
 import { useState, useCallback, useRef, useEffect } from "react";
 import * as THREE from "three";
-import { create as create2 } from "zustand";
+import { create } from "zustand";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function renderDebugPanel(values, onChange) {
   currentValues = values;
@@ -355,7 +223,7 @@ var init_VFXParticlesDebugPanel = __esm({
   "src/VFXParticlesDebugPanel.jsx"() {
     "use strict";
     init_VFXParticles();
-    useDebugPanelStore = create2(() => ({
+    useDebugPanelStore = create(() => ({
       flushChangesRef: { current: null }
     }));
     getFlushChanges = () => useDebugPanelStore.getState().flushChangesRef.current;
@@ -5298,7 +5166,7 @@ var Appearance, Blending, EmitterShape, AttractorType, Easing, Lighting, MAX_ATT
 var init_VFXParticles = __esm({
   "src/VFXParticles.jsx"() {
     "use strict";
-    init_useVFXStore();
+    init_react_store();
     Appearance = Object.freeze({
       DEFAULT: "default",
       GRADIENT: "gradient",
@@ -7540,7 +7408,7 @@ var init_VFXParticles = __esm({
 init_VFXParticles();
 
 // src/VFXEmitter.jsx
-init_useVFXStore();
+init_react_store();
 import {
   useRef as useRef3,
   useEffect as useEffect3,
@@ -7743,7 +7611,7 @@ function useVFXEmitter(name) {
 }
 
 // src/index.ts
-init_useVFXStore();
+init_react_store();
 export {
   Appearance,
   AttractorType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "r3f-vfx",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -20,13 +20,18 @@
     "dev": "tsup --watch",
     "build": "tsup",
     "typecheck": "tsc",
-    "copy-readme": "cp ../README.md README.md",
+    "copy-readme": "cp ../../README.md README.md",
     "prepublishOnly": "bun run typecheck && bun run build && bun run copy-readme"
   },
   "dependencies": {
+    "core-vfx": "0.0.2",
     "zustand": "5.0.10"
   },
   "devDependencies": {
+    "@react-three/fiber": "9.5.0",
+    "@types/react": "19.2.10",
+    "@types/three": "0.182.0",
+    "three": "0.182.0",
     "tsup": "8.5.1",
     "typescript": "5.9.3"
   },