feat(ui): render the rail timeline as a component behind its builder

The observed-history transport is RailTimeline in src/ui/rail/, rendered
by createRailTimeline() with the same update and destroy API. Drag preview,
the coalesced 150 ms commit, release, cancel and blur behave as before; the
slider keeps the ticks it is dragged over, an update from inside a preview
cannot move the handle back, and readouts follow the handle within the same
task. utcClock moves to its own module and is still exported here.
This commit is contained in:
Sameh Khamis committed 2026-10-30 18:41:31 -07:00
1 parent dcecf5c34c
commit ce6040bde1
7 files changed
+264 -206

No files matched your search

+44 -11
View File
@@ -1,7 +1,9 @@
import '../testSupport/registerDom.mjs';
import test from 'node:test';
import assert from 'node:assert/strict';
import { nextTick } from 'vue';
import { createRailTimeline } from './railTimeline.js';
import { railFixture } from './railTestFixture.mjs';
import { railDocumentFixture as railFixture } from './railTestFixture.mjs';
const ticks = [
'2026-09-22T01:00:00Z',
'2026-09-22T01:05:00Z',
@@ -15,7 +17,7 @@ const props = {
readout: 'Latest',
disabled: false,
};
test('preview is immediate, commits are coalesced and the drag DOM and tick mapping stay stable', (t) => {
test('preview is immediate, commits are coalesced and the drag DOM and tick mapping stay stable', async (t) => {
t.mock.timers.enable({ apis: ['setTimeout'] });
const f = railFixture();
const previews = [];
@@ -30,12 +32,13 @@ test('preview is immediate, commits are coalesced and the drag DOM and tick mapp
});
view.update(props);
const slider = f.find((n) => n.tagName === 'INPUT');
const row = slider.parent;
const row = slider.parentElement;
assert.equal(slider.getAttribute('aria-label'), 'Observed history');
slider.value = '0';
slider.dispatchEvent(new Event('input'));
assert.deepEqual(commits, []);
assert.deepEqual(previews, [ticks[0]]);
await nextTick();
assert.equal(slider.getAttribute('aria-valuetext'), '09-22 01:00 UTC');
view.update({
...props,
@@ -43,7 +46,7 @@ test('preview is immediate, commits are coalesced and the drag DOM and tick mapp
index: 1,
readout: 'Refresh',
});
assert.equal(slider.parent, row);
assert.equal(slider.parentElement, row);
assert.equal(row.children[1], slider);
assert.equal(slider.value, '0');
assert.equal(slider.max, '2');
@@ -63,13 +66,13 @@ test('preview is immediate, commits are coalesced and the drag DOM and tick mapp
assert.deepEqual(commits, [ticks[1], ticks[2]]);
t.mock.timers.tick(150);
assert.equal(commits.length, 2);
assert.equal(slider.max, '1');
await nextTick();
assert.equal(slider.max, '1', 'release applies the latest update');
view.destroy();
});
test('identical updates write nothing; controls call actions and destruction cancels commits', (t) => {
t.mock.timers.enable({ apis: ['setTimeout'] });
let writes = 0;
const f = railFixture(() => writes++);
const f = railFixture();
const calls = [];
const view = createRailTimeline({
...f,
@@ -79,9 +82,9 @@ test('identical updates write nothing; controls call actions and destruction can
onPlay: () => calls.push('play'),
});
view.update({ ...props, index: 1 });
writes = 0;
f.writes();
view.update({ ...props, index: 1 });
assert.equal(writes, 0);
assert.equal(f.writes(), 0);
for (const label of ['‹', '›', 'Latest', 'Play'])
f.find((n) => n.textContent === label).click();
assert.deepEqual(calls, [-1, 1, 'latest', 'play']);
@@ -107,12 +110,42 @@ test('observed history label and endpoint times track the advertised tick range'
'Observed history',
);
const endpoints = f.find((n) => n.className === 'rail-timeline-endpoints');
assert.equal(endpoints.parent.className, 'rail-timeline-track');
assert.equal(endpoints.parentElement.className, 'rail-timeline-track');
assert.deepEqual(
endpoints.children.map((n) => n.textContent),
[...endpoints.children].map((n) => n.textContent),
['01:00 UTC', '01:10 UTC'],
);
view.update({ ...props, ticks: ticks.slice(1) });
assert.equal(endpoints.children[0].textContent, '01:05 UTC');
view.destroy();
});
test('an update from inside the preview neither moves the handle back nor survives a disable', async () => {
const f = railFixture();
let view;
let next = null;
const commits = [];
view = createRailTimeline({
...f,
onPreview: () => {
if (next) view.update(next);
return 'preview';
},
onCommit: (tick, index) => commits.push(index),
});
view.update(props);
const slider = f.find((n) => n.tagName === 'INPUT');
next = { ...props, readout: 'Refresh' };
slider.value = '0';
slider.dispatchEvent(new Event('input'));
assert.equal(slider.value, '0');
slider.dispatchEvent(new Event('change'));
assert.deepEqual(commits, [0]);
next = { ...props, disabled: true };
slider.value = '1';
slider.dispatchEvent(new Event('input'));
await nextTick();
assert.equal(slider.value, '2', 'the disabled owner keeps its position');
assert.equal(slider.getAttribute('aria-valuetext'), '09-22 01:10 UTC');
view.destroy();
});