No SOP found for this project yet — complete the SOP Configuration first, then return here.
`
: `No SOP loaded — or import one from the Configuration tool.
`;
return;
}
const p=SOP.project||{}, g=SOP.governance||{};
const sample=SOP.meta&&SOP.meta.sample?`SAMPLE`:'';
bar.innerHTML=`${esc(p.name||'Untitled')} ${sample}
${esc(p.number||'')}${p.division?' · '+esc(p.division):''}
Reference folders (from SOP) — navigate to find & copy the specific file link:
`+
``+srcs.map(s=>`📁 ${esc(s.label)} ${esc(s.system||'')}`).join('')+`
`;
}
function renderSpecFolderLink(){
const el=document.getElementById('spec-folder-link'); if(!el) return;
const spec=sopLinkedSources().find(s=>/spec/i.test(s.label));
const link = spec
? `↗ Open spec folder (${esc(spec.system||'SOP')})`
: '';
// Say where the value came from, since the field itself is read-only now.
const src = gv('wp_spec')
? `from the SOP’s WP type${link ? ' · ' : ''}`
: `no spec section set on this WP type in the SOP`;
el.innerHTML = src + link;
}
// ── PEOPLE PICKERS: Assignees + Distribution ──────────────────────────────────
// Both were free-text lists. They're now multi-selects over the project team named
// on the SOP (site comments 8/3), while still accepting a typed name for someone
// with no user account — subcontractors and GC contacts have to stay addable.
//
// Stored shape keeps BOTH: `assignees`/`distribution` remain comma-joined display
// strings (print, export and the dashboard already read those), and
// `assigneeIds`/`distributionIds` carry the account ids that notification routing
// will need. The hidden inputs keep gv()/set() working unchanged.
let pkgPeople = { assignees: [], distribution: [] }; // [{id,name}] — id '' = typed name
function peopleFieldId(kind){ return kind === 'assignees' ? 'wp_assignees' : 'wp_distribution'; }
// The SOP team first (they're this project's named people), then anyone else on
// the project. Mirrors the Owner picker's ordering.
function peopleOptions(){
const team = sopTeamIds();
const onTeam = projectMembers.filter(u => team.includes(u.id));
const others = projectMembers.filter(u => !team.includes(u.id));
return { onTeam, others };
}
function cmMember(){
const cmId = (SOP && SOP.project && SOP.project.cmId) || '';
return cmId ? (projectMembers.find(u => u.id === cmId) || null) : null;
}
function syncPeopleField(kind){
const el = document.getElementById(peopleFieldId(kind));
if(el) el.value = pkgPeople[kind].map(p => p.name).filter(Boolean).join(', ');
}
function renderPeoplePicker(kind){
const box = document.getElementById('pick_' + kind);
if(!box) return;
const cm = cmMember();
const isCm = p => !!(cm && p.id === cm.id && kind === 'distribution');
const chips = pkgPeople[kind].map((p, i) => {
// The CM stays on distribution by default but can be dropped per package, so
// the chip is marked rather than locked.
const tag = isCm(p) ? ' pp-locked' : '';
const title = isCm(p) ? 'Construction Manager — included by default' : (p.id ? '' : 'Typed name (no user account)');
return `${esc(p.name)}` +
``;
}).join('');
const { onTeam, others } = peopleOptions();
const opt = u => {
const on = pkgPeople[kind].some(p => p.id === u.id);
return ``;
};
const menu =
(onTeam.length ? `Project team (from SOP)
${onTeam.map(opt).join('')}` : '') +
(others.length ? `${onTeam.length?'Others on this project':'On this project'}
${others.map(opt).join('')}` : '') +
(!onTeam.length && !others.length ? `No project members found
` : '') +
`Someone with no user account — they can't be emailed by the suite.
SOP number format has no scope tokens.
';
}
function typeNumberCode(name){ return (name||'').replace(/\b(install|installation)\b/ig,'').replace(/[^a-z0-9]+/gi,'').trim(); }
function updateNumber(){
const fmt=(SOP&&SOP.governance&&SOP.governance.woFormat)||'WP##-[TYPE]';
const t=gv('wp_type');
let out=fmt.replace(/WO##|WP##/i,'WP'+pad2(editingSeq()));
numberTokens().forEach(tok=>{
const v=(numberDims[tok]||'').trim();
out=out.split('['+tok+']').join(v||('['+tok+']'));
});
out=out.split('[TYPE]').join(t?typeNumberCode(t):'[TYPE]');
document.getElementById('wp_number').value=out;
}
function editingSeq(){ // keep an existing package's sequence number if editing, else next
if(editingId){ const ix=savedPackages.findIndex(p=>p.id===editingId); if(ix>=0) return ix+1; }
return nextSeq();
}
// ── MATERIAL LIST ────────────────────────────────────────────────────────────
function unitOptions(cur){
const list=ACU_UNITS.slice(); const c=(cur||'').toUpperCase();
if(c && !list.includes(c)) list.unshift(c);
return ``+list.map(u=>``).join('');
}
// Discipline column on the BOM appears only for multi-discipline packages, so a
// split hands each instance just its own materials. Keeps a stale value as an
// option (mirrors unitOptions) if the discipline was later removed.
function matDisciplineOptions(cur){
const list=pkgDisciplines.slice(); const c=cur||'';
if(c && !list.includes(c)) list.unshift(c);
return ``+list.map(d=>``).join('');
}
function buildMaterials(){
const multi=isMultiDiscipline();
const th=document.getElementById('mat-disc-th'); if(th) th.style.display=multi?'':'none';
const tb=document.getElementById('material-body'); tb.innerHTML='';
pkgMaterials.forEach((m,i)=>{ const tr=document.createElement('tr');
const discCell = multi ? `${i+1}
`).join('');
const opts=STATUS_ORDER.map(o=>``).join('');
return `${esc(d)}
Status:
${rows}
${f.mime==='application/pdf'?'📄':'🖼'} ${esc(f.name||'drawing')}
${wpFileSize(f.size||0)}
`).join('');
}
async function wpFileDescSave(id, v){
try{
const r=await fetch('/api/files/'+encodeURIComponent(id),{method:'PATCH',
headers:{'Content-Type':'application/json'}, body:JSON.stringify({description:v})});
if(!r.ok) throw 0;
const f=pkgFiles.find(x=>x.id===id); if(f) f.description=v;
wpFilesMirror();
}catch(e){ toast('Could not save the description — it is shown but not saved yet.'); }
}
async function wpFileDelete(id){
if(!(await wpConfirmDialog({title:'Remove drawing',
message:'Remove this drawing from the package? The bytes are deleted from the project storage.',
okLabel:'Remove'}))) return;
try{
const r=await fetch('/api/files/'+encodeURIComponent(id),{method:'DELETE'});
if(!r.ok) throw 0;
const out=await r.json();
pkgFiles=pkgFiles.filter(f=>f.id!==id);
wpFilesMirror(); wpFilesRender(); wpFileUsageSet(out.used, out.ceiling);
toast('Drawing removed.');
}catch(e){ toast('Could not remove the drawing — try again.'); }
}
// The running total, on the same line as the rules (D8: warn from 80%, refuse at
// the ceiling - the refusal itself comes from the server and names the number).
function wpFileUsageSet(used, ceiling){
const el=document.getElementById('file-usage'); if(el==null) return;
if(typeof used!=='number' || !ceiling){ el.textContent=''; return; }
const pct=used/ceiling;
const txt=`Project storage: ${wpFileSize(used)} of ${wpFileSize(ceiling)} used.`;
el.innerHTML = pct>=1 ? `${txt} Full — remove a drawing to make room.`
: pct>=0.8 ? `${txt} Approaching the ceiling.`
: esc(txt);
}
async function wpFilesRefreshUsage(){
if(!activeProjectId) return;
try{
const r=await fetch('/api/projects/'+encodeURIComponent(activeProjectId)+'/storage');
if(!r.ok) return;
const out=await r.json();
wpFileUsageSet(out.used, out.ceiling);
}catch(e){}
}
function removeAttach(i){ pkgAttach.splice(i,1); if(!pkgAttach.length)pkgAttach=[{doc:'',rev:'',link:''}]; buildAttach(); }
// ── ADD FILES FROM SOP FOLDER (no-auth interim) ──────────────────────────────
// Opens the SOP source folders, then turns pasted SharePoint file links into
// attachment rows with the file name parsed from the URL. (A true embedded
// picker needs an Azure AD app registration — see DEPLOYMENT.md.)
function fileNameFromUrl(url){
try{
const path=String(url).split('?')[0].split('#')[0];
const seg=decodeURIComponent(path.split('/').filter(Boolean).pop()||'');
// Only use it as a doc name if it looks like a real file (has an extension);
// short "/:f:/s/1) Open a folder, multi-select files in SharePoint, then use Copy link:
`+
``+srcs.map(s=>`📁 ${esc(s.label)} ${esc(s.system||'')}`).join('')+`
`
: `No SOP folders defined — load or import an SOP first.
`;
}
function toggleSopFilePanel(){
const p=document.getElementById('sop-file-panel'); if(!p) return;
const show = !p.style.display || p.style.display==='none';
p.style.display = show ? 'block' : 'none';
if(show){ renderSopFileFolders(); track('sop_file_panel_opened'); }
}
function addPastedFileLinks(){
const ta=document.getElementById('sop-file-links'); if(!ta) return;
const links=ta.value.split(/\r?\n/).map(s=>s.trim()).filter(Boolean);
if(!links.length){ toast('Paste one or more file links first'); return; }
// drop the single empty placeholder row if that's all there is
if(pkgAttach.length===1 && !pkgAttach[0].doc && !pkgAttach[0].rev && !pkgAttach[0].link) pkgAttach=[];
links.forEach(link=>pkgAttach.push({doc:fileNameFromUrl(link), rev:'', link}));
buildAttach(); ta.value=''; toggleSopFilePanel();
toast(links.length+' file'+(links.length>1?'s':'')+' added — set Rev as needed'); track('files_added_from_sop');
}
// ── CONSTRAINTS + RELEASE GATE ───────────────────────────────────────────────
function buildConstraints(){
// Carry the SOP's definition through, not just the name: `critical` decides
// whether reopening this constraint after release is emailed, and `description`
// is the tooltip. Statuses already set on the package are preserved.
const defs=constraintNames().map(n=> (typeof n==='string') ? {name:n} : (n||{}));
const prev={}; pkgConstraints.forEach(c=>prev[c.name]=c);
pkgConstraints=defs.filter(d=>d.name).map(d=>{
const p=prev[d.name];
return {
name: d.name,
status: p ? p.status : 'open',
comment: p ? (p.comment||'') : '',
critical: !!d.critical,
description: d.description || (p && p.description) || ''
};
});
const tb=document.getElementById('constraint-body'); tb.innerHTML='';
pkgConstraints.forEach((c,i)=>{ const tr=document.createElement('tr');
const critTag = c.critical
? ` ⚠ critical`
: '';
tr.innerHTML=`${txt}
`;
if(b._rbLast!==html){ b._rbLast=html; b.innerHTML=html; }
updateConstraintBadge();
}
// Releasing with an unclosed predecessor is allowed but must be explained. The
// reason rides on the package (data.gateOverride) and the server writes it to the
// audit log. Returns false if the user backed out.
async function confirmEarlyRelease(blocking, openConstraints){
// D4 extended this to open constraints on an URGENT package - the same audited
// path, not a new one. A silent bypass would destroy the delay-documentation
// use case that justifies the constraint workflow, so the reason is mandatory
// and the override records exactly which gates it crossed.
const open=(openConstraints||[]).slice();
const parts=[];
if(open.length) parts.push('These constraints are still OPEN:\n\n'+open.map(n=>'• '+n).join('\n'));
if(blocking.length) parts.push('These predecessor packages are not Closed yet:\n\n'+
blocking.map(p=>'• '+(p.number||p.id)+' — '+p.status).join('\n'));
const reason=await wpPromptDialog({
title:'Release with a logged override',
message:parts.join('\n\n')+'\n\nYou can still release this package, but the reason is recorded on it and in the audit log.',
label:'Why is it being released now?', okLabel:'Release — log the reason',
validate:v=>v.trim()?'':'A reason is required — it goes on the package and in the audit log.',
});
if(reason===null) return false;
pkgGateOverride={
reason: reason.trim(),
at: new Date().toISOString(),
by: (window.WP_USER && (WP_USER.full_name||WP_USER.username)) || '',
blocking: blocking.map(p=>p.number||p.id)
};
// The server only honours a constraint override that NAMES what it covers, so
// a constraint opened after the override cannot ride through on an old reason.
if(open.length) pkgGateOverride.constraints=open;
track('predecessor_gate_overridden');
return true;
}
// Which status an on-hold package returns to. The hold entry records it at the
// moment the hold is placed (`from`); the newest hold entry wins. Falls back to
// 'Issued' for a package held before this field existed - it must have been
// released to be flagged, and 'Issued' is the most conservative released state.
function holdReturnStatus(){
for(let i=pkgHolds.length-1;i>=0;i--){
const h=pkgHolds[i];
if(!h || h.released) continue;
if(h.from && STATUS_ORDER.indexOf(h.from)>=0) return h.from;
}
if(prevStatus && STATUS_ORDER.indexOf(prevStatus)>=0) return prevStatus;
return 'Issued';
}
// CR-015: leaving hold. Writes the release to the same history the hold went to -
// timestamp, user, what cleared it - and returns to the recorded prior status.
// Predecessors stay a refusable gate on the way back out (A1): if one reopened
// while the package sat on hold, the audited override is offered, never skipped.
async function releaseHold(clearedName){
const back=holdReturnStatus();
const r=readiness();
if(STATUS_ORDER.indexOf(back)>=ISSUED_IDX && r.blocking.length && !pkgGateOverride){
if(!(await confirmEarlyRelease(r.blocking))){
toast('Constraint cleared — still on hold: predecessor package(s) are not Closed.');
updateReleaseBanner(); return;
}
}
pkgHolds.push({ ts:new Date().toISOString(), released:true,
constraint:clearedName||'',
details:'Hold released — last open constraint cleared'+(clearedName?': '+clearedName:''),
by:(window.WP_USER && (WP_USER.full_name||WP_USER.username)) || '',
to:back });
setRadio('status', back); prevStatus=back;
updateReleaseBanner(); toast('Hold released — back to '+back+'.');
track('hold_released',{to:back});
const sg=document.getElementById('status-group');
if(sg) sg.scrollIntoView({behavior:'smooth', block:'center'});
}
// CR-014: accept / reject, from the banner. Accept is a plain forward step.
// Reject is the audited return: a comment is mandatory, rides on the package
// (data.qaRejections), and the server emails the owner and the QA group.
function qaAccept(){
setRadio('status','QC'); prevStatus='QC';
updateReleaseBanner(); toast('Accepted — package is in QC.');
track('qa_accepted');
}
function qaRejectOpen(){
const el=document.getElementById('qa-reject-comment'); if(el) el.value='';
document.getElementById('qa-reject-modal').classList.add('open');
if(el) el.focus();
}
function qaRejectCancel(){ document.getElementById('qa-reject-modal').classList.remove('open'); }
function qaRejectSubmit(){
const c=(document.getElementById('qa-reject-comment')||{value:''}).value.trim();
const errBox=document.getElementById('qa-reject-comment_err');
if(!c){
if(errBox) errBox.textContent='A comment is required — the crew needs to know what to fix.';
const el=document.getElementById('qa-reject-comment'); if(el){ el.setAttribute('aria-invalid','true'); el.focus(); }
return;
}
if(errBox) errBox.textContent='';
const qel=document.getElementById('qa-reject-comment'); if(qel) qel.removeAttribute('aria-invalid');
pkgQaRejections.push({ ts:new Date().toISOString(), comment:c,
by:(window.WP_USER && (WP_USER.full_name||WP_USER.username)) || '',
from:'Ready for QA' });
document.getElementById('qa-reject-modal').classList.remove('open');
setRadio('status','In Progress'); prevStatus='In Progress';
updateReleaseBanner(); toast('Returned to In Progress — the comment is on the record.');
track('qa_rejected');
}
// D4: the banner's primary action for an Urgent package blocked by constraints.
// It runs the SAME audited path the status control runs - one override, one log.
async function urgentOverrideRelease(){
const r=readiness();
const open=pkgConstraints.filter(c=>c.status==='open').map(c=>c.name);
if(!open.length && !r.blocking.length){ updateReleaseBanner(); return; }
if(!(await confirmEarlyRelease(r.blocking, open))) return;
setRadio('status','Issued'); prevStatus='Issued';
updateReleaseBanner(); track('status_change',{status:'Issued', via:'urgent_override'});
}
async function onStatusChange(target){
const idx=STATUS_ORDER.indexOf(target);
const r=readiness();
// Constraints are a hard gate for Normal and High: nothing releases with one
// open. For an URGENT package the gate is refusable through the audited
// override (D4) - the same confirmEarlyRelease() path, never a silent bypass.
if(idx>=ISSUED_IDX && r.open>0){
const open=pkgConstraints.filter(c=>c.status==='open').map(c=>c.name);
if(wpPriorityOf({priority: gv('wp_priority')})==='Urgent'){
if(!(await confirmEarlyRelease(r.blocking, open))){
setRadio('status', prevStatus||'Scheduled'); updateReleaseBanner(); return;
}
} else {
toast('Cannot move to "'+target+'" — '+open.length+' constraint'+(open.length===1?' is':'s are')+' still open. Clear or mark N/A first.', 'alert');
gotoSection('constraint-card');
setRadio('status', prevStatus||'Scheduled'); updateReleaseBanner(); return;
}
}
// Predecessors are a gate you can refuse: planners genuinely need to release
// ahead of upstream work closing out. Refusing it requires a reason, which is
// stored on the package and written to the audit log by the server.
if(idx>=ISSUED_IDX && r.blocking.length && !pkgGateOverride){
if(!(await confirmEarlyRelease(r.blocking))){
setRadio('status', prevStatus||'Scheduled'); updateReleaseBanner(); return;
}
}
if(target==='Issue'){ openHoldModal(); return; } // modal commits or reverts
prevStatus=target; updateReleaseBanner(); track('status_change',{status:target});
}
// ── HOLD LOG MODAL (comments 7) ──────────────────────────────────────────────
let holdPhotoData='', holdContext=null;
function openHoldModal(preselect, fromConstraint){
holdPhotoData=''; if(!fromConstraint) holdContext=null;
const sel=document.getElementById('hold-constraint');
sel.innerHTML = pkgConstraints.map(c=>``).join('') + '';
const existing = fromConstraint ? (pkgConstraints.find(c=>c.name===preselect)||{}).comment||'' : '';
document.getElementById('hold-details').value=existing;
document.getElementById('hold-doclink').value='';
document.getElementById('hold-photo-preview').innerHTML='';
document.getElementById('hold-modal').classList.add('open');
}
function holdPhotoChange(ev){
const f=ev.target.files&&ev.target.files[0]; if(!f) return;
const r=new FileReader(); r.onload=()=>{ holdPhotoData=r.result; const ok=/^data:image\//.test(holdPhotoData); document.getElementById('hold-photo-preview').innerHTML= ok?`${esc(pkg.number||'(no number)')} — Work Package
${esc(pkg.project)} · ${kindLbl} · TYPE: ${esc(pkg.type).toUpperCase()} · STATUS: ${esc(pkg.status).toUpperCase()} · ${readyTxt}
`;
const costDesc = (COST_CODES.find(c=>c.split('|')[0]===pkg.cost)||'').split('|')[1];
// Project system links travel with the WP; fall back to the live SOP for older packages.
const plinks = (pkg.projectLinks&&pkg.projectLinks.length) ? pkg.projectLinks : ((SOP&&SOP.projectLinks)||[]);
// Each entry is [section id, title, body]. `null` bodies are skipped, which is
// how a section that simply has no content behaves — different from a section
// this project does not use, which never reaches the list at all.
const blocks = [];
const add = (id, title, body) => { if(body != null && sectionOn(id)) blocks.push([title, body]); };
add('general', 'General Information', `| WP Number | ${cell(pkg.number)} |
|---|---|
| Subject | ${cell(pkg.subject)} |
| Type | ${cell(pkg.type)} |
| Discipline(s) | ${esc(pkg.disciplines.join(', '))}${pkg.split?' [MASTER — split into instances]':''}${pkg.instanceOf?` [instance of ${esc(pkg.parentNumber||'')}]`:''} |
| System / Facility Code / UPN | ${cell(pkg.system)} |
| Location | ${cell(wpLocationText(pkg))} |
| Cost Code | ${pkg.cost?esc(pkg.cost)+(costDesc?' — '+esc(costDesc):''):ns()} |
| Acumatica Task | ${cell(pkg.wbs)} |
| Assignees | ${cell(pkg.assignees)} |
| Distribution | ${cell(pkg.distribution)} |
| Priority | ${esc(wpPriorityOf(pkg))} |
| Due Date | ${cell(pkg.due)}${pkg.p6Id?` · P6 activity ${esc(pkg.p6Id)}`:''} |
| P6 Activity | ${pkg.p6Id?esc(pkg.p6Id)+(pkg.p6Desc?' — '+esc(pkg.p6Desc):''):ns()} |
| Specification Section | ${cell(pkg.spec)} |
| Description | ${cell(pkg.desc)} |
| Project Systems | ${plinks.map(l=>esc(l.label)+': '+linkify(l.url)).join(' ')} |
| Enabled by (BIM) | ${/^https?:\/\//i.test(pkg.bimlink)?linkify(pkg.bimlink):cell(pkg.bimlink)} |
| BIM / Model | ${[pkg.modelArea?'Area: '+esc(pkg.modelArea):'', pkg.clash?'Coordination: '+esc(pkg.clash):'', pkg.iff?'IFF #: '+esc(pkg.iff):'', pkg.scanLink?'Scan: '+linkify(pkg.scanLink):'', pkg.lod?'LOD: '+esc(pkg.lod)+' (legacy)':''].filter(Boolean).join(' ')} |
| Asset Tag / ID | Description | controls.dev Link |
|---|---|---|
| ${cell(a.tag)} | ${cell(a.desc)} | ${a.link?linkify(a.link):ns()} |
${esc(d)}${dst}`+
(arr.length?'
`;
}).join('');
} else {
const stepsArr = pkg.workSteps && pkg.workSteps.length ? pkg.workSteps : (pkg.work?String(pkg.work).split('\n').filter(Boolean):[]);
scopeHtml = stepsArr.length ? '- '+arr.map(s=>`
- ${esc(s)} `).join('')+'
- '+stepsArr.map(s=>`
- ${esc(s)} `).join('')+'
| Description of Work | ${scopeHtml} |
|---|---|
| Labor Est. Hrs. | ${cell(pkg.hours)} |
| Predecessor packages | ${
(pkg.predecessors && pkg.predecessors.length)
? pkg.predecessors.map(id=>{ const q=wpById(id); return q ? (esc(q.number||id)+' — '+esc(q.status)) : esc(id)+' (deleted)'; }).join(' ') : 'None' } |
| Sequence phase | ${pkg.seq?esc(pkg.seq):ns()} |
| Released early | Predecessor gate overridden. ${esc(pkg.gateOverride.reason||'')} ${esc(pkg.gateOverride.by||'')} · ${esc(pkg.gateOverride.at?wpFormatDateTime(pkg.gateOverride.at):'')} |
| Qty | Unit | Description | ${showDisc?'Discipline | ':''}
|---|---|---|---|
| ${cell(m.qty)} | ${cell(m.unit)} | ${cell(m.desc)} | ${showDisc?`${cell(m.discipline)} | `:''}
| Document | Rev | Link / Note / Focus area |
|---|---|---|
| ${cell(a.doc)} | ${cell(a.rev)} | ${a.link?linkify(a.link):ns()} |
| ${esc(f.name||'drawing')} [uploaded, ${wpFileSize(f.size||0)}] | ${ns()} | ${cell(f.description)} |
| Kitting Status | ${cell(pkg.kitStatus)} |
|---|---|
| Warehouse Owner | ${cell(pkg.kitOwner)} |
| Kitting Need Date | ${cell(pkg.kitDate)} |
| MIMO Sch. Time / Location | ${cell(pkg.mimoTime)} ${pkg.mimoLoc?'· '+esc(pkg.mimoLoc):''} |
| Constraint | Status | Comment |
|---|---|---|
| ${esc(c.name)} | ${lbl} | ${cell(c.comment)} |
| QC | ${cell(pkg.qc)}${pkg.overrides&&pkg.overrides.wp_qc?` (overridden: ${esc(pkg.overrides.wp_qc)})`:(pkg.qcFromSOP?' [from SOP]':'')} |
|---|---|
| Photo Documentation | ${cell(pkg.photo)}${pkg.overrides&&pkg.overrides.wp_photo?` (overridden: ${esc(pkg.overrides.wp_photo)})`:(pkg.photoFromSOP?' [from SOP]':'')} |
| Witness / Hold Points | ${cell(pkg.hold)} |
| Logged | By | Constraint | Details | Support |
|---|---|---|---|---|
| ${esc(when)} | ${cell(hd.by)} | ${cell(hd.constraint)} | ${cell(hd.details)} | ${sup} |
| Role | Name | Date | Signed |
|---|---|---|---|
| ${esc(s.role)} | ${cell(s.name)} | ${cell(s.date)} | ${s.signed?'✓':'—'} |
| Actual Hrs. | ${cell(pkg.actualHrs)} |
|---|---|
| Installed Quantity | ${cell(pkg.installedQty)} |
| Redlines / As-Built | ${cell(pkg.redlines)} |
| Lessons Learned | ${cell(pkg.lessons)} |
${i+1}.0 ${esc(title)}
${body}`).join(''); h+=`Pushed to: ${cell(pkg.track)}
`; document.getElementById('pkg-doc').innerHTML=h; showOutput(); } function printPackage(){ const c=document.getElementById('pkg-doc').innerHTML; const w=window.open('','_blank'); w.document.write(``, so it was mouse-only
// Every control here is a real button. The rail is built FROM THE CARDS, so a
// section added later, or suppressed by a CR-006 toggle, changes the rail without
// anyone remembering to maintain a second list.
const SEC_EXPAND_KEY = 'wp_iwp_expand_all';
let secExpandAll = false;
let secCurrent = '';
let _secSpyBound = false;
// The cards that are sections: rendered, and carrying a heading to name them.
// `hidden` and `display:none` are how CR-006 and applyKindVisibility() suppress
// one, and a table of contents has to lose exactly what the form lost.
function secCards(){
return [...document.querySelectorAll('.main > .card')].filter(card => {
// `Saved work packages` is a list of OTHER packages, sitting at the bottom of
// the form for editing THIS one - and the navigator panel already lists exactly
// the same thing. It is not a section of the package, so it gets no rail entry.
// It is still collapsed by default (secApplyOpenState), because 310px of a
// duplicate list is not what the page should open on.
if(card.id === 'saved-card') return false;
if(card.hidden || card.style.display === 'none') return false;
return !!card.querySelector('.section-title, .sub-heading');
});
}
function secLabel(card){
const h = card.querySelector('.section-title, .sub-heading');
if(!h) return '';
const clone = h.cloneNode(true);
clone.querySelectorAll('.help-tip, .auto-tag, .collapse-chev').forEach(x => x.remove());
return clone.textContent.trim().replace(/\s+/g, ' ');
}
// Everything below the heading, wrapped once so `aria-controls` has a real target
// and collapsing is `hidden` on one element rather than a `:not()` rule listing
// the heading classes. The old CSS did the latter, which meant the disclosure
// state lived nowhere a screen reader could read it.
function secBody(card){
let body = card.querySelector(':scope > .card-body');
if(body) return body;
const head = card.querySelector(':scope > .section-header, :scope > .sub-heading');
if(!head) return null;
body = document.createElement('div');
body.className = 'card-body';
body.id = (card.id || 'sec') + '-body';
const rest = [];
for(let n = head.nextSibling; n; n = n.nextSibling) rest.push(n);
rest.forEach(n => body.appendChild(n));
card.appendChild(body);
return body;
}
// Turn the heading into a disclosure button, in place and once. The label goes
// inside the button; the help tip and the description stay OUTSIDE it, because a
// tooltip trigger nested in a button is two controls in one hit area.
function secMakeToggle(card){
if(card.dataset.secReady) return;
const body = secBody(card);
if(!body) return;
const title = card.querySelector(':scope > .section-header > .section-title')
|| card.querySelector(':scope > .sub-heading');
if(!title) return;
const label = secLabel(card);
// Every ELEMENT in the heading has to survive, not only the text. `saved-card`'s
// heading carries , which renderSavedList() writes to on
// every save - clearing the heading destroyed it, renderSavedList() then threw on
// a null, and boot stopped one line short of setting wpCreatorReady. The page
// still rendered, so it looked like a slow load rather than a crash.
//
// Help tips go OUTSIDE the button: a tooltip trigger nested inside a button is
// two controls sharing one hit area. Everything else goes inside, because it is
// part of the heading's own text - a count, a badge, a tag.
const kids = [...title.children];
const tips = kids.filter(el => el.classList.contains('help-tip'));
const inside = kids.filter(el => !el.classList.contains('help-tip'));
const btn = document.createElement('button');
btn.type = 'button';
btn.className = 'card-toggle';
btn.setAttribute('aria-expanded', 'true');
btn.setAttribute('aria-controls', body.id);
btn.innerHTML = ''
+ '';
const labelEl = btn.querySelector('.card-toggle-label');
labelEl.textContent = label;
inside.forEach(el => labelEl.appendChild(el));
title.textContent = '';
title.appendChild(btn);
tips.forEach(t => title.appendChild(t));
btn.addEventListener('click', () => {
const open = card.classList.contains('collapsed');
secSetOpen(card, open);
// Opening a section by its own header makes it the one you are in, which the
// rail has to agree with - otherwise the rail marks a section you left.
if(open){ secCurrent = card.id; secMarkRail(); secSyncUrl(); }
});
card.dataset.secReady = '1';
}
function secSetOpen(card, open){
const btn = card.querySelector(':scope .card-toggle');
const body = card.querySelector(':scope > .card-body');
card.classList.toggle('collapsed', !open);
if(btn) btn.setAttribute('aria-expanded', open ? 'true' : 'false');
if(body) body.hidden = !open;
}
function secIsOpen(card){ return !card.classList.contains('collapsed'); }
// ── the rail ─────────────────────────────────────────────────────────────────
function buildSectionRail(){
const rail = document.getElementById('section-rail');
const list = document.getElementById('sec-rail-list');
if(!rail || !list) return;
let cards = secCards();
// Every section carries a real id in the markup. A positional fallback was here
// and it was a bug waiting to be shipped: the id it invents goes into ?section=
// as a shareable address, and the INDEX moves whenever the set of visible
// sections changes - a CR-006 toggle, the BIM flag, or a card being inserted
// ahead of it. A link somebody sent then opens a different section, silently and
// with no error. Name the card in the markup instead; complain loudly if not.
cards.forEach(card => {
if(!card.id){
// Not a toast: this is a defect in the page, not something a user can act on.
try { console.error('T7.2: a form section has no id; its rail entry cannot be'
+ ' addressed. Give it one in wp-creation-index.html.', card); } catch(e){}
return;
}
secMakeToggle(card);
});
cards = cards.filter(c => c.id);
list.innerHTML = cards.map(card =>
'').join('');
list.querySelectorAll('.sec-rail-item').forEach(b => {
b.addEventListener('click', () => gotoSection(b.dataset.sec));
});
rail.hidden = cards.length < 2;
// Whatever the URL asks for, else the first section. Never "all of them", which
// is the state F6 is about.
const want = (typeof WPUrl !== 'undefined' && WPUrl.get && WPUrl.get('section')) || '';
const target = cards.some(c => c.id === want) ? want : (cards[0] && cards[0].id) || '';
secApplyOpenState(target);
updateConstraintBadge();
secBindSpy();
}
// One section open, or all of them. Called on every render, so it is also what
// keeps a suppressed section from being left expanded behind the scenes.
function secApplyOpenState(currentId){
const cards = secCards();
secCurrent = currentId || secCurrent || (cards[0] && cards[0].id) || '';
cards.forEach(card => secSetOpen(card, secExpandAll || card.id === secCurrent));
// The saved-package list is not in `cards` - it is not a section - but it is on
// the page and it is 310px tall, so it collapses like everything else. It gets
// its disclosure button here because the rail loop no longer reaches it.
const saved = document.getElementById('saved-card');
if(saved && saved.style.display !== 'none'){
secMakeToggle(saved);
secSetOpen(saved, secExpandAll);
}
secMarkRail();
}
function secMarkRail(){
document.querySelectorAll('.sec-rail-item').forEach(b => {
const on = b.dataset.sec === secCurrent;
b.classList.toggle('is-current', on);
// aria-current="true", not "page": these are places in a page, not pages.
if(on) b.setAttribute('aria-current', 'true');
else b.removeAttribute('aria-current');
});
}
function secSyncUrl(opts){
if(typeof WPUrl === 'undefined') return;
const patch = { section: secCurrent || '' };
(opts && opts.replace ? WPUrl.replace : WPUrl.push).call(WPUrl, patch);
}
// Open a section and go to it. Focus moves to the section's own heading button,
// not just the scroll position: a keyboard user who activates a rail item has to
// land somewhere, and landing nowhere is why jump links are not navigation.
function gotoSection(id, opts){
const card = document.getElementById(id);
if(!card) return false;
// Moving section is a "you have visibly moved on" moment, so flush the draft
// rather than wait out the debounce. This was bound to the old jump chips at
// initAutosave() time, which only worked because the chips were built before it
// ran; it belongs here, where every section change goes through one door -
// rail click, keyboard, deep link and Back alike.
if(typeof WPAutosave !== 'undefined' && WPAutosave.flush) WPAutosave.flush('section');
secApplyOpenState(id);
const btn = card.querySelector('.card-toggle');
if(btn){
btn.focus({preventScroll:true});
card.scrollIntoView({behavior:'smooth', block:'start'});
}
if(!(opts && opts.fromUrl)) secSyncUrl();
return true;
}
function toggleExpandAll(){
setExpandAll(!secExpandAll);
}
function setExpandAll(on){
secExpandAll = !!on;
try { localStorage.setItem(SEC_EXPAND_KEY, secExpandAll ? '1' : '0'); } catch(e){}
const btn = document.getElementById('sec-expand-all');
if(btn){
btn.setAttribute('aria-pressed', secExpandAll ? 'true' : 'false');
btn.textContent = secExpandAll ? 'Collapse all' : 'Expand all';
}
secApplyOpenState(secCurrent);
track(secExpandAll ? 'sections_expand_all' : 'sections_collapse_all');
}
// With one section open the current one is whatever you opened. With Expand all
// on, that answer is wrong the moment you scroll, so the rail follows the form.
function secBindSpy(){
if(_secSpyBound) return;
_secSpyBound = true;
window.addEventListener('scroll', () => {
if(!secExpandAll) return;
const rail = document.getElementById('section-rail');
if(!rail || rail.hidden) return;
const line = (document.querySelector('.header') || {offsetHeight:0}).offsetHeight + 80;
let seen = '';
secCards().forEach(card => {
if(card.getBoundingClientRect().top <= line) seen = card.id;
});
if(seen && seen !== secCurrent){ secCurrent = seen; secMarkRail(); }
}, {passive:true});
}
// The drawer and the comments panel hang below the page chrome, and the chrome is
// taller since T7.1 - app bar, tab strip, toolbar. Measure it rather than assume.
function positionSectionNav(){
const parts = ['.header', '.main-nav', '.wp-toolbar']
.map(sel => document.querySelector(sel))
.filter(Boolean);
const h = parts.reduce((n, el) => n + el.offsetHeight, 0);
document.documentElement.style.setProperty('--rail-top', h + 'px');
const rail = document.getElementById('section-rail');
if(rail) rail.style.setProperty('--sec-rail-top', h + 'px');
}
let _secChromeBound = false;
function initSectionNavAutoHide(){
positionSectionNav();
if(_secChromeBound) return;
_secChromeBound = true;
window.addEventListener('resize', positionSectionNav, {passive:true});
try { setExpandAll(localStorage.getItem(SEC_EXPAND_KEY) === '1'); } catch(e){}
}
// A2: the count badge on the Constraints rail entry. The rail is sticky at every
// width, so this is the thing a user can see from ANY section - the top banner
// is the warning, this is the pointer to it. It replaced updateStickyStatus(),
// which wrote the same warning a second time into the sticky save bar - and
// destroyed the B5 autosave indicator mounted in the same span every time it did.
function updateConstraintBadge(){
const btn=document.querySelector('.sec-rail-item[data-sec="constraint-card"]');
if(!btn) return;
let badge=btn.querySelector('.sec-badge');
if(!badge){
badge=document.createElement('span');
badge.className='sec-badge';
btn.appendChild(badge);
}
const open=readiness().open;
badge.hidden = open===0;
badge.textContent = open || '';
btn.setAttribute('aria-label', 'Constraints'+(open?` — ${open} open`:''));
}
// ── LOCATION (CR-004 / T6.3) ─────────────────────────────────────────────────
// Three dependent dropdowns off the project's own taxonomy (CR-005 / T5.4). The
// values stored are PATHS — 'B-ONE/L1/S-A' — not display strings, because CR-018
// rolls cost up by them and a rollup keyed on a label breaks the day somebody
// fixes a typo in it. A floor's own code is not unique across buildings; its path
// is.
//
// Loaded with include_inactive=true, which is not a contradiction of CR-005's
// "deactivating hides it from new work packages". Two different questions:
//
// what may be CHOSEN active only — the option lists below filter on it
// what may be SHOWN everything, because a package already referencing a
// deactivated value still has to render its label
//
// Nothing here reads localStorage. X5 is explicit: the option lists cannot come
// from the browser's own copy.
let wpLocations = [];
let wpLocationsLoaded = false;
const LOC_LEVELS = ['building', 'floor', 'sector'];
const LOC_FIELD = {building: 'wp_building', floor: 'wp_floor', sector: 'wp_sector'};
function locNode(path){
return wpLocations.find(n => n.path === path) || null;
}
function locLabel(path){
const n = locNode(path);
return n ? n.name : (path || '');
}
// The label as it should READ on a package — a value that has since been
// deactivated says so, rather than looking like any other choice.
function locLabelFull(path){
const n = locNode(path);
if(!n) return path || '';
return n.active ? n.name : n.name + ' (no longer offered)';
}
async function loadLocations(){
if(!activeProjectId){ wpLocations = []; wpLocationsLoaded = true; buildLocationPickers(); return; }
try {
const r = await fetch('/api/projects/' + encodeURIComponent(activeProjectId)
+ '/locations?include_inactive=true',
{credentials:'same-origin', headers:{'Accept':'application/json'}});
if(!r.ok) throw new Error('HTTP ' + r.status);
const data = await r.json();
wpLocations = data.nodes || [];
} catch(e){
// No cache fallback, deliberately: an option list remembered from last time
// can offer a value this project no longer has, and B4's whole objection is
// to a per-browser answer that looks authoritative.
wpLocations = [];
}
wpLocationsLoaded = true;
buildLocationPickers();
}
/* Fill one level's