rig-review 3.7.0 → 4.0.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/README.md +1 -1
- package/docs/DESIGN.md +145 -74
- package/docs/PANELS.md +20 -12
- package/docs/PARTS_VIEW.md +133 -76
- package/docs/REVIEW_PACKAGE.md +445 -99
- package/docs/STABILITY.md +132 -198
- package/docs/WORKFLOWS.md +41 -120
- package/package.json +4 -3
- package/skills/rig-review/SKILL.md +41 -27
- package/src/build.ts +10 -2
- package/src/cli.ts +17 -16
- package/src/comment-crops.ts +6 -1
- package/src/compare-html.ts +22 -24
- package/src/compare-server.ts +1 -1
- package/src/compare-session.ts +41 -3
- package/src/correction-handoff.ts +27 -4
- package/src/create-pin-gate.ts +3 -0
- package/src/direction-inspection.ts +6 -2
- package/src/feedback-export.ts +68 -1
- package/src/front.ts +5 -200
- package/src/handoff.ts +1 -1
- package/src/interview-routes.ts +1 -1
- package/src/interview-scene.ts +3 -3
- package/src/job-act.ts +77 -73
- package/src/job-api.ts +326 -13
- package/src/job-checkpoint-evidence.ts +113 -0
- package/src/job-cli.ts +27 -14
- package/src/job-contract.ts +284 -62
- package/src/job-front.ts +157 -58
- package/src/job-host.ts +23 -4
- package/src/job-session.ts +109 -24
- package/src/job-source.ts +209 -57
- package/src/job-store.ts +80 -6
- package/src/job-worker.ts +1 -47
- package/src/joined-project.ts +61 -4
- package/src/manifest.ts +32 -4
- package/src/open-workspace.ts +12 -12
- package/src/open.ts +19 -12
- package/src/parts-comment-crops.ts +126 -31
- package/src/parts-comment.ts +351 -28
- package/src/parts-server.ts +19 -7
- package/src/parts-view.ts +588 -109
- package/src/scene-inspection.ts +50 -0
- package/src/server.ts +31 -22
- package/src/session.ts +58 -0
- package/src/stage-comment.ts +48 -1
- package/src/stage-parts.ts +23 -11
- package/web/animation-inspection.ts +1 -1
- package/web/bones-panel.ts +1 -3
- package/web/catalog-en.ts +175 -39
- package/web/catalog-ko.ts +175 -39
- package/web/cloth-panel.ts +1 -2
- package/web/compare.css +3 -13
- package/web/compare.html +3 -3
- package/web/compare.ts +69 -64
- package/web/cuts-panel.ts +1 -3
- package/web/density-strip-panel.ts +1 -2
- package/web/direction-panel.ts +22 -6
- package/web/i18n.ts +13 -1
- package/web/idle-panel.ts +1 -2
- package/web/index.html +1 -5
- package/web/inspection-persistence.ts +2 -1
- package/web/inspector-blocks.ts +149 -40
- package/web/instance-access.ts +24 -5
- package/web/interview-panel.ts +224 -175
- package/web/job-rig-capture.ts +164 -21
- package/web/job-rig-screen.ts +337 -0
- package/web/job-session.ts +611 -1437
- package/web/main.ts +614 -151
- package/web/mesh-panel.ts +1 -2
- package/web/owner-workspace.ts +88 -109
- package/web/part-selection.ts +47 -6
- package/web/part-thumbnails.ts +20 -6
- package/web/parts-render.ts +26 -19
- package/web/parts-viewport-provider.ts +181 -7
- package/web/physics-panel.ts +1 -2
- package/web/readings-panel.ts +1 -2
- package/web/requirements-panel.ts +1 -3
- package/web/retained-frame-stage.ts +105 -0
- package/web/retarget-panel.ts +2 -3
- package/web/rig-fields-panel.ts +1 -2
- package/web/rig-host.ts +64 -0
- package/web/rig-viewport-provider.ts +65 -16
- package/web/scene-plates.ts +57 -4
- package/web/stage-comments.ts +103 -46
- package/web/styles.css +117 -63
- package/web/view-controls.ts +201 -12
- package/web/viewport-capture.ts +12 -2
- package/web/viewport-controller.ts +107 -27
- package/web/viewport-pair.ts +2 -1
- package/web/workspace-preferences.ts +5 -4
- package/web/workspace-ui.ts +151 -19
- package/src/front-worker.ts +0 -2
- package/src/interview-server.ts +0 -54
- package/src/job-hub.ts +0 -304
- package/src/job-image-set.ts +0 -50
- package/web/interview.css +0 -28
- package/web/interview.html +0 -17
- package/web/interview.ts +0 -40
- package/web/job-hub.css +0 -14
- package/web/job-hub.html +0 -5
- package/web/job-hub.ts +0 -179
- package/web/owner-workspace.css +0 -14
- package/web/owner-workspace.html +0 -5
- package/web/parts-flags.ts +0 -48
- package/web/parts.css +0 -104
- package/web/parts.html +0 -49
- package/web/parts.ts +0 -604
- package/web/stage-nav.ts +0 -136
package/web/workspace-ui.ts
CHANGED
|
@@ -1,7 +1,104 @@
|
|
|
1
1
|
/** Browser workspace presentation. Source selection, player clocks and review decisions stay with the page. */
|
|
2
2
|
import {WorkspacePreferenceStore,panelBounds,type WorkspaceLanguage,type WorkspacePanels,type WorkspacePreferences,type WorkspaceTheme} from './workspace-preferences.ts';
|
|
3
3
|
import {allocateWorkspaceLayout,bindWorkspaceSeparator,bindWorkspaceDrawer,defaultWorkspaceColumns,InspectorScrollMemory,inspectorTabs,workspaceMinimums,type InspectorTab,type WorkspaceColumns,type WorkspacePanel,type SeparatorRange} from './workspace-layout.ts';
|
|
4
|
-
import {bindDomI18n,getLinkLanguage,setLanguagePreference,setLinkLanguage,tr} from './i18n.ts';
|
|
4
|
+
import {bindDomI18n,getLinkLanguage,setLanguagePreference,setLinkLanguage,tr,onLanguageChange} from './i18n.ts';
|
|
5
|
+
import {panelMake,actionButton,labelledControl} from './view-controls.ts';
|
|
6
|
+
|
|
7
|
+
/** Header availability belongs to the shared shell, independently of the removed step chips. */
|
|
8
|
+
export function bindHeaderModeAvailability(options:{model:boolean;preRig?:boolean;parts?:boolean;root?:Pick<Document,'querySelectorAll'>}):()=>void {
|
|
9
|
+
const root=options.root??document,reason=options.preRig?'RIG_VERSION_UNAVAILABLE: this draft has no recorded rig review package.':!options.model?'MODEL_UNAVAILABLE: no compiled model is supplied in this inspection.':null;
|
|
10
|
+
if(!reason)return ()=>{};
|
|
11
|
+
const modes=[...root.querySelectorAll<HTMLButtonElement>('[data-mode]')].map(button=>({button,disabled:button.disabled,title:button.getAttribute('title'),pressed:button.getAttribute('aria-pressed')}));
|
|
12
|
+
const render=()=>{for(const {button}of modes){if(options.parts&&button.dataset.mode==='rig')continue;button.disabled=true;button.title=tr(reason);button.setAttribute('title',tr(reason));if(button.getAttribute('aria-pressed')!=='false')button.setAttribute('aria-pressed','false');}};
|
|
13
|
+
const refuse=(event:Event)=>{event.preventDefault();event.stopImmediatePropagation();render();};
|
|
14
|
+
const observer=new MutationObserver(render);for(const {button}of modes){observer.observe(button,{attributes:true,attributeFilter:['aria-pressed']});button.addEventListener('click',refuse,true);}
|
|
15
|
+
const off=onLanguageChange(render);render();
|
|
16
|
+
return ()=>{off();observer.disconnect();for(const {button,disabled,title,pressed}of modes){button.removeEventListener('click',refuse,true);button.disabled=disabled;button.title=title??'';if(title===null)button.removeAttribute('title');else button.setAttribute('title',title);if(pressed===null)button.removeAttribute('aria-pressed');else button.setAttribute('aria-pressed',pressed);}};
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface WorkspaceStatusBarOptions {
|
|
20
|
+
message:HTMLElement|string;readouts:readonly HTMLElement[];source?:HTMLElement;
|
|
21
|
+
}
|
|
22
|
+
/** One C11 DOM constructor; screens supply their existing readout and source nodes. */
|
|
23
|
+
export function mountStatusBar(options:{placement:'inline';message:HTMLElement|string}):{message:HTMLElement};
|
|
24
|
+
export function mountStatusBar(options:WorkspaceStatusBarOptions):{footer:HTMLElement;message:HTMLElement};
|
|
25
|
+
export function mountStatusBar(options:WorkspaceStatusBarOptions|{placement:'inline';message:HTMLElement|string}):{footer?:HTMLElement;message:HTMLElement} {
|
|
26
|
+
const message=typeof options.message==='string'?panelMake('span',{id:'message',className:'status-message',textContent:options.message}):options.message;
|
|
27
|
+
message.setAttribute('role','status');message.setAttribute('aria-live','polite');
|
|
28
|
+
// Retained hosts already place their status in the header; preserve that node and geometry.
|
|
29
|
+
if('placement' in options)return {message};
|
|
30
|
+
const readouts=panelMake('div',{className:'status-readouts'},...options.readouts);readouts.setAttribute('aria-label','Status');
|
|
31
|
+
const footer=panelMake('footer',{className:'status-bar'},message,readouts);
|
|
32
|
+
if(options.source)footer.append(options.source);
|
|
33
|
+
return {footer,message};
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export type WorkspaceHeaderCompatibility = 'rigStep1'|'legacyCompareStep3'|'legacyPartsStep2'|'legacyInterviewStep4'|'legacyOwnerStep6';
|
|
37
|
+
export interface WorkspaceHeaderOptions {
|
|
38
|
+
compatibility:WorkspaceHeaderCompatibility;embedded?:boolean;title?:string;revision?:string;
|
|
39
|
+
/** Only the stopped compare host supplies its existing domain controls and actions. */
|
|
40
|
+
compare?:{modeSwitch:HTMLElement;buildPicker:HTMLElement;actions:HTMLElement};
|
|
41
|
+
}
|
|
42
|
+
export interface WorkspaceHeader {
|
|
43
|
+
header:HTMLElement;title:HTMLElement;subtitle:HTMLElement|null;modeSwitch:HTMLElement|null;dirty:HTMLElement|null;
|
|
44
|
+
stages:HTMLElement|null;status:HTMLParagraphElement|null;language:HTMLSelectElement|null;languageLabel:HTMLLabelElement|null;
|
|
45
|
+
dispose:()=>void;
|
|
46
|
+
}
|
|
47
|
+
/** One C1 construction path; the finite legacy choices expire at their named screen migrations. */
|
|
48
|
+
export function mountWorkspaceShell(options:WorkspaceHeaderOptions):WorkspaceHeader {
|
|
49
|
+
const kind=options.compatibility,rig=kind==='rigStep1',compare=kind==='legacyCompareStep3',parts=kind==='legacyPartsStep2',interview=kind==='legacyInterviewStep4',owner=kind==='legacyOwnerStep6';
|
|
50
|
+
const branded=rig||compare||parts,settingsLanguage=rig||compare;
|
|
51
|
+
const header=panelMake('header');
|
|
52
|
+
const headerClass=rig?'topbar':parts?'pv-top':owner?'owner-header':null;
|
|
53
|
+
if(headerClass)header.className=headerClass;
|
|
54
|
+
if(branded){
|
|
55
|
+
const brand=panelMake('div',{className:parts?'pv-brand':'brand'});
|
|
56
|
+
const mark=panelMake('span',compare?{}:{className:parts?'pv-mark':'brand-mark'},compare?'COMPARE':'r');
|
|
57
|
+
if(compare)brand.append('rig review ',mark);else brand.append(mark,'rig review');
|
|
58
|
+
header.append(brand);
|
|
59
|
+
}
|
|
60
|
+
const title=panelMake(rig||parts?'strong':'h1');
|
|
61
|
+
const titleId=rig?'package-title':compare?'title':parts?'pv-title':null;
|
|
62
|
+
if(titleId)title.id=titleId;
|
|
63
|
+
title.textContent=options.title??(rig?'Review package':compare?'A / B comparison':parts?'Parts review':'');
|
|
64
|
+
let subtitle:HTMLElement|null=null;
|
|
65
|
+
if(branded){
|
|
66
|
+
subtitle=panelMake('span',{id:rig?'revision':compare?'animation':'pv-mode',className:rig?'subtle':compare?'hint':'pv-subtle',textContent:options.revision??''});
|
|
67
|
+
const identity=panelMake('div',{},title,...(parts?[' ']:[]),subtitle);header.append(identity);
|
|
68
|
+
}else{if(interview)header.append('\n ');header.append(title);}
|
|
69
|
+
let modeSwitch:HTMLElement|null=null,dirty:HTMLElement|null=null;
|
|
70
|
+
if(rig||compare){
|
|
71
|
+
modeSwitch=compare?options.compare!.modeSwitch:panelMake('div',{className:'mode-switch'});
|
|
72
|
+
if(rig){
|
|
73
|
+
modeSwitch.setAttribute('role','group');modeSwitch.setAttribute('aria-label','Mode');
|
|
74
|
+
for(const [mode,label] of [['rig','Setup'],['playback','Animate'],['compare','Compare']] as const){
|
|
75
|
+
const button=actionButton(label,null);button.dataset.mode=mode;button.setAttribute('aria-pressed',String(mode==='rig'));
|
|
76
|
+
if(mode==='compare'){button.disabled=true;button.title='No second build supplied: reopen with --compare <built> --reference <video>';}
|
|
77
|
+
else{button.dataset.inspector=mode;button.setAttribute('aria-controls','inspector-'+mode);}
|
|
78
|
+
modeSwitch.append(button);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
header.append(modeSwitch);
|
|
82
|
+
if(compare)header.append(options.compare!.buildPicker,options.compare!.actions);
|
|
83
|
+
else{dirty=panelMake('span',{id:'dirty',className:'subtle',textContent:'Loading…'});header.append(panelMake('div',{className:'top-actions'},dirty));}
|
|
84
|
+
}
|
|
85
|
+
let stages:HTMLElement|null=null,status:HTMLParagraphElement|null=null;
|
|
86
|
+
|
|
87
|
+
if(owner){status=panelMake('p',{className:'owner-status'});status.setAttribute('role','status');header.append(status);}
|
|
88
|
+
let language:HTMLSelectElement|null=null,languageLabel:HTMLLabelElement|null=null;
|
|
89
|
+
if(!parts){
|
|
90
|
+
language=panelMake('select');
|
|
91
|
+
if(settingsLanguage){language.id='settings-language';language.dataset.appPreference='';}
|
|
92
|
+
for(const value of settingsLanguage?['system','en','ko']:['en','ko']){
|
|
93
|
+
const text=settingsLanguage?(value==='system'?'System':value==='en'?'English':'한국어'):interview?(value==='en'?'English':'한국어'):'';
|
|
94
|
+
language.append(panelMake('option',{value,textContent:text}));
|
|
95
|
+
}
|
|
96
|
+
if(settingsLanguage){languageLabel=labelledControl('Language ',language);if(rig)header.append(languageLabel);}
|
|
97
|
+
else{if(interview)header.append('\n ');header.append(language);if(interview)header.append('\n ');}
|
|
98
|
+
}
|
|
99
|
+
if(options.embedded){if(rig||parts)header.hidden=true;else if(interview)language!.hidden=true;}
|
|
100
|
+
return {header,title,subtitle,modeSwitch,dirty,stages,status,language,languageLabel,dispose(){header.remove();languageLabel?.remove();}};
|
|
101
|
+
}
|
|
5
102
|
|
|
6
103
|
/** Reachable effective bounds, accounting for the other panel's saved desired size. */
|
|
7
104
|
export function workspaceResizeRange(available:{width:number;height:number},desired:WorkspacePanels,panel:WorkspacePanel,columns:WorkspaceColumns=defaultWorkspaceColumns):SeparatorRange {
|
|
@@ -23,20 +120,26 @@ export function selectedInspector(root:Pick<Document,'querySelector'>=document):
|
|
|
23
120
|
}
|
|
24
121
|
export interface WorkspaceUI {
|
|
25
122
|
defaults:()=>WorkspacePreferences;beforeTab:()=>void;afterTab:()=>void;scroll:()=>string;restoreScroll:(value:unknown)=>void;
|
|
26
|
-
revealInspector:()=>void;refresh:()=>void;dispose:()=>void;
|
|
123
|
+
revealInspector:()=>void;refresh:()=>void;element:(id:string)=>HTMLElement|null;settle:()=>Promise<void>;dispose:()=>void;
|
|
124
|
+
}
|
|
125
|
+
/** Caller-owned shell regions. The left preference may retain a migrated screen's saved width. */
|
|
126
|
+
export interface WorkspaceRegions {
|
|
127
|
+
layout:HTMLElement;left:HTMLElement;main:HTMLElement;stage:HTMLElement;bottom:HTMLElement;right?:HTMLElement;
|
|
128
|
+
columns?:WorkspaceColumns;
|
|
27
129
|
}
|
|
28
130
|
/** `currentTheme`, when given, is the appearance the Settings theme select shows; otherwise it shows the saved default. */
|
|
29
|
-
export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:WorkspaceTheme)=>void;currentTheme?:()=>WorkspaceTheme|undefined}):WorkspaceUI {
|
|
30
|
-
const
|
|
31
|
-
const
|
|
131
|
+
export function bindWorkspaceUI(options:{root?:HTMLElement;regions?:WorkspaceRegions;changed:()=>void;defaultTheme:(theme:WorkspaceTheme)=>void;currentTheme?:()=>WorkspaceTheme|undefined;language?:HTMLSelectElement;bottomPanel?:{kind:string;strip:HTMLElement;act:HTMLElement;actHome:HTMLElement;collapse:HTMLButtonElement}}):WorkspaceUI {
|
|
132
|
+
const scope=options.root??document,dialogs={} as Record<WorkspacePanel,HTMLDialogElement>;
|
|
133
|
+
const require=<T extends HTMLElement=HTMLElement>(id:string,optional=false)=>{const selector='#'+id,node=(options.root?.id===id?options.root:scope.querySelector<HTMLElement>(selector))??Object.values(dialogs).map(dialog=>dialog.id===id?dialog:dialog.querySelector<HTMLElement>(selector)).find(Boolean)??null;if(!node&&!optional)throw new Error('Missing workspace element: '+id);return node as T;};
|
|
134
|
+
const regions=options.regions,layout=regions?.layout??document.querySelector<HTMLElement>('.layout')!,main=regions?.main??layout.querySelector<HTMLElement>('main')!,stage=regions?.stage??require('stage-layout'),inspector=regions?.bottom??document.querySelector<HTMLElement>('.inspector')!,explorer=regions?regions.right:document.getElementById('parts-explorer');
|
|
32
135
|
layout.classList.add('workspace-layout');
|
|
33
|
-
let left=layout.querySelector<HTMLElement>('.left-panel');if(!left){left=document.createElement('aside');left.className='left-panel';left.innerHTML='<h2>INPUTS</h2><p class="hint">A and B retain their fixed source bindings. The reference video and shared animation are named above the stage.</p>';layout.prepend(left);}left.id='workspace-left';inspector.id='workspace-inspector';
|
|
136
|
+
let left=regions?.left??layout.querySelector<HTMLElement>('.left-panel');if(!left){left=document.createElement('aside');left.className='left-panel';left.innerHTML='<h2>INPUTS</h2><p class="hint">A and B retain their fixed source bindings. The reference video and shared animation are named above the stage.</p>';layout.prepend(left);}left.id='workspace-left';inspector.id='workspace-inspector';
|
|
34
137
|
// A parts explorer placed inside the left column makes that column the explorer: it keeps the explorer's
|
|
35
138
|
// saved width and the page has no right column. Otherwise sources stay left and the explorer stays right.
|
|
36
|
-
const explorerLeft=left.contains(explorer),columns:WorkspaceColumns=explorerLeft?{left:'rightWidth',right:null}:defaultWorkspaceColumns;
|
|
139
|
+
const explorerLeft=regions?regions.columns?.left==='rightWidth'&&!regions.right:!!explorer&&left.contains(explorer),columns:WorkspaceColumns=regions?.columns??(explorerLeft?{left:'rightWidth',right:null}:explorer?defaultWorkspaceColumns:{left:'leftWidth',right:null});
|
|
37
140
|
// A section is an Inspector panel only while it carries data-inspector-panel; the review page's Feedback
|
|
38
141
|
// section lives in the review dialog instead and keeps its id without being a panel.
|
|
39
|
-
const tabs=inspectorTabs.filter(tab=>
|
|
142
|
+
const tabs=inspectorTabs.filter(tab=>require('inspector-'+tab,true)?.dataset.inspectorPanel===tab);if(!tabs.length&&!regions)throw new Error('Missing workspace element: inspector-'+inspectorTabs.join('|inspector-'));
|
|
40
143
|
// The left column is a fixed header row (a leading `.left-header`, when the page has one) and one scrolling
|
|
41
144
|
// body holding everything else, Settings included: the body is the column's only scroll container.
|
|
42
145
|
const header=[...left.children].find(node=>node.className.split(' ').includes('left-header'))??null;
|
|
@@ -44,16 +147,18 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
|
|
|
44
147
|
const settings=document.createElement('section');settings.className='workspace-settings';settings.setAttribute('aria-label','Settings');
|
|
45
148
|
// The header holds the expand/collapse control; the body is hidden while collapsed (a workspace preference, default collapsed).
|
|
46
149
|
const settingsHeader=document.createElement('h2'),settingsToggle=document.createElement('button'),settingsBody=document.createElement('div');settingsHeader.className='sticky-header settings-header';settingsToggle.type='button';settingsToggle.id='settings-toggle';settingsToggle.className='settings-toggle';settingsToggle.textContent='Settings';settingsToggle.setAttribute('aria-controls','settings-body');settingsBody.id='settings-body';settingsBody.className='settings-body';settingsHeader.append(settingsToggle);settings.append(settingsHeader,settingsBody);
|
|
47
|
-
settingsBody.innerHTML='<label>Theme <select id="settings-theme" data-app-preference><option value="system">System</option><option value="dark">Dark</option><option value="light">Light</option></select></label><label
|
|
150
|
+
settingsBody.innerHTML='<label>Theme <select id="settings-theme" data-app-preference><option value="system">System</option><option value="dark">Dark</option><option value="light">Light</option></select></label><label><input id="settings-sync" data-app-preference type="checkbox">Sync cameras by default</label><label><input id="settings-idle" data-app-preference type="checkbox">Repeat idle by default</label><button id="settings-reset" type="button">Reset layout</button><p class="hint">Defaults apply to new inspections. Links and source drafts retain their explicit view.</p><p id="settings-state" class="hint" role="status"></p>';
|
|
151
|
+
const sharedLanguage=options.language??require<HTMLSelectElement>('settings-language');
|
|
152
|
+
if(!sharedLanguage.closest('header'))settingsBody.firstElementChild!.after(sharedLanguage.parentElement!);
|
|
48
153
|
sourceList.append(settings);
|
|
49
|
-
const theme=require<HTMLSelectElement>('settings-theme'),language=
|
|
154
|
+
const theme=require<HTMLSelectElement>('settings-theme'),language=sharedLanguage,sync=require<HTMLInputElement>('settings-sync'),idle=require<HTMLInputElement>('settings-idle'),status=require('settings-state');
|
|
50
155
|
const store=new WorkspacePreferenceStore({onStatus:value=>{status.textContent=tr(value.detail);}});let desired={...store.get().panels};
|
|
51
156
|
const stack=document.createElement('div');stack.className='workspace-stage-stack';for(const child of [...main.children])if(child!==inspector)stack.append(child);main.prepend(stack);
|
|
52
157
|
const triggers=document.createElement('div');triggers.className='workspace-drawer-triggers';triggers.setAttribute('aria-label','Workspace panels');stack.prepend(triggers);
|
|
53
|
-
const panels:Partial<Record<WorkspacePanel,HTMLElement>>=
|
|
54
|
-
const sides:Partial<Record<WorkspacePanel,'left'|'right'>>=
|
|
158
|
+
const panels:Partial<Record<WorkspacePanel,HTMLElement>>={};if(columns.left)panels[columns.left]=left;if(columns.right&&explorer)panels[columns.right]=explorer;panels.inspectorHeight=inspector;
|
|
159
|
+
const sides:Partial<Record<WorkspacePanel,'left'|'right'>>={};if(columns.left)sides[columns.left]='left';if(columns.right&&explorer)sides[columns.right]='right';
|
|
55
160
|
const labels:Record<WorkspacePanel,string>=explorerLeft?{leftWidth:'Sources and settings',rightWidth:'Parts and settings',inspectorHeight:'Inspector'}:{leftWidth:'Sources and settings',rightWidth:'Parts explorer',inspectorHeight:'Inspector'};
|
|
56
|
-
const handles={} as Record<WorkspacePanel,HTMLElement>,
|
|
161
|
+
const handles={} as Record<WorkspacePanel,HTMLElement>,buttons={} as Record<WorkspacePanel,HTMLButtonElement>,disposers:(()=>void)[]=[];
|
|
57
162
|
const present=Object.keys(panels) as WorkspacePanel[],node=(panel:WorkspacePanel)=>panels[panel]!;
|
|
58
163
|
for(const panel of present){
|
|
59
164
|
const handle=document.createElement('div');handle.className='workspace-separator workspace-'+panel+(sides[panel]?' workspace-side-'+sides[panel]:'');handles[panel]=handle;
|
|
@@ -64,15 +169,24 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
|
|
|
64
169
|
const header=document.createElement('div');header.className='sticky-header workspace-drawer-header';const title=document.createElement('span');title.textContent=labels[panel];header.append(title,close);dialog.append(header);document.body.append(dialog);dialogs[panel]=dialog;
|
|
65
170
|
disposers.push(bindWorkspaceDrawer({trigger,drawer:dialog,label:labels[panel],close}));
|
|
66
171
|
}
|
|
67
|
-
const
|
|
172
|
+
const bottom=options.bottomPanel,bottomBody=bottom?inspector.querySelector<HTMLElement>('.inspector-body')!:null,bottomHeading=bottom?bottom.strip.parentElement!:null;
|
|
173
|
+
const bottomCollapseKey=bottom?`rig-review-bottom-collapsed/${bottom.kind}`:'';
|
|
174
|
+
let collapsed=false;
|
|
175
|
+
if(bottom){try{collapsed=localStorage.getItem(bottomCollapseKey)==='true';}catch{}}
|
|
176
|
+
const memory=new InspectorScrollMemory();const active=():InspectorTab=>{const tab=selectedInspector(scope) as InspectorTab|undefined;return tab&&tabs.includes(tab)?tab:tabs[0]!;};
|
|
68
177
|
let disposed=false,frame=0,applying=false,available={width:0,height:0},effective=allocateWorkspaceLayout(available,desired,columns);
|
|
69
178
|
const panelFor=(tab:InspectorTab)=>{const section=require('inspector-'+tab);return (typeof section.querySelector==='function'?section.querySelector<HTMLElement>('.animate-blocks-panel'):null)??section;};
|
|
70
179
|
const userByTab=new Map<InspectorTab,boolean>(),extentByTab=new Map<InspectorTab,string>(),extentOf=(panel:HTMLElement)=>`${panel.scrollWidth}:${panel.scrollHeight}:${panel.clientWidth}:${panel.clientHeight}`;
|
|
71
|
-
const capture=()=>{const tab=active(),section=require('inspector-'+tab),panel=panelFor(tab),saved=memory.snapshot()[tab];if(!section.hidden&&(!saved||saved.x<=Math.max(0,panel.scrollWidth-panel.clientWidth)&&saved.y<=Math.max(0,panel.scrollHeight-panel.clientHeight)))memory.capture(tab,panel,false);};
|
|
72
|
-
const restore=()=>{if(disposed)return;const tab=active(),panel=panelFor(tab);if(panel.clientWidth>0||panel.clientHeight>0)extentByTab.set(tab,extentOf(panel));memory.restore(tab,panel);};
|
|
180
|
+
const capture=()=>{if(!tabs.length)return;const tab=active(),section=require('inspector-'+tab),panel=panelFor(tab),saved=memory.snapshot()[tab];if(!section.hidden&&(!saved||saved.x<=Math.max(0,panel.scrollWidth-panel.clientWidth)&&saved.y<=Math.max(0,panel.scrollHeight-panel.clientHeight)))memory.capture(tab,panel,false);};
|
|
181
|
+
const restore=()=>{if(disposed||!tabs.length)return;const tab=active(),panel=panelFor(tab);if(panel.clientWidth>0||panel.clientHeight>0)extentByTab.set(tab,extentOf(panel));memory.restore(tab,panel);};
|
|
73
182
|
const schedule=()=>{if(!disposed&&!frame)frame=requestAnimationFrame(()=>{frame=0;apply();});};
|
|
74
183
|
const dock=(panel:WorkspacePanel,drawer:boolean)=>{
|
|
75
184
|
const element=node(panel),dialog=dialogs[panel],trigger=buttons[panel];trigger.hidden=!drawer;handles[panel].hidden=drawer;
|
|
185
|
+
if(bottom&&panel==='inspectorHeight'){
|
|
186
|
+
trigger.hidden=true;handles[panel].hidden=drawer||collapsed;
|
|
187
|
+
if(!drawer&&dialog.open)dialog.close();
|
|
188
|
+
const target=drawer?dialog:inspector;if(bottomBody!.parentElement!==target)target.append(bottomBody!);return;
|
|
189
|
+
}
|
|
76
190
|
if(drawer&&element.parentElement!==dialog){const focus=element.contains(document.activeElement);dialog.append(element);if(focus)trigger.focus({preventScroll:true});}
|
|
77
191
|
if(!drawer&&element.parentElement===dialog){const focused=element.contains(document.activeElement)||document.activeElement===trigger;if(dialog.open)dialog.close();trigger.setAttribute('aria-expanded','false');if(sides[panel]==='left')layout.prepend(element);else if(sides[panel]==='right')layout.append(element);else main.append(element);if(focused){element.tabIndex=-1;element.focus({preventScroll:true});}}
|
|
78
192
|
};
|
|
@@ -88,11 +202,28 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
|
|
|
88
202
|
for(const panel of present)dock(panel,mode(panel)==='drawer');
|
|
89
203
|
const gap=workspaceMinimums.separator,side=(key:WorkspaceColumns['left'])=>key&&mode(key)==='panel'?{width:effective[key],separator:gap}:{width:0,separator:0},l=side(columns.left),r=side(columns.right);
|
|
90
204
|
layout.style.setProperty('--workspace-columns',`${l.width}px ${l.separator}px minmax(0,1fr) ${r.separator}px ${r.width}px`);
|
|
91
|
-
|
|
205
|
+
let bottomHeight=effective.inspectorHeight;
|
|
206
|
+
if(bottom){
|
|
207
|
+
const compact=collapsed||effective.inspectorMode==='drawer';bottomBody!.hidden=collapsed;
|
|
208
|
+
const actTarget=dialogs.inspectorHeight.open?bottom.actHome:bottomHeading!;if(bottom.act.parentElement!==actTarget)actTarget.append(bottom.act);
|
|
209
|
+
inspector.dataset.collapsed=String(compact);bottom.collapse.setAttribute('aria-expanded',String(!collapsed));bottom.collapse.textContent=tr(collapsed?'Expand bottom panel':'Collapse bottom panel');
|
|
210
|
+
if(compact)bottomHeight=bottomHeading!.getBoundingClientRect().height;
|
|
211
|
+
}
|
|
212
|
+
main.style.gridTemplateRows=`minmax(0,1fr) ${effective.inspectorMode==='panel'&&!collapsed?gap:0}px ${bottomHeight}px`;
|
|
92
213
|
layout.dataset.stageMinimum=String(effective.stageMinimumSatisfied);for(const binding of bindings)binding.refresh();options.changed();restore();
|
|
93
214
|
}finally{applying=false;}
|
|
94
215
|
}
|
|
95
216
|
const renderSettings=()=>{const value=store.get();setLanguagePreference(value.language);settingsToggle.setAttribute('aria-expanded',String(!value.settingsCollapsed));settingsBody.hidden=value.settingsCollapsed;settings.dataset.collapsed=String(value.settingsCollapsed);theme.value=options.currentTheme?.()??value.theme;language.value=getLinkLanguage()??value.language;sync.checked=value.defaultCameraSync;idle.checked=value.defaultIdleRepeat;status.textContent=tr(store.status().detail);};
|
|
217
|
+
const revealInspector=()=>{
|
|
218
|
+
if(bottom&&collapsed){collapsed=false;try{localStorage.setItem(bottomCollapseKey,'false');}catch{}apply();}
|
|
219
|
+
if(effective.inspectorMode==='drawer'&&!dialogs.inspectorHeight.open){for(const dialog of Object.values(dialogs))if(dialog.open)dialog.close();buttons.inspectorHeight.click();if(bottom)apply();}
|
|
220
|
+
};
|
|
221
|
+
if(bottom){
|
|
222
|
+
const closed=()=>{if(disposed)return;apply();bottom.strip.querySelector<HTMLButtonElement>('[aria-selected=true]')?.focus({preventScroll:true});};
|
|
223
|
+
dialogs.inspectorHeight.addEventListener('close',closed);
|
|
224
|
+
bottom.collapse.onclick=()=>{capture();collapsed=!collapsed;try{localStorage.setItem(bottomCollapseKey,String(collapsed));}catch{}if(dialogs.inspectorHeight.open)dialogs.inspectorHeight.close();apply();if(!collapsed)revealInspector();};
|
|
225
|
+
disposers.push(()=>{bottom.collapse.onclick=null;dialogs.inspectorHeight.removeEventListener('close',closed);});
|
|
226
|
+
}
|
|
96
227
|
theme.onchange=()=>{store.update({theme:theme.value as WorkspaceTheme});options.defaultTheme(store.get().theme);};language.onchange=()=>{setLinkLanguage(null);store.update({language:language.value as WorkspaceLanguage});setLanguagePreference(store.get().language);};sync.onchange=()=>{store.update({defaultCameraSync:sync.checked});};idle.onchange=()=>{store.update({defaultIdleRepeat:idle.checked});};require<HTMLButtonElement>('settings-reset').onclick=()=>store.resetLayout();settingsToggle.onclick=()=>{store.update({settingsCollapsed:!store.get().settingsCollapsed});};
|
|
97
228
|
bindDomI18n(document);const unsubscribe=store.subscribe(value=>{desired={...value.panels};renderSettings();schedule();});renderSettings();
|
|
98
229
|
for(const tab of tabs){
|
|
@@ -110,7 +241,8 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
|
|
|
110
241
|
}
|
|
111
242
|
const observer=new ResizeObserver(schedule);observer.observe(layout);for(const node of [...stack.children])if(node!==stage)observer.observe(node);for(const tab of tabs)observer.observe(panelFor(tab));
|
|
112
243
|
const resumed=()=>{if(!document.hidden)store.refresh();};document.addEventListener('visibilitychange',resumed);schedule();
|
|
113
|
-
return {defaults:()=>store.get(),beforeTab:capture,afterTab:restore,scroll:()=>{capture();return JSON.stringify(memory.snapshot());},restoreScroll(value){if(typeof value!=='string')return;memory.replace(JSON.parse(value));restore();},revealInspector
|
|
114
|
-
|
|
244
|
+
return {defaults:()=>store.get(),beforeTab:capture,afterTab:restore,scroll:()=>{capture();return JSON.stringify(memory.snapshot());},restoreScroll(value){if(typeof value!=='string')return;memory.replace(JSON.parse(value));restore();},revealInspector,refresh:schedule,element:id=>require(id,true)??null,
|
|
245
|
+
async settle(){if(disposed)return;if(frame){cancelAnimationFrame(frame);frame=0;}apply();await new Promise<void>(resolve=>requestAnimationFrame(()=>requestAnimationFrame(()=>resolve())));if(!disposed)apply();},
|
|
246
|
+
dispose(){if(disposed)return;capture();disposed=true;if(frame)cancelAnimationFrame(frame);observer.disconnect();document.removeEventListener('visibilitychange',resumed);unsubscribe();for(const binding of bindings)binding.dispose();for(const dispose of disposers)dispose();for(const dialog of Object.values(dialogs)){if(dialog.open)dialog.close();dialog.remove();}memory.dispose();store.dispose();}
|
|
115
247
|
};
|
|
116
248
|
}
|
package/src/front-worker.ts
DELETED
package/src/interview-server.ts
DELETED
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
import { readFile } from 'node:fs/promises';
|
|
2
|
-
import { randomBytes } from 'node:crypto';
|
|
3
|
-
import { appRoot, buildWeb } from './build.ts';
|
|
4
|
-
import { createLiveLifecycle, LIVE_PATH } from './live-lifecycle.ts';
|
|
5
|
-
import { interviewHeaders, interviewRoutes } from './interview-routes.ts';
|
|
6
|
-
|
|
7
|
-
export async function startInterviewServer(root: string, output: string, port: number, exitOnClose = false) {
|
|
8
|
-
const capability = randomBytes(32).toString('hex');
|
|
9
|
-
const route = interviewRoutes(root, output, capability);
|
|
10
|
-
const bundle = await buildWeb('interview');
|
|
11
|
-
const [html, css] = await Promise.all(['interview.html','interview.css'].map(path => readFile(appRoot + 'web/' + path)));
|
|
12
|
-
const live = createLiveLifecycle({label:'review interview', exitOnClose, stopServer:() => server.stop(true)});
|
|
13
|
-
const server = Bun.serve({hostname:'127.0.0.1', port, websocket:live.websocket, async fetch(req, srv) {
|
|
14
|
-
const origin = 'http://127.0.0.1:' + srv.port;
|
|
15
|
-
const {pathname} = new URL(req.url);
|
|
16
|
-
if (pathname === LIVE_PATH && req.method === 'GET') {
|
|
17
|
-
if (req.headers.get('origin') !== origin) return new Response(null, {status:403});
|
|
18
|
-
return live.upgrade(req, srv, interviewHeaders);
|
|
19
|
-
}
|
|
20
|
-
live.onRequestStart(pathname);
|
|
21
|
-
try {
|
|
22
|
-
const response = await route(req, origin);
|
|
23
|
-
if (response) return response;
|
|
24
|
-
const files = new Map([
|
|
25
|
-
['/', [html, 'text/html; charset=utf-8']],
|
|
26
|
-
['/interview.css', [css, 'text/css']],
|
|
27
|
-
['/interview.js', [bundle, 'text/javascript']],
|
|
28
|
-
] as const);
|
|
29
|
-
const file = req.method === 'GET' ? files.get(pathname as '/' | '/interview.css' | '/interview.js') : undefined;
|
|
30
|
-
return file ? new Response(file[0] as BodyInit, {headers:{...interviewHeaders,'Content-Type':file[1]}}) :
|
|
31
|
-
new Response(null, {status:404, headers:interviewHeaders});
|
|
32
|
-
} finally {live.onRequestEnd(pathname);}
|
|
33
|
-
}});
|
|
34
|
-
return {url:'http://127.0.0.1:' + server.port + '/#cap=' + capability, stop:() => {live.stop(); server.stop(true);}};
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
export const interviewUsage = 'Usage: rig-review interview <create-root> --picks-dir <project-relative directory> [--port <n>]';
|
|
38
|
-
export async function interviewCommand(args: string[]) {
|
|
39
|
-
if (!args.length || args[0] === '--help' || args[0] === '-h') {console.log(interviewUsage); return;}
|
|
40
|
-
const root = args.shift()!;
|
|
41
|
-
let output: string | undefined;
|
|
42
|
-
let port: number | undefined;
|
|
43
|
-
while (args.length) {
|
|
44
|
-
const flag = args.shift();
|
|
45
|
-
const value = args.shift();
|
|
46
|
-
if (flag === '--picks-dir' && value && output === undefined) output = value;
|
|
47
|
-
else if (flag === '--port' && value && /^\d+$/.test(value) && Number(value) <= 65535 && port === undefined) port = Number(value);
|
|
48
|
-
else throw new Error(interviewUsage);
|
|
49
|
-
}
|
|
50
|
-
if (!output) throw new Error(interviewUsage);
|
|
51
|
-
const running = await startInterviewServer(root, output, port ?? 4317, true);
|
|
52
|
-
console.log(running.url);
|
|
53
|
-
for (const signal of ['SIGINT', 'SIGTERM'] as const) process.once(signal, () => running.stop());
|
|
54
|
-
}
|
package/src/job-hub.ts
DELETED
|
@@ -1,304 +0,0 @@
|
|
|
1
|
-
/** Embedded job owner. Trusted callback registrations never cross a process boundary. */
|
|
2
|
-
import {randomBytes, randomUUID} from 'node:crypto';
|
|
3
|
-
import {mkdir, unlink} from 'node:fs/promises';
|
|
4
|
-
import {join} from 'node:path';
|
|
5
|
-
import {buildWeb} from './build.ts';
|
|
6
|
-
import {jobBody, jobObject, sameCapability} from './job-api.ts';
|
|
7
|
-
import {JOB_API_SCHEMA, JOB_ACT_SCHEMA, JOB_CAPABILITIES, type JobCapabilities, type JobHostPorts, type JobReviewerBinding} from './job-contract.ts';
|
|
8
|
-
import {assertJobHostCompatible, createJobRequestContext, installJobWriterBinding, jobHostIdentity,
|
|
9
|
-
jobWindowResources, type JobHostOptions, type JobHostReuseExpectation, type JobHostRecord} from './job-front.ts';
|
|
10
|
-
import {JobSession} from './job-session.ts';
|
|
11
|
-
import {captureJobRoot} from './job-source.ts';
|
|
12
|
-
import {JobError} from './job-store.ts';
|
|
13
|
-
import {acquireClaim, readOpenStatus, releaseClaim, running} from './open.ts';
|
|
14
|
-
import {assertPrivate, readPrivate, writePrivate} from './open-workspace-state.ts';
|
|
15
|
-
import {canonicalStatePath} from './state-dir.ts';
|
|
16
|
-
|
|
17
|
-
export interface JobHubOptions {
|
|
18
|
-
readonly stateDir: string;
|
|
19
|
-
readonly reviewer: JobReviewerBinding;
|
|
20
|
-
readonly port?: number;
|
|
21
|
-
}
|
|
22
|
-
export type JobHubJobOptions = Omit<JobHostOptions, 'stateDir' | 'port' | 'reviewer' | 'reuseOnly'>;
|
|
23
|
-
export interface JobHubJob {
|
|
24
|
-
readonly session: JobSession;
|
|
25
|
-
readonly ports: JobHostPorts;
|
|
26
|
-
readonly origin: string;
|
|
27
|
-
readonly jobUrl: string;
|
|
28
|
-
readonly reused: boolean;
|
|
29
|
-
readonly attachment: JobHostReuseExpectation;
|
|
30
|
-
}
|
|
31
|
-
export interface JobOwnerHub {
|
|
32
|
-
readonly origin: string;
|
|
33
|
-
readonly ownerUrl: string;
|
|
34
|
-
openJob(options: JobHubJobOptions): Promise<JobHubJob>;
|
|
35
|
-
stop(): Promise<void>;
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
export interface JobHubRow {
|
|
39
|
-
jobId: string;
|
|
40
|
-
generation: number;
|
|
41
|
-
status: 'active' | 'closed';
|
|
42
|
-
publication: {publicationId: string; instanceKey: string; sourceHash: string; label: string} | null;
|
|
43
|
-
pendingCount: number;
|
|
44
|
-
}
|
|
45
|
-
export interface JobHubList {
|
|
46
|
-
schema: 'rig-review-job-hub/1';
|
|
47
|
-
capabilities?: JobCapabilities;
|
|
48
|
-
incarnation: string;
|
|
49
|
-
limit: number;
|
|
50
|
-
jobs: JobHubRow[];
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
const schema = 'rig-review-job-hub/1';
|
|
54
|
-
const maximumJobs = 32;
|
|
55
|
-
const responseHeaders = {'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff', 'Referrer-Policy': 'no-referrer'};
|
|
56
|
-
type HubCode = 'JOB_HUB_ALREADY_RUNNING' | 'JOB_HUB_EXTERNAL_HOST' | 'JOB_HUB_HOST_UNRESPONSIVE' |
|
|
57
|
-
'JOB_HUB_CLOSED' | 'JOB_HUB_LIMIT' | 'JOB_HUB_STATE_INVALID';
|
|
58
|
-
class HubError extends Error {
|
|
59
|
-
constructor(readonly code: HubCode) {super(code);}
|
|
60
|
-
}
|
|
61
|
-
interface HubRecord {
|
|
62
|
-
schema: typeof schema;
|
|
63
|
-
pid: number;
|
|
64
|
-
origin: string;
|
|
65
|
-
incarnation: string;
|
|
66
|
-
capability: string;
|
|
67
|
-
}
|
|
68
|
-
interface Member {
|
|
69
|
-
root: string;
|
|
70
|
-
fingerprint: string;
|
|
71
|
-
session: JobSession;
|
|
72
|
-
context: ReturnType<typeof createJobRequestContext>;
|
|
73
|
-
recordPath: string;
|
|
74
|
-
ready: boolean;
|
|
75
|
-
}
|
|
76
|
-
function refused(code: string, status: number) {
|
|
77
|
-
return Response.json({ok: false, error: {code, message: code}}, {status, headers: responseHeaders});
|
|
78
|
-
}
|
|
79
|
-
function hostRecord(value: unknown, jobId?: string): JobHostRecord {
|
|
80
|
-
if (!value || typeof value !== 'object') throw new HubError('JOB_HUB_STATE_INVALID');
|
|
81
|
-
const row = value as JobHostRecord;
|
|
82
|
-
let origin: URL;
|
|
83
|
-
try {origin = new URL(row.origin);} catch {throw new HubError('JOB_HUB_STATE_INVALID');}
|
|
84
|
-
if (row.schema !== 'rig-review-job-host/1' || typeof row.jobId !== 'string' || jobId && row.jobId !== jobId ||
|
|
85
|
-
typeof row.fingerprint !== 'string' || !Number.isSafeInteger(row.pid) || row.pid < 1 ||
|
|
86
|
-
origin.origin !== row.origin || origin.protocol !== 'http:' || origin.hostname !== '127.0.0.1') {
|
|
87
|
-
throw new HubError('JOB_HUB_STATE_INVALID');
|
|
88
|
-
}
|
|
89
|
-
return row;
|
|
90
|
-
}
|
|
91
|
-
|
|
92
|
-
export async function startJobHub(options: JobHubOptions): Promise<JobOwnerHub> {
|
|
93
|
-
const reviewer = structuredClone(options.reviewer);
|
|
94
|
-
if (!reviewer?.id || !['owner', 'delegate'].includes(reviewer.role)) throw new JobError('JOB_AUTHORITY_REFUSED');
|
|
95
|
-
if (options.port !== undefined && (!Number.isSafeInteger(options.port) || options.port < 0 || options.port > 65535)) {
|
|
96
|
-
throw new JobError('JOB_REQUEST_INVALID');
|
|
97
|
-
}
|
|
98
|
-
const stateDir = canonicalStatePath(options.stateDir);
|
|
99
|
-
const directory = join(stateDir, 'job-hub'), control = join(stateDir, 'job-ui');
|
|
100
|
-
for (const path of [directory, control]) {
|
|
101
|
-
await mkdir(path, {recursive: true, mode: 0o700}); await assertPrivate(path, true);
|
|
102
|
-
}
|
|
103
|
-
const recordPath = join(directory, 'host.json'), incarnation = randomUUID();
|
|
104
|
-
const capability = randomBytes(32).toString('hex');
|
|
105
|
-
async function refuseLiveHub(): Promise<null> {
|
|
106
|
-
const previous = await readPrivate(recordPath) as HubRecord | null;
|
|
107
|
-
if (!previous) return null;
|
|
108
|
-
if (previous.schema !== schema || !Number.isSafeInteger(previous.pid) || previous.pid < 1) {
|
|
109
|
-
throw new HubError('JOB_HUB_STATE_INVALID');
|
|
110
|
-
}
|
|
111
|
-
if (running(previous.pid)) throw new HubError('JOB_HUB_ALREADY_RUNNING');
|
|
112
|
-
return null;
|
|
113
|
-
}
|
|
114
|
-
await refuseLiveHub();
|
|
115
|
-
const acquired = await acquireClaim(directory, 'hub', incarnation, refuseLiveHub,
|
|
116
|
-
performance.now() + 20_000, 'JOB_HUB_ALREADY_RUNNING');
|
|
117
|
-
if (!('claim' in acquired)) throw new HubError('JOB_HUB_ALREADY_RUNNING');
|
|
118
|
-
const hubClaim = acquired.claim;
|
|
119
|
-
let server: ReturnType<typeof Bun.serve> | undefined;
|
|
120
|
-
const members = new Map<string, Member>();
|
|
121
|
-
let queue = Promise.resolve(), closing = false, requests = 0;
|
|
122
|
-
let stopping: Promise<void> | undefined;
|
|
123
|
-
const resources = jobWindowResources();
|
|
124
|
-
let hubBundle: Promise<Blob> | undefined;
|
|
125
|
-
async function removeOwned(path: string) {
|
|
126
|
-
const value = await readPrivate(path) as {incarnation?: string; hubIncarnation?: string} | null;
|
|
127
|
-
if (value?.incarnation === incarnation || value?.hubIncarnation === incarnation) {
|
|
128
|
-
await unlink(path).catch(error => {if (error.code !== 'ENOENT') throw error;});
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
function stop(): Promise<void> {
|
|
132
|
-
if (stopping) return stopping;
|
|
133
|
-
closing = true;
|
|
134
|
-
stopping = (async () => {
|
|
135
|
-
await queue;
|
|
136
|
-
for (const member of members.values()) member.context.stop();
|
|
137
|
-
while (requests || [...members.values()].some(member => member.context.busy)) await Bun.sleep(10);
|
|
138
|
-
await server?.stop(true);
|
|
139
|
-
for (const member of members.values()) {
|
|
140
|
-
member.session.dispose(); await removeOwned(member.recordPath);
|
|
141
|
-
}
|
|
142
|
-
members.clear();
|
|
143
|
-
await removeOwned(recordPath);
|
|
144
|
-
await releaseClaim(hubClaim, incarnation);
|
|
145
|
-
})();
|
|
146
|
-
return stopping;
|
|
147
|
-
}
|
|
148
|
-
try {
|
|
149
|
-
await refuseLiveHub();
|
|
150
|
-
server = Bun.serve({hostname: '127.0.0.1', port: options.port ?? 0, idleTimeout: 0,
|
|
151
|
-
async fetch(request): Promise<Response> {
|
|
152
|
-
if (closing) return refused('JOB_HUB_CLOSED', 503);
|
|
153
|
-
requests++;
|
|
154
|
-
try {
|
|
155
|
-
const url = new URL(request.url);
|
|
156
|
-
if (url.origin !== origin) return refused('JOB_LOOPBACK_REQUIRED', 403);
|
|
157
|
-
const resource = url.pathname === '/hub/' ? 'job-hub.html' : url.pathname === '/hub/job-hub.js' ? 'job-hub.js'
|
|
158
|
-
: url.pathname === '/hub/job-hub.css' ? 'job-hub.css' : url.pathname === '/hub/styles.css' ? 'styles.css' : null;
|
|
159
|
-
if (resource) {
|
|
160
|
-
if (!['GET', 'HEAD'].includes(request.method)) return refused('JOB_REQUEST_INVALID', 405);
|
|
161
|
-
if (request.headers.get('sec-fetch-site') === 'cross-site' ||
|
|
162
|
-
request.headers.get('origin') !== null && request.headers.get('origin') !== origin) return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
|
|
163
|
-
if (resource === 'job-hub.html') {
|
|
164
|
-
if (url.searchParams.get('workspace') !== incarnation ||
|
|
165
|
-
[...url.searchParams.keys()].some(key => !['workspace', 'lang'].includes(key) || url.searchParams.getAll(key).length !== 1) ||
|
|
166
|
-
url.searchParams.has('lang') && !['en', 'ko'].includes(url.searchParams.get('lang')!)) return refused('JOB_REQUEST_INVALID', 400);
|
|
167
|
-
} else if (url.search) return refused('JOB_REQUEST_INVALID', 400);
|
|
168
|
-
let body: BodyInit | null = null;
|
|
169
|
-
if (request.method !== 'HEAD') {
|
|
170
|
-
if (resource === 'job-hub.js') body = await (hubBundle ??= buildWeb('job-hub'));
|
|
171
|
-
else body = Bun.file(new URL('../web/' + resource, import.meta.url));
|
|
172
|
-
}
|
|
173
|
-
return new Response(body, {headers: {...responseHeaders,
|
|
174
|
-
'Content-Type': resource.endsWith('.html') ? 'text/html; charset=utf-8' : resource.endsWith('.js') ? 'text/javascript' : 'text/css',
|
|
175
|
-
'Content-Security-Policy': "default-src 'none'; script-src 'self'; style-src 'self'; frame-src 'self'; connect-src 'self'; base-uri 'none'; frame-ancestors 'none'; form-action 'none'"}});
|
|
176
|
-
}
|
|
177
|
-
const selected = /^\/hub\/api\/jobs\/([A-Za-z0-9][A-Za-z0-9._-]{0,127})\/open$/.exec(url.pathname);
|
|
178
|
-
if (url.pathname === '/hub/host' || url.pathname === '/hub/api/jobs' || selected) {
|
|
179
|
-
if (request.method !== (selected ? 'POST' : 'GET') || url.search) return refused('JOB_REQUEST_INVALID', 400);
|
|
180
|
-
if (request.headers.get('sec-fetch-site') === 'cross-site' ||
|
|
181
|
-
request.headers.get('origin') !== null && request.headers.get('origin') !== origin) {
|
|
182
|
-
return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
|
|
183
|
-
}
|
|
184
|
-
if (!sameCapability(request.headers.get('X-Review-Capability'), capability)) {
|
|
185
|
-
return refused('JOB_CAPABILITY_REQUIRED', 403);
|
|
186
|
-
}
|
|
187
|
-
if (selected) {
|
|
188
|
-
if (request.headers.get('origin') !== origin) return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
|
|
189
|
-
try {
|
|
190
|
-
const input = jobObject(await jobBody(request), ['schema', 'incarnation']);
|
|
191
|
-
if (input.schema !== schema || input.incarnation !== incarnation) return refused('JOB_REQUEST_INVALID', 400);
|
|
192
|
-
} catch (error) {return refused(error instanceof JobError ? error.code : 'JOB_REQUEST_INVALID',
|
|
193
|
-
error instanceof JobError && error.code === 'JOB_BODY_LIMIT' ? 413 : 400);}
|
|
194
|
-
const member = members.get(selected[1]!);
|
|
195
|
-
if (!member?.ready) return refused('JOB_UNKNOWN', 404);
|
|
196
|
-
if (member.session.status().status === 'closed') return refused('JOB_CLOSED', 409);
|
|
197
|
-
return Response.json({schema, incarnation, jobId: selected[1],
|
|
198
|
-
entry: `/jobs/${selected[1]}/?hub=${incarnation}`, capability: member.session.hostCredentials().ui}, {headers: responseHeaders});
|
|
199
|
-
}
|
|
200
|
-
if (url.pathname === '/hub/host') return Response.json({schema, incarnation, pid: process.pid,
|
|
201
|
-
origin, apiSchema: JOB_API_SCHEMA, actSchema: JOB_ACT_SCHEMA, capabilities: JOB_CAPABILITIES}, {headers: responseHeaders});
|
|
202
|
-
return Response.json({schema, incarnation, capabilities: JOB_CAPABILITIES, limit: maximumJobs, jobs: [...members.values()].filter(member => member.ready).map(member => {
|
|
203
|
-
const status = member.session.status();
|
|
204
|
-
return {jobId: status.jobId, generation: status.generation, status: status.status,
|
|
205
|
-
publication: status.publication && {publicationId: status.publication.publicationId,
|
|
206
|
-
instanceKey: status.publication.instanceKey, sourceHash: status.publication.source.sourceHash,
|
|
207
|
-
label: status.publication.label.slice(0, 512)}, pendingCount: status.pending.length};
|
|
208
|
-
})}, {headers: responseHeaders});
|
|
209
|
-
}
|
|
210
|
-
const match = /^\/jobs\/([A-Za-z0-9][A-Za-z0-9._-]{0,127})\//.exec(url.pathname);
|
|
211
|
-
const member = match && members.get(match[1]!);
|
|
212
|
-
return member ? await member.context.fetch(request) : refused('JOB_UNKNOWN', 404);
|
|
213
|
-
} finally {requests--;}
|
|
214
|
-
},
|
|
215
|
-
});
|
|
216
|
-
const origin: string = `http://127.0.0.1:${server.port}`;
|
|
217
|
-
const record: HubRecord = {schema, pid: process.pid, origin, incarnation, capability};
|
|
218
|
-
await writePrivate(recordPath, record);
|
|
219
|
-
async function register(input: JobHubJobOptions): Promise<JobHubJob> {
|
|
220
|
-
if (closing) throw new HubError('JOB_HUB_CLOSED');
|
|
221
|
-
if (!input || typeof input !== 'object' || 'reuseOnly' in (input as Record<string, unknown>)) {
|
|
222
|
-
throw new JobError('JOB_REQUEST_INVALID');
|
|
223
|
-
}
|
|
224
|
-
const startup: JobHostOptions = {...input, stateDir, reviewer};
|
|
225
|
-
const identity = jobHostIdentity(startup);
|
|
226
|
-
const root = captureJobRoot(startup.root).path;
|
|
227
|
-
if (members.size >= maximumJobs && ![...members.values()].some(member =>
|
|
228
|
-
member.root === root && member.fingerprint === startup.fingerprint && member.session.status().status === 'active')) {
|
|
229
|
-
throw new HubError('JOB_HUB_LIMIT');
|
|
230
|
-
}
|
|
231
|
-
const session = new JobSession(startup);
|
|
232
|
-
let retained = false;
|
|
233
|
-
let claim: string | undefined;
|
|
234
|
-
let member: Member | undefined;
|
|
235
|
-
const nonce = randomUUID();
|
|
236
|
-
try {
|
|
237
|
-
const existing = members.get(session.jobId);
|
|
238
|
-
if (existing) {
|
|
239
|
-
assertJobHostCompatible(existing.context.record, identity);
|
|
240
|
-
await installJobWriterBinding(existing.session, startup, origin);
|
|
241
|
-
return {session: existing.session, ports: existing.context.ports, origin,
|
|
242
|
-
jobUrl: origin + `/jobs/${session.jobId}/#cap=${existing.session.hostCredentials().ui}`, reused: true, attachment: existing.context.ownerAttachment()};
|
|
243
|
-
}
|
|
244
|
-
if (members.size >= maximumJobs) throw new HubError('JOB_HUB_LIMIT');
|
|
245
|
-
const path = join(control, session.jobId + '.json');
|
|
246
|
-
async function refuseExternal(): Promise<null> {
|
|
247
|
-
const value = await readPrivate(path);
|
|
248
|
-
if (!value) return null;
|
|
249
|
-
const row = hostRecord(value, session.jobId);
|
|
250
|
-
if (row.fingerprint !== startup.fingerprint) throw new HubError('JOB_HUB_STATE_INVALID');
|
|
251
|
-
if (!running(row.pid)) return null;
|
|
252
|
-
let remote: JobHostRecord;
|
|
253
|
-
try {
|
|
254
|
-
const response = await fetch(row.origin + `/jobs/${session.jobId}/host`, {
|
|
255
|
-
headers: {'X-Review-Capability': session.hostCredentials().ui}, redirect: 'error', signal: AbortSignal.timeout(1500),
|
|
256
|
-
});
|
|
257
|
-
if (!response.ok) {await response.body?.cancel(); throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');}
|
|
258
|
-
remote = hostRecord(await readOpenStatus(response, 1500), session.jobId);
|
|
259
|
-
if (remote.origin !== row.origin || remote.pid !== row.pid || remote.fingerprint !== row.fingerprint) {
|
|
260
|
-
throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');
|
|
261
|
-
}
|
|
262
|
-
} catch {throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');}
|
|
263
|
-
assertJobHostCompatible(row, identity); assertJobHostCompatible(remote, identity);
|
|
264
|
-
throw new HubError('JOB_HUB_EXTERNAL_HOST');
|
|
265
|
-
}
|
|
266
|
-
await refuseExternal();
|
|
267
|
-
const acquiredJob = await acquireClaim(control, 'job-' + session.jobId, nonce, refuseExternal,
|
|
268
|
-
performance.now() + 20_000, 'JOB_HUB_EXTERNAL_HOST');
|
|
269
|
-
if (!('claim' in acquiredJob)) throw new HubError('JOB_HUB_EXTERNAL_HOST');
|
|
270
|
-
claim = acquiredJob.claim;
|
|
271
|
-
await refuseExternal();
|
|
272
|
-
const context = createJobRequestContext(session, startup, origin, identity, resources, incarnation, incarnation, () => !closing && !!member?.ready);
|
|
273
|
-
Object.assign(context.record, {hubIncarnation: incarnation});
|
|
274
|
-
member = {root, fingerprint: startup.fingerprint, session, context, recordPath: path, ready: false};
|
|
275
|
-
members.set(session.jobId, member);
|
|
276
|
-
await installJobWriterBinding(session, startup, origin);
|
|
277
|
-
if (closing) throw new HubError('JOB_HUB_CLOSED');
|
|
278
|
-
await writePrivate(path, context.descriptor().record);
|
|
279
|
-
context.publish();
|
|
280
|
-
member.ready = true; retained = true;
|
|
281
|
-
return {session, ports: context.ports, origin,
|
|
282
|
-
jobUrl: origin + `/jobs/${session.jobId}/#cap=${session.hostCredentials().ui}`, reused: false, attachment: context.ownerAttachment()};
|
|
283
|
-
} finally {
|
|
284
|
-
if (!retained) {
|
|
285
|
-
if (member) {
|
|
286
|
-
members.delete(session.jobId); member.context.stop();
|
|
287
|
-
while (member.context.busy) await Bun.sleep(10);
|
|
288
|
-
}
|
|
289
|
-
session.dispose();
|
|
290
|
-
}
|
|
291
|
-
if (claim) await releaseClaim(claim, nonce);
|
|
292
|
-
}
|
|
293
|
-
}
|
|
294
|
-
return {origin, ownerUrl: origin + '/hub/?workspace=' + incarnation + '#cap=' + capability,
|
|
295
|
-
openJob(input) {
|
|
296
|
-
const startup = {...input};
|
|
297
|
-
const task = queue.then(() => register(startup));
|
|
298
|
-
queue = task.then(() => {}, () => {});
|
|
299
|
-
return task;
|
|
300
|
-
}, stop};
|
|
301
|
-
} catch (error) {
|
|
302
|
-
await stop(); throw error;
|
|
303
|
-
}
|
|
304
|
-
}
|