aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--AGENTS.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index cd9de42..82a2b2e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -227,6 +227,16 @@ the whole screen use `ExclusionMode.Ignore`.
Hot reload covers adding and removing windows too: the keepalive window above
was added to a running shell and took effect on save.
+Hot reload does **not** pick up a new component *file*. A directory's generated
+`qmldir` is its import index, and it is only regenerated when a file that
+imports that directory reloads, not when a file appears in it. Adding
+`desktop/Switch.qml` while only editing files under `modules/` left it
+invisible to the running shell, so `NetworkPage` and `BluetoothPage` could not
+resolve `Switch` and the two modules dropped from the grid; the code was
+correct and a fresh `qs` process rendered it. Force the rescan by changing a
+file that imports the directory (`desktop/shell.qml`), or restart the shell.
+Touch alone does not reload: the content must change.
+
`qs -p <dir>` runs one directly. `qs -p <dir> ipc call <target> <fn>` reaches a
running one, which is how `SUPER+v` opens the VM drawer.