Updating docs

Author: hunvreus

README.md

@@ -92,6 +92,9 @@ Notes:
   - Enable with `enableImagePasteDrop`.
   - Provide `onUploadImage` to upload files and return final `{ src }`.
   - Optional fallback with `imageFallback="data-url"` for base64 insertion.
+- Swap behavior:
+  - The editor preloads the final uploaded URL before replacing the temporary `blob:` preview.
+  - If preload fails or times out, the editor keeps the temporary preview and marks the image with an upload error state.
 - Pending uploads:
   - Use `onPendingUploadsChange` to disable autosave/publish while uploads are in progress.
 

src/App.tsx

@@ -345,6 +345,11 @@ export default function App() {
             pass <code className={inlineCodeClass}>onRequestImage</code> to replace the default image prompt with your
             own modal or picker, plus <code className={inlineCodeClass}>onUploadImage</code> for paste/drop uploads.
           </p>
+          <p className="mt-4 leading-relaxed">
+            During uploads, the editor inserts a temporary local preview immediately, then preloads the final uploaded
+            URL before swapping <code className={inlineCodeClass}>src</code>. If preload fails or times out, it keeps
+            the temporary preview and marks an upload error on that image.
+          </p>
           <HighlightedCode
             dark={resolvedIsDark}
             lang="tsx"