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