changed deepClone back to original and added deepProxy

[overthemike]

Related Bug Reports or Discussions

#1165
Fixes #1165

Reverts #1074

Summary

Added deepProxy function and reverted deepClone back to original form. Split the tests for deepProxy and deepClone into different test files.

Check List

• [ x ] pnpm run fix for formatting and linting code and docs

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
valtio	Ready	Preview	Comment	Sep 25, 2025 3:36am

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

[pkg-pr-new]

More templates

• counter
• editor-proxyWithHistory
• valtio-photo-booth-demo
• starter

npm i https://pkg.pr.new/valtio@1169

commit: 99ff603

[github-actions]

Size Change: +671 B (+4.88%) 🔍

Total Size: 14.4 kB

Filename	Size	Change
./dist/esm/vanilla/utils.mjs	3.56 kB	+329 B (+10.18%)	⚠️
./dist/vanilla/utils.js	3.6 kB	+342 B (+10.48%)	⚠️

ℹ️ View Unchanged

Filename	Size
./dist/esm/index.mjs	63 B
./dist/esm/react.mjs	694 B
./dist/esm/react/utils.mjs	257 B
./dist/esm/utils.mjs	68 B
./dist/esm/vanilla.mjs	2.34 kB
./dist/index.js	243 B
./dist/react.js	686 B
./dist/react/utils.js	278 B
./dist/utils.js	248 B
./dist/vanilla.js	2.38 kB

_{compressed-size-action}

[overthemike]

I still need to do the documentation and it could use a few more tests. Wanted to push the code up first to get feedback first.

[dai-shi]

Added deepProxy function and reverted deepClone back to original form.

Thanks. This feels more comfortable and I think we could deprecate deepClone in the near future.

[overthemike]

I added tests and updated some docs for new exports from proxyMap/proxySet. Only thing left really is adding documentation for deepProxy. I'm wondering if we should add it as it's own small page within utils like proxyMap and proxySet have. I think it depends on if this is something we're going to want to keep around or if we eventually would like to deprecate it like we will with deepClone. @dai-shi thoughts?

[dai-shi]

I think it depends on if this is something we're going to want to keep around or if we eventually would like to deprecate it like we will with deepClone.

I think it's something to keep around, but I'm not very sure.
So, what I would do is to name it unstable_deepProxy, and add it to doc. And we hope to get feedback.

[overthemike]

Added page for unstable_deepProxy to the docs and updated a few other places. I think this should be good to go.

[dai-shi]

LGTM