@rig-c/review 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/web/main.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import {bindStageNav} from './stage-nav.ts';
1
2
  import {timeOnlyBasis,feedbackTimingLabel,requireFeedbackFrames,isTimeOnlyFeedback} from '../src/stage-comment.ts';
2
3
  import {bindStageComments,type CommentPose} from './stage-comments.ts';
3
4
  import {discoverTurnDials,TurnState} from '../src/turn-pad.ts';
@@ -6,10 +7,11 @@ import {PartExplorer,loadPartModel,partBounds} from './part-selection.ts';
6
7
  import {AnimationInspectionPanel} from './animation-inspection.ts';
7
8
  import {PartThumbnails,pageRegionTable} from './part-thumbnails.ts';
8
9
  import { CanvasRenderer, loadModel, RigPlayer, type BoneAdjust, type ModelAssets, type PoseBounds } from '@rig-c/play';
9
- import {cameraFrame,cameraSignature,cameraFromSignature,assertCameraView,boundsFitSignature,dragSignature,zoomSignature,type CameraFrame,type CameraPoint,type CameraSignature} from './camera-view.ts';
10
+ import {createViewportController,createViewportState,type CameraTarget} from './viewport-controller.ts';
11
+ import {createRigViewportProvider,rigPanCarry} from './rig-viewport-provider.ts';
12
+ import {mountViewportPair} from './viewport-pair.ts';
10
13
  import {rendererStatus} from './renderer-status.ts';
11
- import {bindAppearance,bindPan,bindStageLayout,syncStageLayout,bindInspectorTabs,idleAvailable,initialIdleAnimation,automaticIdlePreview,bindLayerShortcuts,describeLayerToggles,type ViewPoint} from './view-controls.ts';
12
- import {CLICK_SLOP_PX} from './stage-pick.ts';
14
+ import {bindAppearance,syncStageLayout,bindInspectorTabs,idleAvailable,initialIdleAnimation,automaticIdlePreview,bindLayerShortcuts,describeLayerToggles,type ViewPoint} from './view-controls.ts';
13
15
  import {RigOverlays,type OverlayCircle,type OverlayMarker,type OverlayRegion,type OverlaySnapshot} from './rig-overlays.ts';
14
16
  import {bindMeshPanel,type MeshPanel} from './mesh-panel.ts';
15
17
  import {bindDensityStrip,type DensityStripPanel,type DensityStripViewLike} from './density-strip-panel.ts';
@@ -39,7 +41,7 @@ import {connectLiveWindow} from './live-connection.ts';
39
41
  import {pageInstanceAccess,readOnlyReason} from './instance-access.ts';
40
42
  import {controlComparison,type ControlCommand,type ControlInspection,type ControlView} from '../src/control.ts';
41
43
  import {singleEligibility,videoReferenceAt,type InputState,type SingleLayout} from '../src/comparison-eligibility.ts';
42
- import {parseBookmark,connectInspectionPersistence,serializableView,numericCamera,restoredZoom,restoreTransaction,captureInputs,restoreInputs,type InspectionBookmark,type InspectionBinding,type PersistenceConnection} from './inspection-persistence.ts';
44
+ import {parseBookmark,connectInspectionPersistence,serializableView,restoredZoom,restoreTransaction,captureInputs,restoreInputs,type InspectionBookmark,type InspectionBinding,type PersistenceConnection} from './inspection-persistence.ts';
43
45
  import {initialPlayerAnimation,keptAnimation} from '../src/animation-selection.ts';
44
46
  import {initialReviewSelection} from '../src/open-selection.ts';
45
47
  import type {ReferenceBinding} from '../src/reference.ts';
@@ -86,6 +88,10 @@ const titledIds = new Set(['message', 'player-state', 'layout-state', 'renderer-
86
88
  const text = (id: string, value: string) => { const node = el(id); setSourceText(node, value); if (titledIds.has(id)) setSourceAttribute(node, 'title', value); };
87
89
  const option = (value: string, label: string) => { const item = document.createElement('option'); item.value = value; item.textContent = label; return item; };
88
90
  const errorText = (error: unknown) => error instanceof Error ? error.message : String(error);
91
+ mountViewportPair(el('stage-layout'));
92
+ const viewportState=createViewportState();
93
+ const viewport=createViewportController(createRigViewportProvider({el,player:()=>player,assets:()=>assets,referenceSize:()=>referenceSize,view:()=>view,referenceGeneration:()=>referenceGeneration,parts:()=>parts,text,message,redrawOverlay},viewportState),viewportState);
94
+ const {fitCamera,paneFrame,availableCamera,alignCameras,renderCameraControls,setCameraSync,cameraAction,updateCamera,fitActiveCamera}=viewport;
89
95
  // First, before any URL use: take the `#cap=` handoff into memory/session storage and strip it.
90
96
  const access = pageInstanceAccess();
91
97
  connectLiveWindow(access);
@@ -109,18 +115,10 @@ let duration = 0;
109
115
  let lastFrame = 0;
110
116
  /** #346: wall-clock seconds accumulated toward the next fixed playback step. */
111
117
  let playbackCarry = 0;
112
- type CameraTarget='rig'|'reference';
113
- let cameraSync=true,activeCamera:CameraTarget='rig',cameraRestoring=false,cameraLayout='';
114
- const cameraFrames:Partial<Record<CameraTarget,CameraFrame>>={};
115
118
  let comments:ReturnType<typeof bindStageComments>|null=null;
116
119
  let view: 'compare' | 'reference' | 'rig' = 'compare';
117
120
  // Requested layout persists in the source-bound draft; the effective one follows actual load events only.
118
121
  let rigInput:InputState={state:'pending'},referenceInput:InputState={state:'absent'},effectiveView:SingleLayout|null=null;
119
- let zoom = 1;
120
- let cameraCenter: { x: number; y: number } | null = null;
121
- let referenceCenter:ViewPoint|null=null;
122
- let rigScale=1,referenceScale=1,referenceZoom=1;
123
- let displayedCenter:ViewPoint|null=null;
124
122
  let playbackIntent=0,desiredPlay=false,seekingControl=false;
125
123
  let parts:PartExplorer|null=null;
126
124
  let animationPanel:AnimationInspectionPanel|null=null;
@@ -255,14 +253,14 @@ async function chooseCheckpoint(point: Checkpoint,initial?:{referenceId?:string;
255
253
  if (referenceId && select('reference-select').value !== referenceId) {
256
254
  select('reference-select').value = referenceId; await showReference(referenceId);
257
255
  }
258
- zoom = Math.min(8, Math.max(.25, point.camera?.zoom ?? 1));
259
- if(cameraSync)activeCamera=player?'rig':'reference';
260
- cameraCenter = point.camera ? { x: point.camera.x, y: point.camera.y } : null;
256
+ viewport.state.zoom = Math.min(8, Math.max(.25, point.camera?.zoom ?? 1));
257
+ if(viewport.state.cameraSync)viewport.state.activeCamera=player?'rig':'reference';
258
+ viewport.state.cameraCenter = point.camera ? { x: point.camera.x, y: point.camera.y } : null;
261
259
  seek(time);
262
260
  if (point.axis && player && !input('axis-value').disabled) {
263
261
  select('axis-select').value = point.axis.id; chooseAxis(); input('axis-value').value = String(point.axis.value); applyAxis();
264
262
  }
265
- if(cameraSync)alignCameras();fitCamera(); renderCheckpoint(); renderCheckpoints();
263
+ if(viewport.state.cameraSync)alignCameras();fitCamera(); renderCheckpoint(); renderCheckpoints();
266
264
  }
267
265
 
268
266
  function renderCheckpoint(): void {
@@ -356,7 +354,7 @@ function renderSequenceFrame(): void {
356
354
 
357
355
  async function showReference(id: string): Promise<void> {
358
356
  const generation = ++referenceGeneration;
359
- video?.pause(); video = null;controlledVideoSample=null;delete cameraFrames.reference; referenceCenter=null; referenceSize = null; sequence = null; sequenceSvg = null; selectedPerson=''; lastPoseFrame = -1; el('person-control').hidden = true;
357
+ video?.pause(); video = null;controlledVideoSample=null;delete viewport.state.cameraFrames.reference; viewport.state.referenceCenter=null; referenceSize = null; sequence = null; sequenceSvg = null; selectedPerson=''; lastPoseFrame = -1; el('person-control').hidden = true;
360
358
  const content = el('reference-content'); content.replaceChildren();
361
359
  const reference = data.manifest.references.find(item => item.id === id);
362
360
  el('reference-empty').hidden = false;setReferenceInput(reference?{state:'pending'}:{state:'absent'});
@@ -400,30 +398,6 @@ async function showReference(id: string): Promise<void> {
400
398
  } catch (error) { fail(errorText(error)); message(errorText(error), true); }
401
399
  }
402
400
 
403
- function referenceFit(): void {
404
- if (!referenceSize || !paneFrame('reference')) return;
405
- const viewport = el('reference-viewport'), content = el('reference-content');
406
- const scale = referenceScale = Math.max(.001,Math.min((viewport.clientWidth - 24) / referenceSize.width, (viewport.clientHeight - 56) / referenceSize.height) * referenceZoom);
407
- const center=referenceCenter??{x:referenceSize.width/2,y:referenceSize.height/2};
408
- content.style.left = `${viewport.clientWidth/2-center.x*scale}px`;
409
- content.style.top = `${viewport.clientHeight/2-center.y*scale}px`;
410
- content.style.transform = `scale(${scale})`;
411
- }
412
-
413
- function fitCamera(): void {
414
- const boxKey=assets?.stage??player?.bounds();
415
- const layout=['rig','reference'].map(target=>{const v=el(target+'-viewport');return `${v.clientWidth}:${v.clientHeight}`;}).join('|')+view+referenceGeneration+!!player+JSON.stringify(referenceSize)+JSON.stringify(boxKey);
416
- if(cameraSync&&!cameraRestoring&&layout!==cameraLayout)alignCameras();cameraLayout=layout;
417
- referenceFit();renderNumericView();renderCameraControls();
418
- if (!player || !assets) return;
419
- const box: PoseBounds | null = assets.stage ?? player.bounds(); if (!box || box.width <= 0 || box.height <= 0) return;
420
- const viewport = el('rig-viewport');if(!paneFrame('rig'))return;
421
- const scale = rigScale = Math.max(.001,Math.min((viewport.clientWidth - 28) / box.width, (viewport.clientHeight - 58) / box.height) * zoom);
422
- const center = cameraCenter ?? { x: box.x + box.width / 2, y: box.y + box.height / 2 };displayedCenter={...center};
423
- const root = el('rig-root'); root.style.left = `${viewport.clientWidth / 2 - center.x * scale}px`; root.style.top = `${viewport.clientHeight / 2 + center.y * scale}px`; root.style.transform = `scale(${scale})`;
424
- player.renderer.syncPixelRatio();redrawOverlay(false);renderNumericView();
425
- }
426
-
427
401
  function renderTransport(): void {
428
402
  refreshAnimationInspection();
429
403
  const end = duration > 0 ? ` / ${duration.toFixed(4)}` : '';
@@ -821,40 +795,6 @@ async function exportStrip(): Promise<void> {
821
795
  }
822
796
 
823
797
 
824
- function paneFrame(target:CameraTarget,hidden=false):CameraFrame|null {
825
- const viewport=el(target+'-viewport'),pane=el(target+'-pane');
826
- const box=target==='rig'?assets?.stage??player?.bounds():referenceSize?{x:0,y:0,...referenceSize}:null;
827
- if(!box||target==='rig'&&!player){delete cameraFrames[target];return null;}
828
- if(pane.hidden||viewport.clientWidth<=0||viewport.clientHeight<=0)return hidden?cameraFrames[target]??null:null;
829
- const frame=cameraFrame(target==='rig'?'world':'image',box,viewport.clientWidth,viewport.clientHeight,target==='rig'?28:24,target==='rig'?58:56);
830
- if(frame)cameraFrames[target]=frame;return frame;
831
- }
832
- function paneCamera(target:CameraTarget){return target==='rig'?{zoom,center:cameraCenter}:{zoom:referenceZoom,center:referenceCenter};}
833
- function writeCamera(target:CameraTarget,value:ReturnType<typeof cameraFromSignature>):void {if(target==='rig'){zoom=value.zoom;cameraCenter=value.center;}else{referenceZoom=value.zoom;referenceCenter=value.center;}}
834
- function activateCamera(target:CameraTarget):void {if(paneFrame(target)){activeCamera=target;renderCameraControls();}}
835
- function availableCamera():CameraTarget|null {return paneFrame(activeCamera)?activeCamera:paneFrame('rig')?'rig':paneFrame('reference')?'reference':null;}
836
- function alignCameras():void {
837
- const target=availableCamera();if(!target)return;
838
- const frame=paneFrame(target)!;assertCameraView(paneCamera(target),frame);const signature=cameraSignature(paneCamera(target),frame);
839
- const updates:Partial<Record<CameraTarget,ReturnType<typeof cameraFromSignature>>>={};
840
- for(const other of ['rig','reference'] as const){if(other===target)continue;const next=paneFrame(other);if(next)updates[other]=cameraFromSignature(signature,next);}
841
- for(const other of ['rig','reference'] as const){const update=updates[other];if(update)writeCamera(other,update);}activeCamera=target;
842
- }
843
- function renderCameraControls():void {input('camera-sync').checked=cameraSync;const target=availableCamera();text('zoom-value',`${Math.round((target?paneCamera(target).zoom:1)*100)}% · ${target==='reference'?'Reference':'Rig'}`);button('fit').textContent=cameraSync?'Fit views':'Fit active';text('coordinates',cameraSync?'Cameras synchronized · drag to pan · scroll to zoom':'Independent cameras · drag to pan · scroll to zoom');}
844
- function setCameraSync(value:boolean):void {if(value)alignCameras();cameraSync=value;fitCamera();renderCameraControls();}
845
- function cameraAction(action:()=>void):void {try{action();}catch(error){renderCameraControls();message(errorText(error),true);}}
846
- function updateCamera(target:CameraTarget,value:CameraSignature):void {
847
- const frame=paneFrame(target);if(!frame)return;
848
- const updates:Partial<Record<CameraTarget,ReturnType<typeof cameraFromSignature>>>={[target]:cameraFromSignature(value,frame)};
849
- if(cameraSync)for(const other of ['rig','reference'] as const){if(other===target)continue;const next=paneFrame(other);if(next)updates[other]=cameraFromSignature(value,next);}
850
- for(const other of ['rig','reference'] as const){const update=updates[other];if(update)writeCamera(other,update);}activeCamera=target;
851
- fitCamera();renderCameraControls();
852
- }
853
- function zoomCamera(factor:number,target=availableCamera(),point?:CameraPoint|null):void {if(!target)return;const frame=paneFrame(target);if(frame)updateCamera(target,zoomSignature(cameraSignature(paneCamera(target),frame),factor,frame,point));}
854
- function panCamera(target:CameraTarget,dx:number,dy:number):void {const frame=paneFrame(target);if(frame)updateCamera(target,dragSignature(cameraSignature(paneCamera(target),frame),frame,dx,dy));}
855
- function fitActiveCamera(target=availableCamera()):void {if(!target)return;const part=parts?.value();if(target==='rig'&&part){const box=parts?.bounds(),frame=paneFrame(target);if(!box||!frame){message('PART_FIT_UNAVAILABLE: selected slot has no positive drawn bounds.',true);return;}updateCamera(target,boundsFitSignature(box,frame,28,58));message('Selected slot fitted.');}else{if(!paneFrame(target))return;updateCamera(target,{zoom:1,pan:{x:0,y:0}});message('View fitted.');}}
856
- function zoomViewport(target:CameraTarget,deltaY:number,point?:CameraPoint|null):void {zoomCamera(deltaY<0?1.1:1/1.1,target,point);}
857
-
858
798
  function bind(): void {
859
799
  button('strip-export').onclick = () => { void exportStrip(); };
860
800
  button('chest-export').onclick = () => { void exportChest(); };
@@ -869,10 +809,7 @@ function bind(): void {
869
809
  select('animation-select').onchange = () => {chooseAnimation(select('animation-select').value);if(canRepeatIdle())void playPreview();};
870
810
  select('part-set').onchange = () => { try { if(!player)return;player.setSet(select('part-set').value || null);drawRig(()=>player!.draw());fitCamera(); } catch (error) {text('renderer-state',rendererStatus(null,'failed').label); message(errorText(error), true); } };
871
811
  select('axis-select').onchange = chooseAxis; input('axis-value').oninput = applyAxis;
872
- button('zoom-in').onclick=()=>cameraAction(()=>zoomCamera(1.25));button('zoom-out').onclick=()=>cameraAction(()=>zoomCamera(1/1.25));button('fit').onclick=()=>cameraAction(()=>fitActiveCamera());
873
- input('camera-sync').onchange=()=>cameraAction(()=>setCameraSync(input('camera-sync').checked));
874
- for(const target of ['rig','reference'] as const)for(const event of ['pointerdown','focusin'] as const)el(target+'-viewport').addEventListener(event,()=>activateCamera(target));
875
- for (const id of ['reference-viewport', 'rig-viewport']) el(id).addEventListener('wheel', event => { event.preventDefault(); const rect=el(id).getBoundingClientRect(); cameraAction(()=>zoomViewport(id==='rig-viewport'?'rig':'reference',event.deltaY,{x:event.clientX-rect.left,y:event.clientY-rect.top})); }, { passive: false });
812
+ viewport.bindControls();
876
813
  input('scrub').oninput = () => { pause(); seek(Number(input('scrub').value)); };
877
814
  input('frame-number').onfocus = pause;
878
815
  input('frame-number').onkeydown = event => { if (event.key === 'Enter') { event.preventDefault(); const value = input('frame-number').value.trim(); seekFrame(value ? Number(value) : NaN); } };
@@ -904,13 +841,13 @@ function bind(): void {
904
841
  const selectedAnimation = feedbackAnimation();
905
842
  try { validateFeedbackSelection(data.feedbackCatalog, { frameStart, frameEnd, target, animation: selectedAnimation }); } catch (error) { message(errorText(error), true); return; }
906
843
  const box = assets?.stage ?? player?.bounds();
907
- const center = cameraCenter ?? (box ? { x: box.x + box.width / 2, y: box.y + box.height / 2 } : null);
844
+ const center = viewport.state.cameraCenter ?? (box ? { x: box.x + box.width / 2, y: box.y + box.height / 2 } : null);
908
845
  session.feedback.push({ id: crypto.randomUUID(), frameStart, frameEnd, target, category: select('feedback-category').value as Feedback['category'], summary, context: {...(turnPad?{turn:JSON.parse(JSON.stringify(turnPad.snapshot())) as Json}:{}),part:parts?.feedback()??null,
909
846
  interval: { frameStart, frameEnd, inclusive: true },
910
847
  checkpoint: checkpoint?.id ?? null, animation: selectedAnimation, time, frame: frameAtTime(activeFrameClock(), time),
911
848
  reference: select('reference-select').value || null, person: selectedPerson || null,
912
849
  sourceTime: sequence ? sequence.frames[0]!.t + time : time,
913
- camera: center ? { zoom, x: center.x, y: center.y, coordinateSystem: 'world-y-up' } : { zoom, coordinateSystem: 'reference-fit' },
850
+ camera: center ? { zoom:viewport.state.zoom, x: center.x, y: center.y, coordinateSystem: 'world-y-up' } : { zoom:viewport.state.zoom, coordinateSystem: 'reference-fit' },
914
851
  view:{...serializableView(numericView()),theme:appearance?.get()??'system',layers:{...layers}},
915
852
  axis: axisInspection ? { id: select('axis-select').value, value: Number(input('axis-value').value) } : null,
916
853
  environment: feedbackEnvironment(),
@@ -938,8 +875,9 @@ function bind(): void {
938
875
  } catch (error) { message(`Submission failed: ${errorText(error)}`, true); } finally { saving = false; updateSavedState(); }
939
876
  };
940
877
  // Saved browser defaults seed a new inspection; explicit links and source drafts restore over them.
878
+ viewDisposers.push(bindStageNav({model:!!data.manifest.model,setup:()=>showInspector('rig')}));
941
879
  workspace=bindWorkspaceUI({changed:fitCamera,defaultTheme:theme=>appearance?.set(theme),currentTheme:()=>appearance?.get()});
942
- cameraSync=workspace.defaults().defaultCameraSync;input('camera-sync').checked=cameraSync;input('idle-repeat').checked=workspace.defaults().defaultIdleRepeat;
880
+ viewport.state.cameraSync=workspace.defaults().defaultCameraSync;input('camera-sync').checked=viewport.state.cameraSync;input('idle-repeat').checked=workspace.defaults().defaultIdleRepeat;
943
881
  appearance=bindAppearance(select('settings-theme'),workspace.defaults().theme);
944
882
  inspectorBlocks=bindInspectorBlocks({sections:[el('inspector-rig'),el('inspector-playback')],changed:()=>persistence?.save()});
945
883
  overlays=new RigOverlays({canvas:el<HTMLCanvasElement>('rig-overlay'),rigRoot:el('rig-root')});
@@ -985,10 +923,7 @@ function bind(): void {
985
923
  retargetPanel=bindRetargetPanel({apply:body=>applyRetarget(body),reset:()=>{void resetRebuild(stageWorld());},seek:seekReading});
986
924
  requirementsPanel=bindRequirementsPanel({check:runRequirements,seek:seekReading,animation:()=>animation,slot:()=>parts?.value()?.slot??null,hash:sha256Hex});
987
925
  const tickResize=new ResizeObserver(()=>renderReadingTicks());tickResize.observe(el('transport'));viewDisposers.push(()=>tickResize.disconnect());
988
- viewDisposers.push(bindStageLayout(el('stage-layout'),fitCamera));
989
- // #331: a plain drag on the rig pans and carries the rig, the Family viewer's gesture; the reference pane only pans.
990
- const carryRig={threshold:CLICK_SLOP_PX,move:(dx:number,dy:number)=>{const impulse=dragImpulse(dx,dy,rigScale);if(impulse&&player)player.moved(impulse);}};
991
- for(const target of ['rig','reference'] as const)viewDisposers.push(bindPan(el(target+'-viewport'),(dx,dy)=>cameraAction(()=>panCamera(target,dx,dy)),()=>!comments?.active(),target==='rig'?carryRig:undefined));
926
+ viewDisposers.push(viewport.bindNavigation(rigPanCarry({player:()=>player},viewport.state),()=>!comments?.active()));
992
927
  for(const [id,key] of [['layer-images','images'],['layer-mesh','mesh'],['layer-bones','bones']] as const)input(id).onchange=()=>{layers[key]=input(id).checked;redrawOverlay(false);};
993
928
  viewDisposers.push(bindLayerShortcuts(document));describeLayerToggles(document,el('layer-state').textContent??'');
994
929
  input('idle-repeat').onchange=()=>{syncPlayerLoop();renderIdle();if(canRepeatIdle())void playPreview();};
@@ -996,7 +931,7 @@ function bind(): void {
996
931
  for(const id of ['proposal-panel','checkpoint-detail'])el(id).addEventListener('focusin',pause);
997
932
  bindInspector();bindReviewDialog();
998
933
  document.addEventListener('visibilitychange',()=>{if(document.hidden){const resume=playing;pause();suspendedPreview=resume;}else if(suspendedPreview){suspendedPreview=false;void playPreview();}});
999
- const resize = new ResizeObserver(fitCamera); resize.observe(el('rig-viewport')); resize.observe(el('reference-viewport'));
934
+ const resize = viewport.observeResize();
1000
935
  window.addEventListener('beforeunload', event => { if (dirty) { event.preventDefault(); event.returnValue = ''; } });
1001
936
  window.addEventListener('pagehide', () => { comments?.dispose();persistence?.dispose();turnPad?.dispose();workspace?.dispose();pause();controlDispose?.();appearance?.dispose();viewDisposers.forEach(dispose=>dispose());overlays?.dispose(); player?.dispose(); assets?.dispose(); resize.disconnect(); });
1002
937
  }
@@ -1014,7 +949,7 @@ async function start(): Promise<void> {
1014
949
  // Checkpoints and reference fold away when the package supplies neither.
1015
950
  (el('package-context') as HTMLDetailsElement).open = data.manifest.checkpoints.length > 0 || data.manifest.references.length > 0;
1016
951
  const sourceFiles = el('source-files'); for (const file of data.manifest.authoring) { const a = document.createElement('a'); a.href = assetUrl(file.path); a.textContent = file.label; a.className = 'source-link'; a.target = '_blank'; a.rel = 'noopener'; sourceFiles.append(a); } if (!data.manifest.authoring.length) sourceFiles.textContent = 'No source files supplied';
1017
- populateChestBones(); bind(); parts=new PartExplorer(el('workspace-left'),el('selected-part'),previous=>{if(player&&inspectionSourceState==='ready')animationPanel?.capture(player,parts?.frame('single'));else animationPanel?.capture(null,undefined);weightsView?.refresh();redrawOverlay(true);meshEditor?.selectionChanged();const part=parts?.value();animationPanel?.fromParts(part?.slot??null);meshPanel?.select(part?.slot??null);requirementsPanel?.selectionChanged();renderDropNotices();if(part){activeCamera='rig';if(view==='reference')setView('rig');if(selectedInspector(document)!=='playback')showInspector('rig');renderCameraControls();}if(!cameraRestoring&&(previous?.side!==part?.side||previous?.slot!==part?.slot))cameraAction(()=>fitActiveCamera(part?'rig':availableCamera()));persistence?.save();},part=>{select('feedback-target-kind').value='slot';renderFeedbackTargets(true);input('feedback-target-name').value=part.slot;showInspector('feedback');}); animationPanel=new AnimationInspectionPanel({host:el('animation-inspection'),stage:el('rig-viewport'),project:(x,y)=>rigProject()(x,y),enabled:()=>inspectionSourceState==='ready'&&selectedInspector(document)==='playback',pause,preview:fn=>{animAdjust=fn;if(!player)return;player.adjust=composeAdjust(composeAdjust(composeAdjust(idleAdjust,dialAdjust),turnAdjust),animAdjust);if(!inDrawRig&&player.current&&!playing){player.seek(time);drawRig(()=>player!.draw());}},apply:ops=>applyAnimation(ops),reset:()=>resetAnimationBuild(),seek:exact=>{if(!Number.isFinite(exact)||exact<0||exact>duration){message('KEY_TIME_OUT_OF_DOMAIN: no substitute time was used.',true);return;}seekMarker(animation,exact,'Stored key');},select:value=>{const slot=value?.kind==='slot'?value.name:null;if((parts?.value()?.slot??null)!==slot)parts?.select(slot?{side:'single',slot,mode:parts?.value()?.mode??'context'}:null);parts?.highlightBone(value?.kind==='bone'?value.name:null);redrawOverlay(false);}});viewDisposers.push(()=>animationPanel?.dispose()); updateStripControls(); stripStatus('Choose the entered start–end frames or all feedback ranges to download. Unsubmitted feedback is included; exporting does not submit the review.'); renderFeedbackTargets(true); renderFeedbackRange(); renderCheckpoints(); renderProposals(); renderProvenance(); updateSavedState(); renderCues(); initReport();
952
+ populateChestBones(); bind(); parts=new PartExplorer(el('workspace-left'),el('selected-part'),previous=>{if(player&&inspectionSourceState==='ready')animationPanel?.capture(player,parts?.frame('single'));else animationPanel?.capture(null,undefined);weightsView?.refresh();redrawOverlay(true);meshEditor?.selectionChanged();const part=parts?.value();animationPanel?.fromParts(part?.slot??null);meshPanel?.select(part?.slot??null);requirementsPanel?.selectionChanged();renderDropNotices();if(part){viewport.state.activeCamera='rig';if(view==='reference')setView('rig');if(selectedInspector(document)!=='playback')showInspector('rig');renderCameraControls();}if(!viewport.state.cameraRestoring&&(previous?.side!==part?.side||previous?.slot!==part?.slot))cameraAction(()=>fitActiveCamera(part?'rig':availableCamera()));persistence?.save();},part=>{select('feedback-target-kind').value='slot';renderFeedbackTargets(true);input('feedback-target-name').value=part.slot;showInspector('feedback');}); animationPanel=new AnimationInspectionPanel({host:el('animation-inspection'),stage:el('rig-viewport'),project:(x,y)=>rigProject()(x,y),enabled:()=>inspectionSourceState==='ready'&&selectedInspector(document)==='playback',pause,preview:fn=>{animAdjust=fn;if(!player)return;player.adjust=composeAdjust(composeAdjust(composeAdjust(idleAdjust,dialAdjust),turnAdjust),animAdjust);if(!inDrawRig&&player.current&&!playing){player.seek(time);drawRig(()=>player!.draw());}},apply:ops=>applyAnimation(ops),reset:()=>resetAnimationBuild(),seek:exact=>{if(!Number.isFinite(exact)||exact<0||exact>duration){message('KEY_TIME_OUT_OF_DOMAIN: no substitute time was used.',true);return;}seekMarker(animation,exact,'Stored key');},select:value=>{const slot=value?.kind==='slot'?value.name:null;if((parts?.value()?.slot??null)!==slot)parts?.select(slot?{side:'single',slot,mode:parts?.value()?.mode??'context'}:null);parts?.highlightBone(value?.kind==='bone'?value.name:null);redrawOverlay(false);}});viewDisposers.push(()=>animationPanel?.dispose()); updateStripControls(); stripStatus('Choose the entered start–end frames or all feedback ranges to download. Unsubmitted feedback is included; exporting does not submit the review.'); renderFeedbackTargets(true); renderFeedbackRange(); renderCheckpoints(); renderProposals(); renderProvenance(); updateSavedState(); renderCues(); initReport();
1018
953
  const requestedId = new URLSearchParams(location.search).get('checkpoint'),initial=initialReviewSelection(data.manifest,requestedId,data.explicitReference?.id,data.initialAnimation??undefined),first=initial.checkpoint;
1019
954
  rigInput=data.manifest.model?{state:'pending'}:{state:'absent'};renderLayout();
1020
955
  if(initial.referenceId){select('reference-select').value=initial.referenceId;await showReference(initial.referenceId);}
@@ -1023,7 +958,7 @@ async function start(): Promise<void> {
1023
958
  updateChestMapping();
1024
959
  rigInput=player?{state:'loaded'}:data.manifest.model?{state:'failed',reason:el('rig-empty').textContent||'compiled player unavailable'}:{state:'absent'};renderLayout();
1025
960
  if (first) await chooseCheckpoint(first,initial); else renderCheckpoint();
1026
- activeCamera=player?'rig':'reference';if(cameraSync)alignCameras();renderTransport();fitCamera();
961
+ viewport.state.activeCamera=player?'rig':'reference';if(viewport.state.cameraSync)alignCameras();renderTransport();fitCamera();
1027
962
  if (requestedId && !first) message(`Checkpoint "${requestedId}" is not in this package. Select one from the list.`, true);
1028
963
  else if (readOnly) message(readOnly, true);
1029
964
  else message(data.manifest.model ? 'Record review status and structured feedback while preserving sources. Motion is read only.' : 'No rig supplied. Review the available references and checkpoints.');
@@ -1037,7 +972,7 @@ async function start(): Promise<void> {
1037
972
  function showInspector(name:string,reveal=true):void {if(name==='feedback'){if(reveal)openReview();return;}if(reveal)workspace?.revealInspector();const selector=document.querySelector<HTMLButtonElement>(`[data-inspector="${name}"]`);if(selector&&selector.getAttribute('aria-pressed')!=='true'&&selector.getAttribute('aria-selected')!=='true')selector.click();}
1038
973
  function bindInspector():void {bindInspectorTabs(()=>{workspace?.afterTab();fitCamera();},()=>workspace?.beforeTab());}
1039
974
  /** Opening the review pauses playback, as selecting Feedback did. Its inputs stay in the document whether or not it is open, so the draft keeps them. */
1040
- function openReview():void {const dialog=el<HTMLDialogElement>('review-dialog');for(const drawer of document.querySelectorAll<HTMLDialogElement>('dialog.workspace-drawer[open]'))drawer.close();pause();if(!dialog.open)dialog.showModal();}
975
+ function openReview():void {document.querySelector<HTMLButtonElement>('[data-review-stage="3"]')?.click();const dialog=el<HTMLDialogElement>('review-dialog');for(const drawer of document.querySelectorAll<HTMLDialogElement>('dialog.workspace-drawer[open]'))drawer.close();pause();if(!dialog.open)dialog.showModal();}
1041
976
  function bindReviewDialog():void {
1042
977
  const dialog=el<HTMLDialogElement>('review-dialog');
1043
978
  button('write-review').onclick=openReview;button('review-dialog-close').onclick=()=>dialog.close();
@@ -1047,7 +982,7 @@ function bindReviewDialog():void {
1047
982
  }
1048
983
 
1049
984
  /** Rig world → rig-pane pixels for the current camera. */
1050
- function rigProject(){const root=el('rig-root');return (x:number,y:number)=>({x:parseFloat(root.style.left||'0')+x*rigScale,y:parseFloat(root.style.top||'0')-y*rigScale});}
985
+ function rigProject(){const root=el('rig-root');return (x:number,y:number)=>({x:parseFloat(root.style.left||'0')+x*viewport.state.rigScale,y:parseFloat(root.style.top||'0')-y*viewport.state.rigScale});}
1051
986
  function redrawOverlay(fresh:boolean):void {
1052
987
  animationPanel?.redraw(layers.bones);
1053
988
  if(!overlays||!player)return;
@@ -1078,7 +1013,7 @@ async function playPreview():Promise<void> {
1078
1013
  function localDraft():boolean{return !!comments?.draft()||dirty||!!input('feedback-summary').value.trim()||!!input('feedback-start').value.trim()||!!input('feedback-end').value.trim()||!!select('feedback-category').value||!!input('feedback-target-name').value.trim()&&input('feedback-target-name').value!==data.manifest.id;}
1079
1014
  function controlState():ControlInspection {
1080
1015
  const box=assets?.stage??player?.bounds(),center=box?{x:box.x+box.width/2,y:box.y+box.height/2}:null;
1081
- return {part:parts?.value()??null,partGeneration:parts?.observation()?.generation??null,view:numericView(),theme:appearance?.get()??'system',layout:'auto',effectiveLayout:el('stage-layout').dataset.orientation==='vertical'?'column':'row',cameras:{rig:{zoom:player?zoom:1,pan:{x:center&&cameraCenter?(center.x-cameraCenter.x)*rigScale:0,y:center&&cameraCenter?(cameraCenter.y-center.y)*rigScale:0}},reference:{zoom:referenceSize?referenceZoom:1,pan:{x:referenceSize&&referenceCenter?(referenceSize.width/2-referenceCenter.x)*referenceScale:0,y:referenceSize&&referenceCenter?(referenceSize.height/2-referenceCenter.y)*referenceScale:0}}},animation:animation||null,time:player?.time??time,playing,loop:canRepeatIdle()?'idle':'off',layers:{images:!!player&&layers.images,meshes:!!player&&layers.mesh,bones:!!player&&layers.bones},ready:!!data,seeking:seekingControl||!!video?.seeking||!!persistence?.restoring(),dirty:localDraft(),busy:saving||stripBusy||!!persistence?.restoring(),feedbackEligible:!persistence?.restoring(),comparison:controlComparison(layoutEligibility()),capabilities:{camera:!!player,referenceCamera:!!referenceSize,animation:!!player,time:duration>0,playback:duration>0,layers:{images:!!player,meshes:!!player,bones:!!player}}};
1016
+ return {part:parts?.value()??null,partGeneration:parts?.observation()?.generation??null,view:numericView(),theme:appearance?.get()??'system',layout:'auto',effectiveLayout:el('stage-layout').dataset.orientation==='vertical'?'column':'row',cameras:{rig:{zoom:player?viewport.state.zoom:1,pan:{x:center&&viewport.state.cameraCenter?(center.x-viewport.state.cameraCenter.x)*viewport.state.rigScale:0,y:center&&viewport.state.cameraCenter?(viewport.state.cameraCenter.y-center.y)*viewport.state.rigScale:0}},reference:{zoom:referenceSize?viewport.state.referenceZoom:1,pan:{x:referenceSize&&viewport.state.referenceCenter?(referenceSize.width/2-viewport.state.referenceCenter.x)*viewport.state.referenceScale:0,y:referenceSize&&viewport.state.referenceCenter?(referenceSize.height/2-viewport.state.referenceCenter.y)*viewport.state.referenceScale:0}}},animation:animation||null,time:player?.time??time,playing,loop:canRepeatIdle()?'idle':'off',layers:{images:!!player&&layers.images,meshes:!!player&&layers.mesh,bones:!!player&&layers.bones},ready:!!data,seeking:seekingControl||!!video?.seeking||!!persistence?.restoring(),dirty:localDraft(),busy:saving||stripBusy||!!persistence?.restoring(),feedbackEligible:!persistence?.restoring(),comparison:controlComparison(layoutEligibility()),capabilities:{camera:!!player,referenceCamera:!!referenceSize,animation:!!player,time:duration>0,playback:duration>0,layers:{images:!!player,meshes:!!player,bones:!!player}}};
1082
1017
  }
1083
1018
  async function applyControl(command:ControlCommand,signal:AbortSignal):Promise<void> {
1084
1019
  if(signal.aborted)throw new Error('CONTROL_SUPERSEDED');
@@ -1138,11 +1073,7 @@ async function decodedControlTime(media:HTMLVideoElement,target:number,signal:Ab
1138
1073
  media.currentTime=target;
1139
1074
  });
1140
1075
  }
1141
- function numericView():ControlView {
1142
- const numeric=(target:CameraTarget)=>{const frame=paneFrame(target,true);if(!frame)return null;const camera=paneCamera(target);return numericCamera(frame.space,camera.center??frame.center,camera.zoom,frame.baseScale*camera.zoom,frame.width,frame.height);};
1143
- return {schema:'rig-review-view/1',cameraSync,activeCamera,cameras:{rig:numeric('rig'),a:null,b:null,reference:numeric('reference')}};
1144
- }
1145
- function renderNumericView():void {const node=document.getElementById('view-coordinates');if(node)node.textContent=JSON.stringify(numericView(),null,2);}
1076
+ function numericView():ControlView {return viewport.numericView();}
1146
1077
  function inspectionBinding():InspectionBinding{return {mode:'single',sourceHash:data.sourceHash,rigs:[data.reviewedSource.rig?.sha256??null]};}
1147
1078
  function inspectionBookmark():InspectionBookmark {return {schema:'rig-review-inspection/1',binding:inspectionBinding(),animation:animation||null,time:player?.time??time,theme:appearance?.get()??'system',layers:{images:layers.images,meshes:layers.mesh,bones:layers.bones},view:numericView(),selection:{...(turnPad?{turn:turnPad.snapshot()}:{}),part:parts?.value()??null,view,checkpoint:checkpoint?.id??null,reference:select('reference-select').value||null,person:selectedPerson||null,inspector:selectedInspector()??'view',partSet:select('part-set').disabled?null:select('part-set').value,axis:axisInspection?{id:select('axis-select').value,value:Number(input('axis-value').value)}:null}};}
1148
1079
  async function restoreInspection(bookmark:InspectionBookmark,signal:AbortSignal,preserveSeconds=false):Promise<void> {
@@ -1181,7 +1112,7 @@ async function prepareInspection(bookmark:InspectionBookmark,signal:AbortSignal)
1181
1112
  if(signal.aborted)throw new Error('Inspection restore superseded');
1182
1113
  }
1183
1114
  async function applyInspection(bookmark:InspectionBookmark,signal:AbortSignal,preserveSeconds=false):Promise<void> {
1184
- cameraRestoring=true;try{
1115
+ viewport.state.cameraRestoring=true;try{
1185
1116
  const selection=bookmark.selection;
1186
1117
  if(turnPad){if(selection.turn)turnPad.restore(selection.turn);else{turnPad.state.reset();turnPad.restore(turnPad.snapshot());}}
1187
1118
  parts?.select(selection.part??null);
@@ -1201,13 +1132,13 @@ async function applyInspection(bookmark:InspectionBookmark,signal:AbortSignal,pr
1201
1132
  // while restoration is held, before measuring/applying the saved pane camera.
1202
1133
  await new Promise<void>(resolve=>requestAnimationFrame(()=>requestAnimationFrame(()=>resolve())));if(signal.aborted)throw new Error('Inspection restore superseded');fitCamera();
1203
1134
  const camera=bookmark.view.cameras.rig,ref=bookmark.view.cameras.reference,rigViewport=el('rig-viewport'),referenceViewport=el('reference-viewport');
1204
- const nextZoom=camera&&player&&rigViewport.clientWidth&&rigViewport.clientHeight?restoredZoom(camera,rigScale/zoom,rigViewport.clientWidth,rigViewport.clientHeight):camera?.zoom??null;
1205
- const nextReferenceZoom=ref&&referenceSize&&referenceViewport.clientWidth&&referenceViewport.clientHeight?restoredZoom(ref,referenceScale/referenceZoom,referenceViewport.clientWidth,referenceViewport.clientHeight):ref?.zoom??null;
1206
- if(nextZoom!==null&&camera){zoom=nextZoom;cameraCenter={...camera.center};}
1207
- if(nextReferenceZoom!==null&&ref){referenceZoom=nextReferenceZoom;referenceCenter={...ref.center};}
1208
- cameraSync=bookmark.view.cameraSync??false;activeCamera=bookmark.view.activeCamera==='reference'?'reference':'rig';
1135
+ const nextZoom=camera&&player&&rigViewport.clientWidth&&rigViewport.clientHeight?restoredZoom(camera,viewport.state.rigScale/viewport.state.zoom,rigViewport.clientWidth,rigViewport.clientHeight):camera?.zoom??null;
1136
+ const nextReferenceZoom=ref&&referenceSize&&referenceViewport.clientWidth&&referenceViewport.clientHeight?restoredZoom(ref,viewport.state.referenceScale/viewport.state.referenceZoom,referenceViewport.clientWidth,referenceViewport.clientHeight):ref?.zoom??null;
1137
+ if(nextZoom!==null&&camera){viewport.state.zoom=nextZoom;viewport.state.cameraCenter={...camera.center};}
1138
+ if(nextReferenceZoom!==null&&ref){viewport.state.referenceZoom=nextReferenceZoom;viewport.state.referenceCenter={...ref.center};}
1139
+ viewport.state.cameraSync=bookmark.view.cameraSync??false;viewport.state.activeCamera=bookmark.view.activeCamera==='reference'?'reference':'rig';
1209
1140
  if(player)drawRig(()=>player!.draw());if(selection.part)parts?.assertIdentity(selection.part);fitCamera();redrawOverlay(false);pause();renderTransport();renderCameraControls();
1210
- }finally{cameraRestoring=false;}
1141
+ }finally{viewport.state.cameraRestoring=false;}
1211
1142
  }
1212
1143
  async function waitReferenceMetadata(media:HTMLVideoElement,signal:AbortSignal):Promise<void> {if(media.readyState>=1)return;await new Promise<void>((resolve,reject)=>{const clean=()=>{clearTimeout(timer);media.removeEventListener('loadedmetadata',ready);media.removeEventListener('error',fail);signal.removeEventListener('abort',fail);};const ready=()=>{clean();resolve();},fail=()=>{clean();reject(new Error('Saved reference metadata unavailable'));};const timer=setTimeout(fail,10000);media.addEventListener('loadedmetadata',ready,{once:true});media.addEventListener('error',fail,{once:true});signal.addEventListener('abort',fail,{once:true});});}
1213
1144
  async function setupPersistence():Promise<boolean> {
@@ -15,6 +15,15 @@ const box4 = (v: unknown): v is [number, number, number, number] => Array.isArra
15
15
 
16
16
  export function flagLabel(flag: LabelledFlag, t: Translate): string {
17
17
  if (flag.kind === 'faint') return t('Faint island left out of the mesh: {art} px, brightest alpha {alpha}, at {x},{y} {width}×{height} (part-image px).', { art: flag.art, alpha: flag.maxAlpha, x: flag.box[0], y: flag.box[1], width: flag.box[2], height: flag.box[3] });
18
+ // Exact location plus the row's own string fields: pair, front/back, part, status, reason, and unknown fields
19
+ // all survive without assigning meaning to a code or inferring scope. The path distinguishes even sparse rows.
20
+ const identity = Object.entries(flag.entry)
21
+ .filter(([, v]) => str(v) || (Array.isArray(v) && v.length > 0 && v.every(str)))
22
+ .map(([k, v]) => `${k}: ${JSON.stringify(v)}`);
23
+ return [`${flag.root} · ${flag.path}`, ...identity, checkReadings(flag, t)].join(' · ');
24
+ }
25
+
26
+ function checkReadings(flag: Extract<LabelledFlag, { kind: 'check' }>, t: Translate): string {
18
27
  const e = flag.entry;
19
28
  if (flag.root === 'figure_openings' && str(e.under) && str(e.above) && str(e.animation) && num(e.frame) && num(e.time) && num(e.found_cells) && num(e.allowed_cells))
20
29
  return t('{under} opens under {above} · {animation} f{frame} ({time} s) · {found} cells found / {allowed} allowed', { under: e.under, above: e.above, animation: e.animation, frame: e.frame, time: e.time, found: e.found_cells, allowed: e.allowed_cells });
@@ -23,9 +32,9 @@ export function flagLabel(flag: LabelledFlag, t: Translate): string {
23
32
  return box4(e.rig_box) ? `${line} · ${t('rig box {x},{y} {width}×{height}', { x: e.rig_box[0], y: e.rig_box[1], width: e.rig_box[2], height: e.rig_box[3] })}` : line;
24
33
  }
25
34
  if (flag.status !== null) {
26
- // A gate: its name and status, the part, then the entry's own numeric readings by their producer names.
35
+ // This is the enclosing block's status, not necessarily this row's status or an acceptance verdict.
27
36
  const readings = Object.entries(e).filter(([, v]) => num(v)).map(([k, v]) => `${k} ${v}`);
28
- return [t('{gate} {status} on {part}', { gate: flag.root, status: flag.status, part: flag.item }), ...readings].join(' · ');
37
+ return [t('Block {gate}: {status} · {part}', { gate: flag.root, status: flag.status, part: flag.item }), ...readings].join(' · ');
29
38
  }
30
39
  return t('Check line {path}', { path: flag.path });
31
40
  }
@@ -9,6 +9,7 @@
9
9
  export interface Box { name: string; index: number; x: number; y: number; w: number; h: number }
10
10
  type Ctx = CanvasRenderingContext2D;
11
11
  type Source = CanvasImageSource;
12
+ import type {PaintingRectangle} from '../src/parts-comparison.ts';
12
13
 
13
14
  /** Sentinel backgrounds: colours no art is expected to hold, so a sliver of empty canvas is plain. */
14
15
  export const SENTINELS: Readonly<Record<string, string>> = { green: '#00ff00', magenta: '#ff00ff', black: '#000000', white: '#ffffff' };
@@ -45,9 +46,13 @@ export function paintPart(ctx: Ctx, item: Box, image: Source, options: { bg: str
45
46
  const { w, h } = item;
46
47
  if (options.alpha) paintAlphaOnly(ctx, image, 0, 0, w, h);
47
48
  else { paintBackground(ctx, w, h, options.bg); ctx.drawImage(image, 0, 0); }
48
- if (!options.fronts.length) return;
49
- const mask = options.makeCanvas(w, h), m = mask.getContext('2d')!;
50
- for (const f of options.fronts) m.drawImage(f.image, f.box.x - item.x, f.box.y - item.y);
49
+ paintFootprints(ctx,item,options.fronts,options.makeCanvas);
50
+ }
51
+ export function paintFootprints(ctx:Ctx,item:Box,fronts:readonly {box:Box;image:Source}[],makeCanvas:(w:number,h:number)=>HTMLCanvasElement):void {
52
+ if (!fronts.length) return;
53
+ const {w,h}=item;
54
+ const mask = makeCanvas(w, h), m = mask.getContext('2d')!;
55
+ for (const f of fronts) m.drawImage(f.image, f.box.x - item.x, f.box.y - item.y);
51
56
  m.globalCompositeOperation = 'source-in';
52
57
  m.fillStyle = `rgb(${FOOTPRINT_RGB.join(',')})`;
53
58
  m.fillRect(0, 0, w, h);
@@ -56,6 +61,17 @@ export function paintPart(ctx: Ctx, item: Box, image: Source, options: { bg: str
56
61
  ctx.globalAlpha = 1;
57
62
  }
58
63
 
64
+ /** Original painting's continuous rectangle, displayed with browser interpolation; no native-pixel parity claim. */
65
+ export function paintPaintingCrop(ctx:Ctx,painting:Source,source:PaintingRectangle,w:number,h:number,bg:string):void {
66
+ paintBackground(ctx,w,h,bg);ctx.imageSmoothingEnabled=true;
67
+ ctx.drawImage(painting,source.x,source.y,source.width,source.height,0,0,w,h);
68
+ ctx.imageSmoothingEnabled=false;
69
+ }
70
+ export function paintOverlay(ctx:Ctx,item:Box,image:Source,painting:Source,source:PaintingRectangle,opacity:number,bg:string):void {
71
+ paintPaintingCrop(ctx,painting,source,item.w,item.h,bg);
72
+ ctx.globalAlpha=opacity;ctx.drawImage(image,0,0);ctx.globalAlpha=1;
73
+ }
74
+
59
75
  export interface MeshGeometry { vertices: readonly number[]; triangles: readonly number[] }
60
76
  /** Closed triangle union at pixel centres. Degenerate triangles cover no area. */
61
77
  export function meshCoverage(w: number, h: number, mesh: MeshGeometry): Uint8Array {
@@ -0,0 +1,14 @@
1
+ /** Native image policy for the canonical pair. Camera gestures and writes belong to viewport-controller. */
2
+ import {createViewportController,createViewportState,type ViewportProvider} from './viewport-controller.ts';
3
+ import {t} from './i18n.ts';
4
+ export function createPartsViewport(host:{el:ViewportProvider['el'];canvas:HTMLCanvasElement;message:ViewportProvider['message'];reference:()=>HTMLCanvasElement|null}){
5
+ const state=createViewportState();state.cameraSync=false;
6
+ const provider:ViewportProvider={el:host.el,message:host.message,nativeScale:true,
7
+ panes:(['rig','reference'] as const).map(target=>({target,viewport:host.el(target+'-viewport'),pane:host.el(target+'-pane')})),
8
+ geometry:target=>{const canvas=target==='rig'?host.canvas:host.reference();return canvas?{space:'image',box:{x:0,y:0,width:canvas.width,height:canvas.height},marginX:24,marginY:24}:null;},
9
+ layoutKey:()=>[host.canvas.width,host.canvas.height,host.reference()?.width??0,host.reference()?.height??0,host.el('rig-viewport').clientWidth,host.el('rig-viewport').clientHeight].join(':'),selection:()=>({selected:false,bounds:null}),
10
+ render:controller=>{for(const target of ['rig','reference'] as const){const frame=controller.paneFrame(target);if(!frame)continue;const c=controller.paneCamera(target),center=c.center??frame.center,root=host.el(target==='rig'?'rig-root':'reference-content');root.style.left=`${frame.width/2-center.x*c.zoom}px`;root.style.top=`${frame.height/2-center.y*c.zoom}px`;root.style.transform=`scale(${c.zoom})`;if(target==='rig'){state.rigScale=c.zoom;state.displayedCenter={...center};}}controller.renderCameraControls();},
11
+ renderControls:controller=>{const zoom=controller.paneCamera(controller.availableCamera()??'rig').zoom;host.el('zoom-value').textContent=zoom===1?t('1:1'):`${(zoom*100).toFixed(1)}%`;host.el('native-one').setAttribute('aria-pressed',String(zoom===1));(host.el('camera-sync') as HTMLInputElement).checked=state.cameraSync;host.el('fit').textContent=t('Fit');}
12
+ };
13
+ return createViewportController(provider,state);
14
+ }
package/web/parts.css CHANGED
@@ -14,13 +14,13 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px/1.4 system-ui,-ap
14
14
  .pv-side{border-left:1px solid var(--line)}
15
15
  h2{font-size:11px;letter-spacing:.06em;color:var(--muted);margin:4px 0 8px}
16
16
  #pv-items{list-style:none;margin:0;padding:0}
17
- #pv-items li button{width:100%;display:flex;gap:6px;align-items:center;text-align:left;border:0;background:none;color:inherit;padding:4px 6px;border-radius:5px;cursor:pointer;font:inherit}
17
+ #pv-items li button{width:100%;display:grid;grid-template-columns:minmax(0,1fr) auto;gap:2px 6px;align-items:center;text-align:left;border:0;background:none;color:inherit;padding:4px 6px;border-radius:5px;cursor:pointer;font:inherit}
18
18
  #pv-items li button[aria-current="true"]{background:color-mix(in srgb,var(--accent) 18%,transparent)}
19
- .pv-name{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
20
- .pv-badge{font-size:10px;padding:0 5px;border-radius:8px;border:1px solid var(--line);color:var(--muted)}
19
+ .pv-name{grid-column:1;grid-row:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
20
+ .pv-badge{grid-column:2;grid-row:1;font-size:10px;padding:0 5px;border-radius:8px;border:1px solid var(--line);color:var(--muted)}
21
21
  .pv-badge[data-outcome="clean"]{color:var(--clean);border-color:var(--clean)}
22
22
  .pv-badge[data-outcome="flagged"]{color:var(--flag);border-color:var(--flag)}
23
- .pv-count{font-size:10px;color:var(--flag)}
23
+ .pv-count{grid-column:1/-1;grid-row:2;font-size:10px;color:var(--muted);white-space:nowrap}
24
24
  .pv-stage{display:flex;flex-direction:column;min-width:0;min-height:0}
25
25
  .pv-toolbar{display:flex;flex-wrap:wrap;gap:12px;align-items:center;padding:8px 12px;border-bottom:1px solid var(--line)}
26
26
  .pv-field{display:flex;align-items:center;gap:5px}
@@ -37,8 +37,12 @@ h2{font-size:11px;letter-spacing:.06em;color:var(--muted);margin:4px 0 8px}
37
37
  .pv-box span{position:absolute;left:0;top:-14px;font-size:10px;line-height:12px;background:#000c;color:#fff;padding:0 3px;white-space:nowrap}
38
38
  .pv-region-edge{position:absolute;border:1px dashed #0ff;pointer-events:none}
39
39
  #pv-caption{padding:0 12px 8px;margin:0}
40
- #pv-flags{list-style:none;margin:0;padding:0}
41
- #pv-flags li{border-left:3px solid var(--flag);padding:4px 6px;margin-bottom:6px;background:color-mix(in srgb,var(--flag) 8%,transparent);word-break:break-word}
40
+ #pv-flags,#pv-flags ul{list-style:none;margin:0;padding:0}
41
+ #pv-flags li[data-flag-id]{border-left:3px solid var(--flag);padding:4px 6px;margin-bottom:6px;background:color-mix(in srgb,var(--flag) 8%,transparent);overflow-wrap:anywhere}
42
+ #pv-flags h3{font-size:12px;margin:8px 0 4px}
43
+ #pv-flags details[data-pv-root]{margin-bottom:6px;overflow-wrap:anywhere}
44
+ #pv-flags details[data-pv-root]>summary{font-size:12px;color:var(--text);padding:5px 0}
45
+ #pv-flags details[data-pv-root]>ul{padding-top:4px}
42
46
  #pv-flags code{font-size:11px;display:block;margin-top:4px;color:var(--muted)}
43
47
  #pv-flags details{margin-top:3px}
44
48
  #pv-flags summary{cursor:pointer;font-size:11px;color:var(--muted)}
@@ -56,3 +60,33 @@ textarea,select{font:inherit;color:inherit;background:var(--bg);border:1px solid
56
60
  #pv-mesh-panel p{margin:4px 0}
57
61
  #pv-mesh-panel label{display:flex;flex-direction:column;gap:4px}
58
62
  #pv-mesh-panel textarea{height:48px;resize:vertical}
63
+
64
+ /* Stage navigation retains mounted inspection tools and their state. */
65
+ .review-stage-nav{display:flex;gap:4px;flex-wrap:wrap;align-items:center}
66
+ .review-stage-nav button{font:inherit;white-space:nowrap;padding:5px 8px}
67
+ .review-stage-nav [aria-current="step"]{font-weight:700;text-decoration:underline;text-underline-offset:4px}
68
+ .review-stage-panel{position:fixed;inset:0;z-index:90;display:flex;flex-direction:column;padding:12px;background:var(--bg);color:inherit;overflow:auto}
69
+ .review-stage-panel[hidden]{display:none}
70
+ .review-stage-panel iframe{width:100%;flex:1;min-height:240px;border:0;background:var(--bg)}
71
+ .review-stage-panel iframe[hidden]{display:none}
72
+ .topbar,.pv-top{flex-wrap:wrap}
73
+
74
+ .pv-top[hidden],.pv-verdict[hidden],.review-stage-nav[hidden]{display:none}
75
+
76
+ /* Availability controls remain absent when the controller marks them hidden. */
77
+ .pv-app [hidden]{display:none!important}
78
+
79
+ /* Embedded loading/refusals must stay outside the deliberately hidden app header. */
80
+ #pv-load.pv-embedded-status{margin:0;padding:10px 14px;background:var(--panel);border-bottom:1px solid var(--line);overflow-wrap:anywhere}
81
+ #pv-load.pv-embedded-status[data-result="refused"]{color:var(--flag)}
82
+
83
+ /* The actual canonical viewport pair hosts both standalone parts and the compiled Stage 1 frame. */
84
+ .pv-stage{position:relative}.pv-canvas-wrap{padding:0;overflow:hidden;display:flex;min-height:180px}
85
+ .stage-pane{position:relative;flex:1;min-width:0;min-height:0;overflow:hidden}.viewport{position:absolute;inset:0;overflow:hidden;touch-action:none;background:var(--bg)}
86
+ .pane-label{position:absolute;top:4px;left:6px;z-index:2;pointer-events:none}#rig-root{position:absolute;transform-origin:0 0}#rig-overlay{position:absolute;pointer-events:none}#reference-content{position:absolute;transform-origin:0 0}
87
+ :root{--link:var(--accent);--btn-fg:var(--panel);--rv-panel:var(--panel);--rv-backdrop:var(--line);--fg-muted:var(--muted);--fail:var(--flag);--border:var(--line);--border-strong:var(--line)}
88
+ main{position:relative}.toolbar{anchor-name:--stage-comment-bar}#stage-comment{white-space:nowrap;flex:none}#stage-comment-refusal{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.stage-comment-refusal-note{display:block;margin-top:4px;max-width:100%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:11px;color:var(--fg-muted)}.stage-comment-mode{cursor:crosshair}.stage-comment-mode video{pointer-events:none}.stage-comment-layer{position:absolute;inset:0;pointer-events:none;z-index:20;overflow:hidden}.stage-comment-region{position:absolute;border:2px solid var(--link);pointer-events:none}.stage-comment-pin{position:absolute;transform:translate(-50%,-50%);border-radius:50%;min-width:26px;height:26px;padding:2px 5px;background:var(--link);color:var(--btn-fg);pointer-events:auto}.stage-comment-composer{position:absolute;z-index:30;width:286px;max-width:calc(100% - 8px);max-height:calc(100% - 8px);overflow:auto;overflow-wrap:anywhere;padding:10px;background:var(--rv-panel);border:1px solid var(--link);border-radius:6px;box-shadow:0 4px 20px var(--rv-backdrop)}.stage-comment-composer input{width:100%}.stage-comment-composer small{display:block;margin-top:6px;color:var(--fg-muted)}.stage-comment-composer p{color:var(--fail);margin:4px 0}.stage-comment-list{position:absolute;position-anchor:--stage-comment-bar;z-index:40;right:8px;top:calc(anchor(bottom,50px) + 5px);width:310px;max-width:90%;max-height:60%;overflow:auto;background:var(--rv-panel);border:1px solid var(--border-strong);padding:12px;border-radius:6px}.stage-comment-item{padding:8px 0;border-bottom:1px solid var(--border)}.stage-comment-item>button:first-child{display:block;width:100%;text-align:left;overflow-wrap:anywhere}.stage-comment-item span{display:block;color:var(--fg-muted)}
89
+
90
+ #pv-reference{image-rendering:pixelated;image-rendering:crisp-edges;display:block}
91
+
92
+ .pv-comparison{display:flex;flex-wrap:wrap;align-items:center;gap:12px}#pv-opacity{width:100px}
package/web/parts.html CHANGED
@@ -3,18 +3,24 @@
3
3
  <head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>rig review parts</title><link rel="stylesheet" href="parts.css"></head>
4
4
  <body>
5
5
  <div id="parts-app" class="pv-app">
6
- <header class="pv-top"><div class="pv-brand"><span class="pv-mark">r</span>rig review</div><div><strong id="pv-title">Parts review</strong> <span id="pv-mode" class="pv-subtle"></span></div><span id="pv-load" class="pv-subtle" role="status">Loading…</span></header>
6
+ <header class="pv-top"><div class="pv-brand"><span class="pv-mark">r</span>rig review</div><div><strong id="pv-title">Parts review</strong> <span id="pv-mode" class="pv-subtle"></span></div><span id="pv-load" class="pv-subtle" role="status">Loading…</span><nav data-stage-nav class="review-stage-nav" aria-label="Inspection stages"></nav></header>
7
7
  <div class="pv-layout">
8
8
  <aside class="pv-list" aria-label="Parts"><h2 id="pv-list-title">PARTS</h2><ul id="pv-items" data-pv-items></ul></aside>
9
9
  <main class="pv-stage">
10
10
  <div class="pv-toolbar" role="toolbar" aria-label="View">
11
11
  <label class="pv-field">Background <select id="pv-bg" data-pv-bg><option value="green">Green</option><option value="magenta">Magenta</option><option value="black">Black</option><option value="white">White</option><option value="checker">Checker</option></select></label>
12
- <span class="pv-group" role="group" aria-label="Zoom"><button type="button" data-pv-zoom="1" aria-pressed="true">1×</button><button type="button" data-pv-zoom="2" aria-pressed="false">2×</button><button type="button" data-pv-zoom="4" aria-pressed="false">4×</button></span>
12
+ <span class="pv-group" role="group" aria-label="Zoom"><button type="button" id="zoom-out">−</button><span id="zoom-value">1:1</span><button type="button" id="zoom-in">+</button><button type="button" id="fit">Fit</button><button type="button" id="native-one" aria-pressed="true">1:1</button></span>
13
+ <label class="pv-field"><input id="camera-sync" type="checkbox">Sync cameras</label>
14
+ <button type="button" id="stage-comment" aria-pressed="false" aria-controls="stage-comment-list">Comment · C (0)</button>
13
15
  <label class="pv-field"><input type="checkbox" id="pv-alpha" data-pv-alpha> Alpha only</label>
14
16
  <label class="pv-field" id="pv-footprint-control"><input type="checkbox" id="pv-footprints" data-pv-footprints> Footprints of parts in front</label>
17
+ <span id="pv-comparison" class="pv-comparison" hidden>
18
+ <span class="pv-field">Painting comparison <span class="pv-group" role="group" aria-label="Painting comparison"><button type="button" data-pv-comparison="part" aria-pressed="true">Part</button><button type="button" data-pv-comparison="overlay" aria-pressed="false">Overlay</button></span></span>
19
+ <label class="pv-field" id="pv-opacity-control" hidden>Part opacity <input type="range" id="pv-opacity" min="0" max="1" step="0.001" value="0.5"><output id="pv-opacity-value">50.0%</output></label>
20
+ </span>
15
21
  <span class="pv-group" role="group" aria-label="Atlas view" id="pv-atlas-switch" hidden><button type="button" data-pv-view="item" aria-pressed="true">Region</button><button type="button" data-pv-view="page" aria-pressed="false">Pages</button></span>
16
22
  </div>
17
- <div class="pv-canvas-wrap"><div class="pv-canvas-box" id="pv-canvas-box"><canvas id="pv-canvas" data-pv-canvas width="1" height="1"></canvas><div id="pv-overlay" class="pv-overlay"></div></div></div>
23
+ <div class="pv-canvas-wrap" id="stage-layout"><div class="pv-canvas-box" id="pv-canvas-box"><canvas id="pv-canvas" data-pv-canvas width="1" height="1"></canvas><div id="pv-overlay" class="pv-overlay"></div></div></div>
18
24
  <p id="pv-caption" class="pv-subtle"></p>
19
25
  </main>
20
26
  <aside class="pv-side">
@@ -25,9 +31,11 @@
25
31
  <label><input type="radio" name="pv-outcome" value="clean" data-pv-outcome> Clean</label>
26
32
  <label><input type="radio" name="pv-outcome" value="flagged" data-pv-outcome> Flagged</label>
27
33
  </div>
34
+ <p id="pv-comment-count" role="status"></p>
28
35
  <label class="pv-label" for="pv-note">Note</label><textarea id="pv-note" rows="4" maxlength="10000"></textarea>
29
36
  <label class="pv-label" for="pv-overall">Sign-off</label><select id="pv-overall"><option value="pending">Pending</option><option value="approved">Approved</option><option value="changes-requested">Changes requested</option></select>
30
37
  <button id="pv-save" type="button" class="pv-primary">Save sign-off</button>
38
+ <span><button id="pv-export-json" type="button">Export JSON</button><button id="pv-export-issue" type="button">Export issue</button></span>
31
39
  <p id="pv-save-status" class="pv-subtle" role="status"></p>
32
40
  </section>
33
41
  </aside>