v2.x से माइग्रेट करें

v2.x से वर्तमान संस्करण में जाने पर आम तौर पर दो मुख्य breaking areas होते हैं:

Load API माइग्रेशन (महत्वपूर्ण)

आधुनिक संस्करणों में load एक ही params object स्वीकार करता है।

पहले (v2.x positional शैली):

await tsParticles.load("tsparticles", {
  particles: {
    number: {
      value: 80,
    },
  },
});

बाद में (एकल object):

await tsParticles.load({
  id: "tsparticles",
  options: {
    particles: {
      number: {
        value: 80,
      },
    },
  },
});

आप उसी object में element, url और index भी पास कर सकते हैं।

await tsParticles.load({
  element: document.getElementById("tsparticles") as HTMLElement,
  url: "/particles.json",
  index: 0,
});

पहले:

particles: {
  color: { value: "#00ffcc" },
  stroke: { width: 1, color: "#003344" }
}

बाद में:

particles: {
  paint: {
    fill: { color: { value: "#00ffcc" } },
    stroke: { width: 1, color: "#003344" }
  }
}

सभी @tsparticles/* packages एक साथ अपडेट करें।
जाँचें कि wrappers (React/Vue/Angular आदि) की versions उसी major line पर हैं।
सभी पुराने tsParticles.load(id, options) कॉल को object params में बदलें।
ज्ञात keys (color, stroke) को paint.fill/paint.stroke में माइग्रेट करें।
सबसे जटिल configurations पर visual regression चलाएँ।

सुनिश्चित करें कि lockfile में मिश्रित major versions नहीं हैं।
जाँचें कि चुना गया bundle (basic, slim, all) अभी भी सक्षम features से मेल खाता है।
canvas lifecycle hooks (loaded, particlesLoaded, cleanup paths) फिर से टेस्ट करें।