BlueGit

timfa filemanager

docs: update technical reference and tests index for preview redesign

timfa Tim Falken · pushed by timfa

Authored 2026-05-04 · 6 months ago

Hash
26e2c9e58b0e3d08c207b12fd7adc0410cc34788
Parent
7e179f05
1 file changed +3 −1
.github/technical-reference.md +3 −1
@@ -46,7 +46,6 @@
46 46 - prettyPrintCode(raw, lang) - Best-effort formatter for JSON/markup/script previews before rendering.
47 47 - highlightCode(raw, lang) - Escapes and syntax-highlights preview text into HTML spans.
48 48 - fileAccentColor(name) - Returns canonical file-type accent color used by icon strokes and preview sheet outline.
49 - animatePreviewOpen(sourceSvgEl, sheetEl) - Animates a cloned file icon from its tile position into the full preview sheet.
50 49 - openFolderSidebar() - Persistent sidebar fallback view that shows current folder/root overview when no item is selected.
51 50 - closeSidebar() - Clears selection; hides the panel entirely on mobile and restores folder overview sidebar on desktop.
52 51 - isMobileViewport() - Central media-query helper for mobile-only sidebar/interaction behavior.
@@ -54,11 +53,14 @@
54 53 - renderBreadcrumb() - Builds clickable breadcrumb path and marks each folder segment as a drag-drop move target via .crumb-drop-target and data-path.
55 54 - fetchFileBlob(item) - Downloads a file as Blob with auth headers for preview/download flows.
56 55 - downloadOrView(item, sourceSvgEl) - Opens preview; prefers in-place expanded tile preview when invoked from a file icon, falls back to overlay when no source tile is available.
56 - downloadOrView(item, sourceSvgEl) - Opens in-place expanded tile preview from a file icon; shows error toast if no source tile is found.
57 57 - renderPreviewBody(item, blob, objectUrl, targetEl) - Renders preview content (image/video/audio/pdf/text) or unsupported message into a target container.
58 58 - animateRect(el, fromRect, toRect, opts) - Helper that animates element rectangle (left/top/width/height) for expand/collapse transitions.
59 59 - openExpandedTilePreview(item, tileEl, sourceSvgEl, blob, objectUrl) - Reparents the real file tile to body, expands it to viewport preview, injects close/download controls.
60 - openExpandedTilePreview(item, tileEl, sourceSvgEl, blob, objectUrl) - Reparents tile to body, shows spinner during expand animation, renders content after animation; applies file-type accent colour to tile border and outline glow.
60 61 - closeExpandedTilePreview() - Collapses expanded tile preview back to original grid position and restores original icon markup.
61 62 - closePreview() - Closes either expanded-tile preview or overlay preview, then revokes active preview object URL.
63 - closePreview() - Closes expanded-tile preview and revokes active preview object URL.
62 64 - openMovePicker(item) - Opens Move To selector modal with expandable folder tree across all writable roots and executes /api/files/move.
63 65 - ensureMoveModal() - Lazily creates and wires Move To modal UI (tree, selection state, confirm/cancel handlers).
64 66 - createMoveNode(folderPath, label) - Builds an expandable/selectable folder node for the Move To tree.
@@ -46,7 +46,6 @@
46- prettyPrintCode(raw, lang) - Best-effort formatter for JSON/markup/script previews before rendering.
46- prettyPrintCode(raw, lang) - Best-effort formatter for JSON/markup/script previews before rendering.
47- highlightCode(raw, lang) - Escapes and syntax-highlights preview text into HTML spans.
47- highlightCode(raw, lang) - Escapes and syntax-highlights preview text into HTML spans.
48- fileAccentColor(name) - Returns canonical file-type accent color used by icon strokes and preview sheet outline.
48- fileAccentColor(name) - Returns canonical file-type accent color used by icon strokes and preview sheet outline.
49- animatePreviewOpen(sourceSvgEl, sheetEl) - Animates a cloned file icon from its tile position into the full preview sheet.
50- openFolderSidebar() - Persistent sidebar fallback view that shows current folder/root overview when no item is selected.
49- openFolderSidebar() - Persistent sidebar fallback view that shows current folder/root overview when no item is selected.
51- closeSidebar() - Clears selection; hides the panel entirely on mobile and restores folder overview sidebar on desktop.
50- closeSidebar() - Clears selection; hides the panel entirely on mobile and restores folder overview sidebar on desktop.
52- isMobileViewport() - Central media-query helper for mobile-only sidebar/interaction behavior.
51- isMobileViewport() - Central media-query helper for mobile-only sidebar/interaction behavior.
@@ -54,11 +53,14 @@
54- renderBreadcrumb() - Builds clickable breadcrumb path and marks each folder segment as a drag-drop move target via .crumb-drop-target and data-path.
53- renderBreadcrumb() - Builds clickable breadcrumb path and marks each folder segment as a drag-drop move target via .crumb-drop-target and data-path.
55- fetchFileBlob(item) - Downloads a file as Blob with auth headers for preview/download flows.
54- fetchFileBlob(item) - Downloads a file as Blob with auth headers for preview/download flows.
56- downloadOrView(item, sourceSvgEl) - Opens preview; prefers in-place expanded tile preview when invoked from a file icon, falls back to overlay when no source tile is available.
55- downloadOrView(item, sourceSvgEl) - Opens preview; prefers in-place expanded tile preview when invoked from a file icon, falls back to overlay when no source tile is available.
56- downloadOrView(item, sourceSvgEl) - Opens in-place expanded tile preview from a file icon; shows error toast if no source tile is found.
57- renderPreviewBody(item, blob, objectUrl, targetEl) - Renders preview content (image/video/audio/pdf/text) or unsupported message into a target container.
57- renderPreviewBody(item, blob, objectUrl, targetEl) - Renders preview content (image/video/audio/pdf/text) or unsupported message into a target container.
58- animateRect(el, fromRect, toRect, opts) - Helper that animates element rectangle (left/top/width/height) for expand/collapse transitions.
58- animateRect(el, fromRect, toRect, opts) - Helper that animates element rectangle (left/top/width/height) for expand/collapse transitions.
59- openExpandedTilePreview(item, tileEl, sourceSvgEl, blob, objectUrl) - Reparents the real file tile to body, expands it to viewport preview, injects close/download controls.
59- openExpandedTilePreview(item, tileEl, sourceSvgEl, blob, objectUrl) - Reparents the real file tile to body, expands it to viewport preview, injects close/download controls.
60- openExpandedTilePreview(item, tileEl, sourceSvgEl, blob, objectUrl) - Reparents tile to body, shows spinner during expand animation, renders content after animation; applies file-type accent colour to tile border and outline glow.
60- closeExpandedTilePreview() - Collapses expanded tile preview back to original grid position and restores original icon markup.
61- closeExpandedTilePreview() - Collapses expanded tile preview back to original grid position and restores original icon markup.
61- closePreview() - Closes either expanded-tile preview or overlay preview, then revokes active preview object URL.
62- closePreview() - Closes either expanded-tile preview or overlay preview, then revokes active preview object URL.
63- closePreview() - Closes expanded-tile preview and revokes active preview object URL.
62- openMovePicker(item) - Opens Move To selector modal with expandable folder tree across all writable roots and executes /api/files/move.
64- openMovePicker(item) - Opens Move To selector modal with expandable folder tree across all writable roots and executes /api/files/move.
63- ensureMoveModal() - Lazily creates and wires Move To modal UI (tree, selection state, confirm/cancel handlers).
65- ensureMoveModal() - Lazily creates and wires Move To modal UI (tree, selection state, confirm/cancel handlers).
64- createMoveNode(folderPath, label) - Builds an expandable/selectable folder node for the Move To tree.
66- createMoveNode(folderPath, label) - Builds an expandable/selectable folder node for the Move To tree.