docs(store): reload merges the value

plugins/store/guest-js/index.ts

@@ -396,7 +396,12 @@ interface IStore {
    *
    * This method is useful if the on-disk state was edited by the user and you want to synchronize the changes.
    *
-   * Note: This method does not emit change events.
+   * Note:
+   *   - This method loads the data and merges it with the current store,
+   *     call {@linkcode clear} or {@linkcode reset} first for the store to fully match the on-disk state
+   *     (be careful with the auto save settings as they both trigger that)
+   *   - This method does not emit change events.
+   *
    * @returns
    */
   reload(): Promise<void>

plugins/store/src/store.rs

@@ -284,6 +284,8 @@ impl<R: Runtime> StoreInner<R> {
     }
 
     /// Update the store from the on-disk state
+    ///
+    /// Note: This method loads the data and merges it with the current store
     pub fn load(&mut self) -> crate::Result<()> {
         let bytes = fs::read(&self.path)?;
 
@@ -499,6 +501,12 @@ impl<R: Runtime> Store<R> {
     }
 
     /// Update the store from the on-disk state
+    ///
+    /// Note:
+    ///   - This method loads the data and merges it with the current store,
+    ///     call [`clear`](Self::clear) or [`reset`](Self::reset) first for the store to fully match the on-disk state
+    ///     (be careful with the auto save settings as they both trigger that)
+    ///   - This method does not emit change events
     pub fn reload(&self) -> crate::Result<()> {
         self.store.lock().unwrap().load()
     }