The OSINT investigator's workbench. One case, one folder, every tool. Local-first: your media and your investigations never leave your machine.
JavaScript
import { describe, expect, it } from 'vitest';
import { readFileSync } from 'node:fs';
const source = readFileSync(new URL('./Files.svelte', import.meta.url), 'utf8');
describe('Files bounded loading', () => {
it('loads a bounded first page, not the whole catalog on open', () => {
expect(source).toContain('createPagedList');
expect(source).toContain("status: 'confirmed'");
expect(source).toContain('limit: PAGE');
// the complete-folder fetch is for an open folder (or a List search), not case open
expect(source).toContain("searching ? view === 'list' : Boolean(cwd) || showUnfiled");
});
it('opens a folder on all its files in every view, not its share of the first page', () => {
// A folder of six whose rows sat past the case's first 200 opened in the grid
// on two, under a case-wide "Show more". The grids load the folder too, wait
// for it before saying "empty", and drop the case-wide Show more meanwhile.
expect(source).not.toContain("view === 'list' && !filtering");
expect(source).toContain('{#each completeFolderLoading ? [] : curEntities as e (e.id)}\n <div\n class="tile entity"');
expect(source).toContain('class="list-status grid-status" role="status">Loading all files in this folder');
expect(source.match(/\{#if !completeFolderLoading && !curFolders\.length/g)).toHaveLength(2);
expect(source).toContain('pl.hasMore && completeFolderEntities === null && !completeFolderLoading}');
});
it('offers Show more with an honest filtered total', () => {
expect(source).toContain('{:else if !showTrash && !filtering && pl.hasMore');
expect(source).toContain('pl.loadMore()');
expect(source).toContain('Showing {confirmed.length} of {total}');
expect(source).toContain('/catalog/summary');
expect(source).toContain('searching && pl.serverMode ? pl.total');
});
it('clears the previous case before loading the next', () => {
expect(source).toContain('pl.clear()');
});
it('searches every page and descendant folder through the catalog endpoint', () => {
expect(source).toContain('pl.setQuery(query)');
expect(source).toContain('query: serverQuery');
expect(source).toContain('recursive: Boolean(serverQuery && cwd)');
});
it('loads metadata only for paths the view can render', () => {
expect(source).toContain('/media/metadata');
expect(source).toContain('unique.slice(i, i + 500)');
expect(source).not.toContain(`/satellite\``);
expect(source).not.toContain(`/media\``);
expect(source).toContain('if (caseState.current?.id !== id) return');
});
});
describe('Files desktop affordances', () => {
it('uses the shared SearchInput and a sort control', () => {
expect(source).toContain("import SearchInput from '../components/SearchInput.svelte'");
expect(source).toContain('onSortSelect');
expect(source).toContain('sortEntities(');
});
it('searches through the one predicate the server index is mirrored in', () => {
// Notes, folder and the declared fields all ride on that shared helper, so this
// tool cannot drift from the board or from `search_text`.
expect(source).toContain("import { matchesEntity } from '../lib/entitySearch.js'");
expect(source).toContain('matchesEntity(e, query)');
});
it('keeps the sort control compact instead of stretching to full width', () => {
// the global .select is width:100%; the header control must override it or
// it balloons across the toolbar (reported "the sort bar is enormous")
const block = source.slice(
source.indexOf('.sort-select {'),
source.indexOf('}', source.indexOf('.sort-select {'))
);
expect(block).toContain('width: auto');
expect(block).toContain('flex-shrink: 0');
});
it('offers three view modes: small, large, and a details list', () => {
expect(source).toContain("let view = $state(loadViewMode('files', 'small'))");
expect(source).toContain("{ id: 'small', label: 'Small'");
expect(source).toContain("{ id: 'large', label: 'Large'");
expect(source).toContain("{ id: 'list', label: 'List'");
expect(source).toContain('const dense = $derived(');
});
it('remembers the view it was left on', () => {
expect(source).toContain("saveViewMode('files', next)");
expect(source).toContain('onclick={() => setView(v.id)}');
expect(source).not.toContain('onclick={() => (view = v.id)}');
});
it('opens a picture, video or sound full screen on a double press, and Details stays one press away', () => {
expect(source).toMatch(/function openEntityTile\(entity\) \{\s+if \(viewerItems\.some\(\(item\) => item\.key === entity\.id\)\) \{\s+viewingId = entity\.id;/);
expect(source).toContain('viewerItem(e, tileThumb(e))');
expect(source).toContain('onclick={(ev) => { ev.stopPropagation(); infoEntityId = e.id; }}');
expect(source).toContain('ctxRun((held) => (infoEntityId = held.one.id))');
});
it('opens the picked file on Space, out of the way of fields, buttons and dialogs', () => {
const at = source.indexOf("if (event.key === ' '");
const block = source.slice(at, source.indexOf('return;\n }', at));
expect(block).toContain("uiState.tool === 'files'");
expect(block).toContain('!renaming');
expect(block).toContain('!anyOverlayOpen()');
expect(block).toContain("closest('button, a, input, textarea, select, [contenteditable]')");
expect(block).toContain('spaceTarget(selected, anchor)');
expect(block).toContain('event.preventDefault()');
});
it('leaves the keys to the viewer while it is open, and lets the selection follow it', () => {
expect(source).toContain('if (viewing) return; // the viewer hears its own keys');
expect(source).toMatch(/function viewFile\(id\) \{\s+viewingId = id;\s+selected = \[id\];\s+anchor = id;/);
expect(source).toContain('const id = viewing ?? infoEntityId');
});
it('renders the list view with Name/Type/Size/Added columns', () => {
expect(source).toContain("{:else if view === 'list'}");
expect(source).toContain("{ id: 'name', label: 'Name' }");
expect(source).toContain("{ id: 'type', label: 'Type' }");
expect(source).toContain("{ id: 'size', label: 'Size' }");
expect(source).toContain("{ id: 'recent', label: 'Added' }");
// size comes from the media shelf, added from provenance
expect(source).toContain('fmtSize(tileSize(e))');
expect(source).toContain('fmtAdded(e)');
});
it('sorts from clickable headers and loads the complete open folder', () => {
expect(source).toContain('setHeaderSort(column.id)');
expect(source).toContain('sortDirection');
expect(source).toContain('fetchAllEntities(id');
expect(source).toContain("{ folder }");
expect(source).toContain('{ unfiled: true }');
expect(source).toContain('Loading all files in this folder');
});
it('carries the same selection/drag wiring onto list rows', () => {
// list rows must be selectable, draggable and openable like the tiles
expect(source).toContain('class="lrow entity"');
expect(source).toContain('onclick={(ev) => onTileClick(ev, e.id)}');
expect(source).toContain('ondragstart={(ev) => onTileDragStart(ev, e.id)}');
});
it('previews rendered proof PNGs in both tiles and list rows', () => {
expect(source).toContain("e.type === 'proof' && typeof path === 'string' && /\\.png$/i.test(path)");
expect(source).toContain('class="lrow-thumb"');
expect(source).toContain('src={fileUrl(caseState.current.id, tileThumb(e))}');
expect(source).toContain('{#if tileThumb(e)}');
});
});
describe('Files trash', () => {
it('shows the trash as a first-class Files location', () => {
expect(source).toContain('onclick={openTrash}');
expect(source).toContain('<span class="tname">Trash</span>');
expect(source).toContain('{#if showTrash}');
expect(source).toContain('{formatSize(trashData.size_bytes)}');
});
it('offers the same restore and permanent actions as the sidebar', () => {
expect(source).toContain('restoreGroup(caseState.current.id, group.id)');
expect(source).toContain('purgeGroup(caseState.current.id, group.id)');
expect(source).toContain('emptyTrash(caseState.current.id)');
expect(source).toContain('onclick={() => restoreTrashItem(group)}');
expect(source).toContain('onclick={() => askPurgeTrashItem(group)}');
expect(source).toContain('onclick={askEmptyFilesTrash}');
});
it('keeps permanent deletion behind the danger confirmation', () => {
expect(source).toContain("title: 'Delete permanently?'");
expect(source).toContain("title: 'Empty the trash?'");
expect(source).toContain("detail: 'The files will be deleted from disk.'");
expect(source).toContain("tone: 'danger'");
});
});
describe('Files delete shortcut', () => {
it('routes Delete through the existing grouped confirmation', () => {
expect(source).toContain('<svelte:window onkeydown={onFilesKeydown} />');
expect(source).toContain("event.key !== 'Delete'");
expect(source).toContain('askDeleteEntities([...selected])');
expect(source).toContain('event.preventDefault()');
});
it('does nothing in fields, Trash, or outside Files', () => {
expect(source).toContain("uiState.tool !== 'files'");
expect(source).toContain('showTrash');
expect(source).toContain("target.matches('input, textarea, select')");
expect(source).toContain('target.isContentEditable');
});
});
describe('Ctrl+V on the desktop', () => {
it('gives Files the only way it has ever had to take a file', () => {
// its drag and drop moves items between folders, so an image had to go through
// the Media grid and be filed afterwards
expect(source).toContain("import { listenForPaste, pasteImage, resolvePaste } from '../lib/clipboardPaste.js'");
expect(source).toContain("import PasteDialog from '../components/PasteDialog.svelte'");
expect(source).toContain("resolvePaste('files', payload,");
});
it('only answers while it is the tool on screen', () => {
expect(source).toMatch(/uiState\.tool !== 'files'\) return;\s*return listenForPaste/);
});
it('opens on the folder being looked at, like the New bookmark button does', () => {
expect(source).toContain("{ folder: showUnfiled ? '' : cwd }");
});
it('files the image where the dialog said, and takes a link as a bookmark', () => {
expect(source).toContain("await assignFolder(caseId, result.entity, values.folder ?? '')");
expect(source).toContain('await createBookmark(caseId, { ...values, url: payload.url })');
});
it('shows the folder it landed in, so nothing is filed out of sight', () => {
expect(source).toContain('function revealFiled(folder)');
expect(source).toContain('if (folder) openFolder(folder);');
expect(source).toContain('else openUnfiled();');
});
it('leaves a duplicate where it already sits', () => {
// refiling it under this paste's folder would move an item filed on purpose
expect(source).toContain('if (!result.duplicate && (values.folder');
});
it('moves a new image out of the work folder when the dialog named another', () => {
// registration filed it in the work folder; "Unfiled" has to be applied too
expect(source).toContain("(values.folder ?? '') !== (folderOf(result.entity) ?? '')");
});
it('offers the folder picker the same tree every other dialog here gets', () => {
expect(source).toMatch(/<PasteDialog[^>]*folders=\{allFolders\}/s);
});
});
describe('Files — acting on what the view actually shows', () => {
it('resolves a selection against the complete folder, not the first page', () => {
// List view renders `completeFolderEntities` (the whole open folder) while
// move and delete filtered `confirmed` (the first 200 rows case-wide), so
// any row past page one silently no-opped.
expect(source).toContain('const selectable = $derived(');
expect(source).toContain('const ents = selectable.filter((e) => ids.includes(e.id));');
expect(source).not.toContain('const ents = confirmed.filter((e) => ids.includes(e.id));');
});
});
describe('Files offers what is open to the Add event bar', () => {
it('publishes under its own tool id and withdraws on unmount', () => {
expect(source).toMatch(/offerNote\(\s*'files',/);
expect(source).toContain("onDestroy(() => withdrawNote('files'))");
});
});
describe('Files counts folders across the whole case', () => {
it('reads folder counts from the summary, not the loaded page', () => {
// accepted rows only, as Files lists them: a suggestion is counted under review
expect(source).toContain('summary?.confirmed?.by_folder');
expect(source).toContain('subtreeCountFrom(node, filedCounts)');
expect(source).toContain('{countOf(node)}');
expect(source).not.toContain('{subtreeCount(node)}');
expect(source).toContain('summary?.by_status?.confirmed ?? confirmed.length');
});
it('counts Unfiled across the whole case, not the loaded page', () => {
expect(source).toContain('summary?.confirmed?.unfiled ?? unfiled.length');
expect(source).toContain('<span class="tcount">{unfiledTotal}</span>');
expect(source).not.toContain('{unfiled.length} item');
});
it('removes a folder through the server, which unfiles items past the first page too', () => {
expect(source).toContain('...removeFolderPrompt(path, allFolders)');
expect(source).toContain('await removeFolder(caseState.current.id, path)');
expect(source).not.toContain("assignFolderBatch(caseState.current.id, inside, '')");
});
});
describe('Files right-click', () => {
const menu = source.slice(source.indexOf('<!-- right-click menu'), source.indexOf('<!-- delete confirmation'));
it('offers an item what Details and the Media Library offer it', () => {
expect(menu).toContain('openEntity(held.one)');
expect(menu).toContain('{#each ctxOpenIn as option (option.id)}');
expect(menu).toContain("startRename({ kind: 'entity', entity: ctxOne })");
expect(menu).toContain('moveTo(held.entities)');
expect(menu).toContain('addEvent(held.one)');
expect(menu).toContain('openInTimeline(held.one)');
expect(menu).toContain('showInFolder(held.one)');
expect(menu).toContain('askDeleteEntities(held.ids)');
});
it('takes a picture or a video to the same tools as the Media Library', () => {
expect(source).toContain("import { openInOptions } from '../lib/openIn.js'");
expect(source).toContain('openInOptions({ path: ctxOne.attrs.path, kind: mediaKindOf(ctxOne), label: ctxOne.label })');
});
it('reads what the menu was opened on before closing it', () => {
// ctxOne and ctxEntities follow ctx, so after `ctx = null` they are empty and
// every action did nothing (the browser spec caught Move to… opening nothing)
expect(source).toContain('const held = { ...ctx, entities: ctxEntities, one: ctxOne };');
expect(menu.replace('ctxRun(() => option.run())', '')).not.toMatch(/ctxRun\(\(\) =>/);
});
it('makes a folder out of the selection', () => {
expect(menu).toContain('ctxNewFolder(ctx.ids)');
expect(source).toContain('await assignFolderBatch(caseState.current.id, ents, path)');
});
it('offers a folder rename, import, the work folder and removal', () => {
expect(menu).toContain("startRename({ kind: 'folder', path: ctx.parent, inTree: ctx.inTree })");
expect(menu).toContain('pickImport(held.parent)');
expect(menu).toContain('toggleWorkFolder(held.parent)');
expect(menu).toContain('askDeleteFolder(held.parent)');
});
it('keeps the menu inside the window and closes it on Escape', () => {
expect(source).toContain('window.innerWidth - MENU_W - 8');
expect(source).toContain("if (event.key === 'Escape' && ctx)");
});
});
describe('Files rename', () => {
it('renames in place, from F2 or the menu', () => {
expect(source).toContain("event.key === 'F2'");
expect(source).toContain('{@render renameField()}');
expect(source).toContain('onblur={commitRename}');
});
it('opens one field per rename, where it was asked for', () => {
// a folder shows in the tree rail and as a tile; two fields took focus from
// each other and the blur kept the old name
expect(source).toContain("renaming?.kind === 'folder' && renaming.inTree && renaming.path === node.path");
expect(source).toContain("renaming?.kind === 'folder' && !renaming.inTree && renaming.path === node.path");
});
it('keeps the keys typed in the field away from the tile and the window', () => {
// Enter on the tile opens the folder, and F2 / Delete act on the selection
expect(source).toMatch(/function onRenameKey\(event\) \{[^}]*event\.stopPropagation\(\);/);
});
it('renames an item through the route Details uses, and a folder with its subtree', () => {
expect(source).toContain('await renameEntity(caseId, entity, r.value)');
expect(source).toContain('const target = renamedPath(r.path, r.value)');
expect(source).toContain('await renameFolder(caseId, r.path, target)');
// the open folder follows its own rename
expect(source).toContain('if (inSubtree(cwd, r.path)) cwd = target + cwd.slice(r.path.length)');
});
});
describe('Files filters', () => {
it('narrows by type and by what nothing points at, on the server past one page', () => {
expect(source).toContain('types: typeFilter ? [typeFilter] : null');
expect(source).toContain('unlinked: unlinkedOnly');
expect(source).toContain('const chips = $derived(typeChips(summary?.confirmed))');
expect(source).toContain('Nothing linked yet');
});
it('asks the open folder and what is under it', () => {
expect(source).toContain('folder: !showUnfiled && cwd ? cwd : undefined');
expect(source).toContain('recursive: Boolean(!showUnfiled && cwd)');
});
it('shows a flat result list while filtering, as a search does', () => {
expect(source).toContain('const narrowed = $derived(searching || filtering)');
expect(source).toContain('const curFolders = $derived(narrowed ? [] : sortFolders(current.children))');
});
});
describe('Files and the work folder', () => {
it('opens a case on its work folder', () => {
expect(source).toContain("cwd = caseState.current?.work_folder ?? ''");
});
it('marks the work folder and toggles it from the crumbs', () => {
expect(source).toContain('class="work-toggle"');
expect(source).toContain('toggleWorkFolder(cwd)');
expect(source).toContain('await setWorkFolder(caseState.current.id, working === path ? null : path)');
});
it('starts the new note and bookmark dialogs on it', () => {
expect(source).toMatch(/<FolderSelect bind:value=\{noteModal\.folder\}[^>]*fresh/);
expect(source).toMatch(/<FolderSelect bind:value=\{bookmarkModal\.folder\}[^>]*fresh/);
});
it('files an import where it was asked for, past the work folder', () => {
expect(source).toContain('uploadFiles(caseId, files, sourceUrl)');
expect(source).toContain("const astray = filed.filter((e) => (folderOf(e) ?? '') !== folder)");
});
});