[pull] main from tsparticles:main

.github/workflows/nodejs.yml

@@ -104,6 +104,7 @@ jobs:
 
       - name: Deploy to Firebase (PR preview)
         if: env.firebaseToken != '' && github.event_name == 'pull_request' && github.actor == 'matteobruni'
+        continue-on-error: true
         uses: FirebaseExtended/action-hosting-deploy@v0
         with:
           repoToken: "${{ secrets.GITHUB_TOKEN }}"

.planning/ROADMAP.md

@@ -1,28 +1,23 @@
-# ROADMAP: tsParticles (replaced)
+# ROADMAP: tsParticles
 
 ## Overview
 
-Single focused phase per owner's request.
-
-| #   | Phase                                      | Goal                                                                                                                            |
-| --- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | External Interaction: Drag & Drop Particle | Implement an external interaction allowing users to drag-and-drop particles one at a time into a canvas and interact with them. |
+| # | Phase | Version | Goal |
+|---|-------|---------|------|
+| 1 | GIF Shape, Background Canvas, BgMask Dynamic, Draw Layer System, Particle Modifier, HDR Precision | 4.3.0 | ✅ Released |
+| 2 | Fluid Particle Interaction (DDR-based liquid simulation) | 4.4.0 | In progress — see `.planning/handovers/4.4.0_PLAN.md` |
 
 ## Phase Details
 
-### Phase 1: External Interaction: Drag & Drop Particle
-
-Goal: Provide an external interaction that lets a user drag and drop single particles into the canvas, interact with them (select, move, drop), and expose a minimal API for external consumers to trigger and listen to these interactions.
-
-Requirements: (derived from owner request)
+### Phase 2: Fluid Particle Interaction (4.4.0)
 
-- UI-01: Users can drag a particle from an external palette and drop it onto the canvas. Only one particle is dragged per interaction.
-- UI-02: Dropped particle becomes interactive (can be selected and moved) until deselected.
-- API-01: Emit events on drag-start, drag-end, drop, select, and move with particle identifiers and positions.
-- QA-01: Add automated usability tests that simulate drag-and-drop and assert events fired.
+**Target:** `@tsparticles/interaction-particles-fluid`
 
-Success criteria:
+New particles interactor implementing position-only DDR (Density Displacement Resolution)
+for real-time liquid simulation. Single-pass Gauss-Seidel solver with symmetric displacement.
 
-1. Functional demo shows drag-and-drop of one particle at a time into `demo/vanilla`.
-2. Events are emitted and documented in a short API doc snippet.
-3. Acceptance tests simulate a drag-and-drop and pass in CI.
+**Constraints:**
+- Zero modifications to `@tsparticles/engine`
+- Follows `collisions` package pattern
+- No per-particle state storage
+- Relies on MovePlugin for baseline advection

.planning/STATE.md

@@ -4,12 +4,26 @@ See: .planning/PROJECT.md (initialized)
 
 **Core value:** Provide a small, high-performance, and extensible particle engine that developers can integrate into web projects with minimal configuration.
 
-**Current focus:** Phase 1 — Developer Experience & Docs
+**Current focus:** Phase 2 — 4.4.0 Fluid Interaction
 
-## Session Status — 2026-06-14
+## Session Status — 2026-06-27
 
-### Objective
-Plan and implement wrapper reactivity (options/url/theme prop changes) across Vue 3, Vue 2, Angular, Solid, Qwik, and Astro wrappers, plus fix Vue 3 docs describing nonexistent `:init`/`@particles-init` features.
+### 4.3.0 — Released ✅
+
+All 6 features implemented and gate checks passed:
+- A: GIF Shape — new `@tsparticles/shape-gif` package
+- B: Background Canvas — layered background pipeline
+- C: Background Mask Dynamic — `cover.element` + `cover.draw`
+- D: Draw Layer System — 8 named layers replacing 11 arrays
+- E: Particle Modifier System — generic `IParticleModifier` API
+- F: HDR Precision — floating-point RGB pipeline
+
+Build: 461 projects ✅ | Tests: 152/152 ✅ | Issue aperti: nessun blocco.
+
+### 4.4.0 — Fluid Interaction (next)
+
+**Target:** `@tsparticles/interaction-particles-fluid` — DDR-based liquid simulation.
+See `.planning/handovers/4.4.0_PLAN.md`.
 
 ### Outcome
 **S1 (Vue 3 wrapper) completed**: wrapper reactivity implemented (`id`/`options`/`url` → destroy+reload, `theme` → safe `loadTheme`), demo aligned with reactive config switching, README fully documented. Plan remaining steps on `.planning/handovers/WRAPPER_REACTIVITY_PLAN.md`.