From 2036c79eeb8e1d8210b118d3be6a161a5a1b9101 Mon Sep 17 00:00:00 2001
From: Tito <tito.bouzout@gmail.com>
Date: Fri, 15 May 2026 15:07:49 -0300
Subject: [PATCH 1/2] Update Solid 2.0 documentation for initial values

---
 documentation/solid-2.0/07-dom.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/documentation/solid-2.0/07-dom.md b/documentation/solid-2.0/07-dom.md
index 768ca17df..88c8c5b66 100644
--- a/documentation/solid-2.0/07-dom.md
+++ b/documentation/solid-2.0/07-dom.md
@@ -114,11 +114,32 @@ const on = (type, handler, options) => el => el.addEventListener(type, handler,
 <button ref={[on("click", logCapture, { capture: true }), on("click", logBubble)]} />
 ```
 
+### Initial/Default values handling (and removal of `@once`)
+
+Solid 2.0 removes the `@once` static marker that used to avoid wrapping attributes/properties in effects.
+
+```jsx
+// 1.x: `@once` static marker
+<input value={/* @once */ prop.value} />
+
+// 2.0: non-tracking memo that reads at the right place
+const initialValue = createMemo(() => untrack(() => props.value ));
+
+<input defaultValue={initialValue()} />
+
+// 2.0: for stores, a non-tracking memo with a snapshot could be used
+const initialSize = createMemo(() => untrack(() => snapshot(props.size) ));
+
+<ColorPicker size={initialSize()} /> // {width, height}
+
+```
+
 ## Migration / replacement
 
 - **classList:** Use `class` with an object or array instead.
 - **Attributes:** Use lowercase attribute names; use string `"true"` only where the platform requires it.
 - **Directives:** Replace `use:foo={...}` with `ref={foo(...)}` (or `ref={foo}` when no options are needed). Use an array when you need multiple directives/refs.
+- **@once:** Use `createMemo` with `untrack`
 
 ## Removals
 
@@ -128,6 +149,7 @@ const on = (type, handler, options) => el => el.addEventListener(type, handler,
 | `on:` / `oncapture:`         | Use `onClick` for Solid events; use `ref` callbacks that call `addEventListener` for native listener options |
 | `attr:` / `bool:` namespaces | Single attribute/property model above                                                                        |
 | `use:` directives            | Use `ref` callbacks / directive factories (`ref={directive(opts)}`); arrays compose (`ref={[a, b]}`)         |
+| `@once` marker            | Use `createMemo` with `untrack`          |
 
 ## Alternatives considered
 

From 867d5862948a36086de55c822e112e9a9d819553 Mon Sep 17 00:00:00 2001
From: Tito <tito.bouzout@gmail.com>
Date: Fri, 15 May 2026 15:36:12 -0300
Subject: [PATCH 2/2] add structureClone besides mentioning snapshot

---
 documentation/solid-2.0/07-dom.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/documentation/solid-2.0/07-dom.md b/documentation/solid-2.0/07-dom.md
index 88c8c5b66..6af1e5feb 100644
--- a/documentation/solid-2.0/07-dom.md
+++ b/documentation/solid-2.0/07-dom.md
@@ -127,7 +127,7 @@ const initialValue = createMemo(() => untrack(() => props.value ));
 
 <input defaultValue={initialValue()} />
 
-// 2.0: for stores, a non-tracking memo with a snapshot could be used
+// 2.0: for stores/objects, a non-tracking memo with a snapshot/structureClone could be used
 const initialSize = createMemo(() => untrack(() => snapshot(props.size) ));
 
 <ColorPicker size={initialSize()} /> // {width, height}
@@ -139,7 +139,7 @@ const initialSize = createMemo(() => untrack(() => snapshot(props.size) ));
 - **classList:** Use `class` with an object or array instead.
 - **Attributes:** Use lowercase attribute names; use string `"true"` only where the platform requires it.
 - **Directives:** Replace `use:foo={...}` with `ref={foo(...)}` (or `ref={foo}` when no options are needed). Use an array when you need multiple directives/refs.
-- **@once:** Use `createMemo` with `untrack`
+- **@once:** Use `createMemo` with `untrack`. For stores use `snapshot`, for plain objects use `structureClone`
 
 ## Removals
 
@@ -149,7 +149,7 @@ const initialSize = createMemo(() => untrack(() => snapshot(props.size) ));
 | `on:` / `oncapture:`         | Use `onClick` for Solid events; use `ref` callbacks that call `addEventListener` for native listener options |
 | `attr:` / `bool:` namespaces | Single attribute/property model above                                                                        |
 | `use:` directives            | Use `ref` callbacks / directive factories (`ref={directive(opts)}`); arrays compose (`ref={[a, b]}`)         |
-| `@once` marker            | Use `createMemo` with `untrack`          |
+| `@once` marker            | Use `createMemo` with `untrack`. For stores use `snapshot`, for plain objects use `structureClone`          |
 
 ## Alternatives considered