From ba982fb8210208bab9a887c151d62a6cd0f2e764 Mon Sep 17 00:00:00 2001
From: Guilhem Lemouel <guilhemlemouel@gmail.com>
Date: Tue, 22 Sep 2026 11:28:13 +0200
Subject: [PATCH] docs: note raw app iframe focus limitation

---
 frontend/src/lib/components/raw_apps/RawAppEditor.svelte | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/frontend/src/lib/components/raw_apps/RawAppEditor.svelte b/frontend/src/lib/components/raw_apps/RawAppEditor.svelte
index ad67c62fa2..1b5ed03eb3 100644
--- a/frontend/src/lib/components/raw_apps/RawAppEditor.svelte
+++ b/frontend/src/lib/components/raw_apps/RawAppEditor.svelte
@@ -853,6 +853,9 @@
 			}, 500)
 			const doc = untrack(() => iframeDocument)
 			if (doc !== undefined && isOpenableDocument(doc)) {
+				// Plain setFiles opens the iframe's default document after a content change.
+				// Preserving this document may focus the hidden iframe; eliminating that
+				// transfer requires a focus-preserving update API in the UI Builder.
 				setFilesAndSelectInIframe(files, doc)
 			} else {
 				// Deleted or renamed away since we last told the iframe to open it;