p5 2.0.0 → 2.0.1

package/lib/p5.js

@@ -1,4 +1,4 @@
-/*! p5.js v2.0.0 April 17, 2025 */
+/*! p5.js v2.0.1 April 23, 2025 */
 var p5 = (function () {
   'use strict';
 
@@ -15,7 +15,7 @@ var p5 = (function () {
    * @property {String} VERSION
    * @final
    */
-  const VERSION = '2.0.0';
+  const VERSION = '2.0.1';
 
   // GRAPHICS RENDERER
   /**
@@ -52870,7 +52870,7 @@ var p5 = (function () {
 
   var phongVert = "precision highp int;\n\n#define HOOK_DEFINES\n\nIN vec3 aPosition;\nIN vec3 aNormal;\nIN vec2 aTexCoord;\nIN vec4 aVertexColor;\n\nuniform vec3 uAmbientColor[5];\n\n#ifdef AUGMENTED_HOOK_getWorldInputs\nuniform mat4 uModelMatrix;\nuniform mat4 uViewMatrix;\nuniform mat3 uModelNormalMatrix;\nuniform mat3 uCameraNormalMatrix;\n#else\nuniform mat4 uModelViewMatrix;\nuniform mat3 uNormalMatrix;\n#endif\nuniform mat4 uProjectionMatrix;\nuniform int uAmbientLightCount;\n\nuniform bool uUseVertexColor;\nuniform vec4 uMaterialColor;\n\nOUT vec3 vNormal;\nOUT vec2 vTexCoord;\nOUT vec3 vViewPosition;\nOUT vec3 vAmbientColor;\nOUT vec4 vColor;\n\nstruct Vertex {\n  vec3 position;\n  vec3 normal;\n  vec2 texCoord;\n  vec4 color;\n};\n\nvoid main(void) {\n  HOOK_beforeVertex();\n\n  Vertex inputs;\n  inputs.position = aPosition;\n  inputs.normal = aNormal;\n  inputs.texCoord = aTexCoord;\n  inputs.color = (uUseVertexColor && aVertexColor.x >= 0.0) ? aVertexColor : uMaterialColor;\n#ifdef AUGMENTED_HOOK_getObjectInputs\n  inputs = HOOK_getObjectInputs(inputs);\n#endif\n\n#ifdef AUGMENTED_HOOK_getWorldInputs\n  inputs.position = (uModelMatrix * vec4(inputs.position, 1.)).xyz;\n  inputs.normal = uModelNormalMatrix * inputs.normal;\n  inputs = HOOK_getWorldInputs(inputs);\n#endif\n\n#ifdef AUGMENTED_HOOK_getWorldInputs\n  // Already multiplied by the model matrix, just apply view\n  inputs.position = (uViewMatrix * vec4(inputs.position, 1.)).xyz;\n  inputs.normal = uCameraNormalMatrix * inputs.normal;\n#else\n  // Apply both at once\n  inputs.position = (uModelViewMatrix * vec4(inputs.position, 1.)).xyz;\n  inputs.normal = uNormalMatrix * inputs.normal;\n#endif\n#ifdef AUGMENTED_HOOK_getCameraInputs\n  inputs = HOOK_getCameraInputs(inputs);\n#endif\n\n  // Pass varyings to fragment shader\n  vViewPosition = inputs.position;\n  vTexCoord = inputs.texCoord;\n  vNormal = inputs.normal;\n  vColor = inputs.color;\n\n  // TODO: this should be a uniform\n  vAmbientColor = vec3(0.0);\n  for (int i = 0; i < 5; i++) {\n    if (i < uAmbientLightCount) {\n      vAmbientColor += uAmbientColor[i];\n    }\n  }\n\n  gl_Position = uProjectionMatrix * vec4(inputs.position, 1.);\n  HOOK_afterVertex();\n}\n";
 
-  var phongFrag = "// include lighting.glsl\nprecision highp int;\n\nuniform bool uHasSetAmbient;\nuniform vec4 uSpecularMatColor;\nuniform vec4 uAmbientMatColor;\nuniform vec4 uEmissiveMatColor;\n\nuniform vec4 uTint;\nuniform sampler2D uSampler;\nuniform bool isTexture;\n\nIN vec3 vNormal;\nIN vec2 vTexCoord;\nIN vec3 vViewPosition;\nIN vec3 vAmbientColor;\nIN vec4 vColor;\n\nstruct ColorComponents {\n  vec3 baseColor;\n  float opacity;\n  vec3 ambientColor;\n  vec3 specularColor;\n  vec3 diffuse;\n  vec3 ambient;\n  vec3 specular;\n  vec3 emissive;\n};\n\nstruct Inputs {\n  vec3 normal;\n  vec2 texCoord;\n  vec3 ambientLight;\n  vec3 ambientMaterial;\n  vec3 specularMaterial;\n  vec3 emissiveMaterial;\n  vec4 color;\n  float shininess;\n  float metalness;\n};\n\nvoid main(void) {\n  HOOK_beforeFragment();\n\n  Inputs inputs;\n  inputs.normal = normalize(vNormal);\n  inputs.texCoord = vTexCoord;\n  inputs.ambientLight = vAmbientColor;\n  inputs.color = isTexture\n      ? TEXTURE(uSampler, vTexCoord) * uTint/255.\n      : vColor;\n  if (isTexture && inputs.color.a > 0.0) {\n    // Textures come in with premultiplied alpha. Temporarily unpremultiply it\n    // so hooks users don't have to think about premultiplied alpha.\n    inputs.color.rgb /= inputs.color.a;\n  }\n  inputs.shininess = uShininess;\n  inputs.metalness = uMetallic;\n  inputs.ambientMaterial = uHasSetAmbient ? uAmbientMatColor.rgb : inputs.color.rgb;\n  inputs.specularMaterial = uSpecularMatColor.rgb;\n  inputs.emissiveMaterial = uEmissiveMatColor.rgb;\n  inputs = HOOK_getPixelInputs(inputs);\n\n  vec3 diffuse;\n  vec3 specular;\n  totalLight(vViewPosition, inputs.normal, inputs.shininess, inputs.metalness, diffuse, specular);\n\n  // Calculating final color as result of all lights (plus emissive term).\n\n  vec2 texCoord = inputs.texCoord;\n  vec4 baseColor = inputs.color;\n  ColorComponents c;\n  c.opacity = baseColor.a;\n  c.baseColor = baseColor.rgb;\n  c.ambientColor = inputs.ambientMaterial;\n  c.specularColor = inputs.specularMaterial;\n  c.diffuse = diffuse;\n  c.ambient = inputs.ambientLight;\n  c.specular = specular;\n  c.emissive = inputs.emissiveMaterial;\n  OUT_COLOR = HOOK_getFinalColor(HOOK_combineColors(c));\n  OUT_COLOR.rgb *= OUT_COLOR.a; // Premultiply alpha before rendering\n  HOOK_afterFragment();\n}\n";
+  var phongFrag = "// include lighting.glsl\nprecision highp int;\n\nuniform bool uHasSetAmbient;\nuniform vec4 uSpecularMatColor;\nuniform vec4 uAmbientMatColor;\nuniform vec4 uEmissiveMatColor;\n\nuniform vec4 uTint;\nuniform sampler2D uSampler;\nuniform bool isTexture;\n\nIN vec3 vNormal;\nIN vec2 vTexCoord;\nIN vec3 vViewPosition;\nIN vec3 vAmbientColor;\nIN vec4 vColor;\n\nstruct ColorComponents {\n  vec3 baseColor;\n  float opacity;\n  vec3 ambientColor;\n  vec3 specularColor;\n  vec3 diffuse;\n  vec3 ambient;\n  vec3 specular;\n  vec3 emissive;\n};\n\nstruct Inputs {\n  vec3 normal;\n  vec2 texCoord;\n  vec3 ambientLight;\n  vec3 ambientMaterial;\n  vec3 specularMaterial;\n  vec3 emissiveMaterial;\n  vec4 color;\n  float shininess;\n  float metalness;\n};\n\nvoid main(void) {\n  HOOK_beforeFragment();\n\n  Inputs inputs;\n  inputs.normal = normalize(vNormal);\n  inputs.texCoord = vTexCoord;\n  inputs.ambientLight = vAmbientColor;\n  inputs.color = isTexture\n      ? TEXTURE(uSampler, vTexCoord) * (vec4(uTint.rgb/255., 1.) * uTint.a/255.)\n      : vColor;\n  if (isTexture && inputs.color.a > 0.0) {\n    // Textures come in with premultiplied alpha. Temporarily unpremultiply it\n    // so hooks users don't have to think about premultiplied alpha.\n    inputs.color.rgb /= inputs.color.a;\n  }\n  inputs.shininess = uShininess;\n  inputs.metalness = uMetallic;\n  inputs.ambientMaterial = uHasSetAmbient ? uAmbientMatColor.rgb : inputs.color.rgb;\n  inputs.specularMaterial = uSpecularMatColor.rgb;\n  inputs.emissiveMaterial = uEmissiveMatColor.rgb;\n  inputs = HOOK_getPixelInputs(inputs);\n\n  vec3 diffuse;\n  vec3 specular;\n  totalLight(vViewPosition, inputs.normal, inputs.shininess, inputs.metalness, diffuse, specular);\n\n  // Calculating final color as result of all lights (plus emissive term).\n\n  vec2 texCoord = inputs.texCoord;\n  vec4 baseColor = inputs.color;\n  ColorComponents c;\n  c.opacity = baseColor.a;\n  c.baseColor = baseColor.rgb;\n  c.ambientColor = inputs.ambientMaterial;\n  c.specularColor = inputs.specularMaterial;\n  c.diffuse = diffuse;\n  c.ambient = inputs.ambientLight;\n  c.specular = specular;\n  c.emissive = inputs.emissiveMaterial;\n  OUT_COLOR = HOOK_getFinalColor(HOOK_combineColors(c));\n  OUT_COLOR.rgb *= OUT_COLOR.a; // Premultiply alpha before rendering\n  HOOK_afterFragment();\n}\n";
 
   var fontVert = "IN vec3 aPosition;\nIN vec2 aTexCoord;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nuniform vec4 uGlyphRect;\nuniform float uGlyphOffset;\n\nOUT vec2 vTexCoord;\nOUT float w;\n\nvoid main() {\n  vec4 positionVec4 = vec4(aPosition, 1.0);\n\n  // scale by the size of the glyph's rectangle\n  positionVec4.xy *= uGlyphRect.zw - uGlyphRect.xy;\n\n  // Expand glyph bounding boxes by 1px on each side to give a bit of room\n  // for antialiasing\n  vec3 newOrigin = (uModelViewMatrix * vec4(0., 0., 0., 1.)).xyz;\n  vec3 newDX = (uModelViewMatrix * vec4(1., 0., 0., 1.)).xyz;\n  vec3 newDY = (uModelViewMatrix * vec4(0., 1., 0., 1.)).xyz;\n  vec2 pixelScale = vec2(\n    1. / length(newOrigin - newDX),\n    1. / length(newOrigin - newDY)\n  );\n  vec2 offset = pixelScale * normalize(aTexCoord - vec2(0.5, 0.5));\n  vec2 textureOffset = offset * (1. / vec2(\n    uGlyphRect.z - uGlyphRect.x,\n    uGlyphRect.w - uGlyphRect.y\n  ));\n\n  // move to the corner of the glyph\n  positionVec4.xy += uGlyphRect.xy;\n\n  // move to the letter's line offset\n  positionVec4.x += uGlyphOffset;\n\n  positionVec4.xy += offset;\n  \n  gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n  vTexCoord = aTexCoord + textureOffset;\n  w = gl_Position.w;\n}\n";
 
@@ -65649,6 +65649,7 @@ var p5 = (function () {
     attributes(p5, p5.Graphics.prototype);
     curves(p5, p5.Graphics.prototype);
     vertex(p5, p5.Graphics.prototype);
+    customShapes(p5, p5.Graphics.prototype);
 
     setting(p5, p5.Graphics.prototype);
     loadingDisplaying(p5, p5.Graphics.prototype);
@@ -70089,9 +70090,10 @@ var p5 = (function () {
    * a p5 sketch.  It expects an incoming sketch closure and it can also
    * take an optional node parameter for attaching the generated p5 canvas
    * to a node.  The sketch closure takes the newly created p5 instance as
-   * its sole argument and may optionally set <a href="#/p5/preload">preload()</a>,
-   * <a href="#/p5/setup">setup()</a>, and/or
-   * <a href="#/p5/draw">draw()</a> properties on it for running a sketch.
+   * its sole argument and may optionally set an asynchronous function
+   * using `async/await`, along with the standard <a href="#/p5/setup">setup()</a>,
+   *  and/or <a href="#/p5/setup">setup()</a>, and/or <a href="#/p5/draw">draw()</a>
+   *  properties on it for running a sketch.
    *
    * A p5 sketch can run in "global" or "instance" mode:
    * "global"   - all properties and methods are attached to the window
@@ -70212,10 +70214,11 @@ var p5 = (function () {
           bindGlobal(p);
         }
 
+        const protectedProperties = ['constructor', 'length'];
         // Attach its properties to the window
         for (const p in this) {
           if (this.hasOwnProperty(p)) {
-            if(p[0] === '_') continue;
+            if(p[0] === '_' || protectedProperties.includes(p)) continue;
             bindGlobal(p);
           }
         }
@@ -70540,6 +70543,8 @@ var p5 = (function () {
    * <a href="#/p5/draw">draw()</a> begins looping. If the
    * <a href="#/p5/preload">preload()</a> is declared, then `setup()` will
    * run immediately after <a href="#/p5/preload">preload()</a> finishes
+   * 
+   * 
    * loading assets.
    *
    * Note: `setup()` doesn’t have to be declared, but it’s common practice to do so.
@@ -76719,7 +76724,7 @@ var p5 = (function () {
           // actual name with correct capitalization doesnt exist in context,
           // and if the user-defined symbol is of the type function
           if (
-            fxns[lowercase] &&
+            fxns.hasOwnProperty(lowercase) &&
             !context[fxns[lowercase]] &&
             typeof context[prop] === 'function'
           ) {
@@ -83264,6 +83269,13 @@ var p5 = (function () {
   			]
   		]
   	},
+  	createMatrix: {
+  		overloads: [
+  			[
+  				"Number[]"
+  			]
+  		]
+  	},
   	noise: {
   		overloads: [
   			[
@@ -83686,23 +83698,14 @@ var p5 = (function () {
   	bezierOrder: {
   		overloads: [
   			[
-  				"Number"
   			],
   			[
+  				"Number"
   			]
   		]
   	},
   	splineVertex: {
   		overloads: [
-  			[
-  				"Number",
-  				"Number"
-  			],
-  			[
-  				"Number",
-  				"Number",
-  				"Number?"
-  			],
   			[
   				"Number",
   				"Number",
@@ -83721,20 +83724,20 @@ var p5 = (function () {
   	splineProperty: {
   		overloads: [
   			[
-  				"String",
-  				null
+  				"String"
   			],
   			[
-  				"String"
+  				"String",
+  				null
   			]
   		]
   	},
   	splineProperties: {
   		overloads: [
   			[
-  				"Object"
   			],
   			[
+  				"Object"
   			]
   		]
   	},
@@ -83796,6 +83799,19 @@ var p5 = (function () {
   			]
   		]
   	},
+  	curveVertex: {
+  		overloads: [
+  			[
+  				"Number",
+  				"Number"
+  			],
+  			[
+  				"Number",
+  				"Number",
+  				"Number?"
+  			]
+  		]
+  	},
   	endShape: {
   		overloads: [
   			[
@@ -84602,6 +84618,42 @@ var p5 = (function () {
   			]
   		]
   	},
+  	parseObj: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
+  	parseSTL: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
+  	isBinary: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
+  	matchDataViewAt: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
+  	parseBinarySTL: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
+  	parseASCIISTL: {
+  		overloads: [
+  			[
+  			]
+  		]
+  	},
   	model: {
   		overloads: [
   			[
@@ -97787,6 +97839,15 @@ var p5 = (function () {
      * </div>
      */
     fn._onkeyup = function(e) {
+
+      const context = this._isGlobal ? window : this;
+      if (typeof context.keyReleased === 'function') {
+        const executeDefault = context.keyReleased(e);
+        if (executeDefault === false) {
+          e.preventDefault();
+        }
+      }
+      
       delete this._downKeyCodes[e.code];
       delete this._downKeys[e.key];
 
@@ -97803,15 +97864,9 @@ var p5 = (function () {
         this.key = lastPressedKey;
       }
 
-      const context = this._isGlobal ? window : this;
-      if (typeof context.keyReleased === 'function') {
-        const executeDefault = context.keyReleased(e);
-        if (executeDefault === false) {
-          e.preventDefault();
-        }
-      }
     };
 
+
     /**
      * A function that's called once when keys with printable characters are pressed.
      *
@@ -99023,25 +99078,25 @@ var p5 = (function () {
 
     fn._updatePointerCoords = function (e) {
       if (this._curElement !== null) {
-         const canvas = this._curElement.elt;
-         const sx = canvas.scrollWidth / this.width || 1;
-         const sy = canvas.scrollHeight / this.height || 1;
+        const canvas = this._curElement.elt;
+        const sx = canvas.scrollWidth / this.width || 1;
+        const sy = canvas.scrollHeight / this.height || 1;
 
-         if (e.pointerType == 'touch') {
+        if (e.pointerType == 'touch') {
             const touches = [];
             for (const touch of this._activePointers.values()) {
-               touches.push(getTouchInfo(canvas, sx, sy, touch));
+              touches.push(getTouchInfo(canvas, sx, sy, touch));
             }
             this.touches = touches;
-         } else {
-            const mousePos = getMouseInfo(canvas, sx, sy, e);
-            this.movedX = e.movementX || 0;
-            this.movedY = e.movementY || 0;
-            this.mouseX = mousePos.x;
-            this.mouseY = mousePos.y;
-            this.winMouseX = mousePos.winX;
-            this.winMouseY = mousePos.winY;
-         }
+        } 
+
+        const mousePos = getMouseInfo(canvas, sx, sy, e);
+        this.movedX = e.movementX || 0;
+        this.movedY = e.movementY || 0;
+        this.mouseX = mousePos.x;
+        this.mouseY = mousePos.y;
+        this.winMouseX = mousePos.winX;
+        this.winMouseY = mousePos.winY;
 
          if (!this._hasMouseInteracted) {
             this._updateMouseCoords();
@@ -106062,11 +106117,10 @@ var p5 = (function () {
      *
      * If a sketch has a
      * <a href="#/p5/setup">setup()</a> function, then `millis()` begins tracking
-     * time before the code in <a href="#/p5/setup">setup()</a> runs. If a
-     * sketch includes a <a href="#/p5/preload">preload()</a> function, then
-     * `millis()` begins tracking time as soon as the code in
-     * <a href="#/p5/preload">preload()</a> starts running.
-     *
+     * time before the code in <a href="#/p5/setup">setup()</a> runs.  If a
+     * sketch includes asynchronous loading using `async`/`await`, then
+     * `millis()` begins tracking time as soon as the asynchronous code
+     * starts running.
      * @method millis
      * @return {Number} number of milliseconds since starting the sketch.
      *