Vito
ecd21165a7
* feat(history): add bounded chronological read projections (#209) * fix(history): validate internal continuation positions (#209) * feat(history): expose fenced history windows and run details (#209) * fix(history): release retired projection connections (#209) * feat(history): resolve reported outputs through current authorization (#209) * fix(history): reject invalid inspection targets (#209) * feat(history): add scoped history state and current-file adapter (#209) * fix(history): preserve slideshow and clear stale reentry actions (#209) * feat(history): render recorded executions and frozen run details (#209) * fix(history): recover receipts and refresh capture evidence (#209) * test(history): verify chronological history across restore and host modes (#209) * fix(history): enforce chronological marker visual parity (#209) * fix(history): resolve final chronological review findings Address #209 recovery, bounded visit restoration, exact receipt availability, and portable regression coverage. * test(history): repair Windows fixtures and review feedback Address #209 and PR #227 native path, cleanup, media and review-comment expectations. Document Windows portability preflight without changing production behavior. * ci: raise the viewerjs job budget for the larger browser suite The cross-browser workflows suite grew from 396 to 496 tests on this branch, which pushed the whole viewerjs job to about 25.5 minutes against the 25 minute cap set in #181. Two exact-head runs on this branch timed out without any test failing: run 39173019283 was killed on test 474 of 496, and run 39175125474 printed "496 passed (12.8m)" and was then cancelled during Playwright shutdown. Raise only the job budget. Browser projects, workers and per-test timeouts are unchanged. Splitting the browsers into parallel jobs is tracked separately.
73 lines
3.5 KiB
JavaScript
73 lines
3.5 KiB
JavaScript
import {rootedFileAdapter} from './inspection-state.mjs';
|
|
|
|
/** A viewer visits only the descriptors loaded by its opening query. */
|
|
export function createViewerSession({items, initialKey, onChange = () => {}, setTimer = setTimeout, clearTimer = clearTimeout, adapter = rootedFileAdapter}) {
|
|
if (!Array.isArray(items) || !items.length) throw new TypeError('A loaded media collection is required');
|
|
const keys = new Set();
|
|
const loaded = Object.freeze(items.map(item => {
|
|
adapter.validate(item);
|
|
const key = adapter.key(item);
|
|
if (keys.has(key)) throw new TypeError('Duplicate viewer identity');
|
|
keys.add(key);
|
|
return Object.freeze({...item, ...(adapter !== rootedFileAdapter && item.occurrence ? {occurrence:Object.freeze({...item.occurrence}), reference:Object.freeze({...item.reference})} : {})});
|
|
}));
|
|
const index = loaded.findIndex(item => adapter.key(item) === initialKey);
|
|
if (index < 0) throw new TypeError('Selected media is not loaded');
|
|
let state = Object.freeze({key:initialKey,index,total:loaded.length,phase:'stopped',requested:false,mediaReady:false});
|
|
let timer = null, deadline = 0;
|
|
function cancel() {
|
|
deadline++;
|
|
if (timer !== null) clearTimer(timer);
|
|
timer = null;
|
|
}
|
|
function publish(update) {
|
|
state = Object.freeze({...state,...update});
|
|
onChange(state, loaded[state.index]);
|
|
}
|
|
function phase(ready = state.mediaReady) {
|
|
return !state.requested ? 'stopped' : loaded[state.index].is_video ? 'paused-video' : ready ? 'playing-image' : 'waiting-image';
|
|
}
|
|
function schedule() {
|
|
if (state.phase !== 'playing-image' || timer !== null) return;
|
|
const key = state.key, token = ++deadline;
|
|
timer = setTimer(() => {
|
|
if (token !== deadline || state.phase !== 'playing-image' || !state.requested || state.key !== key) return;
|
|
timer = null;navigate(1);
|
|
},3500);
|
|
}
|
|
function navigate(direction) {
|
|
if (state.phase === 'disposed') return;
|
|
if (direction !== -1 && direction !== 1) throw new TypeError('Viewer direction must be -1 or 1');
|
|
if (loaded.length === 1) return;
|
|
cancel();
|
|
const next = (state.index + direction + loaded.length) % loaded.length;
|
|
publish({index:next,key:adapter.key(loaded[next]),phase:state.requested ? loaded[next].is_video ? 'paused-video' : 'waiting-image' : 'stopped',mediaReady:false});
|
|
}
|
|
publish({});
|
|
return {
|
|
get state() { return state; },
|
|
navigate,
|
|
play() {
|
|
if (state.phase === 'disposed' || state.phase === 'error' || state.requested || loaded.length < 2 || loaded[state.index].is_video) return;
|
|
publish({requested:true,phase:state.mediaReady ? 'playing-image' : 'waiting-image'});
|
|
schedule();
|
|
},
|
|
stop() {
|
|
if (state.phase === 'disposed') return;
|
|
cancel();publish({requested:false,phase:state.phase === 'error' ? 'error' : 'stopped'});
|
|
},
|
|
ready(key) {
|
|
if (state.phase === 'disposed' || key !== state.key || state.mediaReady) return;
|
|
publish({mediaReady:true,phase:phase(true)});schedule();
|
|
},
|
|
failed(key) {
|
|
if (state.phase === 'disposed' || key !== state.key) return;
|
|
cancel();publish({mediaReady:false,phase:'error',requested:false});
|
|
},
|
|
dispose() {
|
|
if (state.phase === 'disposed') return;
|
|
cancel();publish({phase:'disposed',requested:false,mediaReady:false});
|
|
},
|
|
};
|
|
}
|