rig-review 3.7.0 → 4.0.1

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.
Files changed (109) hide show
  1. package/README.md +3 -3
  2. package/docs/DESIGN.md +145 -74
  3. package/docs/PANELS.md +20 -12
  4. package/docs/PARTS_VIEW.md +133 -76
  5. package/docs/REVIEW_PACKAGE.md +446 -100
  6. package/docs/STABILITY.md +132 -198
  7. package/docs/WORKFLOWS.md +41 -120
  8. package/package.json +4 -3
  9. package/skills/rig-review/SKILL.md +41 -27
  10. package/src/build.ts +10 -2
  11. package/src/cli.ts +17 -16
  12. package/src/comment-crops.ts +6 -1
  13. package/src/compare-html.ts +22 -24
  14. package/src/compare-server.ts +1 -1
  15. package/src/compare-session.ts +41 -3
  16. package/src/correction-handoff.ts +27 -4
  17. package/src/create-pin-gate.ts +3 -0
  18. package/src/direction-inspection.ts +6 -2
  19. package/src/feedback-export.ts +68 -1
  20. package/src/front.ts +5 -200
  21. package/src/handoff.ts +1 -1
  22. package/src/interview-routes.ts +1 -1
  23. package/src/interview-scene.ts +3 -3
  24. package/src/job-act.ts +77 -73
  25. package/src/job-api.ts +326 -13
  26. package/src/job-checkpoint-evidence.ts +113 -0
  27. package/src/job-cli.ts +27 -14
  28. package/src/job-contract.ts +284 -62
  29. package/src/job-front.ts +192 -61
  30. package/src/job-host.ts +23 -4
  31. package/src/job-session.ts +109 -24
  32. package/src/job-source.ts +227 -58
  33. package/src/job-store.ts +80 -6
  34. package/src/job-worker.ts +1 -47
  35. package/src/joined-project.ts +61 -4
  36. package/src/manifest.ts +32 -4
  37. package/src/open-workspace.ts +12 -12
  38. package/src/open.ts +19 -12
  39. package/src/parts-comment-crops.ts +126 -31
  40. package/src/parts-comment.ts +351 -28
  41. package/src/parts-server.ts +19 -7
  42. package/src/parts-view.ts +588 -109
  43. package/src/scene-inspection.ts +50 -0
  44. package/src/server.ts +31 -22
  45. package/src/session.ts +58 -0
  46. package/src/stage-comment.ts +48 -1
  47. package/src/stage-parts.ts +23 -11
  48. package/web/animation-inspection.ts +1 -1
  49. package/web/bones-panel.ts +1 -3
  50. package/web/catalog-en.ts +175 -39
  51. package/web/catalog-ko.ts +175 -39
  52. package/web/cloth-panel.ts +1 -2
  53. package/web/compare.css +3 -13
  54. package/web/compare.html +3 -3
  55. package/web/compare.ts +69 -64
  56. package/web/cuts-panel.ts +1 -3
  57. package/web/density-strip-panel.ts +1 -2
  58. package/web/direction-panel.ts +22 -6
  59. package/web/i18n.ts +13 -1
  60. package/web/idle-panel.ts +1 -2
  61. package/web/index.html +1 -5
  62. package/web/inspection-persistence.ts +2 -1
  63. package/web/inspector-blocks.ts +149 -40
  64. package/web/instance-access.ts +24 -5
  65. package/web/interview-panel.ts +224 -175
  66. package/web/job-rig-capture.ts +164 -21
  67. package/web/job-rig-screen.ts +344 -0
  68. package/web/job-session.ts +611 -1443
  69. package/web/main.ts +614 -151
  70. package/web/mesh-panel.ts +1 -2
  71. package/web/owner-workspace.ts +88 -109
  72. package/web/part-selection.ts +47 -6
  73. package/web/part-thumbnails.ts +20 -6
  74. package/web/parts-render.ts +26 -19
  75. package/web/parts-viewport-provider.ts +181 -7
  76. package/web/physics-panel.ts +1 -2
  77. package/web/readings-panel.ts +1 -2
  78. package/web/requirements-panel.ts +1 -3
  79. package/web/retained-frame-stage.ts +105 -0
  80. package/web/retarget-panel.ts +2 -3
  81. package/web/rig-fields-panel.ts +1 -2
  82. package/web/rig-host.ts +64 -0
  83. package/web/rig-viewport-provider.ts +65 -16
  84. package/web/scene-plates.ts +57 -4
  85. package/web/stage-comments.ts +103 -46
  86. package/web/styles.css +117 -63
  87. package/web/view-controls.ts +201 -12
  88. package/web/viewport-capture.ts +12 -2
  89. package/web/viewport-controller.ts +107 -27
  90. package/web/viewport-pair.ts +2 -1
  91. package/web/workspace-preferences.ts +5 -4
  92. package/web/workspace-ui.ts +151 -19
  93. package/src/front-worker.ts +0 -2
  94. package/src/interview-server.ts +0 -54
  95. package/src/job-hub.ts +0 -304
  96. package/src/job-image-set.ts +0 -50
  97. package/web/interview.css +0 -28
  98. package/web/interview.html +0 -17
  99. package/web/interview.ts +0 -40
  100. package/web/job-hub.css +0 -14
  101. package/web/job-hub.html +0 -5
  102. package/web/job-hub.ts +0 -179
  103. package/web/owner-workspace.css +0 -14
  104. package/web/owner-workspace.html +0 -5
  105. package/web/parts-flags.ts +0 -48
  106. package/web/parts.css +0 -104
  107. package/web/parts.html +0 -49
  108. package/web/parts.ts +0 -604
  109. package/web/stage-nav.ts +0 -136
package/web/parts.ts DELETED
@@ -1,604 +0,0 @@
1
- import {defaultPartsComparison,paintingRectangle,type PartsComparison} from '../src/parts-comparison.ts';
2
- import {mountViewportPair} from './viewport-pair.ts';
3
- import {createPartsViewport} from './parts-viewport-provider.ts';
4
- import {bindStageComments,type CommentUiPose,type CommentCodec} from './stage-comments.ts';
5
- import {parsePartsComment,snapImageRegion,type PartsComment} from '../src/parts-comment.ts';
6
- import {projectMark,unprojectMark,region} from '../src/stage-comment.ts';
7
- import {bindStageNav,stagePartsSelectionIndex,type StagePartsState,type StagePartsWindow} from './stage-nav.ts';
8
- /**
9
- * The parts and atlas view (#348). Every part on its own, on a sentinel background, through the shared native-scale
10
- * viewport controller; the footprints of the parts drawn in front of it; the producer's flags on it; and a
11
- * per-part verdict saved as `rig-review-parts-verdict/2`. In atlas mode, the pages as packed with every region's box
12
- * and name, and a click from a region to its own view.
13
- *
14
- * Nothing here measures the art: flags come from the producer's files, and the footprint is the front parts' own
15
- * alpha drawn over the selected part (the parts.json draw order, back first, says which parts are in front).
16
- */
17
- import { bindDomI18n, onLanguageChange, setLinkLanguage, setLanguagePreference, t } from './i18n.ts';
18
- import { pageInstanceAccess } from './instance-access.ts';
19
- import { connectLiveWindow } from './live-connection.ts';
20
- import { flagLabel, readingGroup, countedFlag } from './parts-flags.ts';
21
- import { paintAssembly, pickAssembly, paintAssemblyOutline, frontParts, paintAlphaOnly, paintBackground, paintPart, paintMesh, paintOverlay, paintPaintingCrop, paintFootprints } from './parts-render.ts';
22
-
23
- type Outcome = 'pending' | 'clean' | 'flagged';
24
- interface Mesh { vertices: number[]; triangles: number[]; figures: Record<string, unknown> }
25
- interface Entry { outcome: Outcome; note: string; mesh?: { outcome: Outcome; note: string } }
26
- interface Item { mesh?: Mesh; name: string; index: number; x: number; y: number; w: number; h: number; page?: string; degrees?: number; image?: boolean;imageHash?:string }
27
- interface Page { name: string; width: number; height: number; index: number }
28
- type Flag =
29
- | { id: string; item: string; source: 'mesh_report'; kind: 'faint'; art: number; maxAlpha: number; box: [number, number, number, number] }
30
- | { id: string; item: string; source: 'check'; kind: 'check'; path: string; line: string; root: string; status: string | null; entry: Record<string, unknown>; classification?: 'part' | 'pair' | 'evidence' | 'unclassified' };
31
- interface ViewData {
32
- inspectionSourceHash?:string;
33
- joinedVerdictBinding?:string;
34
- verdictReadOnlyReason?:string;
35
- draft?:{inspectionOnly?:boolean;label:string;buildId:string;inspectionSourceHash:string;mappings:{part:string;skin:string;slot:string;attachment:string;vertices:number;triangles:number}[];evidence:unknown};draftUnavailable?:string;
36
- differenceAvailable?:boolean;painting:{sha256:string;width:number;height:number}|null;sourceHash:string;mode: 'parts' | 'atlas'; title: string; rigSize: [number, number] | null; items: Item[]; pages: Page[]; flags: Flag[]; readings?: Flag[];
37
- flagSources: string[]; flagMissing: string[]; verdictFile: string;
38
- verdict: { comments?:PartsComment[];status: string; parts: Record<string, Entry> } | null; verdictStale: 'files' | 'flags' | null;
39
- }
40
-
41
- /** Page pixels shown around a region in its own view, so the packer's bleed and padding are visible. */
42
- export const REGION_MARGIN = 4;
43
-
44
- const $ = <T extends HTMLElement>(id: string) => document.getElementById(id) as T;
45
- const access = pageInstanceAccess();
46
- const stageEmbedded=new URL(location.href).searchParams.get('stageEmbed')==='1';
47
- const stageSide=new URL(location.href).searchParams.get('side');
48
- let stageBuild='inspected',stageRestore:StagePartsState|null=null;
49
- let receiveSource:()=>void=()=>{};const sourceReady=new Promise<void>(resolve=>{receiveSource=resolve;});
50
- if(typeof window!=='undefined')window.addEventListener('message',event=>{if(event.source===parent&&event.origin===location.origin&&event.data?.type==='review-stage-source'&&(event.data.buildId==='inspected'||/^[a-f0-9]{64}$/.test(event.data.buildId))){stageBuild=event.data.buildId;stageRestore=event.data.state??null;receiveSource();}});
51
- const stageHeaders=()=>access.headers(stageEmbedded?{'X-Review-Stage-Build':stageBuild}:{});
52
- const partsApi=stageEmbedded?(stageSide==='a'||stageSide==='b'?`/api/compare/${stageSide}/stage-parts`:'/api/stage-parts'):'/api/parts';
53
-
54
- const state = { data: null as ViewData | null, selected: 0, zoom: 1, bg: 'green', alpha: false, footprints: false, comparison:defaultPartsComparison(), differenceThreshold:0, hidden: new Set<string>(), view: 'item' as 'item' | 'page' | 'assembled', page: 0, meshShown: new Set<string>(), verdict: new Map<string, Entry>() };
55
- const comments:PartsComment[]=[];let commentUi:ReturnType<typeof bindStageComments>|null=null;let viewport:ReturnType<typeof createPartsViewport>|null=null;let painting=false;
56
- const images = new Map<string, HTMLImageElement>();
57
-
58
- function load(src: string): Promise<HTMLImageElement> {
59
- const cached = images.get(src);
60
- if (cached) return Promise.resolve(cached);
61
- return new Promise((resolve, reject) => {
62
- const img = new Image();
63
- img.onload = () => { images.set(src, img); resolve(img); };
64
- img.onerror = () => reject(new Error(src));
65
- if(stageEmbedded)void fetch(access.route(src),{headers:stageHeaders()}).then(async res=>{if(!res.ok)throw new Error('STAGE_DRAFT_CHANGED');const url=URL.createObjectURL(await res.blob());img.addEventListener('load',()=>URL.revokeObjectURL(url),{once:true});img.src=url;}).catch(reject);
66
- else img.src = access.route(src);
67
- });
68
- }
69
- const itemImage = (item: Item) => load(`${partsApi}/image/${item.index}`);
70
- const pageImage = (name: string) => { const page = state.data?.pages.find(p => p.name === name); return page ? load(`${partsApi}/page/${page.index}`) : Promise.reject(new Error('PARTS_PAINT_FAILED')); };
71
-
72
- function setCanvas(canvas: HTMLCanvasElement, w: number, h: number): CanvasRenderingContext2D {
73
- canvas.width = w; canvas.height = h;
74
- canvas.style.width = `${w * state.zoom}px`; canvas.style.height = `${h * state.zoom}px`;
75
- const ctx = canvas.getContext('2d', { willReadFrequently: true })!;
76
- ctx.imageSmoothingEnabled = false;
77
- return ctx;
78
- }
79
-
80
- function overlayBox(x: number, y: number, w: number, h: number): HTMLDivElement {
81
- const div = document.createElement('div');
82
- div.className = 'pv-box';
83
- div.style.left = `${x * state.zoom}px`; div.style.top = `${y * state.zoom}px`;
84
- div.style.width = `${w * state.zoom}px`; div.style.height = `${h * state.zoom}px`;
85
- return div;
86
- }
87
-
88
- let paintToken = 0;
89
- let paintFailure:string|null=null,paintReset=false;
90
- async function paint():Promise<void>{
91
- const token=++paintToken;painting=true;
92
- try{
93
- await paintRaster(token);if(token!==paintToken)return;
94
- await paintReference(token);if(token!==paintToken)return;
95
- if(paintFailure)$('pv-save-status').textContent='';paintFailure=null;viewport?.fitCamera();commentUi?.refresh();
96
- }catch(error){
97
- if(token!==paintToken)return;
98
- const failure=error instanceof Error&&error.message.startsWith('PARTS_DIFFERENCE_')?error.message:'PARTS_PAINT_FAILED: view could not be rendered; select the part to retry';
99
- const canvas=$<HTMLCanvasElement>('pv-canvas');canvas.getContext('2d')?.clearRect(0,0,canvas.width,canvas.height);
100
- const ref=$<HTMLCanvasElement>('pv-reference') as HTMLCanvasElement|null;if(ref){if(canvas.width>0&&canvas.height>0){ref.width=canvas.width;ref.height=canvas.height;}ref.getContext('2d')?.clearRect(0,0,ref.width,ref.height);}
101
- $('pv-overlay').replaceChildren();$('pv-caption').textContent=t(failure);$('pv-save-status').textContent=t(failure);
102
- painting=false;paintFailure=null;paintReset=true;
103
- try{viewport?.writeCamera?.('rig',{zoom:1,center:null});viewport?.writeCamera?.('reference',{zoom:1,center:null});viewport?.fitCamera();}
104
- finally{paintReset=false;paintFailure=failure;}
105
- commentUi?.refresh();
106
- }finally{if(token===paintToken)painting=false;}
107
- }
108
- const assemblyAlpha=new Map<string,Uint8ClampedArray>();
109
- function sourceAlpha(item:Item,img:HTMLImageElement):Uint8ClampedArray {
110
- const cached=assemblyAlpha.get(item.name);if(cached)return cached;
111
- const c=document.createElement('canvas');c.width=item.w;c.height=item.h;const ctx=c.getContext('2d')!;ctx.drawImage(img,0,0);
112
- const rgba=ctx.getImageData(0,0,item.w,item.h).data,alpha=new Uint8ClampedArray(item.w*item.h);for(let i=0;i<alpha.length;i++)alpha[i]=rgba[i*4+3]!;assemblyAlpha.set(item.name,alpha);return alpha;
113
- }
114
-
115
- function partFrame(data:ViewData,item:Item) {
116
- if(state.view==='assembled'&&data.rigSize) {
117
- return {x:0,y:0,w:data.rigSize[0],h:data.rigSize[1]};
118
- }
119
- return item;
120
- }
121
-
122
- function rasterFrame(data:ViewData,item:Item):{x:number;y:number;w:number;h:number}|null {
123
- if(data.mode==='parts')return partFrame(data,item);
124
- if(state.view==='page') {
125
- const page=data.pages[state.page];
126
- return page?{x:0,y:0,w:page.width,h:page.height}:null;
127
- }
128
- const page=data.pages.find(p=>p.name===item.page);
129
- if(!page)return null;
130
- const x=Math.max(0,item.x-REGION_MARGIN),y=Math.max(0,item.y-REGION_MARGIN);
131
- const right=Math.min(page.width,item.x+item.w+REGION_MARGIN);
132
- const bottom=Math.min(page.height,item.y+item.h+REGION_MARGIN);
133
- return {x,y,w:right-x,h:bottom-y};
134
- }
135
-
136
- async function paintRaster(token:number): Promise<void> {
137
- const data = state.data;
138
- if (!data || !data.items.length) return;
139
- const canvas = $<HTMLCanvasElement>('pv-canvas'), overlay = $('pv-overlay'), caption = $('pv-caption');
140
- const item = data.items[state.selected]!;
141
- const frame=rasterFrame(data,item);
142
- if(!frame)throw new Error('PARTS_PAINT_FAILED');
143
- const {x,y,w,h}=frame;
144
- if(state.view==='assembled'&&data.mode==='parts'&&data.rigSize){
145
- const shown=data.items.filter(i=>!state.hidden.has(i.name));
146
- const layers=await Promise.all(shown.map(async box=>({box,image:await itemImage(box)})));
147
- const original=state.comparison.mode==='overlay'&&data.painting?await load('/api/parts/painting'):null;
148
- if(token!==paintToken)return;
149
- const ctx=setCanvas(canvas,w,h);
150
- if(original){
151
- paintPaintingCrop(ctx,original,paintingRectangle({x:0,y:0,w,h},data.rigSize,data.painting!),w,h,state.bg);
152
- const assembled=document.createElement('canvas');assembled.width=w;assembled.height=h;const a=assembled.getContext('2d')!;a.imageSmoothingEnabled=false;for(const l of layers)a.drawImage(l.image,l.box.x,l.box.y);ctx.globalAlpha=state.comparison.opacity;ctx.drawImage(assembled,0,0);ctx.globalAlpha=1;
153
- }else paintAssembly(ctx,w,h,layers,{bg:state.bg,alpha:state.alpha});
154
- overlay.replaceChildren();
155
- const selected=layers.find(l=>l.box.name===item.name);
156
- if(selected){const outline=document.createElement('canvas');outline.width=w;outline.height=h;outline.dataset.assemblyOutline=item.name;paintAssemblyOutline(outline.getContext('2d')!,item,sourceAlpha(item,selected.image));overlay.append(outline);}
157
- caption.textContent=t('Assembled package · {count} visible parts. Selection and verdict remain per part.',{count:shown.length});
158
- return;
159
- }
160
- if (data.mode === 'atlas' && state.view === 'page') {
161
- const page = data.pages[state.page]!, img = await pageImage(page.name);
162
- if (token !== paintToken) return;
163
- const ctx = setCanvas(canvas, w, h);
164
- if (state.alpha) paintAlphaOnly(ctx, img, 0, 0, page.width, page.height);
165
- else { paintBackground(ctx, page.width, page.height, state.bg); ctx.drawImage(img, 0, 0); }
166
- overlay.replaceChildren(...data.items.filter(r => r.page === page.name).map(r => {
167
- const box = overlayBox(r.x, r.y, r.w, r.h);
168
- box.dataset.viewportAction = 'select-region';
169
- box.dataset.region = r.name; box.dataset.x = String(r.x); box.dataset.y = String(r.y); box.dataset.w = String(r.w); box.dataset.h = String(r.h);
170
- if (r.index === item.index) box.setAttribute('aria-current', 'true');
171
- const label = document.createElement('span'); label.textContent = r.name; box.append(label);
172
- box.title = `${r.name} · ${r.x},${r.y} ${r.w}×${r.h}${r.degrees ? ` · ${r.degrees}°` : ''}`;
173
- box.onclick = () => { select(r.index); setView('item'); };
174
- return box;
175
- }));
176
- const regions = data.items.filter(r => r.page === page.name).length;
177
- caption.textContent = regions === 1
178
- ? t('Page {name}: {width}×{height} px, 1 region. The background shows through padding; a region box is the packer\'s, and pixels outside it are bleed.', { name: page.name, width: page.width, height: page.height })
179
- : t('Page {name}: {width}×{height} px, {count} regions. The background shows through padding; a region box is the packer\'s, and pixels outside it are bleed.', { name: page.name, width: page.width, height: page.height, count: regions });
180
- return;
181
- }
182
- if (data.mode === 'atlas') {
183
- const page = data.pages.find(p => p.name === item.page)!, img = await pageImage(item.page!);
184
- if (token !== paintToken) return;
185
- const ctx = setCanvas(canvas, w, h);
186
- if (state.alpha) paintAlphaOnly(ctx, img, x, y, w, h);
187
- else { paintBackground(ctx, w, h, state.bg); ctx.drawImage(img, x, y, w, h, 0, 0, w, h); }
188
- const edge = overlayBox(item.x - x, item.y - y, item.w, item.h);
189
- edge.className = 'pv-region-edge';
190
- overlay.replaceChildren(edge);
191
- caption.textContent = t('Region {name} on {page} at {x},{y}, {width}×{height} px, with {margin} px of the page around it (dashed: the region box).', { name: item.name, page: item.page!, x: item.x, y: item.y, width: item.w, height: item.h, margin: REGION_MARGIN }) + (item.degrees ? ' ' + t('Packed at {degrees}°.', { degrees: item.degrees }) : '');
192
- return;
193
- }
194
- if(state.comparison.mode==='difference'){
195
- const response=await fetch(access.route(`${partsApi}/difference/${item.index}?threshold=${state.comparison.threshold}&footprints=${state.footprints}`),{headers:stageHeaders()});
196
- if(!response.ok){const out=await response.json() as {error:string};throw new Error(out.error);}
197
- const image=await createImageBitmap(await response.blob());
198
- try{if(token!==paintToken)return;const ctx=setCanvas(canvas,w,h);paintBackground(ctx,w,h,state.bg);ctx.drawImage(image,0,0);overlay.replaceChildren();
199
- caption.textContent=t('Difference: {count} pixels above threshold · {covered} covered pixels excluded · visual comparison, no automatic verdict.',{count:response.headers.get('X-Difference-Count')??'',covered:response.headers.get('X-Difference-Covered')??''});
200
- }finally{image.close();}return;
201
- }
202
- const img = await itemImage(item), front = state.footprints ? frontParts(data.items, item) : [];
203
- const fronts = await Promise.all(front.map(async o => ({ o, img: await itemImage(o) })));
204
- const original=state.comparison.mode==='overlay'&&data.painting?await load('/api/parts/painting'):null;
205
- if (token !== paintToken) return;
206
- const ctx = setCanvas(canvas, w, h);
207
- const makeCanvas=(w:number,h:number)=>Object.assign(document.createElement('canvas'),{width:w,height:h});
208
- if(original){paintOverlay(ctx,item,img,original,paintingRectangle(item,data.rigSize!,data.painting!),state.comparison.opacity,state.bg);paintFootprints(ctx,item,fronts.map(f=>({box:f.o,image:f.img})),makeCanvas);}
209
- else paintPart(ctx, item, img, { bg: state.bg, alpha: state.alpha, fronts: fronts.map(f => ({ box: f.o, image: f.img })), makeCanvas: (w, h) => Object.assign(document.createElement('canvas'), { width: w, height: h }) });
210
- if (!original && item.mesh && state.meshShown.has(item.name)) paintMesh(ctx, img, item.w, item.h, item.mesh, (w, h) => Object.assign(document.createElement('canvas'), { width: w, height: h }));
211
- overlay.replaceChildren(...data.flags.filter((f): f is Extract<Flag, { kind: 'faint' }> => f.item === item.name && f.kind === 'faint').map(f => {
212
- const box = overlayBox(f.box[0], f.box[1], f.box[2], f.box[3]);
213
- box.dataset.flag = f.id;
214
- return box;
215
- }));
216
- caption.textContent = t('{name}: {width}×{height} px at {x},{y} in rig px, draw order {order} of {count}.', { name: item.name, width: item.w, height: item.h, x: item.x, y: item.y, order: item.index + 1, count: data.items.length })
217
- + (state.footprints ? ' ' + (front.length === 1 ? t('Tinted: the footprint of the part drawn in front ({names}).', { names: front[0]!.name }) : front.length ? t('Tinted: the footprints of {count} parts drawn in front ({names}).', { count: front.length, names: front.map(o => o.name).join(', ') }) : t('No part is drawn in front of it.')) : '');
218
- }
219
-
220
- async function paintReference(token:number):Promise<void>{const data=state.data,item=data?.items[state.selected];if(!data?.painting||!item)return;const img=await load('/api/parts/painting');if(token!==paintToken||data!==state.data||item!==state.data?.items[state.selected])return;const box=partFrame(data,item);const canvas=$<HTMLCanvasElement>('pv-reference');canvas.width=box.w;canvas.height=box.h;const ctx=canvas.getContext('2d')!;paintPaintingCrop(ctx,img,paintingRectangle(box,data.rigSize!,data.painting),box.w,box.h,state.bg);}
221
-
222
- function renderComparison():void {
223
- const active=state.data?.mode==='parts'&&(!!state.data.painting||!!state.data.differenceAvailable),overlay=active&&state.comparison.mode==='overlay',difference=state.comparison.mode==='difference';
224
- const button=document.querySelector<HTMLButtonElement>('[data-pv-comparison="difference"]');if(button){button.disabled=!state.data?.differenceAvailable||state.view!=='item';button.title=button.disabled?t('PARTS_DIFFERENCE_UNAVAILABLE: declared painting_in_rig and individual part view required.'):'';}
225
- document.querySelector<HTMLButtonElement>('[data-pv-comparison="overlay"]')!.disabled=!state.data?.painting;
226
- $('pv-threshold-control').hidden=!difference;$<HTMLInputElement>('pv-threshold').value=String(state.comparison.mode==='difference'?state.comparison.threshold:state.differenceThreshold);
227
- $('pv-comparison').hidden=!active;for(const b of document.querySelectorAll<HTMLElement>('[data-pv-comparison]'))b.setAttribute('aria-pressed',String(b.dataset.pvComparison===state.comparison.mode));
228
- $('pv-opacity-control').hidden=!overlay;$<HTMLInputElement>('pv-opacity').value=String(state.comparison.opacity);$('pv-opacity-value').textContent=(state.comparison.opacity*100).toFixed(1)+'%';
229
- $<HTMLInputElement>('pv-alpha').disabled=overlay||difference;
230
- const mesh=document.querySelector<HTMLInputElement>('#pv-mesh-control input');if(mesh)mesh.disabled=overlay||difference||state.view==='assembled';
231
- $<HTMLInputElement>('pv-footprints').disabled=state.data?.mode==='atlas'||state.view==='assembled';
232
- }
233
-
234
- function renderFlags(): void {
235
- const data = state.data!, item = data.items[state.selected];
236
- const list = $('pv-flags');
237
- const flags = item ? [...data.flags.filter(f => f.kind === 'faint' && f.item === item.name), ...(data.readings ?? data.flags.filter(f => f.kind === 'check')).filter(f => f.item === item.name || f.item === '')] : [];
238
- const row = (f: Flag): HTMLLIElement => {
239
- const li = document.createElement('li');
240
- li.dataset.flagId = f.id; li.dataset.flagSource = f.source;
241
- const label = document.createElement('span'); label.className = 'pv-flag-label'; label.textContent = flagLabel(f, t);
242
- li.append(label);
243
- if (f.kind === 'check') {
244
- // The producer's object, verbatim, one click away: the label names its fields and hides none of it.
245
- const raw = document.createElement('details'), summary = document.createElement('summary'), code = document.createElement('code');
246
- summary.textContent = t('Producer line'); code.textContent = `${f.path}: ${f.line}`;
247
- raw.append(summary, code); li.append(raw);
248
- }
249
- return li;
250
- };
251
- // Source and producer-root groups are presentation only. Every original row and verdict flag id is retained.
252
- list.replaceChildren(...(['mesh_report', 'check'] as const).flatMap(source => {
253
- const fromSource = flags.filter(f => f.source === source);
254
- if (!fromSource.length) return [];
255
- const sourceItem = document.createElement('li'), heading = document.createElement('h3');
256
- sourceItem.dataset.pvSource = source;
257
- heading.textContent = source === 'mesh_report' ? 'mesh_report.json' : 'check.json';
258
- sourceItem.append(heading);
259
- const categories = source === 'mesh_report' ? ['mesh'] as const : ['part', 'pair', 'evidence', 'unclassified'] as const;
260
- for (const category of categories) {
261
- const selected = fromSource.filter(f => readingGroup(f) === category);
262
- if (!selected.length) continue;
263
- const section = document.createElement('details'), title = document.createElement('summary');
264
- section.dataset.pvCategory = category;
265
- title.textContent = t(category === 'mesh' ? 'Mesh flags' : category === 'part' ? 'Part findings' : category === 'pair' ? 'Pair readings' : category === 'evidence' ? 'Check evidence' : 'Unclassified check rows');
266
- section.append(title);
267
- const roots = new Map<string, Flag[]>();
268
- for (const f of selected) {
269
- const root = f.kind === 'check' ? f.root : 'contour.bridges.faint';
270
- const group = roots.get(root) ?? [];
271
- group.push(f); roots.set(root, group);
272
- }
273
- for (const [root, group] of roots) {
274
- const details = document.createElement('details'), summary = document.createElement('summary'), rows = document.createElement('ul');
275
- details.dataset.pvRoot = root; details.dataset.flagSource = source;
276
- summary.textContent = group.length === 1 ? t('{root} · 1 row', { root }) : t('{root} · {count} rows', { root, count: group.length });
277
- rows.append(...group.map(row)); details.append(summary, rows); section.append(details);
278
- }
279
- sourceItem.append(section);
280
- }
281
- return [sourceItem];
282
- }));
283
- if (!flags.length) { const li = document.createElement('li'); li.className = 'pv-none'; li.textContent = t('No producer flag names this part.'); list.replaceChildren(li); }
284
- $('pv-flag-sources').textContent = [
285
- data.flagSources.length ? t('Read from: {files}.', { files: data.flagSources.join(', ') }) : '',
286
- data.flagMissing.length ? t('Not found: {files}.', { files: data.flagMissing.join(', ') }) : '',
287
- t('Occlusion coverage is not read yet: the producer does not write it.'),
288
- t('Badges count only mesh flags and explicit part findings. Pair readings and check evidence are not counted.'),
289
- flags.some(f => readingGroup(f) === 'unclassified') ? t('Missing or invalid row metadata: source-root rows remain unclassified and are not counted.') : '',
290
- ].filter(Boolean).join(' ');
291
- }
292
-
293
- function renderList(): void {
294
- const data = state.data!, list = $('pv-items');
295
- const seen = new Set<string>();
296
- list.replaceChildren(...data.items.filter(i => !seen.has(i.name) && seen.add(i.name)).map(item => {
297
- const li = document.createElement('li'), button = document.createElement('button');
298
- button.type = 'button'; button.dataset.pvItem = item.name; button.title = item.name;
299
- if (data.items[state.selected]?.name === item.name) button.setAttribute('aria-current', 'true');
300
- const name = document.createElement('span'); name.className = 'pv-name'; name.textContent = item.name;
301
- const onItem = [...data.flags.filter(f => f.kind === 'faint'), ...(data.readings ?? [])].filter(f => f.item === item.name && countedFlag(f));
302
- const flags = document.createElement('span'); flags.className = 'pv-count';
303
- // flagSources holds actual basenames (including custom.json); flagMissing canonically names unread kinds.
304
- const meshRead = !data.flagMissing.includes('mesh_report.json'), checkRead = !data.flagMissing.includes('check.json');
305
- const mesh = onItem.filter(f => f.source === 'mesh_report').length, check = onItem.filter(f => f.source === 'check').length;
306
- if (onItem.length) {
307
- if (meshRead && checkRead) flags.textContent = t('mesh {mesh} · check {check}', { mesh, check });
308
- else if (meshRead) flags.textContent = t('mesh {mesh}', { mesh });
309
- else if (checkRead) flags.textContent = t('check {check}', { check });
310
- }
311
- const outcome = state.verdict.get(item.name)?.outcome ?? 'pending';
312
- const badge = document.createElement('span'); badge.className = 'pv-badge'; badge.dataset.outcome = outcome; badge.textContent = t(outcome === 'clean' ? 'Clean' : outcome === 'flagged' ? 'Flagged' : 'Pending');
313
- button.append(name, flags, badge);
314
- button.onclick = () => { select(item.index); if (data.mode === 'atlas') setView('item'); };
315
- li.append(button);
316
- if(data.mode==='parts'){
317
- const label=document.createElement('label'),visible=document.createElement('input');visible.type='checkbox';visible.checked=!state.hidden.has(item.name);visible.dataset.pvVisible=item.name;visible.setAttribute('aria-label',t('Show {name} in assembly',{name:item.name}));
318
- visible.onchange=()=>{if(visible.checked)state.hidden.delete(item.name);else state.hidden.add(item.name);void paint();};label.append(visible);li.append(label);
319
- }
320
- return li;
321
- }));
322
- }
323
-
324
- function renderVerdict(): void {
325
- const item = state.data!.items[state.selected];
326
- if (!item) return;
327
- const entry = state.verdict.get(item.name) ?? { outcome: 'pending' as Outcome, note: '' };
328
- for (const radio of document.querySelectorAll<HTMLInputElement>('input[data-pv-outcome]')) radio.checked = radio.value === entry.outcome;
329
- $<HTMLTextAreaElement>('pv-note').value = entry.note;
330
- $('pv-comment-count').textContent=t('Comments on this part: {count}',{count:comments.filter(c=>c.part===item.name).length});
331
- }
332
-
333
- function renderMesh(): void {
334
- document.getElementById('pv-mesh-panel')?.remove();
335
- document.getElementById('pv-mesh-control')?.remove();
336
- const item = state.data!.items[state.selected]!;
337
- if (!item.mesh) return;
338
- const control = document.createElement('label'); control.id = 'pv-mesh-control'; control.className = 'pv-field';
339
- const toggle = document.createElement('input'); toggle.type = 'checkbox'; toggle.checked = state.meshShown.has(item.name); toggle.disabled=state.comparison.mode!=='part'||state.view==='assembled';
340
- toggle.onchange = () => { if (toggle.checked) state.meshShown.add(item.name); else state.meshShown.delete(item.name); void paint(); };
341
- control.append(toggle, t('mesh from rig.json UVs')); document.querySelector('.pv-toolbar')!.append(control);
342
- const panel = document.createElement('section'); panel.id = 'pv-mesh-panel';
343
- const heading = document.createElement('h2'); heading.textContent = t('Mesh geometry'); panel.append(heading);
344
- const figures = document.createElement('dl');
345
- for (const key of ['mode', 'vertices', 'triangles', 'art_coverage', 'stray_cleared']) {
346
- const dt = document.createElement('dt'), dd = document.createElement('dd'); dt.textContent = key;
347
- dd.textContent = Object.hasOwn(item.mesh.figures, key) ? JSON.stringify(item.mesh.figures[key]) : t('not reported');
348
- dd.dataset.meshFigure = key; figures.append(dt, dd);
349
- }
350
- panel.append(figures);
351
- const help = document.createElement('p'); help.textContent = t('Pink: art pixels outside every triangle.'); panel.append(help);
352
- if(stageEmbedded&&!state.data?.joinedVerdictBinding){document.querySelector('.pv-verdict')!.before(panel);return;}
353
- const entry = state.verdict.get(item.name)!;
354
- const select = document.createElement('select'); select.setAttribute('aria-label', t('Mesh outcome'));
355
- for (const [value, label] of [['pending', 'Pending'], ['clean', 'Clean'], ['flagged', 'Flagged']]) { const option = document.createElement('option'); option.value = value!; option.textContent = t(label!); select.append(option); }
356
- select.value = entry.mesh!.outcome;
357
- const note = document.createElement('textarea'); note.maxLength = 10000; note.value = entry.mesh!.note; note.setAttribute('aria-label', t('Mesh note'));
358
- select.onchange = () => { entry.mesh!.outcome = select.value as Outcome; };
359
- note.oninput = () => { entry.mesh!.note = note.value; };
360
- const outcomeLabel = document.createElement('label'), noteLabel = document.createElement('label');
361
- outcomeLabel.append(t('Mesh outcome'), select); noteLabel.append(t('Mesh note'), note);
362
- panel.append(outcomeLabel, noteLabel); document.querySelector('.pv-verdict')!.before(panel);
363
- }
364
-
365
- function select(index: number): void {
366
- queueMicrotask(renderCorrections);
367
- const data = state.data!;
368
- const item = data.items[index]!;
369
- if (item.page !== undefined) state.page = data.pages.findIndex(p => p.name === item.page);
370
- const changed=state.selected!==index;state.selected = index;if((changed||paintFailure)&&viewport&&state.view!=='assembled'){viewport.writeCamera('rig',{zoom:1,center:null});viewport.writeCamera('reference',{zoom:1,center:null});}
371
- commentUi?.refresh();
372
- renderList(); renderFlags(); renderVerdict(); renderMesh(); renderComparison(); void paint();
373
- }
374
-
375
- function setView(view: 'item' | 'page' | 'assembled'): void {
376
- if(view==='assembled'&&(state.data?.mode!=='parts'||!state.data.rigSize))return;
377
- if((state.view!==view||paintFailure)&&viewport){viewport.writeCamera('rig',{zoom:1,center:null});viewport.writeCamera('reference',{zoom:1,center:null});}
378
- if(view!=='item'&&state.comparison.mode==='difference')state.comparison={mode:'part',opacity:state.comparison.opacity};
379
- state.view = view;renderMesh();renderComparison();$('rig-label').textContent=t(view==='assembled'?'Assembled':'Selected part');commentUi?.refresh();
380
- for (const b of document.querySelectorAll<HTMLButtonElement>('[data-pv-view]')) b.setAttribute('aria-pressed', String(b.dataset.pvView === view));
381
- void paint();
382
- }
383
-
384
- function updateEntry(change: Partial<{ outcome: Outcome; note: string }>): void {
385
- const item = state.data!.items[state.selected]!;
386
- const entry = { ...(state.verdict.get(item.name) ?? { outcome: 'pending' as Outcome, note: '' }), ...change };
387
- state.verdict.set(item.name, entry);
388
- renderList();
389
- }
390
-
391
- /** Explicit approval only: refuse before changing any pending entry when a flag remains. */
392
- async function approveAll(): Promise<void> {
393
- if (stageEmbedded || !state.data) return;
394
- const entries = state.data.items.map(item => state.verdict.get(item.name));
395
- if (entries.some(entry => entry?.outcome === 'flagged' || entry?.mesh?.outcome === 'flagged')) {
396
- const status = $('pv-save-status');
397
- status.textContent = t('PARTS_APPROVE_ALL_FLAGGED: resolve flagged part and mesh outcomes before approving all.');
398
- status.dataset.result = 'refused';
399
- return;
400
- }
401
- for (const item of state.data.items) {
402
- const entry = state.verdict.get(item.name) ?? { outcome: 'pending' as Outcome, note: '' };
403
- if (entry.outcome === 'pending') entry.outcome = 'clean';
404
- if (item.mesh) {
405
- entry.mesh ??= { outcome: 'pending', note: '' };
406
- if (entry.mesh.outcome === 'pending') entry.mesh.outcome = 'clean';
407
- }
408
- state.verdict.set(item.name, entry);
409
- }
410
- $<HTMLSelectElement>('pv-overall').value = 'approved';
411
- renderList(); renderVerdict(); renderMesh();
412
- await save();
413
- }
414
-
415
- async function save(): Promise<void> {
416
- const data=state.data;
417
- if(!data||stageEmbedded&&(!data.joinedVerdictBinding||!access.capability||stageBuild!=='inspected'))return;
418
- const status = $('pv-save-status'),button=$<HTMLButtonElement>('pv-save');
419
- const body = { status: $<HTMLSelectElement>('pv-overall').value, parts: Object.fromEntries(state.verdict),
420
- ...(stageEmbedded?{binding:data.joinedVerdictBinding}:{comments}) };
421
- button.disabled=true;
422
- try{
423
- const headers=stageEmbedded?stageHeaders():access.headers();headers.set('Content-Type','application/json');
424
- const res = await fetch(access.route(stageEmbedded?partsApi+'/verdict':'/api/parts/verdict'), { method: 'POST', headers, body: JSON.stringify(body) });
425
- const out = await res.json() as { error?: string; verdict?: { source: { sha256: string } } };
426
- status.textContent = res.ok ? t('Saved {file}: source {hash}.', { file: data.verdictFile, hash: out.verdict!.source.sha256.slice(0, 12) }) : out.error ? t(out.error) : t('Save failed.');
427
- status.dataset.result = res.ok ? 'saved' : 'refused';
428
- }catch{
429
- status.textContent=t('Save failed.');status.dataset.result='refused';
430
- }finally{button.disabled=false;}
431
- }
432
-
433
- async function boot(): Promise<void> {
434
- const box=$('pv-canvas-box'),layout=$('stage-layout');mountViewportPair(layout);$('rig-root').append(box);const reference=document.createElement('canvas');reference.id='pv-reference';$('reference-content').append(reference);$('rig-empty').hidden=true;$('rig-overlay').hidden=true;$('rig-label').textContent=t('Selected part');$('rig-viewport').tabIndex=0;
435
- viewport=createPartsViewport({el:$,canvas:$<HTMLCanvasElement>('pv-canvas'),message:(msg)=>{$('pv-save-status').textContent=t(msg);},reference:()=>state.data?.painting?$<HTMLCanvasElement>('pv-reference'):null,
436
- frameSize:target=>{
437
- const data=state.data,item=data?.items[state.selected];
438
- if(!data||!item||paintReset)return null;
439
- if(paintFailure)return {w:0,h:0};
440
- return target==='rig'?rasterFrame(data,item)??{w:0,h:0}:data.painting?partFrame(data,item):null;
441
- },
442
- });viewport.bindControls();
443
- $('native-one').onclick=()=>viewport!.cameraAction(()=>viewport!.updateCamera(viewport!.availableCamera()??'rig',{zoom:1,pan:{x:0,y:0}}));
444
- bindDomI18n(document);
445
- bindStageNav({partsOnly:true,model:false});
446
- if(stageEmbedded){
447
- const header=document.querySelector<HTMLElement>('.pv-top')!,status=$('pv-load');
448
- header.hidden=true;status.classList.add('pv-embedded-status');header.after(status);
449
- document.querySelector<HTMLElement>('.pv-layout')!.hidden=true;
450
- document.querySelector<HTMLElement>('.pv-verdict')!.hidden=true;
451
- const approveButton=$<HTMLButtonElement>('pv-approve-all');approveButton.disabled=true;
452
- const saveButton=$<HTMLButtonElement>('pv-save');saveButton.disabled=true;
453
- }
454
- window.addEventListener('message',event=>{if(event.source!==parent||event.origin!==location.origin||event.data?.type!=='review-stage-language'||!['en','ko'].includes(event.data.language))return;setLinkLanguage(null);setLanguagePreference(event.data.language);});
455
- connectLiveWindow(access);
456
- if(stageEmbedded)await sourceReady;
457
- const res = await fetch(access.route(partsApi), { headers: stageHeaders() });
458
- const data = await res.json() as ViewData & { error?: string };
459
- if (!res.ok) { const status=$('pv-load');status.textContent=t(data.error??'Load failed.');status.dataset.result='refused';return; }
460
- state.data = data;if(!data.differenceAvailable)document.querySelector('[data-pv-comparison="difference"]')?.remove();if(stageEmbedded)for(const item of data.items)if(item.mesh)state.meshShown.add(item.name);$('reference-empty').textContent=data.painting?'':t('PARTS_REFERENCE_UNAVAILABLE: supply --painting to compare the original painting');$('reference-empty').hidden=!!data.painting;if(data.painting)viewport.state.cameraSync=true;comments.push(...data.verdict?.comments??[]);setupPartsComments();viewport.bindNavigation(undefined,()=>!commentUi?.active()&&!paintFailure);viewport.observeResize();
461
- if(stageEmbedded&&data.joinedVerdictBinding){
462
- document.querySelector<HTMLElement>('.pv-verdict')!.hidden=false;
463
- $('pv-approve-all').hidden=true;
464
- $('pv-comment-count').hidden=true;
465
- const save=$<HTMLButtonElement>('pv-save');
466
- save.disabled=!access.capability;
467
- if(!access.capability)save.title=t('Read-only view: reopen with rig-review open to edit.');
468
- }
469
- document.getElementById('parts-correction-hint')!.hidden = data.mode !== 'parts' || stageEmbedded;
470
- for (const item of data.items) state.verdict.set(item.name, { outcome: 'pending', note: '', ...(item.mesh ? { mesh: { outcome: 'pending' as Outcome, note: '' } } : {}) });
471
- if (data.verdict) { for (const [name, v] of Object.entries(data.verdict.parts)) if (state.verdict.has(name)) state.verdict.set(name, { outcome: v.outcome, note: v.note ?? '', ...(v.mesh ? { mesh: v.mesh } : {}) }); $<HTMLSelectElement>('pv-overall').value = data.verdict.status; }
472
- document.title = data.title;
473
- $('pv-title').textContent = data.title;
474
- $('pv-mode').textContent = data.mode === 'parts' ? t('Parts package, before rigging') : t('Atlas of a built rig');
475
- $('pv-list-title').textContent = data.mode === 'parts' ? t('PARTS') : t('REGIONS');
476
- $('pv-load').textContent = data.verdictStale === 'files' ? t('A saved sign-off was made on other files; this review starts fresh.') : data.verdictStale === 'flags' ? t('The saved sign-off is for different producer flags; this review starts fresh.') : data.verdict ? t('Saved sign-off loaded.') : data.verdictReadOnlyReason?t(data.verdictReadOnlyReason):'';
477
- if(stageEmbedded){$('pv-load').hidden=$('pv-load').textContent==='';document.querySelector<HTMLElement>('.pv-layout')!.hidden=false;}
478
- $('pv-atlas-switch').hidden = data.mode !== 'atlas';
479
- const assemble=$<HTMLButtonElement>('pv-assemble');assemble.disabled=data.mode!=='parts'||!data.rigSize;assemble.title=assemble.disabled?t(data.mode==='atlas'?'Assembly unavailable: atlas regions carry no rig placement.':'Assembly unavailable: rig_size is not declared.'):'';
480
- assemble.onclick=()=>{setView(state.view==='assembled'?'item':'assembled');assemble.setAttribute('aria-pressed',String(state.view==='assembled'));};
481
- bindAssemblyPicking();
482
- for(const button of document.querySelectorAll<HTMLElement>('[data-pv-comparison]'))button.onclick=()=>{const mode=button.dataset.pvComparison as PartsComparison['mode'];state.comparison=mode==='difference'?{mode,opacity:state.comparison.opacity,threshold:state.differenceThreshold}:{mode,opacity:state.comparison.opacity};if(state.comparison.mode!=='part'){state.alpha=false;$<HTMLInputElement>('pv-alpha').checked=false;state.meshShown.delete(state.data!.items[state.selected]!.name);renderMesh();}renderComparison();void paint();};
483
- $<HTMLInputElement>('pv-opacity').oninput=e=>{state.comparison.opacity=Number((e.target as HTMLInputElement).value);renderComparison();void paint();};
484
- $<HTMLInputElement>('pv-threshold').oninput=e=>{
485
- const input=e.target as HTMLInputElement,threshold=input.valueAsNumber,status=$('pv-save-status');
486
- if(!Number.isInteger(threshold)||threshold<0||threshold>255){
487
- input.value=String(state.differenceThreshold);
488
- status.dataset.thresholdRefused='true';
489
- status.textContent=t('PARTS_COMPARISON_INVALID: enter an integer threshold from 0 to 255. Last valid value restored.');
490
- return;
491
- }
492
- if(status.dataset.thresholdRefused){delete status.dataset.thresholdRefused;status.textContent='';}
493
- state.differenceThreshold=threshold;
494
- if(state.comparison.mode==='difference')state.comparison.threshold=threshold;
495
- void paint();
496
- };
497
- const footprints = $<HTMLInputElement>('pv-footprints');
498
- if (data.mode === 'atlas') { footprints.disabled = true; $('pv-footprint-control').title = t('Footprints need a parts package: atlas regions carry no rig placement.'); }
499
- $<HTMLSelectElement>('pv-bg').onchange = e => { state.bg = (e.target as HTMLSelectElement).value; void paint(); };
500
- $<HTMLInputElement>('pv-alpha').onchange = e => { state.alpha = (e.target as HTMLInputElement).checked; void paint(); };
501
- footprints.onchange = e => { state.footprints = (e.target as HTMLInputElement).checked; void paint(); };
502
-
503
- for (const b of document.querySelectorAll<HTMLButtonElement>('[data-pv-view]')) b.onclick = () => setView(b.dataset.pvView as 'item' | 'page');
504
- for (const r of document.querySelectorAll<HTMLInputElement>('input[data-pv-outcome]')) r.onchange = () => { if (r.checked) updateEntry({ outcome: r.value as Outcome }); };
505
- $<HTMLTextAreaElement>('pv-note').oninput = e => updateEntry({ note: (e.target as HTMLTextAreaElement).value });
506
- $('pv-save').onclick = () => { void save(); };
507
- $('pv-approve-all').onclick = () => approveAll();
508
- for(const format of ['json','issue'])$('pv-export-'+format).onclick=async()=>{const res=await fetch(access.route(stageEmbedded?partsApi+'/export/'+format:'/api/parts/export?format='+format),{headers:stageHeaders()});const value=await res.text();if(!res.ok){$('pv-save-status').textContent=JSON.parse(value).error??t('Save failed.');return;}const url=URL.createObjectURL(new Blob([value],{type:format==='json'?'application/json':'text/markdown'})),a=document.createElement('a');a.href=url;a.download=stageEmbedded?(format==='json'?data.verdictFile:data.verdictFile.replace(/\.json$/,'.md')):format==='json'?'parts-review-export.json':'parts-review-export.md';a.click();setTimeout(()=>URL.revokeObjectURL(url),1000);};
509
- onLanguageChange(() => { if (state.data) select(state.selected); });
510
- if(stageEmbedded)(window as StagePartsWindow).rigReviewStageParts={snapshot:stagePartsSnapshot};
511
- if(data.items.length){if(stageRestore)await restoreStageParts(stageRestore);else select(0);}
512
- renderCorrections();
513
- document.body.dataset.ready = 'true';
514
- }
515
-
516
- /** Observe taps only; the shared controller exclusively owns pan, zoom and pinch. */
517
- function bindAssemblyPicking():void {
518
- const pane=$('rig-viewport');let tap:{id:number;x:number;y:number}|null=null;const pointers=new Set<number>();
519
- pane.addEventListener('pointerdown',e=>{pointers.add(e.pointerId);if(pointers.size===1&&e.button===0)tap={id:e.pointerId,x:e.clientX,y:e.clientY};else tap=null;});
520
- pane.addEventListener('pointermove',e=>{if(tap&&Math.hypot(e.clientX-tap.x,e.clientY-tap.y)>4)tap=null;});
521
- pane.addEventListener('pointercancel',e=>{pointers.delete(e.pointerId);tap=null;});
522
- pane.addEventListener('pointerup',e=>{
523
- pointers.delete(e.pointerId);const start=tap;tap=null;
524
- if(!start||start.id!==e.pointerId||Math.hypot(e.clientX-start.x,e.clientY-start.y)>4||state.view!=='assembled'||painting||paintFailure||commentUi?.active())return;
525
- const data=state.data!,r=$('pv-canvas').getBoundingClientRect(),zoom=viewport!.paneCamera('rig').zoom;
526
- const layers=data.items.flatMap(box=>{const img=images.get(`${partsApi}/image/${box.index}`);return img?[{box,alpha:sourceAlpha(box,img)}]:[];});
527
- const hit=pickAssembly(layers,(e.clientX-r.left)/zoom,(e.clientY-r.top)/zoom,state.hidden);if(hit)select(hit.index);
528
- });
529
- }
530
-
531
- interface PartsPose extends CommentUiPose {item:Item;sourceHash:string;view:PartsComment['view']}
532
- function setupPartsComments():void {
533
- const codec:CommentCodec<PartsComment,PartsPose>={
534
- read:c=>{try{parsePartsComment(c);const camera={space:'image' as const,center:c.view.camera.center,zoom:c.view.camera.zoom,viewport:c.view.camera.viewport,visible:{x:c.view.camera.center.x-c.view.camera.viewport.width/c.view.camera.zoom/2,y:c.view.camera.center.y-c.view.camera.viewport.height/c.view.camera.zoom/2,width:c.view.camera.viewport.width/c.view.camera.zoom,height:c.view.camera.viewport.height/c.view.camera.zoom}};const r=c.imageRegion;return {mode:'parts',viewport:'rig',screen:region(projectMark(r,camera),projectMark({x:r.x+r.width,y:r.y+r.height},camera)),world:r,camera,crop:c.crop,bookmark:{part:c.part,imageHash:c.imageHash,sourceHash:c.sourceHash,view:c.view}};}catch{return null;}},
535
- signature:p=>[p.item.name,p.item.imageHash,p.sourceHash,p.camera,p.view],
536
- matches:(_mark,p,c)=>p.item.name===c.part&&p.item.imageHash===c.imageHash&&p.sourceHash===c.sourceHash,
537
- label:c=>`${c.part} · ${c.summary}`,
538
- create:async(p,_view,screen,crop,_bookmark,summary)=>{const r=snapImageRegion(region(unprojectMark(screen,p.camera),unprojectMark({x:screen.x+screen.width,y:screen.y+screen.height},p.camera)));const c:PartsComment={schema:'rig-review-parts-comment/1',id:crypto.randomUUID(),summary,part:p.item.name,imageHash:p.item.imageHash!,sourceHash:p.sourceHash,imageRegion:r,rigRegion:{...r,x:p.item.x+r.x,y:p.item.y+r.y},view:p.view,crop,nativeCrop:null};const res=await fetch(access.route('/api/parts/comment'),{method:'POST',headers:access.headers({'Content-Type':'application/json'}),body:JSON.stringify(c)}),out=await res.json() as {comment:PartsComment;error?:string};if(!res.ok)throw new Error(out.error);return parsePartsComment(out.comment);}
539
- };
540
- const pose=():PartsPose|null=>{const data=state.data,item=data?.items[state.selected],camera=viewport?.numericView().cameras.rig;if(!data||!item||!camera||data.mode!=='parts'||state.view!=='item')return null;return {mode:'parts',camera,item:{...item},sourceHash:data.sourceHash,view:{camera:{zoom:camera.zoom,center:{...camera.center},viewport:{...camera.viewport}},cameraSync:viewport!.state.cameraSync,referenceCamera:(()=>{const c=viewport!.numericView().cameras.reference;return c?{zoom:c.zoom,center:{...c.center},viewport:{...c.viewport}}:null;})(),background:state.bg,alpha:state.alpha,footprints:state.footprints,mesh:state.meshShown.has(item.name),comparison:{...state.comparison}},capture:{pane:$('rig-viewport'),root:$('rig-root'),images:true,canvas:$<HTMLCanvasElement>('pv-canvas'),backend:'canvas2d',nearest:true}};};
541
- commentUi=bindStageComments({toolbar:document.querySelector<HTMLElement>('.pv-toolbar')!,viewports:{rig:$('rig-viewport')},pose,pause:async()=>{},bookmark:()=>null,
542
- restore:async(raw)=>{const res=await fetch(access.route(partsApi),{headers:stageHeaders()});const current=await res.json() as ViewData&{error?:string};if(!res.ok||current.sourceHash!==state.data?.sourceHash)throw new Error(current.error??'PARTS_COMMENT_STALE_SOURCE');const b=raw as {part:string;imageHash:string;sourceHash:string;view:PartsComment['view']},item=state.data!.items.find(i=>i.name===b.part);if(!item||item.imageHash!==b.imageHash||state.data!.sourceHash!==b.sourceHash)throw new Error('PARTS_COMMENT_STALE_SOURCE: reopen the bound source');setView('item');$('pv-assemble').setAttribute('aria-pressed','false');select(item.index);state.bg=b.view.background;state.alpha=b.view.alpha;state.footprints=b.view.footprints;state.comparison={...(b.view.comparison??defaultPartsComparison())};if(state.comparison.mode==='difference')state.differenceThreshold=state.comparison.threshold;renderComparison();if(b.view.mesh)state.meshShown.add(item.name);else state.meshShown.delete(item.name);$<HTMLSelectElement>('pv-bg').value=state.bg;$<HTMLInputElement>('pv-alpha').checked=state.alpha;$<HTMLInputElement>('pv-footprints').checked=state.footprints;renderMesh();viewport!.state.cameraRestoring=true;try{await paint();if(!paintFailure){viewport!.writeCamera('rig',{zoom:b.view.camera.zoom,center:{...b.view.camera.center}});if(b.view.referenceCamera)viewport!.writeCamera('reference',{zoom:b.view.referenceCamera.zoom,center:{...b.view.referenceCamera.center}});viewport!.state.cameraSync=b.view.cameraSync;viewport!.fitCamera();}}finally{viewport!.state.cameraRestoring=false;}},
543
- feedback:()=>comments,locked:()=>false,add:c=>comments.push(c),changed:()=>renderVerdict(),error:m=>{$('pv-save-status').textContent=t(m);},blocked:()=>painting,refusal:()=>paintFailure??(state.view==='assembled'?'PARTS_COMMENT_UNAVAILABLE: select the individual part view to comment':null)??(state.data?.mode!=='parts'||stageEmbedded?'PARTS_COMMENT_UNAVAILABLE: original part image required':null),codec});
544
- }
545
-
546
- if (typeof document !== 'undefined' && document.getElementById('parts-app')) void boot();
547
-
548
- function renderCorrections():void {
549
- const data = state.data;
550
- if (!stageEmbedded && (!data || (!Object.hasOwn(data, 'draft') && !Object.hasOwn(data, 'draftUnavailable')))) {
551
- document.getElementById('pv-corrections')?.remove();
552
- return;
553
- }
554
- let host=document.getElementById('pv-corrections');if(!host){host=document.createElement('section');host.id='pv-corrections';document.querySelector('.pv-toolbar')!.after(host);}
555
- host.replaceChildren();const item=data?.items[state.selected],mapping=data?.draft?.mappings.find(m=>m.part===item?.name);
556
- const label=document.createElement('p');label.textContent=t(data?.draft&&!mapping?'STAGE_DRAFT_NO_MESH: this part has no mesh attachment; direct correction is unavailable.':data?.draft?.label??data?.draftUnavailable??'STAGE_DRAFT_UNAVAILABLE: no producer-compatible draft is supplied.');host.append(label);
557
- if(!mapping||!data?.draft)return;
558
- label.textContent+=` · ${mapping.part} · ${mapping.skin}/${mapping.slot}/${mapping.attachment} · v ${mapping.vertices} t ${mapping.triangles} · ${data.draft.buildId}`;
559
- if(data.draft.inspectionOnly)return;
560
- for(const [instrument,title,operation]of [['chest','Chest regions',t('rig-parts remesh --mesh')],['mesh','Mesh parameters',t('rig-parts remesh --mesh')],['delta','Edit Mesh',t('rig-parts remesh --delta')]]){
561
- const button=document.createElement('button');button.type='button';button.textContent=t(title!);button.title=`${mapping.part} · ${operation}`;button.onclick=()=>parent.postMessage({type:'review-stage-correction',part:mapping.part,sourceHash:data.sourceHash,buildId:data.draft!.buildId,instrument},location.origin);host.append(button);
562
- }
563
- const guidance=document.createElement('p');guidance.textContent=t('Use Write review, choose Parts review and name the Create draft. Export the saved item with the feedback CLI. Mesh deltas retain evidence as unsupported operations.');host.append(guidance);
564
- }
565
-
566
- function stagePartsSnapshot():StagePartsState|null {
567
- const data=state.data,item=data?.items[state.selected],mapping=data?.draft?.mappings.find(m=>m.part===item?.name);
568
- if(!data?.inspectionSourceHash||!item?.imageHash||!mapping||!viewport)return null;
569
- return {inspectionSourceHash:data.inspectionSourceHash,part:item.name,imageHash:item.imageHash,box:{x:item.x,y:item.y,w:item.w,h:item.h},mapping:{skin:mapping.skin,slot:mapping.slot,attachment:mapping.attachment},rig:{...viewport.paneCamera('rig')},reference:{...viewport.paneCamera('reference')},cameraSync:viewport.state.cameraSync,bg:state.bg,alpha:state.alpha,footprints:state.footprints,view:state.view,mesh:state.meshShown.has(item.name)};
570
- }
571
- async function restoreStageParts(saved:StagePartsState):Promise<void>{
572
- if(!state.data||!viewport)return;
573
- try{
574
- const index=stagePartsSelectionIndex(state.data,saved);
575
- viewport.state.cameraRestoring=true;state.bg=saved.bg;state.alpha=saved.alpha;state.footprints=saved.footprints;state.view=saved.view;
576
- if(saved.mesh)state.meshShown.add(saved.part);else state.meshShown.delete(saved.part);
577
- select(index);await paint();if(!paintFailure){viewport.writeCamera('rig',saved.rig);if(state.data.painting)viewport.writeCamera('reference',saved.reference);viewport.state.cameraSync=saved.cameraSync;viewport.fitCamera();}
578
- }catch{const status=$('pv-load');status.hidden=false;status.dataset.result='refused';status.textContent=t('STAGE_DRAFT_MISMATCH: separated parts and draft mesh identity differ.');document.querySelector<HTMLElement>('.pv-layout')!.hidden=true;}
579
- finally{viewport.state.cameraRestoring=false;}
580
- }
581
- if(typeof window!=='undefined')window.addEventListener('message',event=>{if(event.source===parent&&event.origin===location.origin&&event.data?.type==='review-stage-restore'&&event.data.state)void restoreStageParts(event.data.state);});
582
-
583
- async function revalidateStageParts(nextBuild?:string,savedState?:StagePartsState|null):Promise<void>{
584
- const targetBuild=nextBuild==='inspected'||(typeof nextBuild==='string'&&/^[a-f0-9]{64}$/.test(nextBuild))?nextBuild:stageBuild;
585
- try{
586
- const headers=access.headers(stageEmbedded?{'X-Review-Stage-Build':targetBuild}:{});
587
- const response=await fetch(access.route(partsApi),{headers}),data=await response.json() as ViewData&{error?:string};
588
- const sameBuild=targetBuild===stageBuild&&(data.draft?.buildId??targetBuild)===(state.data?.draft?.buildId??stageBuild);
589
- const validBuild=sameBuild?data.sourceHash===state.data?.sourceHash:Boolean(data.inspectionSourceHash&&data.inspectionSourceHash===state.data?.inspectionSourceHash&&data.draft?.buildId===targetBuild);
590
- if(!response.ok||!validBuild)throw new Error(data.error??'STAGE_DRAFT_MISMATCH: separated parts and draft mesh identity differ.');
591
- stageBuild=targetBuild;state.data=data;
592
- if(stageEmbedded){
593
- document.querySelector<HTMLElement>('.pv-verdict')!.hidden=!data.joinedVerdictBinding;
594
- const status=$('pv-load');status.textContent=data.verdictReadOnlyReason?t(data.verdictReadOnlyReason):'';status.hidden=status.textContent==='';delete status.dataset.result;
595
- }
596
- if(savedState)await restoreStageParts(savedState);else if(!sameBuild){select(state.selected);await paint();}
597
- renderCorrections();
598
- }catch(error){
599
- document.querySelector<HTMLElement>('.pv-verdict')!.hidden=true;if(state.data)delete state.data.joinedVerdictBinding;
600
- const status=$('pv-load');status.hidden=false;status.dataset.result='refused';status.textContent=t(error instanceof Error?error.message:String(error));
601
- document.querySelector<HTMLElement>('.pv-layout')!.hidden=true;
602
- }
603
- }
604
- if(typeof window!=='undefined')window.addEventListener('message',event=>{if(event.source!==parent||event.origin!==location.origin||event.data?.type!=='review-stage-revalidate')return;void revalidateStageParts(event.data.buildId,event.data.state);});