BlueGit

timfa filemanager

Document sidebar race guards and watched overlays

timfa Tim Falken · pushed by timfa

Authored 2026-05-15 · 6 months ago

Hash
8ba1a8d3c6728dd1b84b8d514948c62c5a28d73d
Parent
5fc4383a
1 file changed +5 −0
.github/technical-reference.md +5 −0
@@ -192,9 +192,12 @@
192 192 - loadMoveChildren(containerEl, dirPath) - Lazy-loads subfolders for a tree node via /api/files/list.
193 193 - isInlinePreviewableBlob(blob, name) - Determines if a blob can be previewed inline by MIME/extension.
194 194 - makeFileItem(item) - Builds a .file-item element; roots in Home now use folder-like interaction (single-click focus, double-click open), roots are non-draggable, and mobile long-press contextmenu suppression remains.
195 - makeFileItem(item) - Adds per-video watched overlays in the tile icon centre for the current user (`fully` filled eye, `partway` outlined eye).
195 196 - attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
197 - beginSidebarLoad() - Aborts in-flight sidebar requests and increments a load token so stale async responses cannot mutate the current sidebar state.
196 198 - openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
197 199 - openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
200 - openSidebar(item) - Uses abortable metadata/access requests and stale-load guards to prevent race-condition UI duplication when selection changes quickly.
198 201 - canWrite(item) - Resolves whether the current user may write to the selected item/root; personal folders are always writable for the owner.
199 202 - fetchRootAccessList(rootPath) - Fetches root access users from the server for a specific configured root.
200 203 - formatRootAccessList(users) - Formats root access entries as "username mode" values for sidebar rendering.
@@ -246,6 +249,8 @@
246 249 - video preview applies caption overrides per open - Verifies requested caption overrides are always loaded into Video.js settings.
247 250 - video preview does not save caption style settings per user on close - Verifies caption style changes are not persisted to per-user video preferences.
248 251 - video preview releases the backend stream session when closed - Verifies closing a streamed video preview sends an explicit backend release call.
252 - rapid file reselection does not duplicate sidebar action buttons after delayed metadata - Verifies stale sidebar loads are ignored so action buttons are not duplicated.
253 - video tiles show centred watched overlays for fully and partway statuses - Verifies watched-status overlays render as filled/outlined eye icons.
249 254
250 255 ## tests/video-stream.test.js
251 256 - createVideoStreamSession resolves once ffmpeg starts writing stream assets - Verifies session creation no longer waits for the final master playlist before preview can begin.
@@ -192,9 +192,12 @@
192- loadMoveChildren(containerEl, dirPath) - Lazy-loads subfolders for a tree node via /api/files/list.
192- loadMoveChildren(containerEl, dirPath) - Lazy-loads subfolders for a tree node via /api/files/list.
193- isInlinePreviewableBlob(blob, name) - Determines if a blob can be previewed inline by MIME/extension.
193- isInlinePreviewableBlob(blob, name) - Determines if a blob can be previewed inline by MIME/extension.
194- makeFileItem(item) - Builds a .file-item element; roots in Home now use folder-like interaction (single-click focus, double-click open), roots are non-draggable, and mobile long-press contextmenu suppression remains.
194- makeFileItem(item) - Builds a .file-item element; roots in Home now use folder-like interaction (single-click focus, double-click open), roots are non-draggable, and mobile long-press contextmenu suppression remains.
195- makeFileItem(item) - Adds per-video watched overlays in the tile icon centre for the current user (`fully` filled eye, `partway` outlined eye).
195- attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
196- attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
197- beginSidebarLoad() - Aborts in-flight sidebar requests and increments a load token so stale async responses cannot mutate the current sidebar state.
196- openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
198- openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
197- openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
199- openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
200- openSidebar(item) - Uses abortable metadata/access requests and stale-load guards to prevent race-condition UI duplication when selection changes quickly.
198- canWrite(item) - Resolves whether the current user may write to the selected item/root; personal folders are always writable for the owner.
201- canWrite(item) - Resolves whether the current user may write to the selected item/root; personal folders are always writable for the owner.
199- fetchRootAccessList(rootPath) - Fetches root access users from the server for a specific configured root.
202- fetchRootAccessList(rootPath) - Fetches root access users from the server for a specific configured root.
200- formatRootAccessList(users) - Formats root access entries as "username mode" values for sidebar rendering.
203- formatRootAccessList(users) - Formats root access entries as "username mode" values for sidebar rendering.
@@ -246,6 +249,8 @@
246- video preview applies caption overrides per open - Verifies requested caption overrides are always loaded into Video.js settings.
249- video preview applies caption overrides per open - Verifies requested caption overrides are always loaded into Video.js settings.
247- video preview does not save caption style settings per user on close - Verifies caption style changes are not persisted to per-user video preferences.
250- video preview does not save caption style settings per user on close - Verifies caption style changes are not persisted to per-user video preferences.
248- video preview releases the backend stream session when closed - Verifies closing a streamed video preview sends an explicit backend release call.
251- video preview releases the backend stream session when closed - Verifies closing a streamed video preview sends an explicit backend release call.
252- rapid file reselection does not duplicate sidebar action buttons after delayed metadata - Verifies stale sidebar loads are ignored so action buttons are not duplicated.
253- video tiles show centred watched overlays for fully and partway statuses - Verifies watched-status overlays render as filled/outlined eye icons.
249
254
250## tests/video-stream.test.js
255## tests/video-stream.test.js
251- createVideoStreamSession resolves once ffmpeg starts writing stream assets - Verifies session creation no longer waits for the final master playlist before preview can begin.
256- createVideoStreamSession resolves once ffmpeg starts writing stream assets - Verifies session creation no longer waits for the final master playlist before preview can begin.