feat(core): expose internal states and functions (#931)

* feat(core): expose internal states and functions * use createHandler * refactor * update docs * update docs * Revert "update docs" This reverts commit 33b04d4.
pmndrs · Aug 15, 2024 · eac3442 · eac3442
1 parent 233e811
commit eac3442
Show file tree

Hide file tree

Showing 5 changed files with 301 additions and 253 deletions.
diff --git a/docs/api/hacks/internals.mdx b/docs/api/hacks/internals.mdx
@@ -0,0 +1,17 @@
+---
+title: 'Internals'
+section: 'API'
+subSection: 'Hacks'
+description: ''
+---
+
+Valtio exposes some internal capabilities.
+This isn't for app developers. Use it at your own risk.
+
+# unstable_getInternalStates
+
+This function exposes the internal states. Modifying such states may result in wrong behaviors. You need to understand the [source code](https://github.com/pmndrs/valtio/blob/main/src/vanilla.ts) thoroughly to use it.
+
+# unstable_replaceInternalFunction
+
+This function exposes a way to replace some internal functions. It can easily break things. You need to understand the [source code](https://github.com/pmndrs/valtio/blob/main/src/vanilla.ts) thoroughly to use it.
diff --git a/docs/api/hacks/unstable_buildProxyFunction.mdx b/docs/api/hacks/unstable_buildProxyFunction.mdx