Mark array() method as deprecated with warning message

[hxrshxz]

Resolves #8151

Changes:

Marked both the static and instance version of the array() method as deprecated

PR Checklist

• npm run lint passes
• Inline reference is included / updated
• Unit tests are included / updated

[davepagurek]

This is currently throwing errors in the tests. Inside of classes, we don't have access to a global p5. We do have access to them in the exported addon function body though. In #8176 I dealt with something similar by patching the class in the exported addon function to give it access to these.

Also, once this does work, we probably don't want to flood the user's console with logs if they're using this a bunch every frame. We should maybe track whether or not we've logged this warning yet, and don't log it a second time.

[hxrshxz]

Thanks for your help sharing this pattern made the fix super easy

[sidwellr]

As long as this is being changed, I suggest updating the documentation as well. Change from "Returns the vector's components as an array of numbers" to something like "Returns the vector's first three components as an array of three numbers." The existing example is great; it makes clear that the result will have three numbers even for a 2D array.

I also suggest including a pointer to its replacement in the deprecation message (and perhaps something similar in the FES message):

@deprecated array() will be removed in a future version of p5.js; use the more flexible v.values instead of v.array()

[hxrshxz]

@davepagurek please have a look , thank you

[Copilot]

Pull request overview

This PR marks the array() method in p5.Vector as deprecated, addressing issue #8151. It adds runtime deprecation warnings using p5._friendlyError to notify users that the method will be removed in a future version. This is the first deprecation in p5.js to include runtime warnings, establishing a new pattern beyond just JSDoc annotations.

Key Changes:

• Added @deprecated JSDoc tags to both instance and static array() methods
• Implemented a deprecation warning system that shows a friendly error message once per session
• Created _showArrayDeprecationWarning() helper method to manage the warning display

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.