@tsparticles/preset-fountain 4.3.1 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
  (function(g){g.__tsParticlesInternals=g.__tsParticlesInternals||{};g.__tsParticlesInternals.bundles=g.__tsParticlesInternals.bundles||{};g.__tsParticlesInternals.effects=g.__tsParticlesInternals.effects||{};g.__tsParticlesInternals.engine=g.__tsParticlesInternals.engine||{};g.__tsParticlesInternals.interactions=g.__tsParticlesInternals.interactions||{};g.__tsParticlesInternals.palettes=g.__tsParticlesInternals.palettes||{};g.__tsParticlesInternals.paths=g.__tsParticlesInternals.paths||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins=g.__tsParticlesInternals.plugins||{};g.__tsParticlesInternals.plugins.emittersShapes=g.__tsParticlesInternals.plugins.emittersShapes||{};g.__tsParticlesInternals.presets=g.__tsParticlesInternals.presets||{};g.__tsParticlesInternals.shapes=g.__tsParticlesInternals.shapes||{};g.__tsParticlesInternals.updaters=g.__tsParticlesInternals.updaters||{};g.__tsParticlesInternals.utils=g.__tsParticlesInternals.utils||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas=g.__tsParticlesInternals.canvas||{};g.__tsParticlesInternals.canvas.utils=g.__tsParticlesInternals.canvas.utils||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path=g.__tsParticlesInternals.path||{};g.__tsParticlesInternals.path.utils=g.__tsParticlesInternals.path.utils||{};var __tsProxyFactory=typeof Proxy!=="undefined"?function(obj){return new Proxy(obj,{get:function(target,key){if(!(key in target)){target[key]={};}return target[key];}});}:function(obj){return obj;};g.__tsParticlesInternals.bundles=__tsProxyFactory(g.__tsParticlesInternals.bundles);g.__tsParticlesInternals.effects=__tsProxyFactory(g.__tsParticlesInternals.effects);g.__tsParticlesInternals.interactions=__tsProxyFactory(g.__tsParticlesInternals.interactions);g.__tsParticlesInternals.palettes=__tsProxyFactory(g.__tsParticlesInternals.palettes);g.__tsParticlesInternals.paths=__tsProxyFactory(g.__tsParticlesInternals.paths);g.__tsParticlesInternals.plugins=__tsProxyFactory(g.__tsParticlesInternals.plugins);g.__tsParticlesInternals.plugins.emittersShapes=__tsProxyFactory(g.__tsParticlesInternals.plugins.emittersShapes);g.__tsParticlesInternals.presets=__tsProxyFactory(g.__tsParticlesInternals.presets);g.__tsParticlesInternals.shapes=__tsProxyFactory(g.__tsParticlesInternals.shapes);g.__tsParticlesInternals.updaters=__tsProxyFactory(g.__tsParticlesInternals.updaters);g.__tsParticlesInternals.utils=__tsProxyFactory(g.__tsParticlesInternals.utils);g.__tsParticlesInternals.canvas=__tsProxyFactory(g.__tsParticlesInternals.canvas);g.__tsParticlesInternals.path=__tsProxyFactory(g.__tsParticlesInternals.path);g.tsparticlesInternalExports=g.tsparticlesInternalExports||{};})(typeof globalThis!=="undefined"?globalThis:typeof window!=="undefined"?window:this);
2
- /* Preset v4.3.1 */
2
+ /* Preset v4.4.0 */
3
3
  (function (global, factory) {
4
4
  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
5
5
  typeof define === 'function' && define.amd ? define(['exports'], factory) :
@@ -305,6 +305,9 @@
305
305
  })(PixelMode || (PixelMode = {}));
306
306
 
307
307
  const minRadius = 0;
308
+ function isForbiddenKey(key) {
309
+ return key === "__proto__" || key === "constructor" || key === "prototype";
310
+ }
308
311
  function hasMatchMedia() {
309
312
  return typeof matchMedia !== "undefined";
310
313
  }
@@ -380,7 +383,7 @@
380
383
  if (!hasNested) {
381
384
  const sourceDict = source, destDict = destination;
382
385
  for (const key of sourceKeys) {
383
- if (key === "__proto__" || key === "constructor" || key === "prototype") {
386
+ if (isForbiddenKey(key)) {
384
387
  continue;
385
388
  }
386
389
  const v = sourceDict[key];
@@ -391,7 +394,7 @@
391
394
  continue;
392
395
  }
393
396
  for (const key of sourceKeys) {
394
- if (key === "__proto__" || key === "constructor" || key === "prototype") {
397
+ if (isForbiddenKey(key)) {
395
398
  continue;
396
399
  }
397
400
  const sourceDict = source, destDict = destination, value = sourceDict[key];
@@ -807,7 +810,7 @@
807
810
  return this.#domArray;
808
811
  }
809
812
  get version() {
810
- return "4.3.1";
813
+ return "4.4.0";
811
814
  }
812
815
  addEventListener(type, listener) {
813
816
  this.#eventDispatcher.addEventListener(type, listener);
@@ -888,6 +891,10 @@
888
891
  }
889
892
 
890
893
  function initEngine() {
894
+ const existing = globalThis.tsParticles;
895
+ if (existing?.pluginManager) {
896
+ return existing;
897
+ }
891
898
  return new Engine();
892
899
  }
893
900
 
@@ -985,6 +992,15 @@
985
992
  AnimationMode["random"] = "random";
986
993
  })(AnimationMode || (AnimationMode = {}));
987
994
 
995
+ var HdrMode;
996
+ (function (HdrMode) {
997
+ HdrMode["standard"] = "standard";
998
+ HdrMode["natural"] = "natural";
999
+ HdrMode["vivid"] = "vivid";
1000
+ HdrMode["cinematic"] = "cinematic";
1001
+ HdrMode["dynamic"] = "dynamic";
1002
+ })(HdrMode || (HdrMode = {}));
1003
+
988
1004
  var LimitMode;
989
1005
  (function (LimitMode) {
990
1006
  LimitMode["delete"] = "delete";
@@ -1240,6 +1256,29 @@
1240
1256
  }
1241
1257
  }
1242
1258
 
1259
+ const defaultPeakNits = 400, minPeakNits = 0, toStringValue = (value) => String(value);
1260
+ class HDROptions extends OptionLoader {
1261
+ enable = true;
1262
+ mode = HdrMode.standard;
1263
+ peakNits = defaultPeakNits;
1264
+ doLoad(data) {
1265
+ if (data.enable !== undefined && !isBoolean(data.enable)) {
1266
+ throw new Error(`Invalid HDR "enable" value: expected a boolean, got "${String(data.enable)}"`);
1267
+ }
1268
+ if (data.mode !== undefined &&
1269
+ (typeof data.mode !== "string" || !Object.values(HdrMode).includes(data.mode))) {
1270
+ throw new Error(`Invalid HDR "mode" value: expected one of ${Object.values(HdrMode).join(", ")}, got "${toStringValue(data.mode)}"`);
1271
+ }
1272
+ if (data.peakNits !== undefined &&
1273
+ (!isNumber(data.peakNits) || !Number.isFinite(data.peakNits) || data.peakNits <= minPeakNits)) {
1274
+ throw new Error(`Invalid HDR "peakNits" value: expected a positive number, got "${String(data.peakNits)}"`);
1275
+ }
1276
+ loadProperty(this, "enable", data.enable);
1277
+ loadProperty(this, "mode", data.mode);
1278
+ loadProperty(this, "peakNits", data.peakNits);
1279
+ }
1280
+ }
1281
+
1243
1282
  class ResizeEvent extends OptionLoader {
1244
1283
  delay = 0.5;
1245
1284
  enable = true;
@@ -1683,7 +1722,7 @@
1683
1722
  duration = 0;
1684
1723
  fpsLimit = 120;
1685
1724
  fullScreen;
1686
- hdr = true;
1725
+ hdr;
1687
1726
  key;
1688
1727
  name;
1689
1728
  palette;
@@ -1703,6 +1742,7 @@
1703
1742
  this.#container = container;
1704
1743
  this.background = new Background();
1705
1744
  this.fullScreen = new FullScreen();
1745
+ this.hdr = new HDROptions();
1706
1746
  this.particles = loadParticlesOptions(this.#pluginManager, this.#container);
1707
1747
  this.resize = new ResizeEvent();
1708
1748
  }
@@ -1725,7 +1765,15 @@
1725
1765
  loadProperty(this, "detectRetina", data.detectRetina);
1726
1766
  loadRangeProperty(this, "duration", data.duration);
1727
1767
  loadProperty(this, "fpsLimit", data.fpsLimit);
1728
- loadProperty(this, "hdr", data.hdr);
1768
+ const hdrData = data.hdr;
1769
+ if (isBoolean(hdrData)) {
1770
+ this.hdr.enable = hdrData;
1771
+ this.hdr.mode = HdrMode.standard;
1772
+ this.hdr.peakNits = 400;
1773
+ }
1774
+ else {
1775
+ this.hdr.load(hdrData);
1776
+ }
1729
1777
  loadProperty(this, "pauseOnBlur", data.pauseOnBlur);
1730
1778
  loadProperty(this, "pauseOnOutsideViewport", data.pauseOnOutsideViewport);
1731
1779
  loadProperty(this, "zLayers", data.zLayers);
@@ -1768,7 +1816,7 @@
1768
1816
  }
1769
1817
  }
1770
1818
 
1771
- const styleCache = new Map(), maxStyleCacheSize = 2000, rgbFixedPrecision = 2, hslFixedPrecision = 2, hdrRgbFixedPrecision = 4, hdrHslFixedPrecision = 4, sdrReferenceWhiteNits = 203, hdrAnimationScale = sdrReferenceWhiteNits / maxNits;
1819
+ const styleCache = new Map(), maxStyleCacheSize = 2000, rgbFixedPrecision = 2, hslFixedPrecision = 2, hdrRgbFixedPrecision = 4, hdrHslFixedPrecision = 4, sdrReferenceWhiteNits = 203, acesA = 2.51, acesB = 0.03, acesC = 2.43, acesD = 0.59, acesE = 0.14, saturationBoost = 1.15, lightnessBoost = 1.05, temperatureR = 1.05, temperatureB = 0.95, contrastFactor = 1.1, luminanceR = 0.2126, luminanceG = 0.7152, luminanceB = 0.0722, dynamicLuminanceFactor = 2, channelCount = 3;
1772
1820
  function getCachedStyle(key, generator) {
1773
1821
  let cached = styleCache.get(key);
1774
1822
  if (!cached) {
@@ -1780,6 +1828,42 @@
1780
1828
  }
1781
1829
  return cached;
1782
1830
  }
1831
+ function acesFilmic(x) {
1832
+ return clamp((x * (acesA * x + acesB)) / (x * (acesC * x + acesD) + acesE), none, one);
1833
+ }
1834
+ function applyHdrModeAdjustments(r, g, b, mode, maxChannel) {
1835
+ switch (mode) {
1836
+ case HdrMode.vivid: {
1837
+ const avg = (r + g + b) / channelCount;
1838
+ return {
1839
+ b: clamp(clamp(avg + (b - avg) * saturationBoost, none, maxChannel) * lightnessBoost, none, maxChannel),
1840
+ g: clamp(clamp(avg + (g - avg) * saturationBoost, none, maxChannel) * lightnessBoost, none, maxChannel),
1841
+ r: clamp(clamp(avg + (r - avg) * saturationBoost, none, maxChannel) * lightnessBoost, none, maxChannel),
1842
+ };
1843
+ }
1844
+ case HdrMode.cinematic: {
1845
+ const tempR = r * temperatureR, tempB = b * temperatureB, avg = (tempR + g + tempB) / channelCount;
1846
+ return {
1847
+ b: clamp(avg + (tempB - avg) * contrastFactor, none, maxChannel),
1848
+ g: clamp(avg + (g - avg) * contrastFactor, none, maxChannel),
1849
+ r: clamp(avg + (tempR - avg) * contrastFactor, none, maxChannel),
1850
+ };
1851
+ }
1852
+ case HdrMode.dynamic: {
1853
+ const luminance = luminanceR * r + luminanceG * g + luminanceB * b, vividWeight = Math.min(one, luminance * dynamicLuminanceFactor), naturalWeight = one - vividWeight, avg = (r + g + b) / channelCount, vividR = clamp(avg + (r - avg) * saturationBoost, none, maxChannel) * lightnessBoost, vividG = clamp(avg + (g - avg) * saturationBoost, none, maxChannel) * lightnessBoost, vividB = clamp(avg + (b - avg) * saturationBoost, none, maxChannel) * lightnessBoost;
1854
+ return {
1855
+ b: clamp(b * naturalWeight + vividB * vividWeight, none, maxChannel),
1856
+ g: clamp(g * naturalWeight + vividG * vividWeight, none, maxChannel),
1857
+ r: clamp(r * naturalWeight + vividR * vividWeight, none, maxChannel),
1858
+ };
1859
+ }
1860
+ case HdrMode.standard:
1861
+ return { b, g, r };
1862
+ case HdrMode.natural:
1863
+ default:
1864
+ return { b, g, r };
1865
+ }
1866
+ }
1783
1867
  function stringToRgba(pluginManager, input) {
1784
1868
  if (!input) {
1785
1869
  return;
@@ -1937,21 +2021,40 @@
1937
2021
  r: getRgbInRangeValue(),
1938
2022
  };
1939
2023
  }
1940
- function getStyleFromRgb(color, hdr, opacity) {
1941
- const rgbPrecision = hdr ? hdrRgbFixedPrecision : rgbFixedPrecision, op = opacity ?? defaultOpacity$1, key = `rgb-${color.r.toFixed(rgbPrecision)}-${color.g.toFixed(rgbPrecision)}-${color.b.toFixed(rgbPrecision)}-${hdr ? "hdr" : "sdr"}-${op.toString()}`;
1942
- return getCachedStyle(key, () => (hdr ? getHdrStyleFromRgb(color, opacity) : getSdrStyleFromRgb(color, opacity)));
2024
+ function getStyleFromRgb(color, hdr, opacity, peakNits, mode) {
2025
+ const rgbPrecision = hdr ? hdrRgbFixedPrecision : rgbFixedPrecision, op = opacity ?? defaultOpacity$1, key = hdr
2026
+ ? `rgb-${color.r.toFixed(rgbPrecision)}-${color.g.toFixed(rgbPrecision)}-${color.b.toFixed(rgbPrecision)}-hdr-${op.toString()}-${(peakNits ?? maxNits).toString()}-${mode ?? HdrMode.standard}`
2027
+ : `rgb-${color.r.toFixed(rgbPrecision)}-${color.g.toFixed(rgbPrecision)}-${color.b.toFixed(rgbPrecision)}-sdr-${op.toString()}`;
2028
+ return getCachedStyle(key, () => hdr ? getHdrStyleFromRgb(color, opacity, peakNits, mode) : getSdrStyleFromRgb(color, opacity));
1943
2029
  }
1944
- function getHdrStyleFromRgb(color, opacity, peakNits = maxNits) {
1945
- const headroom = peakNits / sdrReferenceWhiteNits;
1946
- return `color(display-p3 ${((color.r / rgbMax) * headroom).toString()} ${((color.g / rgbMax) * headroom).toString()} ${((color.b / rgbMax) * headroom).toString()} / ${(opacity ?? defaultOpacity$1).toString()})`;
2030
+ function getHdrStyleFromRgb(color, opacity, peakNits = maxNits, mode = HdrMode.standard) {
2031
+ const headroom = peakNits / sdrReferenceWhiteNits, middleGray = 0.18, mapped = hdrToneMapColor(color, headroom, middleGray, mode);
2032
+ return `color(display-p3 ${mapped.r.toString()} ${mapped.g.toString()} ${mapped.b.toString()} / ${(opacity ?? defaultOpacity$1).toString()})`;
2033
+ }
2034
+ function hdrToneMapColor(color, headroom, middleGray, mode) {
2035
+ const rNorm = color.r / rgbMax, gNorm = color.g / rgbMax, bNorm = color.b / rgbMax;
2036
+ if (mode !== HdrMode.natural && mode !== HdrMode.vivid && mode !== HdrMode.cinematic && mode !== HdrMode.dynamic) {
2037
+ return { b: bNorm, g: gNorm, r: rNorm };
2038
+ }
2039
+ const maxChannel = Math.max(one, headroom), luminance = luminanceR * rNorm + luminanceG * gNorm + luminanceB * bNorm, mappedLuminance = hdrToneMap(luminance, headroom, middleGray), scale = luminance > none ? mappedLuminance / luminance : one;
2040
+ return applyHdrModeAdjustments(clamp(rNorm * scale, none, maxChannel), clamp(gNorm * scale, none, maxChannel), clamp(bNorm * scale, none, maxChannel), mode, maxChannel);
2041
+ }
2042
+ function hdrToneMap(normalized, headroom, middleGray) {
2043
+ if (normalized <= middleGray) {
2044
+ return acesFilmic(normalized);
2045
+ }
2046
+ const expanded = normalized + (normalized - middleGray) * (headroom - one);
2047
+ return acesFilmic(expanded);
1947
2048
  }
1948
2049
  function getSdrStyleFromRgb(color, opacity) {
1949
2050
  return `rgba(${color.r.toString()}, ${color.g.toString()}, ${color.b.toString()}, ${(opacity ?? defaultOpacity$1).toString()})`;
1950
2051
  }
1951
- function getStyleFromHsl(color, hdr, opacity) {
1952
- const hslPrecision = hdr ? hdrHslFixedPrecision : hslFixedPrecision, op = opacity ?? defaultOpacity$1, key = `hsl-${color.h.toFixed(hslPrecision)}-${color.s.toFixed(hslPrecision)}-${color.l.toFixed(hslPrecision)}-${hdr ? "hdr" : "sdr"}-${op.toString()}`;
2052
+ function getStyleFromHsl(color, hdr, opacity, peakNits, mode) {
2053
+ const hslPrecision = hdr ? hdrHslFixedPrecision : hslFixedPrecision, op = opacity ?? defaultOpacity$1, key = hdr
2054
+ ? `hsl-${color.h.toFixed(hslPrecision)}-${color.s.toFixed(hslPrecision)}-${color.l.toFixed(hslPrecision)}-hdr-${op.toString()}-${(peakNits ?? maxNits).toString()}-${mode ?? HdrMode.standard}`
2055
+ : `hsl-${color.h.toFixed(hslPrecision)}-${color.s.toFixed(hslPrecision)}-${color.l.toFixed(hslPrecision)}-sdr-${op.toString()}`;
1953
2056
  return getCachedStyle(key, () => hdr
1954
- ? getStyleFromRgb(hslToRgbFloat(color), true, opacity)
2057
+ ? getStyleFromRgb(hslToRgbFloat(color), true, opacity, peakNits, mode)
1955
2058
  : `hsla(${color.h.toString()}, ${color.s.toString()}%, ${color.l.toString()}%, ${op.toString()})`);
1956
2059
  }
1957
2060
  function getHslFromAnimation(animation) {
@@ -2014,7 +2117,7 @@
2014
2117
  colorValue.velocity = defaultVelocity;
2015
2118
  }
2016
2119
  }
2017
- function updateColorValue(data, decrease, delta, hdr) {
2120
+ function updateColorValue(data, decrease, delta, _hdr) {
2018
2121
  const minLoops = 0, minDelay = 0, identity = 1, minVelocity = 0, minOffset = 0, velocityFactor = 3.6;
2019
2122
  if (!data.enable ||
2020
2123
  ((data.maxLoops ?? minLoops) > minLoops && (data.loops ?? minLoops) > (data.maxLoops ?? minLoops))) {
@@ -2027,7 +2130,7 @@
2027
2130
  if ((data.delayTime ?? minDelay) > minDelay && data.time < (data.delayTime ?? minDelay)) {
2028
2131
  return;
2029
2132
  }
2030
- const offset = data.offset ? randomInRangeValue(data.offset) : minOffset, velocity = ((data.velocity ?? minVelocity) * delta.factor + offset * velocityFactor) * (hdr ? hdrAnimationScale : identity), decay = data.decay ?? identity, max = data.max, min = data.min;
2133
+ const offset = data.offset ? randomInRangeValue(data.offset) : minOffset, velocity = (data.velocity ?? minVelocity) * delta.factor + offset * velocityFactor, decay = data.decay ?? identity, max = data.max, min = data.min;
2031
2134
  if (!decrease || data.status === AnimationStatus.increasing) {
2032
2135
  data.value += velocity;
2033
2136
  if (data.value > max) {
@@ -2059,9 +2162,9 @@
2059
2162
  return;
2060
2163
  }
2061
2164
  const { h, s, l } = color;
2062
- updateColorValue(h, false, delta, hdr);
2063
- updateColorValue(s, true, delta, hdr);
2064
- updateColorValue(l, true, delta, hdr);
2165
+ updateColorValue(h, false, delta);
2166
+ updateColorValue(s, true, delta);
2167
+ updateColorValue(l, true, delta);
2065
2168
  }
2066
2169
  function alterHsl(color, type, value) {
2067
2170
  return {
@@ -2111,7 +2214,7 @@
2111
2214
  }
2112
2215
 
2113
2216
  async function loadBlendPlugin(engine) {
2114
- engine.checkVersion("4.3.1");
2217
+ engine.checkVersion("4.4.0");
2115
2218
  await engine.pluginManager.register(e => {
2116
2219
  e.pluginManager.addPlugin(new BlendPlugin());
2117
2220
  });
@@ -2148,7 +2251,7 @@
2148
2251
  }
2149
2252
 
2150
2253
  async function loadCircleShape(engine) {
2151
- engine.checkVersion("4.3.1");
2254
+ engine.checkVersion("4.4.0");
2152
2255
  await engine.pluginManager.register(e => {
2153
2256
  e.pluginManager.addShape(["circle"], () => {
2154
2257
  return Promise.resolve(new CircleDrawer());
@@ -2196,7 +2299,7 @@
2196
2299
  }
2197
2300
 
2198
2301
  async function loadHexColorPlugin(engine) {
2199
- engine.checkVersion("4.3.1");
2302
+ engine.checkVersion("4.4.0");
2200
2303
  await engine.pluginManager.register(e => {
2201
2304
  e.pluginManager.addColorManager("hex", new HexColorManager());
2202
2305
  });
@@ -2249,7 +2352,7 @@
2249
2352
  }
2250
2353
 
2251
2354
  async function loadHslColorPlugin(engine) {
2252
- engine.checkVersion("4.3.1");
2355
+ engine.checkVersion("4.4.0");
2253
2356
  await engine.pluginManager.register(e => {
2254
2357
  e.pluginManager.addColorManager("hsl", new HslColorManager());
2255
2358
  });
@@ -2273,7 +2376,7 @@
2273
2376
  }
2274
2377
 
2275
2378
  async function loadMovePlugin(engine) {
2276
- engine.checkVersion("4.3.1");
2379
+ engine.checkVersion("4.4.0");
2277
2380
  await engine.pluginManager.register(e => {
2278
2381
  const moveEngine = e, movePluginManager = moveEngine.pluginManager;
2279
2382
  movePluginManager.initializers.pathGenerators ??= new Map();
@@ -2483,7 +2586,7 @@
2483
2586
  }
2484
2587
 
2485
2588
  async function loadOpacityUpdater(engine) {
2486
- engine.checkVersion("4.3.1");
2589
+ engine.checkVersion("4.4.0");
2487
2590
  await engine.pluginManager.register(e => {
2488
2591
  e.pluginManager.addParticleUpdater("opacity", container => {
2489
2592
  return Promise.resolve(new OpacityUpdater(container));
@@ -2828,7 +2931,7 @@
2828
2931
  }
2829
2932
 
2830
2933
  async function loadOutModesUpdater(engine) {
2831
- engine.checkVersion("4.3.1");
2934
+ engine.checkVersion("4.4.0");
2832
2935
  await engine.pluginManager.register(e => {
2833
2936
  e.pluginManager.addParticleUpdater("outModes", container => {
2834
2937
  return Promise.resolve(new OutOfCanvasUpdater(container));
@@ -2899,7 +3002,7 @@
2899
3002
  }
2900
3003
 
2901
3004
  async function loadPaintUpdater(engine) {
2902
- engine.checkVersion("4.3.1");
3005
+ engine.checkVersion("4.4.0");
2903
3006
  await engine.pluginManager.register(e => {
2904
3007
  e.pluginManager.addParticleUpdater("paint", container => {
2905
3008
  return Promise.resolve(new PaintUpdater(e.pluginManager, container));
@@ -2954,7 +3057,7 @@
2954
3057
  }
2955
3058
 
2956
3059
  async function loadRgbColorPlugin(engine) {
2957
- engine.checkVersion("4.3.1");
3060
+ engine.checkVersion("4.4.0");
2958
3061
  await engine.pluginManager.register(e => {
2959
3062
  e.pluginManager.addColorManager("rgb", new RgbColorManager());
2960
3063
  });
@@ -3039,7 +3142,7 @@
3039
3142
  }
3040
3143
 
3041
3144
  async function loadSizeUpdater(engine) {
3042
- engine.checkVersion("4.3.1");
3145
+ engine.checkVersion("4.4.0");
3043
3146
  await engine.pluginManager.register(e => {
3044
3147
  e.pluginManager.addParticleUpdater("size", container => {
3045
3148
  return Promise.resolve(new SizeUpdater(container));
@@ -3048,7 +3151,7 @@
3048
3151
  }
3049
3152
 
3050
3153
  async function loadBasic(engine) {
3051
- engine.checkVersion("4.3.1");
3154
+ engine.checkVersion("4.4.0");
3052
3155
  await engine.pluginManager.register(async (e) => {
3053
3156
  await Promise.all([
3054
3157
  loadBlendPlugin(e),
@@ -3379,7 +3482,7 @@
3379
3482
  }
3380
3483
 
3381
3484
  async function loadDestroyUpdater(engine) {
3382
- engine.checkVersion("4.3.1");
3485
+ engine.checkVersion("4.4.0");
3383
3486
  await engine.pluginManager.register(e => {
3384
3487
  e.pluginManager.addParticleUpdater("destroy", container => {
3385
3488
  return Promise.resolve(new DestroyUpdater(e.pluginManager, container));
@@ -3593,7 +3696,7 @@
3593
3696
  })(EmitterClickMode || (EmitterClickMode = {}));
3594
3697
 
3595
3698
  async function loadEmittersPluginSimple(engine) {
3596
- engine.checkVersion("4.3.1");
3699
+ engine.checkVersion("4.4.0");
3597
3700
  await engine.pluginManager.register(async (e) => {
3598
3701
  const instancesManager = await getEmittersInstancesManager(e);
3599
3702
  await addEmittersShapesManager(e);
@@ -3657,7 +3760,7 @@
3657
3760
  }
3658
3761
 
3659
3762
  async function loadTrailPlugin(engine) {
3660
- engine.checkVersion("4.3.1");
3763
+ engine.checkVersion("4.4.0");
3661
3764
  await engine.pluginManager.register(e => {
3662
3765
  e.pluginManager.addPlugin(new TrailPlugin(e.pluginManager));
3663
3766
  });
@@ -3896,7 +3999,11 @@
3896
3999
  if (!fColor && !sColor) {
3897
4000
  return;
3898
4001
  }
3899
- const container = this.#container, zIndexOptions = particle.options.zIndex, zIndexFactor = zIndexFactorOffset - particle.zIndexFactor, { fillOpacity, opacity, strokeOpacity } = particle.getOpacity(), transform = this.#reusableTransform, colorStyles = this.#reusableColorStyles, fill = fColor ? getStyleFromHsl(fColor, container.hdr, fillOpacity * opacity) : undefined, stroke = sColor ? getStyleFromHsl(sColor, container.hdr, strokeOpacity * opacity) : fill;
4002
+ const container = this.#container, zIndexOptions = particle.options.zIndex, zIndexFactor = zIndexFactorOffset - particle.zIndexFactor, { fillOpacity, opacity, strokeOpacity } = particle.getOpacity(), transform = this.#reusableTransform, colorStyles = this.#reusableColorStyles, fill = fColor
4003
+ ? getStyleFromHsl(fColor, container.hdr, fillOpacity * opacity, container.peakNits, container.hdrMode)
4004
+ : undefined, stroke = sColor
4005
+ ? getStyleFromHsl(sColor, container.hdr, strokeOpacity * opacity, container.peakNits, container.hdrMode)
4006
+ : fill;
3900
4007
  transform.a = transform.b = transform.c = transform.d = undefined;
3901
4008
  colorStyles.fill = fill;
3902
4009
  colorStyles.stroke = stroke;
@@ -4230,7 +4337,9 @@
4230
4337
  if (typeof background.element === "string") {
4231
4338
  if (typeof document !== "undefined") {
4232
4339
  const node = document.querySelector(background.element);
4233
- if (node instanceof HTMLCanvasElement || node instanceof HTMLVideoElement || node instanceof HTMLImageElement) {
4340
+ if ((typeof HTMLCanvasElement !== "undefined" && node instanceof HTMLCanvasElement) ||
4341
+ (typeof HTMLVideoElement !== "undefined" && node instanceof HTMLVideoElement) ||
4342
+ (typeof HTMLImageElement !== "undefined" && node instanceof HTMLImageElement)) {
4234
4343
  this.#backgroundElement = node;
4235
4344
  }
4236
4345
  else if (node) {
@@ -4241,10 +4350,10 @@
4241
4350
  }
4242
4351
  }
4243
4352
  }
4244
- else if (background.element instanceof HTMLCanvasElement ||
4245
- background.element instanceof OffscreenCanvas ||
4246
- background.element instanceof HTMLVideoElement ||
4247
- background.element instanceof HTMLImageElement) {
4353
+ else if ((typeof HTMLCanvasElement !== "undefined" && background.element instanceof HTMLCanvasElement) ||
4354
+ (typeof OffscreenCanvas !== "undefined" && background.element instanceof OffscreenCanvas) ||
4355
+ (typeof HTMLVideoElement !== "undefined" && background.element instanceof HTMLVideoElement) ||
4356
+ (typeof HTMLImageElement !== "undefined" && background.element instanceof HTMLImageElement)) {
4248
4357
  this.#backgroundElement = background.element;
4249
4358
  }
4250
4359
  }
@@ -4312,6 +4421,7 @@
4312
4421
  zoom = defaultZoom;
4313
4422
  #container;
4314
4423
  #generated;
4424
+ #hdrMediaListeners;
4315
4425
  #mutationObserver;
4316
4426
  #originalStyle;
4317
4427
  #pluginManager;
@@ -4376,7 +4486,6 @@
4376
4486
  });
4377
4487
  this.resize();
4378
4488
  this.#initStyle();
4379
- this.initBackground();
4380
4489
  this.#safeMutationObserver(obs => {
4381
4490
  const element = this.domElement;
4382
4491
  if (!element || !(element instanceof Node)) {
@@ -4386,6 +4495,8 @@
4386
4495
  });
4387
4496
  this.initPlugins();
4388
4497
  this.#initContext();
4498
+ this.initBackground();
4499
+ this.#initHdrListeners();
4389
4500
  this.render.init();
4390
4501
  }
4391
4502
  initBackground() {
@@ -4395,7 +4506,8 @@
4395
4506
  }
4396
4507
  const elementStyle = element.style, color = rangeColorToRgb(this.#pluginManager, background.color);
4397
4508
  if (color) {
4398
- elementStyle.backgroundColor = getStyleFromRgb(color, container.actualOptions.hdr, background.opacity);
4509
+ const hdrOptions = container.actualOptions.hdr;
4510
+ elementStyle.backgroundColor = getStyleFromRgb(color, container.hdr, background.opacity, hdrOptions.peakNits, hdrOptions.mode);
4399
4511
  }
4400
4512
  else {
4401
4513
  elementStyle.backgroundColor = "";
@@ -4492,6 +4604,7 @@
4492
4604
  obs.disconnect();
4493
4605
  });
4494
4606
  this.#mutationObserver = undefined;
4607
+ this.#removeHdrListeners();
4495
4608
  this.render.stop();
4496
4609
  }
4497
4610
  async windowResize() {
@@ -4511,9 +4624,16 @@
4511
4624
  }
4512
4625
  }
4513
4626
  #initContext() {
4514
- const container = this.#container, canSupportHdr = container.actualOptions.hdr &&
4627
+ const container = this.#container, canSupportHdr = container.actualOptions.hdr.enable &&
4515
4628
  safeMatchMedia("(color-gamut: p3)")?.matches &&
4516
4629
  safeMatchMedia("(dynamic-range: high)")?.matches;
4630
+ container.hdr = canSupportHdr ?? false;
4631
+ container.hdrMode = container.actualOptions.hdr.mode;
4632
+ container.peakNits = container.actualOptions.hdr.peakNits;
4633
+ const renderCanvas = this.renderCanvas;
4634
+ if (!renderCanvas) {
4635
+ return;
4636
+ }
4517
4637
  this.render.setContextSettings({
4518
4638
  alpha: true,
4519
4639
  desynchronized: true,
@@ -4522,11 +4642,47 @@
4522
4642
  ? { colorSpace: "display-p3", colorType: "float16" }
4523
4643
  : { colorSpace: "srgb" }),
4524
4644
  });
4525
- const renderCanvas = this.renderCanvas;
4526
- if (!renderCanvas) {
4527
- return;
4645
+ let context;
4646
+ try {
4647
+ context = renderCanvas.getContext("2d", this.render.settings);
4648
+ }
4649
+ catch {
4650
+ context = null;
4651
+ }
4652
+ if (canSupportHdr && !context) {
4653
+ container.hdr = false;
4654
+ const sdrSettings = {
4655
+ alpha: true,
4656
+ desynchronized: true,
4657
+ willReadFrequently: false,
4658
+ colorSpace: "srgb",
4659
+ };
4660
+ this.render.setContextSettings(sdrSettings);
4661
+ try {
4662
+ context = renderCanvas.getContext("2d", sdrSettings);
4663
+ }
4664
+ catch {
4665
+ context = null;
4666
+ }
4667
+ }
4668
+ this.render.setContext(context);
4669
+ }
4670
+ #initHdrListeners() {
4671
+ this.#removeHdrListeners();
4672
+ const p3Query = safeMatchMedia("(color-gamut: p3)"), hdrQuery = safeMatchMedia("(dynamic-range: high)"), handleChange = () => {
4673
+ this.#recreateRenderCanvas();
4674
+ this.#initContext();
4675
+ this.initBackground();
4676
+ }, listeners = [];
4677
+ if (p3Query) {
4678
+ p3Query.addEventListener("change", handleChange);
4679
+ listeners.push({ handler: handleChange, mql: p3Query });
4680
+ }
4681
+ if (hdrQuery) {
4682
+ hdrQuery.addEventListener("change", handleChange);
4683
+ listeners.push({ handler: handleChange, mql: hdrQuery });
4528
4684
  }
4529
- this.render.setContext(renderCanvas.getContext("2d", this.render.settings));
4685
+ this.#hdrMediaListeners = listeners;
4530
4686
  }
4531
4687
  #initStyle() {
4532
4688
  const element = this.domElement, options = this.#container.actualOptions;
@@ -4550,6 +4706,25 @@
4550
4706
  element.style.setProperty(key, value, "important");
4551
4707
  }
4552
4708
  }
4709
+ #recreateRenderCanvas() {
4710
+ const renderCanvas = this.renderCanvas;
4711
+ if (!renderCanvas) {
4712
+ return;
4713
+ }
4714
+ if (this.domElement) {
4715
+ return;
4716
+ }
4717
+ this.renderCanvas = new OffscreenCanvas(renderCanvas.width, renderCanvas.height);
4718
+ }
4719
+ #removeHdrListeners() {
4720
+ if (!this.#hdrMediaListeners) {
4721
+ return;
4722
+ }
4723
+ for (const { handler, mql } of this.#hdrMediaListeners) {
4724
+ mql.removeEventListener("change", handler);
4725
+ }
4726
+ this.#hdrMediaListeners = undefined;
4727
+ }
4553
4728
  #repairStyle() {
4554
4729
  const element = this.domElement;
4555
4730
  if (!element) {
@@ -4934,9 +5109,9 @@
4934
5109
  }
4935
5110
  getOpacity() {
4936
5111
  const zIndexOptions = this.options.zIndex, zIndexFactor = zIndexFactorOffset - this.zIndexFactor, zOpacityFactor = zIndexFactor ** zIndexOptions.opacityRate, baseOpacity = getRangeValue(this.opacity?.value ?? defaultOpacity$1), modifierOpacity = this.#applyModifiers(undefined, m => m.opacity), opacity = modifierOpacity ?? baseOpacity, fillOpacity = this.fillOpacity ?? defaultOpacity$1, strokeOpacity = this.strokeOpacity ?? defaultOpacity$1;
4937
- this.#cachedOpacityData.fillOpacity = opacity * fillOpacity * zOpacityFactor;
5112
+ this.#cachedOpacityData.fillOpacity = fillOpacity;
4938
5113
  this.#cachedOpacityData.opacity = opacity * zOpacityFactor;
4939
- this.#cachedOpacityData.strokeOpacity = opacity * strokeOpacity * zOpacityFactor;
5114
+ this.#cachedOpacityData.strokeOpacity = strokeOpacity;
4940
5115
  return this.#cachedOpacityData;
4941
5116
  }
4942
5117
  getPosition() {
@@ -5791,6 +5966,7 @@
5791
5966
  effectDrawers;
5792
5967
  fpsLimit;
5793
5968
  hdr;
5969
+ hdrMode;
5794
5970
  id;
5795
5971
  pageHidden;
5796
5972
  particleCreatedPlugins;
@@ -5798,6 +5974,7 @@
5798
5974
  particlePositionPlugins;
5799
5975
  particleUpdaters;
5800
5976
  particles;
5977
+ peakNits;
5801
5978
  plugins;
5802
5979
  retina;
5803
5980
  shapeDrawers;
@@ -5828,6 +6005,8 @@
5828
6005
  this.id = Symbol(id);
5829
6006
  this.fpsLimit = 120;
5830
6007
  this.hdr = false;
6008
+ this.hdrMode = HdrMode.standard;
6009
+ this.peakNits = 400;
5831
6010
  this.#smooth = false;
5832
6011
  this.#delay = 0;
5833
6012
  this.#duration = 0;
@@ -5967,8 +6146,9 @@
5967
6146
  this.updateActualOptions();
5968
6147
  this.canvas.initBackground();
5969
6148
  this.canvas.resize();
5970
- const { delay, duration, fpsLimit, hdr, smooth, zLayers } = this.actualOptions;
5971
- this.hdr = hdr;
6149
+ const { delay, duration, fpsLimit, smooth, zLayers } = this.actualOptions, hdrOptions = this.actualOptions.hdr;
6150
+ this.hdrMode = hdrOptions.mode;
6151
+ this.peakNits = hdrOptions.peakNits;
5972
6152
  this.zLayers = zLayers;
5973
6153
  this.#duration = getRangeValue(duration) * millisecondsToSeconds;
5974
6154
  this.#delay = getRangeValue(delay) * millisecondsToSeconds;
@@ -6556,7 +6736,7 @@
6556
6736
  let handled = false;
6557
6737
  const canvas = container.canvas;
6558
6738
  if (trailFill.color) {
6559
- canvas.render.paintBase(getStyleFromRgb(trailFill.color, container.hdr, trailFill.opacity));
6739
+ canvas.render.paintBase(getStyleFromRgb(trailFill.color, container.hdr, trailFill.opacity, container.peakNits, container.hdrMode));
6560
6740
  handled = true;
6561
6741
  }
6562
6742
  else if (trailFill.image) {