feat(01-02): export and serve validated local media pairs
This commit is contained in:
1 parent
488c904807
commit
49f874e64c
6 files changed
+465
-3
No files matched your search
@@ -0,0 +1,112 @@
|
||||
// Native media, independent clocks. No follower seek or rate-based correction.
|
||||
export function safeLocalURL(value) {
|
||||
if (typeof value !== 'string' || value.length > 4096 || !value) throw Error('Missing local link');
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (/[\\:?#<>"\u0000-\u0020]/.test(decoded) || decoded.startsWith('/') ||
|
||||
decoded.split('/').some(p => !p || p === '.' || p === '..')) throw Error('Unsafe local link');
|
||||
return value;
|
||||
}
|
||||
|
||||
export function createPairController({original, port, onChange = () => {}}) {
|
||||
const media = {original, port};
|
||||
let problem = '', selected = null;
|
||||
const snapshot = () => ({problem, selected});
|
||||
const notify = () => onChange(snapshot());
|
||||
const pause = () => { for (const m of Object.values(media)) if (m) m.pause(); notify(); };
|
||||
const fail = message => { problem = message; pause(); };
|
||||
for (const [side, m] of Object.entries(media)) {
|
||||
if (!m) continue;
|
||||
m.muted = true;
|
||||
m.playbackRate = 1;
|
||||
m.addEventListener('waiting', () => fail(side + ' buffering'));
|
||||
m.addEventListener('error', () => fail(side + ' decoding/media error'));
|
||||
}
|
||||
async function selectEvent(event) {
|
||||
pause();
|
||||
for (const side of ['original', 'port']) {
|
||||
const m = media[side], marker = event?.[side];
|
||||
if (!m || !marker || !Number.isFinite(marker.media_seconds) || marker.media_seconds < 0 ||
|
||||
marker.media_seconds > m.duration) throw Error('Missing or out-of-range corresponding event');
|
||||
}
|
||||
for (const side of ['original', 'port']) {
|
||||
media[side].playbackRate = 1;
|
||||
media[side].currentTime = event[side].media_seconds;
|
||||
}
|
||||
selected = event; problem = ''; notify();
|
||||
}
|
||||
async function play() {
|
||||
if (!original || !port) { fail('Missing recording'); return false; }
|
||||
try {
|
||||
for (const m of Object.values(media)) m.playbackRate = 1;
|
||||
const results = await Promise.allSettled(Object.values(media).map(m => m.play()));
|
||||
const rejected = results.find(r => r.status === 'rejected');
|
||||
if (rejected) throw rejected.reason;
|
||||
problem = ''; notify(); return true;
|
||||
} catch (error) { fail('Play rejected: ' + error.message); return false; }
|
||||
}
|
||||
return {selectEvent, play, pause, snapshot};
|
||||
}
|
||||
|
||||
function element(doc, tag, text) { const node = doc.createElement(tag); node.textContent = text; return node; }
|
||||
|
||||
export function renderCapabilities(container, ledger) {
|
||||
const doc = container.ownerDocument;
|
||||
container.replaceChildren(element(doc, 'h2', 'Capability evidence'));
|
||||
const rows = ledger?.capabilities ?? [];
|
||||
if (!rows.length) { container.append(element(doc, 'p', 'No capability ledger supplied. Acceptance remains open.')); return; }
|
||||
for (const row of rows) {
|
||||
const article = doc.createElement('article');
|
||||
article.append(element(doc, 'h3', row.group + ' · ' + row.id), element(doc, 'p', row.summary),
|
||||
element(doc, 'p', 'Requirements: ' + row.requirement_ids.join(', ')),
|
||||
element(doc, 'p', 'Verified scope: ' + JSON.stringify(row.verified_scope)),
|
||||
element(doc, 'p', 'Differences: ' + JSON.stringify(row.differences)),
|
||||
element(doc, 'p', 'Acceptance: ' + JSON.stringify(row.acceptance)),
|
||||
element(doc, 'p', 'Current evidence: ' + JSON.stringify(row.current)),
|
||||
element(doc, 'p', 'Scenarios: ' + row.scenario_ids.join(', ')),
|
||||
element(doc, 'p', 'Source references: ' + JSON.stringify(row.source_links)));
|
||||
const history = doc.createElement('details');
|
||||
history.append(element(doc, 'summary', 'History / superseded evidence'), element(doc, 'p', JSON.stringify(row.history)));
|
||||
article.append(history); container.append(article);
|
||||
}
|
||||
}
|
||||
|
||||
async function mount() {
|
||||
const doc = document;
|
||||
try {
|
||||
const response = await fetch('review.json');
|
||||
if (!response.ok) throw Error('Review JSON unavailable');
|
||||
const model = await response.json();
|
||||
doc.querySelector('#scope').textContent = 'Case: ' + model.case_id;
|
||||
const media = {};
|
||||
for (const side of ['original', 'port']) {
|
||||
const data = model.sides[side], panel = doc.querySelector('#' + side + '-panel');
|
||||
const m = doc.querySelector('#' + side);
|
||||
media[side] = data.media ? m : null;
|
||||
if (data.media) m.src = safeLocalURL(data.media.url);
|
||||
panel.querySelector('.missing').textContent = data.missing;
|
||||
panel.querySelector('.classification').textContent = [data.evidence_kind ?? 'missing',
|
||||
JSON.stringify(data.platform ?? {}), data.scope ?? '', data.historical ? 'HISTORICAL' : '',
|
||||
...(data.limitations ?? [])].join(' · ');
|
||||
for (const artifact of data.artifacts) {
|
||||
const a = element(doc, 'a', artifact.role + ' · ' + artifact.path);
|
||||
a.href = safeLocalURL(artifact.url); a.target = '_blank'; a.rel = 'noopener';
|
||||
panel.querySelector('.links').append(a);
|
||||
}
|
||||
}
|
||||
const controller = createPairController({...media, onChange: state => {
|
||||
doc.querySelector('#state').textContent = state.problem || 'Paused or playing at actual recording speed';
|
||||
}});
|
||||
const events = doc.querySelector('#events');
|
||||
model.events.forEach((event, i) => { const option = element(doc, 'option', event.name +
|
||||
(!event.original || !event.port ? ' · missing correspondence' : '')); option.value = String(i); events.append(option); });
|
||||
events.addEventListener('change', async () => {
|
||||
if (events.value === '') return;
|
||||
try { await controller.selectEvent(model.events[Number(events.value)]); }
|
||||
catch (error) { doc.querySelector('#state').textContent = error.message; }
|
||||
});
|
||||
doc.querySelector('#play').addEventListener('click', () => controller.play());
|
||||
doc.querySelector('#pause').addEventListener('click', controller.pause);
|
||||
renderCapabilities(doc.querySelector('#capabilities'), model.ledger);
|
||||
} catch (error) { doc.querySelector('#scope').textContent = 'Review unavailable: ' + error.message; }
|
||||
}
|
||||
if (typeof document !== 'undefined') mount();
|
||||
Reference in new issue
Block a user