custom-pixi-particles 4.35.0 → 4.37.0

package/README.md

@@ -9,12 +9,15 @@
 - [Installation](#️-installation)
 - [Quick Start](#-quick-start)
 - [API Reference](#-api-reference)
+  - [Textures: static, animated, and mixed](#textures-static-animated-and-mixed)
 - [Configuration Guide](#-configuration-guide)
   - [Emission Types](#emission-types)
   - [Behaviours](#behaviours)
 - [Examples](#-examples)
 - [Performance Tips](#-performance-tips)
 - [Troubleshooting](#-troubleshooting)
+- [Common Use Cases](#-common-use-cases)
+- [Best Practices](#-best-practices)
 - [Special Effects](#special-effects)
   - [Shatter Effect](#shatter-effect)
   - [Dissolve Effect](#dissolve-effect)
@@ -30,6 +33,7 @@
   - [Liquid Mercury Effect](#liquid-mercury-effect)
 - [Versions Compatibility](#️-versions-compatibility)
 - [Advanced Editor](#️-advanced-editor)
+- [License](#-license)
 - [Contributing](#-contributing)
 
 ---
@@ -45,8 +49,9 @@ If you find **custom-pixi-particles** useful and would like to support my work,
 - **Simple API**: Effortlessly create particle emitters with minimal code.
 - **Highly Configurable**: Adjust particle behavior, appearance, animation, and more.
 - **Performance Optimized**: Handle thousands of particles with minimal performance overhead.
-- **PIXI.js Compatibility**: Fully compatible with **PIXI.js v8**, **PIXI.js v7**, with legacy support for v5.x and v6.x.
+- **PIXI.js Compatibility**: Current releases target **PIXI.js v8**. For legacy **v5/v6** projects, use `custom-pixi-particles@4.x`.
 - **Real-Time Customization**: Dynamically update textures, positions, configurations, and emitters on the fly.
+- **Static and animated textures**: Use single-frame textures, frame sequences (`prefix00.png`, `prefix01.png`, …), or **mix both** per particle via `textureVariants` and optional `variantWeights`.
 - **Shatter Effect**: Create dramatic sprite shattering effects with realistic physics and automatic cleanup.
 
 ---
@@ -64,17 +69,25 @@ Install via npm:
 npm install custom-pixi-particles
 ```
 
-**Peer dependency:** This library requires **PIXI.js** (or **pixi.js-legacy**). Install the version compatible with your project:
+This package targets modern PixiJS and includes `pixi.js` in its dependencies by default.
+For legacy PixiJS v5/v6 compatibility, use `custom-pixi-particles@4.x` with `pixi.js-legacy`.
 
 ```bash
-# For PIXI.js v8
-npm install pixi.js
+# For PIXI.js v8 (current)
+npm install custom-pixi-particles pixi.js
 
-# For PIXI.js v7
-npm install pixi.js
+# For PIXI.js v5/v6 (legacy line)
+npm install custom-pixi-particles@4 pixi.js-legacy
+```
+
+If you need prebuilt browser bundles from this repo, run:
 
-# For PIXI.js v5/v6 (legacy)
-npm install pixi.js-legacy
+```bash
+npm run build
+npm run build:browser:v8
+# optional:
+# npm run build:browser:v7
+# npm run build:browser:v6
 ```
 
 ---
@@ -83,17 +96,22 @@ npm install pixi.js-legacy
 
 ### Import or Require
 ```javascript
-// ES6 Modules
-import customPixiParticles from 'custom-pixi-particles'
+// ES modules
+import { customPixiParticles } from 'custom-pixi-particles'
 
 // CommonJS
-const customPixiParticles = require('custom-pixi-particles')
+const { customPixiParticles } = require('custom-pixi-particles')
+```
+
+You can also import Pixi helpers directly from this package:
+```javascript
+import { Application, Assets } from 'custom-pixi-particles'
 ```
 
 ### Basic Example
 ```javascript
 import { Application } from 'pixi.js'
-import customPixiParticles from 'custom-pixi-particles'
+import { customPixiParticles } from 'custom-pixi-particles'
 
 // Create PIXI application
 const app = new Application()
@@ -178,13 +196,10 @@ Initializes a particle emitter with the specified configuration.
 
 ```javascript
 const particles = customPixiParticles.create({
-  textures: [String],             // Array of particle texture paths or PIXI.Texture objects
+  textures: [String],             // Array of particle texture paths
   emitterConfig: Object,          // Configuration object for the emitter (see Configuration section)
   animatedSpriteZeroPad: Number,  // Zero-padding for animated sprite names (default: 2)
   animatedSpriteIndexToStart: Number, // Initial frame index for animated sprites (default: 0)
-  animatedSprite: Boolean,        // Enable animated sprite textures (default: false)
-  animatedSpriteFrameRate: Number, // Frame rate for animated sprites
-  animatedSpriteLoop: Boolean,    // Loop animated sprites (default: true)
   finishingTextures: [String],    // Textures used for particle finishing animations
   vertices: Boolean,              // Use vertex mode for rendering (default: true)
   position: Boolean,              // Allow position-based behavior (default: true)
@@ -195,9 +210,13 @@ const particles = customPixiParticles.create({
   maxFPS: Number,                 // Cap emitter update frequency (default: 60)
   minFPS: Number,                 // Minimum FPS threshold (default: 30)
   tickerSpeed: Number,            // Speed of the PIXI ticker (default: 0.02)
+  particleLinks: Object,          // Optional proximity-line mesh between particles
+  canvasSizeProvider: Function,   // Optional callback returning { width, height } for canvas-aware bounds
 })
 ```
 
+`create(...)` returns a `Renderer`.
+
 ### Configuration Object Structure
 
 The `emitterConfig` object contains all the settings for your particle system:
@@ -223,9 +242,73 @@ const emitterConfig = {
   behaviours: [
     // See Behaviours section for details
   ],
+
+  // Optional — see "Textures: static, animated, and mixed" below
+  // animatedSprite: { enabled: true, frameRate: 0.25, loop: true, randomFrameStart: false },
+  // textureVariants: [ /* mix static + animated */ ],
+  // variantWeights: [0.5, 0.5],
+}
+```
+
+### Textures: static, animated, and mixed
+
+Particle visuals come from the `textures` array you pass to `customPixiParticles.create({ textures, emitterConfig, ... })` **plus** texture-related fields on **`emitterConfig`**. All asset keys must be loaded with Pixi’s **`Assets`** (or equivalent) before particles spawn.
+
+#### 1. Static textures only (default)
+
+If animated sprites are **not** enabled, each entry in `textures` is treated as a **full texture id** (e.g. `'spark.png'`). Each new particle picks one at random.
+
+```javascript
+const textures = ['a.png', 'b.png', 'c.png']
+// emitterConfig without animatedSprite.enabled / without textureVariants
+```
+
+#### 2. Animated sprites (legacy mode, all entries are sequences)
+
+Set **`emitterConfig.animatedSprite.enabled: true`**. Then each string in `textures` is a **filename prefix** (no extension). The renderer loads consecutive frames:
+
+`{prefix}{index}.png` — e.g. `fire00.png`, `fire01.png`, … until a frame is missing.
+
+- **Padding**: use `animatedSpriteZeroPad` / `animatedSpriteIndexToStart` on `create({ ... })` (defaults: pad `2`, start index `0`). Per-sequence overrides exist on each `frames` variant when using `textureVariants` (below).
+- **Playback**: `emitterConfig.animatedSprite` typically includes `frameRate`, `loop`, and optional `randomFrameStart` (see the live editor’s General → Animated sprite for the exact shape your JSON uses).
+
+```javascript
+customPixiParticles.create({
+  textures: ['explosion_', 'smoke_'], // two different frame sequences
+  animatedSpriteZeroPad: 2,
+  emitterConfig: {
+    animatedSprite: { enabled: true, frameRate: 0.25, loop: true },
+    // ...behaviours, emitController, etc.
+  },
+})
+```
+
+#### 3. Mix static and animated (`textureVariants`)
+
+For **some particles static and some animated**, set a non-empty **`emitterConfig.textureVariants`** array. Each item is either:
+
+| Type | Meaning |
+|------|--------|
+| `{ type: 'staticRandom', textures: ['x.png', 'y.png'] }` | Pick one static texture at random for that variant. |
+| `{ type: 'frames', prefix: 'boom_', frameRate?, loop?, randomFrameStart?, animatedSpriteZeroPad?, animatedSpriteIndexToStart? }` | Load `boom_00.png`, `boom_01.png`, … (PNG, same rules as legacy animated). |
+
+Optional **`emitterConfig.variantWeights`**: same length as `textureVariants`, relative probabilities (normalized internally). If omitted, variants are equally likely.
+
+```javascript
+emitterConfig: {
+  textureVariants: [
+    { type: 'staticRandom', textures: ['spark.png', 'glow.png'] },
+    { type: 'frames', prefix: 'fire_', frameRate: 0.3, loop: true },
+  ],
+  variantWeights: [0.6, 0.4], // 60% static pool, 40% fire_ sequence
+  // ...
 }
 ```
 
+When `textureVariants` is set, it **replaces** the simple “all static” / “all prefixes” derivation from `textures` alone. You still pass `textures` to `create()` for updates like `setTextures` / defaults where the code falls back to the legacy list.
+
+**Note:** `finishingTextures` apply to **static** particles when a particle enters finishing state; animated display uses `AnimatedSprite` and does not swap to finishing textures the same way.
+
 ### Event Callbacks
 Triggered when the particle animation completes.
 ```javascript
@@ -284,6 +367,10 @@ Refreshes the particle texture (e.g. after changing texture source).
 ```javascript
 particles.updateTexture()
 ```
+Updates particle-link settings at runtime.
+```javascript
+particles.setParticleLinks({ enabled: true, maxDistance: 100 })
+```
 
 ### Position Updates
 Dynamically adjust the emitter's position.
@@ -834,7 +921,7 @@ particles.emitter.behaviours.add(myCustomBehaviour)
 // New and existing particles will use the new behaviour on the next update
 ```
 
-**Extending built-in behaviours:** All built-in behaviour classes are exported from the package so you can extend any of them: `SpawnBehaviour`, `LifeBehaviour`, `PositionBehaviour`, `ColorBehaviour`, `SizeBehaviour`, `AngularVelocityBehaviour`, `EmitDirectionBehaviour`, `RotationBehaviour`, `TurbulenceBehaviour`, `CollisionBehaviour`, `AttractionRepulsionBehaviour`, `NoiseBasedMotionBehaviour`, `ForceFieldsBehaviour`, `TimelineBehaviour`, `GroupingBehaviour`, `SoundReactiveBehaviour`, `LightEffectBehaviour`, `StretchBehaviour`, `TemperatureBehaviour`, `MoveToPointBehaviour`, `Wireframe3DBehaviour`, `VortexBehaviour`, `PulseBehaviour`, `RippleBehaviour`, `OrbitBehaviour`, `FlickerBehaviour`, `WobbleBehaviour`, `ColorCycleBehaviour`, `ConstrainToShapeBehaviour`, `GravityWellBehaviour`, `TrailBehaviour`, `BounceBehaviour`, `HomingBehaviour`, `FloatUpBehaviour`, `MagnetBehaviour`, `NearMissDispersionBehaviour`, `ConversionCascadeBehaviour`, `BoidsFlockingBehaviour`, `ProximityStateBehaviour`, `PhaseFieldFlowBehaviour`, `PhaseCoherenceBehaviour`, `CurvatureFlowBehaviour`, `LimitCycleBehaviour`, `AizawaAttractorBehaviour`, `ToroidalFlowBehaviour`, `ProximityTriggeredPhaseBehaviour`, `LissajousHarmonicLatticeBehaviour`, `JacobianCurlFieldBehaviour`. Also exported: `Behaviour`, `BehaviourRegistry`, `EmitterBehaviours`, `BehaviourNames`.
+**Extending built-in behaviours:** Core behaviour classes are exported directly from the package (for example `SpawnBehaviour`, `LifeBehaviour`, `PositionBehaviour`, `ColorBehaviour`, `SizeBehaviour`, `FormPatternBehaviour`, `ToroidalWrapBehaviour`, plus `Behaviour`, `BehaviourRegistry`, `EmitterBehaviours`, `BehaviourNames`). Advanced behaviours are available by name in emitter configs/editor presets; if you need class-level inheritance for one that is not exported at top-level, import from the package source in this repo.
 
 **Replacing a built-in behaviour:** Register your class under the same name as a built-in (e.g. `SpawnBehaviour`) **before** creating the renderer or loading config. The registry is checked first, so your implementation is used instead. Use this for customizations like multiple trails on one shape, different trailing logic (e.g. CCV-style), or any variant of spawn/trail/position without changing the library.
 
@@ -928,7 +1015,7 @@ Defines where and how particles spawn. Supports multiple spawn types.
 - `Path` - Custom path defined by points
 - `Oval` - Elliptical distributions
 
-**Additional behaviours** (see the [editor](https://okuniewicz.eu/) for full documentation): Aizawa Attractor, Boids Flocking, Bounce, Color Cycle, Constrain To Shape, Conversion Cascade, Curvature Flow, Flicker, Float Up, Gravity Well, Homing, Jacobian Curl-Field, Lissajous Harmonic Lattice, Limit Cycle, Magnet, Near Miss Dispersion, Orbit, Phase Coherence, Phase Field Flow, Proximity State, Proximity Triggered Phase, Pulse, Ripple, Trail, Toroidal Flow, Vortex, Wobble.
+**Additional behaviours** (see the [editor](https://okuniewicz.eu/) for full documentation): Aizawa Attractor, Beat Phase Lock, Bezier Flow Tube, Boids Flocking, Bounce, Color Cycle, Constrain To Shape, Conversion Cascade, Curvature Flow, Damage Flash Ripple, Emitter Attractor Link, Flicker, Float Up, Form Pattern, Gravity Well, Homing, Jacobian Curl-Field, Kelvin Wake, Lissajous Harmonic Lattice, Limit Cycle, Magnet, Near Miss Dispersion, Obstacle SDF Steer, Orbit, Phase Coherence, Phase Field Flow, Proximity State, Proximity Triggered Phase, Pulse, Ripple, RVO Avoidance, Screen Space Flow Map, Shear Flow, Toroidal Wrap, Trail, Toroidal Flow, Vortex, Wobble.
 
 #### Size Behaviour
 Controls particle size over time.
@@ -1193,60 +1280,6 @@ Moves particles toward specific points.
 }
 ```
 
-#### Wireframe3D Behaviour
-Renders 3D wireframe shapes (cube, sphere, pyramid, torus, cylinder, etc.) with optional orbit, pulsate, path motion, dashed lines, and depth styling. When this behaviour is present, the emitter is wrapped in a container that provides a Graphics object for the wireframe; use it for 3D-style particle backdrops or decorative shapes.
-
-```javascript
-{
-  priority: 50,
-  enabled: true,
-  shapeType: 'cube',           // 'cube' | 'sphere' | 'pyramid' | 'torus' | 'cylinder' | 'tetrahedron' | 'octahedron' | 'grid' | 'lattice' | 'custom'
-  size: 100,
-  rotationSpeedX: 0.5,
-  rotationSpeedY: 0.3,
-  rotationSpeedZ: 0.2,
-  lineColor: 0xffffff,
-  lineWidth: 1,
-  perspective: 400,
-  cameraZ: 500,
-  depthStyle: 'none',          // 'none' | 'fade' | 'thickness' | 'both'
-  sortByDepth: false,
-  orbitEnabled: false,
-  orbitRadius: 50,
-  orbitSpeed: 1,
-  pulsateEnabled: false,
-  pulsateMin: 80,
-  pulsateMax: 120,
-  pulsateSpeed: 2,
-  pathType: 'none',
-  pathSpeed: 1,
-  pathScale: 50,
-  dashedEnabled: false,
-  dashLength: 10,
-  gapLength: 5,
-  colorOverTimeEnabled: false,
-  colorOverTimeSpeed: 1,
-  perVertexColor: false,
-  noiseWobbleEnabled: false,
-  noiseWobbleAmount: 10,
-  noiseWobbleSpeed: 1,
-  attractParticlesEnabled: false,
-  attractStrength: 0,
-  latticeSegmentsX: 4,
-  latticeSegmentsY: 4,
-  latticeSegmentsZ: 4,
-  gridSegments: 4,
-  torusInnerRadius: 0.5,
-  cylinderHeight: 1,
-  customVertices: [],
-  customEdges: [],
-  wireframes: [],
-  name: 'Wireframe3DBehaviour',
-}
-```
-
----
-
 ## 💡 Examples
 
 ### Fire Effect
@@ -1421,6 +1454,14 @@ const textConfig = {
 5. **FPS Capping**: Use `maxFPS` and `minFPS` to control update frequency
 6. **Batch Updates**: Update multiple emitters in a single frame when possible
 7. **Clean Up**: Call `destroy()` and `clearPool()` when done with emitters
+8. **Runtime `behaviour.enabled` toggles**: If you flip `enabled` on an existing behaviour instance without re-running the emitter parser (add/remove), call `emitter.behaviours.invalidateEnabledApplySnapshot()` before particle simulation runs, or rely on the next full `emitter.update()` after toggling in the same frame as other code paths that only call `apply`/`init` without going through `update()`.
+
+### Profiling checklist (Chrome / Chromium)
+
+1. Open **Performance** (or **JavaScript Profiler**), record while your effect runs at target particle count.
+2. In the flame chart, look for **`Emitter.update`**, **`EmitterBehaviours.apply`**, and behaviour names in hot frames.
+3. Confirm **GC** time: high allocation rates often come from per-frame object creation outside this library; spatial grids here use numeric cell keys to avoid string churn on neighbor queries.
+4. Compare **GPU** vs **CPU**: if the bottleneck is upload/draw, reduce `ParticleContainer` feature flags (`rotation`, `tint`, `uvs`) and particle count before micro-optimizing simulation.
 
 ---
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import Renderer from './lib/pixi/Renderer';
+import SpriteContainerRenderer from './lib/pixi/SpriteContainerRenderer';
 import { ICustomPixiParticlesSettings } from './lib/customPixiParticlesSettingsInterface';
 import TestRenderer from './lib/pixi/TestRenderer';
 import { CrystallizeEffect, DissolveEffect, GhostEffect, GlitchEffect, GranularErosionEffect, LiquidMercuryEffect, MagneticAssemblyEffect, MetaballPass, MeltEffect, PixelSortEffect, PrismRefractionEffect, ShatterEffect, SlitScanEffect } from './lib/effects';
@@ -9,7 +10,7 @@ export type { IShatterEffectOptions, ShatterMode, IDissolveEffectOptions, Dissol
  * @param {ICustomPixiParticlesSettings} settings The settings for the renderer
  */
 declare const customPixiParticles: {
-    create(settings: ICustomPixiParticlesSettings): any;
+    create(settings: ICustomPixiParticlesSettings): Renderer | SpriteContainerRenderer;
 };
 declare const _customPixiParticlesEditorOnly: {
     create(settings: ICustomPixiParticlesSettings): TestRenderer;
@@ -18,10 +19,10 @@ export type { TextureVariant, TextureVariantFrames, TextureVariantStaticRandom }
 export type { IParticleLinkSettings } from './lib/pixi/particleLinkLayer';
 export { drawParticleLinks, mergeParticleLinkSettings, PARTICLE_LINK_DEFAULTS, } from './lib/pixi/particleLinkLayer';
 export type { IBehaviour } from './lib/behaviour';
-export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, FormPatternBehaviour, type FormPatternMode, type FormPatternProgressMode, type FormPatternAssignmentMode, type FormPatternBakedPolylineMode, type FormPatternPathKind, type FormPatternSinePhaseMode, type FormPatternStaggerOrder, type FormPatternPathVarietySeedMode, type FormPatternVisualModulation, Wireframe3DBehaviour, ToroidalWrapBehaviour, BehaviourNames, } from './lib/behaviour';
+export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, WarpBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, FormPatternBehaviour, type FormPatternMode, type FormPatternProgressMode, type FormPatternAssignmentMode, type FormPatternBakedPolylineMode, type FormPatternPathKind, type FormPatternSinePhaseMode, type FormPatternStaggerOrder, type FormPatternPathVarietySeedMode, type FormPatternVisualModulation, ToroidalWrapBehaviour, BehaviourNames, } from './lib/behaviour';
+export { EmissionRegistry, RandomEmission, StandardEmission, UniformEmission, PersistentFillEmission, BurstScheduleEmission, CurveEmission, EmissionTypes, } from './lib/emission';
 export { rasterizeTextToPoints, buildPresetShape, matchPointsToCount, resampleToCount, flattenSvgPathToPoints, assignGreedyNearest, assignByPolarAngle, assignHungarian, hungarianMinAssignment, assignHungarianTargetIndices, assignGreedyNearestTargetIndices, assignByPolarAngleTargetIndices, sortTargetIndicesByAngle, blendMorphedPresets, rasterizeOpaquePixelsToPoints, rasterizeOpaquePixelsToPointsWithColors, matchSamplesToCount, sortPointsByAngle, shuffledIndices, seededUnit, extractSvgPathDFromMarkup, parseSvgViewBox, normalizePointsToBounds, replicatePointsByWeights, sampleMorphKeyframes, assignPathOrderTargetIndices, rasterizeOpaquePixelsToPointsWeighted, rasterizeOpaquePixelsToPointsWithColorsWeighted, } from './lib/util/formPatternSampling';
 export type { PresetShapeType, PresetShapeParams, TextRasterMode, RasterizeTextOptions, PointRgb, MorphKeyframe, IParticleXYWithUid, } from './lib/util/formPatternSampling';
-export { PersistentFillEmission } from './lib/emission';
 export { PersistentWrapEmitter } from './lib/emitter';
 export { Application, Loader } from 'pixi.js-legacy';
 export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ICustomPixiParticlesSettings, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, PixelSortEffect, PrismRefractionEffect, CrystallizeEffect, SlitScanEffect, GranularErosionEffect, LiquidMercuryEffect, MetaballPass, };

package/dist/index.js

@@ -1,7 +1,8 @@
 import Renderer from './lib/pixi/Renderer';
+import SpriteContainerRenderer from './lib/pixi/SpriteContainerRenderer';
 import TestRenderer from './lib/pixi/TestRenderer';
+import { inferParticleContainerFeatures, preferSpriteParticlePathForTextures } from './lib/inferParticleContainerFeatures';
 import { CrystallizeEffect, DissolveEffect, GhostEffect, GlitchEffect, GranularErosionEffect, LiquidMercuryEffect, MagneticAssemblyEffect, MetaballPass, MeltEffect, PixelSortEffect, PrismRefractionEffect, ShatterEffect, SlitScanEffect, } from './lib/effects';
-import { Container, Graphics } from 'pixi.js-legacy';
 /**
  * Constructs a renderer for custom pixi particles
  * @class Renderer
@@ -9,10 +10,18 @@ import { Container, Graphics } from 'pixi.js-legacy';
  */
 const customPixiParticles = {
     create(settings) {
-        var _a;
-        const { textures, emitterConfig, animatedSpriteZeroPad = 2, animatedSpriteIndexToStart = 0, finishingTextures = [], vertices = true, position = true, rotation = true, uvs = true, tint = true, maxParticles = 10000, maxFPS = 60, minFPS = 30, tickerSpeed = 0.02, particleLinks, canvasSizeProvider, } = settings;
-        const hasWireframe = (_a = emitterConfig === null || emitterConfig === void 0 ? void 0 : emitterConfig.behaviours) === null || _a === void 0 ? void 0 : _a.some((b) => b.name === 'Wireframe3DBehaviour');
-        const renderer = new Renderer({
+        var _a, _b, _c, _d, _e;
+        const { textures, emitterConfig, animatedSpriteZeroPad = 2, animatedSpriteIndexToStart = 0, finishingTextures = [], maxParticles = 10000, maxFPS = 60, minFPS = 30, tickerSpeed = 0.02, particleLinks, canvasSizeProvider, } = settings;
+        const texturesArr = Array.isArray(textures) ? textures : [];
+        const useSpritePath = preferSpriteParticlePathForTextures(texturesArr);
+        const inferred = inferParticleContainerFeatures(emitterConfig);
+        const vertices = (_a = settings.vertices) !== null && _a !== void 0 ? _a : inferred.vertices;
+        const position = (_b = settings.position) !== null && _b !== void 0 ? _b : inferred.position;
+        const rotation = (_c = settings.rotation) !== null && _c !== void 0 ? _c : inferred.rotation;
+        const uvs = (_d = settings.uvs) !== null && _d !== void 0 ? _d : inferred.uvs;
+        const tint = (_e = settings.tint) !== null && _e !== void 0 ? _e : inferred.tint;
+        const RendererCtor = useSpritePath ? SpriteContainerRenderer : Renderer;
+        const renderer = new RendererCtor({
             textures,
             animatedSpriteZeroPad,
             animatedSpriteIndexToStart,
@@ -30,43 +39,31 @@ const customPixiParticles = {
             particleLinks,
             canvasSizeProvider,
         });
-        if (hasWireframe) {
-            const graphics = new Graphics();
-            const container = new Container();
-            container.addChild(graphics);
-            container.addChild(renderer);
-            renderer.wireframeGraphics = graphics;
-            Object.defineProperty(container, 'emitter', { get: () => renderer.emitter });
-            container.updateConfig = (c) => renderer.updateConfig(c);
-            container.updatePosition = (p) => renderer.updatePosition(p);
-            container.play = () => renderer.play();
-            container.stop = () => renderer.stop();
-            container.stopImmediately = () => renderer.stopImmediately();
-            container.pause = (p) => renderer.pause(p);
-            container.resume = () => renderer.resume();
-            container.start = () => renderer.start();
-            container.setTickerSpeed = (s) => renderer.setTickerSpeed(s);
-            container.updateTexture = () => renderer.updateTexture();
-            container.setParticleLinks = (p) => renderer.setParticleLinks(p);
-            const origDestroy = container.destroy.bind(container);
-            container.destroy = () => {
-                renderer.destroy();
-                origDestroy();
-            };
-            return container;
-        }
         return renderer;
     },
 };
 const _customPixiParticlesEditorOnly = {
     create(settings) {
-        const { textures, emitterConfig, animatedSpriteZeroPad = 2, animatedSpriteIndexToStart = 0, finishingTextures = [], maxFPS = 60, minFPS = 60, tickerSpeed = 0.02, particleLinks, canvasSizeProvider, } = settings;
+        var _a, _b, _c, _d, _e;
+        const { textures, emitterConfig, animatedSpriteZeroPad = 2, animatedSpriteIndexToStart = 0, finishingTextures = [], maxParticles = 10000, maxFPS = 60, minFPS = 60, tickerSpeed = 0.02, particleLinks, canvasSizeProvider, } = settings;
+        const inferred = inferParticleContainerFeatures(emitterConfig);
+        const vertices = (_a = settings.vertices) !== null && _a !== void 0 ? _a : inferred.vertices;
+        const position = (_b = settings.position) !== null && _b !== void 0 ? _b : inferred.position;
+        const rotation = (_c = settings.rotation) !== null && _c !== void 0 ? _c : inferred.rotation;
+        const uvs = (_d = settings.uvs) !== null && _d !== void 0 ? _d : inferred.uvs;
+        const tint = (_e = settings.tint) !== null && _e !== void 0 ? _e : inferred.tint;
         return new TestRenderer({
             textures,
             animatedSpriteZeroPad,
             animatedSpriteIndexToStart,
             emitterConfig,
             finishingTextures,
+            vertices,
+            position,
+            rotation,
+            uvs,
+            tint,
+            maxParticles,
             maxFPS,
             minFPS,
             tickerSpeed,
@@ -76,9 +73,9 @@ const _customPixiParticlesEditorOnly = {
     },
 };
 export { drawParticleLinks, mergeParticleLinkSettings, PARTICLE_LINK_DEFAULTS, } from './lib/pixi/particleLinkLayer';
-export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, FormPatternBehaviour, Wireframe3DBehaviour, ToroidalWrapBehaviour, BehaviourNames, } from './lib/behaviour';
+export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, WarpBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, FormPatternBehaviour, ToroidalWrapBehaviour, BehaviourNames, } from './lib/behaviour';
+export { EmissionRegistry, RandomEmission, StandardEmission, UniformEmission, PersistentFillEmission, BurstScheduleEmission, CurveEmission, EmissionTypes, } from './lib/emission';
 export { rasterizeTextToPoints, buildPresetShape, matchPointsToCount, resampleToCount, flattenSvgPathToPoints, assignGreedyNearest, assignByPolarAngle, assignHungarian, hungarianMinAssignment, assignHungarianTargetIndices, assignGreedyNearestTargetIndices, assignByPolarAngleTargetIndices, sortTargetIndicesByAngle, blendMorphedPresets, rasterizeOpaquePixelsToPoints, rasterizeOpaquePixelsToPointsWithColors, matchSamplesToCount, sortPointsByAngle, shuffledIndices, seededUnit, extractSvgPathDFromMarkup, parseSvgViewBox, normalizePointsToBounds, replicatePointsByWeights, sampleMorphKeyframes, assignPathOrderTargetIndices, rasterizeOpaquePixelsToPointsWeighted, rasterizeOpaquePixelsToPointsWithColorsWeighted, } from './lib/util/formPatternSampling';
-export { PersistentFillEmission } from './lib/emission';
 export { PersistentWrapEmitter } from './lib/emitter';
 // Re-export so demos can use one import (avoids loading Pixi twice)
 export { Application, Loader } from 'pixi.js-legacy';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AA0BpD;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,MAAM,CAAC,QAAsC;;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,GAAG,GAAG,IAAI,EACV,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,EAClB,aAAa,EACb,kBAAkB,GACnB,GAAG,QAAQ,CAAA;QACZ,MAAM,YAAY,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,UAAU,0CAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAA;QACnG,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,MAAM;YACN,MAAM;YACN,WAAW;YACX,aAAa;YACb,kBAAkB;SACnB,CAAC,CAAA;QACF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA;YAC/B,MAAM,SAAS,GAAG,IAAI,SAAS,EAAS,CAAA;YACxC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAC5B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAC5B,QAAQ,CAAC,iBAAiB,GAAG,QAAQ,CAAA;YACrC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5E,SAAS,CAAC,YAAY,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;YAC7D,SAAS,CAAC,cAAc,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;YACjE,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YACtC,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YACtC,SAAS,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAA;YAC5D,SAAS,CAAC,KAAK,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACpD,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;YAC1C,SAAS,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YACxC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;YACpE,SAAS,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;YACxD,SAAS,CAAC,gBAAgB,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAA;YACrE,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACrD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBACvB,QAAQ,CAAC,OAAO,EAAE,CAAA;gBAClB,WAAW,EAAE,CAAA;YACf,CAAC,CAAA;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF,CAAA;AAED,MAAM,8BAA8B,GAAG;IACrC,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,EAClB,aAAa,EACb,kBAAkB,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,YAAY,CAAC;YACtB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,MAAM;YACN,MAAM;YACN,WAAW;YACX,aAAa;YACb,kBAAkB;SACnB,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAID,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EAUpB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,wBAAwB,EACxB,mBAAmB,EACnB,6BAA6B,EAC7B,uCAAuC,EACvC,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,qCAAqC,EACrC,+CAA+C,GAChD,MAAM,gCAAgC,CAAA;AAWvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,8BAA8B,EAE9B,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/Model.d.ts

@@ -1,4 +1,43 @@
 export default class Model {
+    reactiveSignals: {
+        beat: number;
+        energy: number;
+        loudness: number;
+        onset: number;
+        flux: number;
+        lowBand: number;
+        midBand: number;
+        highBand: number;
+        pulsePhase: number;
+        beatPhase: number;
+        phase1x: number;
+        phase2x: number;
+        phase4x: number;
+        source: 'none' | 'soundReactive' | 'pulse' | 'beatPhaseLock' | 'mixed';
+        /** Optional debug info emitted by behaviours for UI/inspector overlays. */
+        debug?: any;
+        raw: {
+            soundReactive: {
+                energy: number;
+                lowBand: number;
+                midBand: number;
+                highBand: number;
+                beat: number;
+            };
+            pulse: {
+                energy: number;
+                pulsePhase: number;
+            };
+            beatPhaseLock: {
+                beat: number;
+                beatPhase: number;
+            };
+        };
+    };
+    /**
+     * Runtime emitter reference used by advanced behaviours that spawn child particles.
+     */
+    emitter: any;
     /**
      * Refreshed each frame by Renderer/TestRenderer when ToroidalWrapBehaviour uses canvas bounds.
      * Particle space origin at emitter center; half-width = width/2 (matches Pixi render buffer).
@@ -10,36 +49,15 @@ export default class Model {
         maxY: number;
     } | null;
     /**
-     * Boolean value indicating whether warping is enabled
+     * Last pointer position in particle space (same coordinates as SpawnBehaviour custom points).
+     * Updated by Renderer.updatePosition when the host passes cursor/follow-mouse updates.
      */
-    warp: boolean;
-    /**
-     * The Z position of the camera
-     */
-    cameraZ: number;
-    /**
-     * The conversion rate for cameraZ
-     */
-    cameraZConverter: number;
-    /**
-     * The speed of warp
-     */
-    warpSpeed: number;
-    /**
-     * The base speed of warp
-     */
-    warpBaseSpeed: number;
-    /**
-     * Update the model with the behaviour object
-     * @param {Object} behaviour - The behaviour object
-     */
-    update(behaviour: any): void;
-    /**
-     * Update the camera position based on the delta time
-     * @param {number} deltaTime - The delta time
-     */
-    updateCamera(deltaTime: number): void;
+    pointerWorld: {
+        x: number;
+        y: number;
+    } | null;
     /** Sets {@link toroidalCanvasBounds} from render buffer size (centered rect). */
     setToroidalCanvasBoundsFromSize(width: number, height: number): void;
     clearToroidalCanvasBounds(): void;
+    resetReactiveSignals(): void;
 }