fix(primitive): implement as proxy to avoid breaking references

[andretchen0]

This is the last in a series of PRs to implement primitives in a way that doesn't break references in <script setup> (see #701). With this PR, <primitive> is now implemented as a JS Proxy.

Problem

#701 Under the hood, <primitive /> copies its :object. This breaks references to the object in <script setup>.

Solution

Implement <primitive /> as a JS Proxy.

Playground

http://localhost:5173/issues/701

Problem

#751 Rigged models are squished and do not animate. Bones and animations lose their reference to the model.

Solution

Implement <primitive /> as a JS Proxy.

Playground

http://localhost:5173/models/rigged

Problem

#721 Tres typically removes/disposes in descendants-first order – children are removed before parents. nodeOps.remove sometimes calls a THREE object's dispose method. THREE's dispose implementation does not check for the existence of attributes before trying to delete them – which can result in a user-facing error.

Solution

Try/catch on dispose in nodeOps.remove.

Problem

Cientos' components using primitives under the hood – Sparkles and Contact Shadows – do not work under Tres v4.

Solution

Implement <primitive /> as a JS Proxy.

Playground

http://localhost:5173/issues/701-cientos-v4

closes #751
closes #721
closes #701

[netlify]

✅ Deploy Preview for tresjs-docs ready!

Name	Link
🔨 Latest commit	9fb8cc9
🔍 Latest deploy log	https://app.netlify.com/sites/tresjs-docs/deploys/668da913f4040f0008bf1137
😎 Deploy Preview	https://deploy-preview-764--tresjs-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[alvarosabu]

Hi @andretchen0 I think I'm gonna pin this PR somewhere just as an example of how a PR should be done, thanks for the incredible amount of work, this is how primitives should have been working fro the beginning but now thanks to you they work.