"""Synthetic playback-contract checks; fixture timings are not book defaults.""" from playwright.sync_api import sync_playwright from pathlib import Path base=Path(__file__).resolve().parents[3] / 'books/_extensions/mlsysbook-ext/figure-explore' with sync_playwright() as p: for engine in [p.chromium,p.webkit]: browser=engine.launch() for width,theme in [(1440,'light'),(390,'dark')]: page=browser.new_page(viewport={'width':width,'height':1000}) errors=[] page.on('pageerror',lambda error:errors.append(str(error))) page.set_content('
') page.add_style_tag(path=str(base/'original-player.css')) page.add_script_tag(path=str(base/'original-player.js')) page.evaluate('''theme=>{document.body.classList.toggle('dark',theme==='dark');const root=document.querySelector('#root');const outer=document.querySelector('#outer');window.player=MLSysOriginalPlayer.create({root,outer,layout:'classic',title:'Values moving through a diagram',scope:'Illustrative contributions; motion does not represent measured latency.',steps:[{label:'Ready',description:'The value remains at the source.'},{label:'Read',description:'Read the source value.'},{label:'Compute',description:'The compute stage receives the value.'},{label:'Write',description:'Commit the result to the destination.'}],render(index,{stage,details}){if(!stage.firstChild)stage.innerHTML='';const c=stage.querySelector('circle');c.setAttribute('cx',50+100*index);details.textContent='Committed state: '+index;},transition({from,to,stage,animate,onFrame}){const c=stage.querySelector('circle');animate(c,[{opacity:1},{opacity:.3},{opacity:1}]);onFrame(t=>{c.setAttribute('cx',50+100*(from+(to-from)*t));root.dataset.progress=t;});}});}''',theme) page.evaluate('player.next()');page.wait_for_timeout(100);assert page.locator('.mlsys-original-narration').inner_text().startswith('In motion · 2 / 4 · Read');assert page.locator('#root').get_attribute('data-step')=='0';assert page.locator('.mlsys-original-controls button').first.inner_text()=='Pause';page.evaluate('player.pause()');assert page.locator('.mlsys-original-narration').inner_text().startswith('Paused · 2 / 4 · Read') before=page.locator('circle').get_attribute('cx');page.wait_for_timeout(150) assert page.locator('circle').get_attribute('cx')==before assert page.evaluate('player.state.index')==0 page.evaluate('player.play()');page.wait_for_function('player.state.index===3 && !player.state.playing') assert page.evaluate('player.state.phase')=='idle' page.evaluate('player.go(1)');assert page.locator('circle').get_attribute('cx')=='150' page.evaluate('player.next()');page.wait_for_timeout(30);page.evaluate('player.next()') assert page.evaluate('player.state.index')==2 page.wait_for_timeout(450);assert page.evaluate('player.state.index')==2 page.locator('#root').focus();page.keyboard.press('p');assert page.evaluate('player.state.index')==1 page.locator('#editing').focus();page.keyboard.press('n');assert page.evaluate('player.state.index')==1 page.evaluate('player.restart()');page.locator('#root').focus();page.keyboard.press('n');page.wait_for_function('player.state.index===1') page.evaluate('player.expand()');assert page.locator('dialog').is_visible() page.keyboard.press('Tab');assert page.evaluate("!!document.activeElement.closest('dialog')") page.screenshot(path=f'/tmp/original-player-{engine.name}-{width}-{theme}.png') page.keyboard.press('Escape');assert page.locator('dialog').count()==0 assert page.locator('#outer #root').count()==1 page.evaluate('player.play()');page.wait_for_timeout(40) page.evaluate("document.querySelector('#outer').hidden=true") page.wait_for_timeout(50);assert not page.evaluate('player.state.playing') x=page.locator('circle').get_attribute('cx');page.wait_for_timeout(100);assert page.locator('circle').get_attribute('cx')==x page.evaluate("document.querySelector('#outer').hidden=false; player.go(2)") page.emulate_media(reduced_motion='reduce');page.evaluate('player.next()');page.wait_for_function('player.state.index===3') assert not page.evaluate('player.state.playing') # Reduced-motion navigation commits atomically, even when a visibility or # explicit pause arrives before the next animation frame. page.evaluate('player.go(0); player.next(); player.pause()') assert page.evaluate('player.state.index===1 && player.state.target===null && player.state.phase==="idle"') page.evaluate('player.play()');page.wait_for_function('player.state.index===3 && !player.state.playing') assert page.evaluate('document.documentElement.scrollWidth<=innerWidth') page.evaluate('player.go(1); player.next()');page.wait_for_timeout(20);page.evaluate('player.back()');assert page.evaluate('player.state.index')==1;page.evaluate('player.expand(); player.play()');page.wait_for_timeout(30);page.evaluate('player.destroy()');page.wait_for_timeout(400);assert page.locator('#root').text_content()=='';assert page.locator('dialog').count()==0 assert not errors,errors print(engine.name,width,theme,'PASS') browser.close() # --------------------------------------------------------------------------- # Opt-in compact layout (layout:'compact'). The default-layout checks above are # unchanged; everything below covers only the opt-in path. # --------------------------------------------------------------------------- import re, sys, json # Intro lint (2026-10-29, compact pilot round two): one imperative sentence of at # most 30 words, no contractions, no second person, and every number it states # must appear in that figure's step menu, step labels, or committed narration. INTRO_MAX_WORDS = 30 _CONTRACTION = re.compile(r"\b\w+(?:n['’]t|['’](?:ll|re|ve|d|m))\b|\b(?:it|that|what|there|here|let|who|he|she)['’]s\b", re.I) _YOU = re.compile(r"\byou(?:r|rs|rself|selves)?\b|\byou['’]\w+", re.I) _NUM = re.compile(r"(? INTRO_MAX_WORDS: problems.append(f'{len(words)} words > {INTRO_MAX_WORDS}') if not intro.endswith('.') or re.search(r'[.!?]\s', intro): problems.append('not exactly one sentence') if _CONTRACTION.search(intro): problems.append('contraction: ' + _CONTRACTION.search(intro).group(0)) if _YOU.search(intro): problems.append('second person: ' + _YOU.search(intro).group(0)) if words[0].lower().strip('“"') in _NOT_IMPERATIVE or words[0].lower().endswith('ing'): problems.append('does not open with an imperative verb: ' + words[0]) missing = numbers(intro) - numbers(' \n '.join(corpus)) if missing: problems.append('numbers absent from steps: ' + ', '.join(sorted(missing))) return problems # The lint itself: known-good and known-bad cases. _CORPUS = ['1 / 6 · Printed point: batch 32', '2 / 6 · Drop to batch 1', '6 / 6 · Batch 1,024: intensity rises', 'S = 2¹⁵ overflows'] assert lint_intro('Move the marker from batch 32 to batch 1, then to batch 1,024, and watch S = 2¹⁵ overflow.', _CORPUS) == [] assert any('numbers' in x for x in lint_intro('Move the marker from batch 1 to batch 2,048.', _CORPUS)) assert any('numbers' in x for x in lint_intro('Move the marker to batch 512.', _CORPUS)) assert any('second person' in x for x in lint_intro('Watch how your batch moves.', _CORPUS)) assert any('contraction' in x for x in lint_intro('Watch the batch, which won’t move.', _CORPUS)) assert any('contraction' in x or 'second person' in x for x in lint_intro("You'll watch the batch move.", _CORPUS)) assert any('words' in x for x in lint_intro('Watch ' + 'the batch ' * 16 + 'move.', _CORPUS)) assert any('sentence' in x for x in lint_intro('Watch the batch. It moves.', _CORPUS)) assert any('imperative' in x for x in lint_intro('The batch moves.', _CORPUS)) assert numbers('FP16 and FP32 at batch-32, B1, 1,024 and 2¹⁵') == {'32', '1,024', '2¹⁵'} print('compact intro lint self-test PASS') # Static: every module that opts into the compact layout must pass an intro. for module in sorted(base.glob('*.js')): text = module.read_text() if re.search(r"layout\s*:\s*['\"]compact['\"]", text): assert re.search(r"\bintro\s*:", text), (module.name, 'compact layout without intro') # Label lint (2026-10-29, round three): the menu counter is the only step number, so a step label # must not begin with a bare number ("4. Backprop"); write "Backprop (stage 4)". _NUMBERED = re.compile(r'^\s*\d+[.)]\s') def lint_label(text): """Problem string for a menu option ('9 / 16 · label') or a raw label; '' if fine.""" label = re.sub(r'^\d+(?:\s*→\s*\d+)?\s*/\s*\d+\s*·\s*', '', text) return 'label starts with a bare number: ' + label if _NUMBERED.match(label) else '' assert lint_label('9 / 16 · 4. Backprop') and lint_label('4. Backprop') and not lint_label('9 / 16 · Backprop (stage 4)') and not lint_label('2 / 4 · 2:1 ratio') print('compact label lint self-test PASS') # Coverage of the visible diagram by the pinned dock (+ cue) or the jump pill, and whether some # step cue (bar, cue, pill, or narration heading) is on screen. Shared with the scroll sweeps. COVER = '''()=>{const r=document.querySelector('#root'),q=s=>r.querySelector(s),dlg=r.closest('dialog'); const body=dlg?dlg.querySelector('.mlsys-original-dialog-body').getBoundingClientRect():null; const vt=body?body.top:parseFloat(getComputedStyle(document.documentElement).getPropertyValue('--mlsys-original-header-offset'))||0,vb=body?body.bottom:innerHeight; const s=q('.mlsys-original-stage').getBoundingClientRect(),d=q('.mlsys-original-dock'),k=d.getBoundingClientRect(),c=q('.mlsys-original-cue'),j=q('.mlsys-original-jump'); const shown=n=>getComputedStyle(n).visibility==='visible',vis=Math.max(0,Math.min(s.bottom,vb)-Math.max(s.top,vt)); const area=b=>Math.max(0,Math.min(b.bottom,s.bottom,vb)-Math.max(b.top,s.top,vt))*Math.max(0,Math.min(b.right,s.right)-Math.max(b.left,s.left)); let covered=0;const parts=[];if(d.dataset.stuck==='bottom')parts.push(k);if(shown(c))parts.push(c.getBoundingClientRect());if(shown(j))parts.push(j.getBoundingClientRect());parts.forEach(b=>covered+=area(b)); const h=q('.mlsys-original-narration strong').getBoundingClientRect(),barIn=k.top>=vt-1&&k.bottom<=vb+1; return {vis,stageH:s.height,frac:vis?covered/(vis*s.width):0,barIn,cue:shown(c),pill:shown(j),head:h.top>=Math.max(vt,k.bottom)-1&&h.bottom<=vb+1,explained:barIn||shown(c)||shown(j)||(h.top>=vt&&h.bottom<=vb)}}''' COMPACT = '''([theme, intro])=>{document.body.classList.toggle('dark',theme==='dark');const root=document.querySelector('#root');const outer=document.querySelector('#outer'); const spec={root,outer,layout:'compact',intro,title:'Values moving through a diagram',scope:'Illustrative contributions; motion does not represent measured latency.', viewControls:(()=>{const l=document.createElement('label');l.textContent='Diagram view ';const s=document.createElement('select');s.setAttribute('aria-label','Diagram view');s.append(new Option('Whole diagram','whole'));l.append(s);return l;})(), steps:[{label:'Ready',description:'The value remains at the source.'},{label:'2. Read the source',description:'Read the source value.'},{label:'3. Compute',description:'The compute stage receives the value.'},{label:'Write',description:'Commit the result to the destination.'}], render(index,{stage,details,assumptions}){if(!stage.firstChild)stage.innerHTML='';const c=stage.querySelector('circle');c.setAttribute('cx',50+100*index);details.textContent='Committed state: '+index;window.sawAssumptions=!!assumptions;}, transition({from,to,stage,onFrame}){const c=stage.querySelector('circle');onFrame(t=>c.setAttribute('cx',50+100*(from+(to-from)*t)));}}; window.player=MLSysOriginalPlayer.create(spec);}''' INTRO = 'Follow the value from the source to the destination and watch the circle move.' BOX = '(s)=>{const r=document.querySelector(s).getBoundingClientRect();return {top:r.top,bottom:r.bottom,left:r.left,right:r.right,width:r.width,height:r.height}}' with sync_playwright() as p: for engine in [p.chromium,p.webkit]: browser=engine.launch() for width,theme in [(1440,'light'),(390,'dark')]: page=browser.new_page(viewport={'width':width,'height':800}) errors=[] page.on('pageerror',lambda error:errors.append(str(error))) page.set_content('
') page.add_style_tag(path=str(base/'original-player.css')) page.add_script_tag(path=str(base/'original-player.js')) # Unmodified lessons inherit the diagram-first layout without invented prose. page.evaluate('''()=>{const root=document.createElement('div');document.body.append(root);const player=MLSysOriginalPlayer.create({root,outer:document.querySelector('#outer'),title:'Existing lesson',scope:'Existing assumptions',steps:[{label:'Start',description:'Existing explanation.'}],render(){}});window.defaultLayout=root.dataset.layout;window.defaultIntroHidden=root.querySelector('.mlsys-original-intro').hidden;player.destroy();root.remove();}''') assert page.evaluate("window.defaultLayout==='compact' && window.defaultIntroHidden"),'default layout must be compact without an empty intro' # A compact player without an intro is a configuration error. for bad in ['', ' ', None]: page.evaluate('''(i)=>{try{MLSysOriginalPlayer.create({root:document.createElement('div'),outer:document.querySelector('#outer'),layout:'compact',intro:i,title:'t',scope:'s',steps:[{label:'a'}],render(){}});window.threw=false}catch(e){window.threw=/intro/.test(e.message)}}''',bad) assert page.evaluate('window.threw'),('compact without intro must throw',bad) page.evaluate(COMPACT,[theme,INTRO]) root=page.locator('#root') order=page.evaluate("[...document.querySelector('#root').children].map(n=>n.className)") assert order==['mlsys-original-title','mlsys-original-intro','mlsys-original-assumptions','mlsys-original-view-controls','mlsys-original-stage','mlsys-original-jump-anchor','mlsys-original-dock','mlsys-original-narration','mlsys-original-details'],order assert page.locator('.mlsys-original-view-controls select[aria-label="Diagram view"]').count()==1,'viewControls sit beside the stage' assert root.get_attribute('data-numbered-labels')=='2','lint hook counts labels that start with a stage number' assert page.evaluate('window.sawAssumptions'),'compact render receives the Assumptions disclosure' assert root.get_attribute('data-layout')=='compact' and root.get_attribute('aria-describedby') is None,'root does not re-read the intro' assert page.locator('.mlsys-original-assumptions-summary').inner_text()=='Assumptions' assert page.locator('.mlsys-original-shortcuts,.mlsys-original-current-cue,.mlsys-original-speed').count()==0 group=root.get_by_role('group',name='Animation controls') assert group.get_attribute('title') is None,'no group tooltip' desc=page.locator('#'+group.get_attribute('aria-describedby')) assert desc.count()==1 and desc.evaluate('n=>n.hidden') and 'N next' in desc.text_content() and 'minus slower' in desc.text_content(),'shortcut description is referenced, not rendered twice' assert root.get_by_role('combobox',name='Playback speed').count()==0,'no speed dropdown in the bar' phone = page.evaluate("document.querySelector('#root').getBoundingClientRect().width")<=660 SPEED=re.compile(r'^Speed \d(\.\d)?×$') visible=['Play','Back','Next','Expand']+([] if phone else ['Restart']) for name in visible:assert group.get_by_role('button',name=name,exact=True).count()==1,name assert group.get_by_role('button',name=SPEED).count()==1 and group.get_by_role('button',name=SPEED).inner_text().strip().endswith('1×'),'Speed button names and shows the rate' # Back/Next are single chevrons (one stroke path), not skip-to-start/end bars. assert page.evaluate("[...document.querySelectorAll('.mlsys-original-btn-back svg, .mlsys-original-btn-next svg')].every(g=>g.querySelectorAll('path').length===1&&!g.querySelector('[fill=\"currentColor\"]'))") if phone:assert group.get_by_role('button',name='Restart',exact=True).count()==0,'phone Restart lives in the popover' bars=page.evaluate('''()=>[...document.querySelectorAll('.mlsys-original-controls > :is(button,label)')].filter(n=>n.getClientRects().length).map(n=>{const r=n.getBoundingClientRect();return [Math.round(r.top+r.height/2),Math.round(r.width),Math.round(r.height)]})''') assert max(c for c,_,_ in bars)-min(c for c,_,_ in bars)<=4,('one row',bars) # Phones: 44 px for every target. Desktop WebKit draws a native menu at its own height (>= 24 px). assert all(w>=44 and h>=44 for _,w,h in bars) if phone else all(h>=(24 if w>200 else 40) for _,w,h in bars),('targets',bars) assert page.evaluate('''()=>[...document.querySelectorAll('.mlsys-original-controls button')].every(b=>!b.title&&b.querySelector(':scope > .mlsys-original-tip[aria-hidden="true"]')?.textContent)'''),'visible tooltips replace title' menu=group.get_by_role('combobox',name='Sequence',exact=True) assert menu.locator('option').evaluate_all('xs=>xs.map(x=>x.textContent)')==['1 / 4 · Ready','2 / 4 · Read the source (stage 2)','3 / 4 · Compute (stage 3)','4 / 4 · Write'],'one counter; stage numbers become (stage N)' assert all(not lint_label(x) for x in menu.locator('option').evaluate_all('xs=>xs.map(x=>x.textContent)')) st=page.evaluate(BOX,'.mlsys-original-stage');dk=page.evaluate(BOX,'.mlsys-original-dock');nr=page.evaluate(BOX,'.mlsys-original-narration') # Adjacency in flow: a viewport tall enough that nothing pins. page.set_viewport_size({'width':width,'height':1600}) page.evaluate('scrollTo(0, document.querySelector("#root").getBoundingClientRect().top+scrollY-20)');page.wait_for_timeout(200) st=page.evaluate(BOX,'.mlsys-original-stage');dk=page.evaluate(BOX,'.mlsys-original-dock');nr=page.evaluate(BOX,'.mlsys-original-narration') assert st['bottom']<=dk['top']+1 and abs(dk['bottom']-nr['top'])<=1,('diagram, bar, narration adjacent',st,dk,nr) page.set_viewport_size({'width':width,'height':800});page.wait_for_timeout(150) assert page.locator('.mlsys-original-status').inner_text()==('' if phone else 'Ready') or phone assert root.get_attribute('data-status')=='ready','Ready before first play, not Paused' live=page.locator('#root [role="status"]');assert live.count()==1 and live.text_content()=='Ready','one screen-reader status' assert page.locator('#root .mlsys-original-narration').get_attribute('aria-live') is None,'narration is not a second live region' # Mid-move: the menu keeps the committed step and shows the pending one with an arrow. page.evaluate('player.next()');page.wait_for_timeout(60) assert root.get_attribute('data-status')=='moving' and root.get_attribute('data-step')=='0' assert menu.evaluate('s=>s.value')=='0' and menu.evaluate('s=>s.selectedOptions[0].textContent')=='1 → 2 / 4 · Read the source (stage 2)' assert page.locator('.mlsys-original-face-count').text_content()=='1→2' page.evaluate('player.pause()');assert root.get_attribute('data-status')=='paused' narr=page.locator('.mlsys-original-narration strong').text_content();assert narr.endswith('Next · Read the source (stage 2)'),narr # Paused mid-move: only the target's title, never its body (the diagram has not reached it yet). assert page.locator('.mlsys-original-narration p').count()==0,'mid-move narration shows the target title only' announced=page.locator('#root [aria-live="polite"]').text_content();assert 'Read the source' not in announced,('no departure announcement',announced) page.evaluate('player.next()');assert root.get_attribute('data-step')=='1' and menu.evaluate('s=>s.selectedOptions[0].textContent')=='2 / 4 · Read the source (stage 2)' assert page.locator('.mlsys-original-narration strong').text_content().endswith('Read the source (stage 2)'),'narration keeps the full title' assert page.locator('#root [aria-live="polite"]').text_content()=='Step 2 of 4: Read the source (stage 2). Read the source value.','announced once on arrival' assert page.locator('.mlsys-original-narration p').text_content()=='Read the source value.','the explanation appears on arrival' # Idle mid-sequence: no status word (visible or spoken); Ready is for step 1 only. assert root.get_attribute('data-status')=='idle' and page.locator('.mlsys-original-status').text_content()=='' and live.text_content()=='','no status word mid-sequence' page.evaluate('player.go(0)');assert root.get_attribute('data-status')=='ready' and live.text_content()=='Ready','Ready at step 1' page.evaluate('player.go(1)') page.evaluate('player.play()');page.wait_for_timeout(30);page.evaluate('player.pause()');page.wait_for_timeout(30) assert root.get_attribute('data-status')=='paused' and live.text_content()=='Paused','interrupted play is Paused';page.evaluate('player.go(1)') assert root.get_attribute('data-status')=='idle','a manual step after a pause clears the status' page.evaluate('player.play()');page.wait_for_function("document.querySelector('#root').dataset.status==='reading'",timeout=3000) page.wait_for_function('player.state.index===3 && !player.state.playing',timeout=6000);assert root.get_attribute('data-status')=='complete' assert group.get_by_role('button',name='Replay',exact=True).count()==1 # Speed: −/+ work in compact; the popover offers the four rates. root.focus();page.keyboard.press('+');assert page.evaluate('player.state.speed')==1.5 page.keyboard.press('-');page.keyboard.press('-');assert page.evaluate('player.state.speed')==0.5 keys=group.get_by_role('button',name=SPEED);keys.click() assert keys.get_attribute('aria-expanded')=='true' radios=root.get_by_role('radiogroup',name='Playback speed').get_by_role('radio') assert radios.evaluate_all('xs=>xs.map(x=>x.value)')==['0.5','1','1.5','2'] and page.evaluate('document.activeElement.value')=='0.5' root.get_by_role('radio',name='2×').click();assert page.evaluate('player.state.speed')==2 assert page.evaluate('document.activeElement.value')=='2','the clicked speed radio keeps focus (Safari)' page.keyboard.press('ArrowLeft');assert page.evaluate('player.state.speed')==1.5,'arrow keys keep working' page.keyboard.press('ArrowRight');assert page.evaluate('player.state.speed')==2 assert keys.inner_text().strip().endswith('2×') pop=page.evaluate(BOX,'.mlsys-original-popover');assert pop['top']>=-1 and pop['bottom']<=801,('popover inside the viewport',pop) assert page.evaluate("getComputedStyle(document.querySelector('.mlsys-original-popover')).maxHeight")!='none','popover height bounded' assert 'Close expanded view' in page.locator('.mlsys-original-keylist').inner_text() and page.locator('.mlsys-original-keylist kbd').count()==7 if phone:root.get_by_role('button',name='Restart',exact=True).click();assert page.evaluate('player.state.index')==0;keys.click() page.keyboard.press('Escape');assert keys.get_attribute('aria-expanded')=='false' and page.evaluate('document.activeElement.classList.contains("mlsys-original-options-button")') for name in ['Back','Expand']: group.get_by_role('button',name=name,exact=True).focus();assert group.get_by_role('button',name=name,exact=True).count()==1,(name,'name stable on focus') # Tooltips (WCAG 1.4.13): hover shows the tip, the tip itself is hoverable (it persists while the # pointer moves onto it), and Escape hides it without moving focus or closing anything. page.evaluate('player.go(1)');root.focus();nxt=group.get_by_role('button',name='Next',exact=True);tip=nxt.locator('.mlsys-original-tip') nxt.hover();page.wait_for_timeout(50);assert tip.is_visible(),'hover shows the tooltip' tb=tip.bounding_box();page.mouse.move(tb['x']+tb['width']/2,tb['y']+tb['height']/2);page.wait_for_timeout(50);assert tip.is_visible(),'tooltip persists while hovered' page.keyboard.press('Escape');assert not tip.is_visible() and page.evaluate("document.activeElement===document.querySelector('#root')"),'Escape dismisses the tooltip in place' # One Escape does one thing: inside Expand, dismissing a tooltip does not also close the dialog. group.get_by_role('button',name='Expand',exact=True).click();dnext=page.locator('dialog .mlsys-original-btn-next');dnext.hover();page.wait_for_timeout(50) assert dnext.locator('.mlsys-original-tip').is_visible();page.keyboard.press('Escape');page.wait_for_timeout(50) assert page.locator('dialog[open]').count()==1 and not dnext.locator('.mlsys-original-tip').is_visible(),'Escape on a tooltip keeps the dialog open' page.keyboard.press('Escape');page.wait_for_timeout(50);assert page.locator('dialog').count()==0,'the next Escape closes the dialog' page.mouse.move(2,2);root.focus() group.get_by_role('button',name='Expand',exact=True).hover();nxt.hover();page.wait_for_timeout(50);assert tip.is_visible(),'the tooltip returns on the next hover' page.mouse.move(2,2) # Legend: the Esc row shows the close icon, not Expand. assert page.evaluate("[...document.querySelectorAll('.mlsys-original-keylist li')].at(-1).querySelector('svg').innerHTML.includes('M6.5 6.5')") page.screenshot(path=f'/tmp/original-player-compact-{engine.name}-{width}-{theme}.png') # Sticky dock: diagram on screen with the bar below the fold. Tall diagram (desktop): the bar # pins with its one-line cue, covering at most 15% of the visible diagram. Short diagram # (phone): pinning would exceed the cap, so the bar flows and the jump pill carries the cue. page.evaluate('player.go(1)') y=page.evaluate("document.querySelector('.mlsys-original-stage').getBoundingClientRect().bottom+scrollY-innerHeight+10") page.evaluate(f'scrollTo(0,{y})');page.wait_for_timeout(250) dock=page.locator('.mlsys-original-dock');cover=page.evaluate(COVER) assert cover['explained'] and cover['frac']<=0.15+1e-3,cover if not phone: assert dock.get_attribute('data-stuck')=='bottom' and dock.get_attribute('data-cue')=='above',(dock.get_attribute('data-stuck'),dock.get_attribute('data-cue')) dk=page.evaluate(BOX,'.mlsys-original-dock');ck=page.evaluate(BOX,'.mlsys-original-cue') assert abs(dk['bottom']-800)<=1 and abs(ck['bottom']-dk['top'])<=1 and ck['height']<=32 and page.locator('.mlsys-original-cue').inner_text()=='Read the source (stage 2)',ck # Pinned: no status word, and Speed shows only its rate, so the menu keeps room for the title. assert not page.locator('.mlsys-original-status').is_visible() and keys.locator('.mlsys-original-control-label').evaluate('n=>n.getBoundingClientRect().width')<=1 and keys.is_visible(),'pinned: no status, Speed shows its rate' # A keep-visible readout at the diagram's bottom edge: the bar no longer pins over it (no pinned # bar without its title either); the pill rides above the readout instead of covering it. page.evaluate('''()=>{const svg=document.querySelector('#root .mlsys-original-stage svg');const r=document.createElementNS('http://www.w3.org/2000/svg','rect'); r.setAttribute('x','0');r.setAttribute('y','268');r.setAttribute('width','440');r.setAttribute('height','32');r.setAttribute('fill','#fc8');r.id='keep';r.setAttribute('data-mlsys-keep','');svg.append(r);scrollBy(0,1)}''') page.wait_for_timeout(250);cover=page.evaluate(COVER) assert dock.get_attribute('data-stuck')!='bottom' and dock.get_attribute('data-hold')=='natural',('no pin over a keep region',dock.get_attribute('data-stuck')) kp=page.evaluate(BOX,'#keep');jp=page.evaluate(BOX,'.mlsys-original-jump') assert page.locator('.mlsys-original-jump').is_visible() and jp['bottom']<=kp['top']+0.5,('pill rides above the keep region',jp,kp) page.evaluate("document.querySelector('#keep').remove()");page.evaluate('scrollBy(0,-1)');page.wait_for_timeout(250) else: assert dock.get_attribute('data-hold')=='natural' and page.locator('.mlsys-original-jump').is_visible(),cover assert page.locator('.mlsys-original-jump').inner_text().replace('\n',' ').startswith('2/4'),page.locator('.mlsys-original-jump').inner_text() # The pill is a named, keyboard-reachable button with a down arrow (not a menu chevron); it moves # focus to the narration. Pointer-sized hit area: at least 44 px tall. jump=page.locator('.mlsys-original-jump') if jump.is_visible(): assert root.get_by_role('button',name='Go to step explanation').count()==1 and jump.get_attribute('tabindex') is None and jump.get_attribute('aria-hidden') is None assert jump.evaluate("b=>b.querySelector('svg').innerHTML.includes('M12 4.5v15')"),'down arrow icon' assert jump.evaluate("b=>parseFloat(getComputedStyle(b,'::after').height)")>=44,'44 px hit area' page.evaluate("document.querySelector('#root .mlsys-original-stage').tabIndex=-1");root.focus() # WebKit's Tab skips buttons unless the OS "Tab to all controls" setting is on; there, check the # button is in the tab order (tabIndex 0) and focus it directly. assert jump.evaluate('b=>b.tabIndex')==0 reach=engine.name=='webkit' and (jump.focus() or True) and page.evaluate("document.activeElement===document.querySelector('.mlsys-original-jump')") for _ in range(0 if reach else 4): page.keyboard.press('Tab') if page.evaluate("document.activeElement===document.querySelector('.mlsys-original-jump')"):reach=True;break assert reach,'Tab reaches the pill' page.keyboard.press('Enter');page.wait_for_timeout(700) assert page.evaluate("document.activeElement===document.querySelector('#root .mlsys-original-narration')"),'the pill moves focus to the explanation' nb=page.evaluate(BOX,'#root .mlsys-original-narration');assert nb['top']>=0 and nb['bottom']<=801,('narration scrolled into view',nb) page.evaluate(f'scrollTo(0,{y})');page.wait_for_timeout(250) # Scrolled past the diagram -> the bar sits at the top; scrolling back restores the bottom state. page.evaluate("scrollTo(0, document.querySelector('.mlsys-original-narration').getBoundingClientRect().bottom+scrollY+5)");page.wait_for_timeout(250) assert dock.get_attribute('data-stuck') in ('top','none') page.evaluate(f'scrollTo(0,{y})');page.wait_for_timeout(250);assert dock.get_attribute('data-stuck')==('bottom' if not phone else 'none') group.get_by_role('button',name='Expand',exact=True).click();assert page.locator('dialog .mlsys-original-compact .mlsys-original-stage').is_visible() page.locator('dialog .mlsys-original-dialog-body').evaluate('d=>d.scrollTop=d.scrollHeight');page.wait_for_timeout(200) cl=page.evaluate(BOX,'.mlsys-original-dialog-close');dk=page.evaluate(BOX,'dialog .mlsys-original-dock');sb=page.evaluate(BOX,'dialog .mlsys-original-dialog-body') assert dk['top']>=cl['bottom']-1 and sb['top']>=cl['bottom']-1,('dialog dock and body below the Close bar',cl,dk,sb) page.keyboard.press('Escape');assert page.locator('dialog').count()==0 and page.locator('#outer #root').count()==1 assert page.evaluate('document.documentElement.scrollWidth<=innerWidth') page.emulate_media(media='print');assert not root.is_visible();page.emulate_media(media='screen') page.evaluate('player.destroy()');assert root.text_content()=='' and root.get_attribute('data-layout') is None and root.get_attribute('data-status') is None assert not errors,errors print('compact',engine.name,width,theme,'PASS') browser.close() FOCUS_MARGIN = 8 FOCUS_IN_FRAME = '''(r,pad)=>{const st=r.querySelector('.mlsys-original-stage'),f=st.querySelector('svg').getBoundingClientRect(); const foci=[...st.querySelectorAll('[data-mlsys-focus]')].filter(n=>getComputedStyle(n).visibility!=='hidden'&&n.getClientRects().length).map(n=>n.getBoundingClientRect()).filter(b=>b.width||b.height); const m=foci.map(b=>Math.min(b.left-f.left,f.right-b.right,b.top-f.top,f.bottom-b.bottom));return {n:foci.length,min:m.length?Math.min(...m):null}}''' # Optional: lint the intros of emitted compact mounts in built chapters. # check_original_player.py --chapter-links links.json ({"vol1:fig-x": "http://.../ch.html?view=explore#fig-x"}) if '--chapter-links' in sys.argv: links=json.loads(Path(sys.argv[sys.argv.index('--chapter-links')+1]).read_text()) linted=0 with sync_playwright() as p: browser=p.chromium.launch() for key,url in links.items(): fid=url.split('#',1)[1] page=browser.new_page(viewport={'width':1440,'height':900},reduced_motion='reduce') page.goto(url,wait_until='domcontentloaded') page.wait_for_function('(id)=>document.getElementById(id)?.dataset.mlsysExploreState==="ready"',arg=fid) comp=page.locator('#'+fid+' .mlsys-original-player') if comp.count()!=1 or comp.get_attribute('data-layout')!='compact':page.close();continue intro=comp.locator('.mlsys-original-intro').inner_text() menu=comp.locator('.mlsys-original-sequence select');corpus=menu.locator('option').evaluate_all('xs=>xs.map(x=>x.textContent)') for i in range(len(corpus)): menu.select_option(str(i));corpus.append(comp.locator('.mlsys-original-narration').inner_text()) problems=lint_intro(intro,corpus) assert not problems,(key,intro,problems) labels=[x for x in corpus if ' · ' in x[:12]]+comp.locator('.mlsys-original-narration strong').all_inner_texts() bad=[lint_label(x) for x in labels if lint_label(x)] assert not bad and comp.get_attribute('data-numbered-labels') is None,(key,'step labels must not start with a bare number',bad,comp.get_attribute('data-numbered-labels')) # Protection contract (2026-10-30, round four): every committed state of a compact module marks its # highlighted region with data-mlsys-focus inside the stage (the dock and pill avoid it), and in every # view the module offers, each focus region plus FOCUS_MARGIN px lies inside the drawing's frame # (no Follow crop or edge clips what the step is about). view=comp.locator('select[aria-label="Diagram view"]') for v in (view.locator('option').evaluate_all('xs=>xs.map(x=>x.value)') if view.count() else [None]): if v:view.select_option(v) for i in range(menu.locator('option').count()): menu.select_option(str(i)) g=comp.evaluate(FOCUS_IN_FRAME,FOCUS_MARGIN) assert g['n']>0,(key,'view',v,'step',i+1,'has no visible data-mlsys-focus region') assert g['min']>=FOCUS_MARGIN,(key,'view',v,'step',i+1,'focus region within',g['min'],'px of the frame edge') print('intro',key,len(intro.split()),'words; focus regions in frame PASS') linted+=1;page.close() browser.close() assert linted,'no compact mounts found in --chapter-links'