Merge branch 'main' into svelte-html

sveltejs · dummdidumm · Nov 19, 2024 · Nov 21, 2024 · Nov 27, 2024 · Nov 27, 2024
commit 8df29aa3409451640ca0b472855b3262ed6ef928
diff --git a/documentation/docs/98-reference/.generated/shared-warnings.md b/documentation/docs/98-reference/.generated/shared-warnings.md
@@ -20,6 +20,13 @@ The following properties cannot be cloned with `$state.snapshot` — the return
 %properties%
 ```
 
+`$state.snapshot` tries to clone the given value in order to return a reference that no longer changes. Certain objects may not be cloneable, in which case the original value is returned. In the following example, `property` is cloned, but `window` is not, because DOM elements are uncloneable:
+
+```js
+const object = $state({ property: 'this is cloneable', window })
+const snapshot = $state.snapshot(object);
+```
+
 ### svelte_html_duplicate_attribute
 
 ```

diff --git a/packages/svelte/messages/shared-warnings/warnings.md b/packages/svelte/messages/shared-warnings/warnings.md
@@ -12,6 +12,13 @@ Elements such as `<input>` cannot have content, any children passed to these ele
 >
 > %properties%
 
+`$state.snapshot` tries to clone the given value in order to return a reference that no longer changes. Certain objects may not be cloneable, in which case the original value is returned. In the following example, `property` is cloned, but `window` is not, because DOM elements are uncloneable:
+
+```js
+const object = $state({ property: 'this is cloneable', window })
+const snapshot = $state.snapshot(object);
+```
+
 ## svelte_html_duplicate_attribute
 
 > Duplicate attribute '%name%' across multiple `<svelte:html>` blocks, the latest value will be used.