spec-up-t 1.3.0-beta → 1.3.0

package/assets/compiled/body.js

@@ -109,7 +109,7 @@ function showModal(e){const n=document.createElement("div");n.className="spec-up
 function tokenInput(){document.querySelector(".button-token-input").addEventListener("click",(()=>{const t=prompt("Please enter your GitHub token:");t?(localStorage.setItem("githubToken",t),console.log("GitHub token is set.")):alert("GitHub token is not set.")}))}document.addEventListener("DOMContentLoaded",(function(){tokenInput()}));
 function pdfDownload(){fetch("./index.pdf",{method:"HEAD"}).then((e=>{if(e.ok){let e=document.createElement("a");e.classList.add("button-pdf-download"),e.classList.add("btn","d-block","btn-sm","btn-outline-secondary"),e.target="_blank",e.rel="noopener noreferrer",e.href="./index.pdf",e.title="Download this page as a PDF",e.innerHTML='\n               <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.5" class="me-1" viewBox="0 0 16 16">\n                  <path d="M4 0a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V4.5L9.5 0H4zm0 1h5v4h4v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1zm7 4h-1V2l3 3h-2z"/>\n                  <path d="M6.5 10.5a.5.5 0 0 1-.5-.5V7.5a.5.5 0 0 1 .5-.5H8a.5.5 0 0 1 .5.5V10a.5.5 0 0 1-.5.5H6.5z"/>\n               </svg>\n            ',e.style.display="inline-flex",e.style.alignItems="center",e.style.justifyContent="center",document.querySelector(".service-menu").prepend(e)}else console.log("PDF file does not exist. No PDF download button will be added.")})).catch((e=>{console.error("Error checking PDF file:",e)}))}document.addEventListener("DOMContentLoaded",(function(){pdfDownload()}));
 function insertTrefs(e){!function(e){const n=[];document.querySelectorAll("dl.terms-and-definitions-list dt span.transcluded-xref-term").forEach((e=>{const t=e.textContent.trim(),r=e.closest("dt");if(r){const e=r.nextElementSibling;if(e?.classList.contains("transcluded-xref-term")&&e.classList.contains("meta-info-content-wrapper"))return}n.push({element:e,textContent:t,dt:r,parent:r?.parentNode})}));const t=n.map((n=>{const{textContent:t,dt:r,parent:d}=n;if(!r||!d)return null;const o=e.xtrefs.find((e=>e.term===t)),s=document.createDocumentFragment(),i=document.createElement("dd");if(i.classList.add("transcluded-xref-term","meta-info-content-wrapper","collapsed"),o){const e=`\n| Property | Value |\n| -------- | ----- |\n| Owner | ${o.avatarUrl?`![avatar](${o.avatarUrl})`:""} ${o.owner||"Unknown"} |\n| Repo | ${o.repo&&o.repoUrl?`[${o.repo}](${o.repoUrl})`:"Unknown"} |\n| Commit hash | ${o.commitHash||"Unknown"} |\n            `;i.innerHTML=md.render(e),s.appendChild(i);let n=o.content.split("\n").map((e=>e.replace(/^\s*~\s*/,""))).join("\n").replace(/\]\]/g,"");const t=document.createElement("div");t.innerHTML=md.render(n),t.querySelectorAll("a").forEach((e=>e.replaceWith(...e.childNodes))),n=t.innerHTML;const r=document.createElement("div");r.innerHTML=md.render(n);const d=r.querySelectorAll("dd");if(d.length>0)Array.from(d).forEach((e=>{const n=e.cloneNode(!0);n.classList.add("transcluded-xref-term","transcluded-xref-term-embedded"),s.appendChild(n)}));else{const e=document.createElement("dd");e.classList.add("transcluded-xref-term","transcluded-xref-term-embedded"),e.innerHTML=r.innerHTML,s.appendChild(e)}}else{i.innerHTML=md.render("\n| Property | Value |\n| -------- | ----- |\n| Owner | Unknown |\n| Repo | Unknown |\n| Commit hash | not found |\n            "),s.appendChild(i);const e=document.createElement("dd");e.innerHTML="<p>This term was not found in the external repository.</p>",s.appendChild(e)}return{dt:r,parent:d,fragment:s}})).filter(Boolean);requestAnimationFrame((()=>{t.forEach((e=>{const{dt:n,parent:t,fragment:r}=e;t.insertBefore(r,n.nextSibling)})),document.dispatchEvent(new CustomEvent("trefs-inserted",{detail:{count:t.length}}))}))}(e)}function initializeOnTrefsInserted(e){let n=!1;document.addEventListener("trefs-inserted",(function(t){n||(n=!0,e(),t.detail&&console.log(`Collapsible definitions initialized after ${t.detail.count} xrefs were inserted`))})),setTimeout((()=>{n||(console.warn("trefs-inserted event was not received, initializing collapsible definitions anyway"),e(),n=!0)}),1e3)}document.addEventListener("DOMContentLoaded",(()=>{"undefined"!=typeof allXTrefs&&allXTrefs?.xtrefs?insertTrefs(allXTrefs):(console.error("allXTrefs is undefined or missing xtrefs property"),document.dispatchEvent(new CustomEvent("trefs-inserted",{detail:{count:0,error:"Missing xtrefs data"}})))}));
-function collapseDefinitions(){let{dds:t,dts:e,regularDds:s,specialDds:a}=function(){const t=document.querySelectorAll("#content dl.terms-and-definitions-list > dd");return{dds:t,dts:document.querySelectorAll("#content dl.terms-and-definitions-list > dt"),regularDds:Array.from(t).filter((t=>!i(t.textContent.trim()))),specialDds:Array.from(t).filter((t=>i(t.textContent.trim())))}}();function i(t){return["Source","See also","More in","Also see","See:","See also","See more","See more in","See more about","See more on","See more at","More:","Supporting definitions:"].some((e=>t.startsWith(e)))}a.forEach((t=>{t.classList.add("terms-def-extra-info")})),e.forEach((t=>{if(t.querySelector(".collapse-all-defs-button"))return;const e=document.createElement("button");e.classList.add("collapse-all-defs-button","btn-outline-secondary","d-print-none","btn","p-0","fs-5","d-flex","align-items-center","justify-content-center"),e.innerHTML='<span class="state-indicator" data-state="0">①</span><span class="state-indicator" data-state="1">②</span><span class="state-indicator" data-state="2">③</span>',e.setAttribute("id","toggleButton"),e.setAttribute("title","Change how much info is shown"),e.setAttribute("data-state","2"),e.querySelector('.state-indicator[data-state="2"]').classList.add("active"),t.appendChild(e)})),document.addEventListener("click",(e=>{if(e.target.classList.contains("collapse-all-defs-button")||e.target.classList.contains("state-indicator")){const i=e.target.classList.contains("collapse-all-defs-button")?e.target:e.target.closest(".collapse-all-defs-button"),n=(i.closest("dt"),i.getBoundingClientRect());document.documentElement.classList.add("definitions-transitioning"),i.style.position="fixed",i.style.top=`${n.top}px`,i.style.right=window.innerWidth-n.right+"px",i.style.zIndex="1000",function(){const e=document.querySelectorAll(".collapse-all-defs-button");switch((parseInt(e[0].dataset.state||0)+1)%3){case 0:t.forEach((t=>{t.classList.add("hidden"),t.classList.remove("visible")})),e.forEach((t=>{t.dataset.state=0,t.title="Show basic definitions",t.querySelectorAll(".state-indicator").forEach((t=>{0===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.add("defs-hidden");break;case 1:s.forEach((t=>{t.classList.remove("hidden"),t.classList.add("visible")})),a.forEach((t=>{t.classList.add("hidden"),t.classList.remove("visible")})),e.forEach((t=>{t.dataset.state=1,t.title="Show all definitions",t.querySelectorAll(".state-indicator").forEach((t=>{1===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.remove("defs-hidden");break;case 2:t.forEach((t=>{t.classList.remove("hidden"),t.classList.add("visible")})),a.forEach((t=>{t.classList.add("terms-def-extra-info")})),e.forEach((t=>{t.dataset.state=2,t.title="Hide all definitions",t.querySelectorAll(".state-indicator").forEach((t=>{2===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.remove("defs-hidden")}}(),requestAnimationFrame((()=>{i.style.position="",i.style.top="",i.style.right="",i.style.zIndex="",document.documentElement.classList.remove("definitions-transitioning");const t=i.getBoundingClientRect();window.scrollTo({top:window.scrollY+(t.top-n.top),behavior:"instant"})}))}}))}document.addEventListener("DOMContentLoaded",(function(){initializeOnTrefsInserted(collapseDefinitions)}));
+function collapseDefinitions(){let{dds:t,dts:e,regularDds:s,specialDds:a}=function(){const t=document.querySelectorAll("#content dl.terms-and-definitions-list > dd");return{dds:t,dts:document.querySelectorAll("#content dl.terms-and-definitions-list > dt"),regularDds:Array.from(t).filter((t=>!i(t.textContent.trim()))),specialDds:Array.from(t).filter((t=>i(t.textContent.trim())))}}();function i(t){return["Source","See also","More in","Also see","See:","See also","See more","See more in","See more about","See more on","See more at","More:","Supporting definitions:"].some((e=>t.startsWith(e)))}a.forEach((t=>{t.classList.add("terms-def-extra-info")})),e.forEach((t=>{if(t.querySelector(".collapse-all-defs-button"))return;const e=document.createElement("button");e.classList.add("collapse-all-defs-button","btn-outline-secondary","d-print-none","btn","p-0","fs-5","d-flex","align-items-center","justify-content-center"),e.innerHTML='<span class="state-indicator" data-state="0">①</span><span class="state-indicator" data-state="1">②</span><span class="state-indicator" data-state="2">③</span>',e.setAttribute("id","toggleButton"),e.setAttribute("title","Change how much info is shown"),e.setAttribute("data-state","2"),e.querySelector('.state-indicator[data-state="2"]').classList.add("active"),t.appendChild(e)})),document.addEventListener("click",(e=>{if(e.target.classList.contains("collapse-all-defs-button")||e.target.classList.contains("state-indicator")){const i=e.target.classList.contains("collapse-all-defs-button")?e.target:e.target.closest(".collapse-all-defs-button"),n=i.getBoundingClientRect();document.documentElement.classList.add("definitions-transitioning"),i.style.position="fixed",i.style.top=`${n.top}px`,i.style.right=window.innerWidth-n.right+"px",i.style.zIndex="1000",function(){const e=document.querySelectorAll(".collapse-all-defs-button");switch((parseInt(e[0].dataset.state||0)+1)%3){case 0:t.forEach((t=>{t.classList.add("hidden"),t.classList.remove("visible")})),e.forEach((t=>{t.dataset.state=0,t.title="Show basic definitions",t.querySelectorAll(".state-indicator").forEach((t=>{0===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.add("defs-hidden");break;case 1:s.forEach((t=>{t.classList.remove("hidden"),t.classList.add("visible")})),a.forEach((t=>{t.classList.add("hidden"),t.classList.remove("visible")})),e.forEach((t=>{t.dataset.state=1,t.title="Show all definitions",t.querySelectorAll(".state-indicator").forEach((t=>{1===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.remove("defs-hidden");break;case 2:t.forEach((t=>{t.classList.remove("hidden"),t.classList.add("visible")})),a.forEach((t=>{t.classList.add("terms-def-extra-info")})),e.forEach((t=>{t.dataset.state=2,t.title="Hide all definitions",t.querySelectorAll(".state-indicator").forEach((t=>{2===parseInt(t.dataset.state)?t.classList.add("active"):t.classList.remove("active")}))})),document.querySelector("html").classList.remove("defs-hidden")}}(),requestAnimationFrame((()=>{i.style.position="",i.style.top="",i.style.right="",i.style.zIndex="",document.documentElement.classList.remove("definitions-transitioning");const t=i.getBoundingClientRect();window.scrollTo({top:window.scrollY+(t.top-n.top),behavior:"instant"})}))}}))}document.addEventListener("DOMContentLoaded",(function(){initializeOnTrefsInserted(collapseDefinitions)}));
 function createTermFilter(){const e=document.querySelector(".terms-and-definitions-list");if(0===(e?e.querySelectorAll("dt"):[]).length)return;const c=document.getElementById("terminology-section-utility-container"),t=document.createElement("div");t.className="d-flex mt-0";const n=document.createElement("div");n.className="form-check me-3",n.innerHTML='\n        <input class="form-check-input" type="checkbox" id="showLocalTermsCheckbox" checked>\n        <label class="form-check-label" for="showLocalTermsCheckbox">\n            Show local terms\n        </label>\n    ';const o=document.createElement("div");o.className="form-check ms-3",o.innerHTML='\n        <input class="form-check-input" type="checkbox" id="showExternalTermsCheckbox" checked>\n        <label class="form-check-label" for="showExternalTermsCheckbox">\n            Show external terms\n        </label>\n    ',t.appendChild(n),t.appendChild(o),t.addEventListener("change",(function(e){e.target.matches('input[type="checkbox"]')&&function(e){const c=t.querySelectorAll('input[type="checkbox"]'),n=Array.from(c).filter((e=>e.checked));e.target.checked||0===n.length&&c.forEach((c=>{c!==e.target&&(c.checked=!0)})),c.forEach((e=>{const c=document.querySelector("html");"showLocalTermsCheckbox"===e.id?c.classList.toggle("hide-local-terms",!e.checked):"showExternalTermsCheckbox"===e.id&&c.classList.toggle("hide-external-terms",!e.checked)}))}(e)})),c.appendChild(t)}document.addEventListener("DOMContentLoaded",(function(){createTermFilter()}));
 function createToggleButton(e){const t=document.createElement("button");t.classList.add("meta-info-toggle-button","btn"),t.innerHTML='<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" viewBox="0 0 16 16" style="shape-rendering: geometricPrecision;"><path fill-rule="evenodd" d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/><path d="M8.93 6.588l-2.29.287-.082.38.45.083c.294.07.352.176.288.469l-.738 3.468c-.194.897.105 1.319.808 1.319.545 0 1.178-.252 1.465-.598l.088-.416c-.2.176-.492.246-.686.246-.275 0-.375-.193-.304-.533L8.93 6.588z"/><path d="M9 4.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0z"/></svg>',t.title="Meta info",t.addEventListener("click",(function(t){t.preventDefault(),t.stopPropagation();e.classList.contains("collapsed")?(e.classList.remove("collapsed"),e.getBoundingClientRect()):e.classList.add("collapsed")}));let n=e.previousElementSibling;for(;n&&"DT"!==n.tagName;)n=n.previousElementSibling;n?n.appendChild(t):e.insertBefore(t,e.firstChild)}function collapseMetaInfo(){document.querySelectorAll("dl > dd:has(table)").forEach((function(e){e.classList.add("meta-info-content-wrapper");const t=document.createElement("div");for(t.classList.add("meta-info-inner-wrapper");e.firstChild&&e.firstChild!==e.querySelector(".meta-info-toggle-button");)t.appendChild(e.firstChild);e.querySelector(".meta-info-toggle-button")||createToggleButton(e),e.appendChild(t),e.classList.add("collapsed")}))}document.addEventListener("DOMContentLoaded",(function(){initializeOnTrefsInserted(collapseMetaInfo)}));
 function fixLastDd(){document.querySelectorAll("dl.terms-and-definitions-list").forEach((t=>{t.querySelectorAll(":scope > dd").forEach(((t,e)=>{t.classList.remove("last-dd");let s=t.nextElementSibling;s&&"DT"!==s.tagName||t.classList.contains("last-dd")||t.classList.add("last-dd")}))}))}document.addEventListener("trefs-inserted",(function(){fixLastDd()}));

package/assets/compiled/head.css

@@ -28,4 +28,5 @@ article a[href^="https://"]:not(.btn)::after,article a[href^=http]:not(.btn)::af
 #content .figure{width:100%;margin-bottom:1.5rem}#content .figure img{transition:all .3s ease}#content .figure img:hover{transform:scale(1.01);cursor:pointer}#content img.img-fluid{max-width:100%;height:auto}#content .figure-caption{margin-top:.5rem;font-style:italic;color:#6c757d}
 #content .figure:has(.scrollHintImage){padding:0;margin:0;width:auto;height:auto}
 .highlight2{padding-left:1em;padding-right:1em;border:1px dashed #71bbe6;background:#a9dde03b}
+#toc ul.toc{counter-reset:toc-section}#toc ul.toc>li{counter-reset:toc-subsection}#toc ul.toc>li>ul>li{counter-reset:toc-subsubsection}#toc ul.toc>li>a::before{counter-increment:toc-section;content:counter(toc-section) ". ";font-weight:700;margin-right:.5em}#toc ul.toc>li>ul>li>a::before{counter-increment:toc-subsection;content:counter(toc-section) "." counter(toc-subsection) " ";font-weight:700;margin-right:.5em}#toc ul.toc>li>ul>li>ul>li>a::before{counter-increment:toc-subsubsection;content:counter(toc-section) "." counter(toc-subsection) "." counter(toc-subsubsection) " ";font-weight:700;margin-right:.5em}main article{counter-reset:main-section}main article h2{counter-reset:main-subsection}main article h3{counter-reset:main-subsubsection}main article h2::before{counter-increment:main-section;content:counter(main-section) ". ";font-weight:700;margin-right:.5em;color:#007bff}main article h3::before{counter-increment:main-subsection;content:counter(main-section) "." counter(main-subsection) " ";font-weight:700;margin-right:.5em;color:#007bff}main article h4::before{counter-increment:main-subsubsection;content:counter(main-section) "." counter(main-subsection) "." counter(main-subsubsection) " ";font-weight:700;margin-right:.5em;color:#007bff}main article h5::before,main article h6::before{font-weight:700;margin-right:.5em;color:#6c757d}.toc-anchor{margin-left:.5em}@media print{#toc ul.toc>li>a::before,#toc ul.toc>li>ul>li>a::before,#toc ul.toc>li>ul>li>ul>li>a::before,main article h2::before,main article h3::before,main article h4::before{color:#000!important}}
 :target{scroll-margin-top:calc(50vh)}body:not([hashscroll]) :target{animation:highlight-target 3.5s .25s ease}body:not([hashscroll]) dt:has(:target){animation:highlight-target-parent-dt 3.5s .25s ease}dl.terms-and-definitions-list>.highlight{background-color:#ff0!important;transition:background-color .3s ease-in-out}svg[icon]{width:1.25em;height:1.25em;vertical-align:text-top}@keyframes highlight-target{50%{background-color:#ff0}}@keyframes highlight-target-parent-dt{50%{background-color:#ff0;border:1px solid #00c8ff}}#svg{display:none}main *{overflow-wrap:anywhere;word-break:normal}.table-responsive{overflow-x:auto!important;-webkit-overflow-scrolling:touch;width:100%;max-width:100%}.table-responsive *{overflow-wrap:normal!important;word-break:normal!important;white-space:nowrap!important}dd td img{max-width:30px}.notice{margin:1em 0;padding:.5em .9em .55em .65em;border-left:.5em solid}.notice p{margin:.4em 0 0}.note{background:#e9fbe9;border-color:#52e052}.note .notice-link{display:block;color:#178217}.issue{background:#e9f0fb;border-color:#527fe0}.issue .notice-link:before{display:block;color:#1e4cae}.warning{background:#fbe9e9;border-color:#e05252}.warning .notice-link{display:block;color:#ae1e1e}.example{color:#cebe00;background:#1a1e23;border-left:.5em solid}.example .notice-link{display:block;color:inherit;font-size:1.1em;font-family:Heebo,sans-serif}.example pre[class*=language-]{padding:0;border-radius:0}.todo{background:#fbe4ff;border-color:#9700e2}.todo .notice-link{display:block;color:#6d00a2}.alert-primary{background-color:#f9fcff;border-color:#b2ebf2;color:#00838f}.alert-secondary{background-color:#f5f5f5;border-color:#e0e0e0;color:#616161}.alert-success{background-color:#e8f5e9;border-color:#c8e6c9;color:#388e3c}.alert-danger{background-color:#ffebee;border-color:#ef9a9a;color:#d32f2f}.alert-warning{background-color:#fffde7;border-color:#fff9c4;color:#f9a825}.alert-info{background-color:#e1f5fe;border-color:#b3e5fc;color:#0288d1}.alert-light{background-color:#f9f9f9;border-color:#eee;color:#424242}.alert-dark{background-color:#e0e0e0;border-color:#bdbdbd;color:#212121}.alert a{color:inherit;font-weight:700}.alert-primary a{color:#006064}.alert-success a{color:#2e7d32}.alert-danger a{color:#b71c1c}.alert-warning a{color:#f57f17}.alert-info a{color:#01579b}.alert-dark a{color:#000}[data-bs-theme=dark] .alert-primary{background-color:#004d40;border-color:#00695c;color:#b2dfdb}[data-bs-theme=dark] .alert-secondary{background-color:#424242;border-color:#616161;color:#e0e0e0}[data-bs-theme=dark] .alert-success{background-color:#1b5e20;border-color:#2e7d32;color:#a5d6a7}[data-bs-theme=dark] .alert-danger{background-color:#b71c1c;border-color:#c62828;color:#ef9a9a}[data-bs-theme=dark] .alert-warning{background-color:#f57f17;border-color:#ffb300;color:#ffe082}[data-bs-theme=dark] .alert-info{background-color:#01579b;border-color:#0277bd;color:#81d4fa}[data-bs-theme=dark] .alert-light{background-color:#303030;border-color:#424242;color:#e0e0e0}[data-bs-theme=dark] .alert-dark{background-color:#212121;border-color:#424242;color:#bdbdbd}[data-bs-theme=dark] .alert a{color:inherit;font-weight:700}[data-bs-theme=dark] .alert-primary a{color:#80cbc4}[data-bs-theme=dark] .alert-success a{color:#81c784}[data-bs-theme=dark] .alert-danger a{color:#ef5350}[data-bs-theme=dark] .alert-warning a{color:#ffca28}[data-bs-theme=dark] .alert-info a{color:#4fc3f7}[data-bs-theme=dark] .alert-dark a{color:#9e9e9e}#offcanvasSettings .btn-menu-item{border-radius:unset;width:100%;text-align:left;border:1px solid #dee2e6;background-color:var(--card-bg);color:var(--card-text);padding:10px 15px;margin-bottom:5px;transition:background-color .2s ease}#offcanvasSettings .btn-menu-item:hover{background-color:#e9ecef}

package/assets/css/counter.css

@@ -0,0 +1,104 @@
+/*
+ * CSS Counters for Navigation Menu Items and Content Headings
+ * Description: Adds incremental numbering to TOC menu items and corresponding content headings
+ */
+
+/* Reset and initialize counters for the table of contents */
+#toc ul.toc {
+  counter-reset: toc-section;
+}
+
+#toc ul.toc > li {
+  counter-reset: toc-subsection;
+}
+
+#toc ul.toc > li > ul > li {
+  counter-reset: toc-subsubsection;
+}
+
+/* Add numbering to first-level TOC items (h2 equivalent) */
+#toc ul.toc > li > a::before {
+  counter-increment: toc-section;
+  content: counter(toc-section) ". ";
+  font-weight: bold;
+  margin-right: 0.5em;
+}
+
+/* Add numbering to second-level TOC items (h3 equivalent) */
+#toc ul.toc > li > ul > li > a::before {
+  counter-increment: toc-subsection;
+  content: counter(toc-section) "." counter(toc-subsection) " ";
+  font-weight: bold;
+  margin-right: 0.5em;
+}
+
+/* Add numbering to third-level TOC items (h4 equivalent) */
+#toc ul.toc > li > ul > li > ul > li > a::before {
+  counter-increment: toc-subsubsection;
+  content: counter(toc-section) "." counter(toc-subsection) "." counter(toc-subsubsection) " ";
+  font-weight: bold;
+  margin-right: 0.5em;
+}
+
+/* Initialize counters for main content headings */
+main article {
+  counter-reset: main-section;
+}
+
+main article h2 {
+  counter-reset: main-subsection;
+}
+
+main article h3 {
+  counter-reset: main-subsubsection;
+}
+
+/* Add numbering to main content headings */
+main article h2::before {
+  counter-increment: main-section;
+  content: counter(main-section) ". ";
+  font-weight: bold;
+  margin-right: 0.5em;
+  color: #007bff;
+}
+
+main article h3::before {
+  counter-increment: main-subsection;
+  content: counter(main-section) "." counter(main-subsection) " ";
+  font-weight: bold;
+  margin-right: 0.5em;
+  color: #007bff;
+}
+
+main article h4::before {
+  counter-increment: main-subsubsection;
+  content: counter(main-section) "." counter(main-subsection) "." counter(main-subsubsection) " ";
+  font-weight: bold;
+  margin-right: 0.5em;
+  color: #007bff;
+}
+
+/* Optional: Style for h5 and h6 if needed */
+main article h5::before,
+main article h6::before {
+  font-weight: bold;
+  margin-right: 0.5em;
+  color: #6c757d;
+}
+
+/* Ensure numbering doesn't interfere with existing anchor links */
+.toc-anchor {
+  margin-left: 0.5em;
+}
+
+/* Print-friendly styles */
+@media print {
+  #toc ul.toc > li > a::before,
+  #toc ul.toc > li > ul > li > a::before,
+  #toc ul.toc > li > ul > li > ul > li > a::before,
+  main article h2::before,
+  main article h3::before,
+  main article h4::before {
+    color: #000 !important;
+  }
+}

package/assets/js/collapse-definitions.js

@@ -206,9 +206,6 @@ function collapseDefinitions() {
                 event.target :
                 event.target.closest('.collapse-all-defs-button');
 
-            // Find the parent dt and dl elements
-            const dtElement = button.closest('dt');
-
             // Get button's position in viewport and page
             const buttonRect = button.getBoundingClientRect();
 

package/assets/js/custom-elements.js

@@ -7,21 +7,21 @@ customElements.define('slide-panels', class SidePanels extends HTMLElement {
   }
   constructor() {
     super();
-    
+
     this.addEventListener('pointerup', e => {
       if (e.target === this) this.close();
     })
   }
-  get active (){
+  get active() {
     return this.getAttribute('open');
   }
-  toggle(panel){
+  toggle(panel) {
     this.active === panel ? this.close() : this.open(panel)
   }
-  open (panel){
+  open(panel) {
     this.setAttribute('open', panel);
   }
-  close (){
+  close() {
     this.removeAttribute('open');
   }
 
@@ -39,12 +39,12 @@ customElements.define('detail-box', class DetailBox extends HTMLElement {
     return ['open'];
   }
   constructor() {
-    super();   
-    
+    super();
+
     this.addEventListener('pointerup', e => {
       if (e.target.hasAttribute('detail-box-toggle')) {
         e.stopPropagation();
-        this.toggle();   
+        this.toggle();
       }
     });
 
@@ -55,7 +55,7 @@ customElements.define('detail-box', class DetailBox extends HTMLElement {
       }
     });
   }
-  toggle(){
+  toggle() {
     this.toggleAttribute('open');
   }
   attributeChangedCallback(attr, last, current) {
@@ -91,24 +91,22 @@ customElements.define('tab-panels', class TabPanels extends HTMLElement {
   }
   attributeChangedCallback(attr, last, current) {
     domReady.then(() => {
-      switch(attr) {  
-        case 'selected-index':
-          let index = current || 0;
-          let nav = this.querySelector('nav');
-          if (nav.parentElement === this) {
-            let tabs = nav.children;
-            let selected = tabs[index];
-            for (let tab of tabs) tab.removeAttribute('selected');
-            if (selected) selected.setAttribute('selected', '');
-            let panel = Array.prototype.filter.call(this.children, node => {
-              if (node.tagName === 'SECTION') {
-                node.removeAttribute('selected');
-                return true;
-              }
-            })[index];
-            if (panel) panel.setAttribute('selected', '');
-          }
-          break;
+      if (attr === 'selected-index') {
+        let index = current || 0;
+        let nav = this.querySelector('nav');
+        if (nav.parentElement === this) {
+          let tabs = nav.children;
+          let selected = tabs[index];
+          for (let tab of tabs) tab.removeAttribute('selected');
+          if (selected) selected.setAttribute('selected', '');
+          let panel = Array.prototype.filter.call(this.children, node => {
+            if (node.tagName === 'SECTION') {
+              node.removeAttribute('selected');
+              return true;
+            }
+          })[index];
+          if (panel) panel.setAttribute('selected', '');
+        }
       }
     });
   }

package/assets/js/highlight-heading-plus-sibling-nodes.test.js

@@ -0,0 +1,120 @@
+/**
+ * @jest-environment jsdom
+ */
+/**
+ * @fileoverview Unit tests for highlight-heading-plus-sibling-nodes.js
+ * Covers all exported functions to satisfy SonarQube coverage requirements.
+ */
+const {
+  highlightHeadingSection,
+  getHeadingLevel,
+  collectHeadingSiblings,
+  wrapNodesWithHighlight,
+  removeExistingHighlights,
+  initializeAnchorHighlighting
+} = require('./highlight-heading-plus-sibling-nodes');
+
+describe('highlight-heading-plus-sibling-nodes', () => {
+  let container;
+
+  beforeEach(() => {
+    // Set up a DOM structure for testing
+    document.body.innerHTML = '';
+    container = document.createElement('div');
+    container.innerHTML = `
+      <h2 id="h2-1">Heading 2</h2>
+      <p id="p1">Paragraph 1</p>
+      <ul id="ul1"><li>Item</li></ul>
+      <h3 id="h3-1">Heading 3</h3>
+      <p id="p2">Paragraph 2</p>
+      <h2 id="h2-2">Heading 2b</h2>
+    `;
+    document.body.appendChild(container);
+  });
+
+  afterEach(() => {
+    document.body.innerHTML = '';
+  });
+
+  describe('getHeadingLevel', () => {
+    it('returns correct level for h2-h6', () => {
+      expect(getHeadingLevel(document.getElementById('h2-1'))).toBe(2);
+      expect(getHeadingLevel(document.getElementById('h3-1'))).toBe(3);
+    });
+    it('returns null for h1 or non-heading', () => {
+      const h1 = document.createElement('h1');
+      expect(getHeadingLevel(h1)).toBeNull();
+      expect(getHeadingLevel(document.getElementById('p1'))).toBeNull();
+    });
+  });
+
+  describe('collectHeadingSiblings', () => {
+    it('collects heading and following siblings until next heading of same or higher level', () => {
+      const h2 = document.getElementById('h2-1');
+      const siblings = collectHeadingSiblings(h2, 2);
+      expect(siblings.map(n => n.id)).toEqual(['h2-1', 'p1', 'ul1', 'h3-1', 'p2']);
+    });
+    it('stops at next heading of same or higher level', () => {
+      const h3 = document.getElementById('h3-1');
+      const siblings = collectHeadingSiblings(h3, 3);
+      expect(siblings.map(n => n.id)).toEqual(['h3-1', 'p2']);
+    });
+  });
+
+  describe('wrapNodesWithHighlight', () => {
+    it('wraps nodes in a div.highlight2', () => {
+      const nodes = [document.getElementById('h2-1'), document.getElementById('p1')];
+      const wrapper = wrapNodesWithHighlight(nodes);
+      expect(wrapper).not.toBeNull();
+      expect(wrapper.className).toBe('highlight2');
+      expect(wrapper.contains(nodes[0])).toBe(true);
+      expect(wrapper.contains(nodes[1])).toBe(true);
+    });
+    it('returns null if nodes is empty', () => {
+      expect(wrapNodesWithHighlight([])).toBeNull();
+    });
+  });
+
+  describe('removeExistingHighlights', () => {
+    it('removes all .highlight2 wrappers and restores children', () => {
+      const nodes = [document.getElementById('h2-1'), document.getElementById('p1')];
+      wrapNodesWithHighlight(nodes);
+      expect(document.querySelectorAll('.highlight2').length).toBe(1);
+      const removed = removeExistingHighlights();
+      expect(removed).toBe(1);
+      expect(document.querySelectorAll('.highlight2').length).toBe(0);
+      // Children are restored to parent
+      expect(container.contains(nodes[0])).toBe(true);
+      expect(container.contains(nodes[1])).toBe(true);
+    });
+  });
+
+  describe('highlightHeadingSection', () => {
+    it('highlights section for valid anchor', () => {
+      expect(highlightHeadingSection('#h2-1')).toBe(true);
+      const highlight = document.querySelector('.highlight2');
+      expect(highlight).not.toBeNull();
+      expect(highlight.contains(document.getElementById('h2-1'))).toBe(true);
+    });
+    it('returns false for invalid anchor', () => {
+      expect(highlightHeadingSection('#does-not-exist')).toBe(false);
+      expect(highlightHeadingSection('not-a-hash')).toBe(false);
+      expect(highlightHeadingSection('#')).toBe(false);
+    });
+    it('returns false for non-heading element', () => {
+      expect(highlightHeadingSection('#p1')).toBe(false);
+    });
+  });
+
+  describe('initializeAnchorHighlighting', () => {
+    it('sets up event listeners and highlights on hash', () => {
+      window.location.hash = '#h2-1';
+      // Remove highlights if any
+      removeExistingHighlights();
+      initializeAnchorHighlighting();
+      // Simulate hashchange
+      window.dispatchEvent(new HashChangeEvent('hashchange'));
+      expect(document.querySelector('.highlight2')).not.toBeNull();
+    });
+  });
+});

package/config/asset-map.json

@@ -27,6 +27,7 @@
       "assets/css/add-bootstrap-classes-to-images.css",
       "assets/css/horizontal-scroll-hint.css",
       "assets/css/highlight-heading-plus-sibling-nodes.css",
+      "assets/css/counter.css",
       "assets/css/index.css"
     ],
     "js": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.3.0-beta",
+  "version": "1.3.0",
   "description": "Technical specification drafting tool that generates rich specification documents from markdown. Forked from https://github.com/decentralized-identity/spec-up by Daniel Buchner (https://github.com/csuwildcat)",
   "main": "./index",
   "repository": {
@@ -68,7 +68,8 @@
     "braces": ">=3.0.3"
   },
   "devDependencies": {
-    "jest": "^29.7.0"
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^30.0.5"
   },
   "scripts": {
     "test": "jest",

package/sonar-project.properties

@@ -1,6 +1,7 @@
-sonar.projectKey=blockchainbird_spec-up-t
-sonar.organization=blockchainbird
-sonar.host.url=https://sonarcloud.io
-sonar.token=SONAR_TOKEN
-sonar.exclusions=assets/compiled/refs.json
-sonar.cpd.exclusions=**/*.test.js
+# Temporarily disabled for Automatic Analysis
+# sonar.projectKey=blockchainbird_spec-up-t
+# sonar.organization=blockchainbird
+# sonar.host.url=https://sonarcloud.io
+# sonar.token=SONAR_TOKEN
+# sonar.exclusions=assets/compiled/refs.json
+# sonar.cpd.exclusions=**/*.test.js

package/src/create-docx.js

@@ -83,7 +83,7 @@ function processNode(node, elements = []) {
                 if (li.tagName.toLowerCase() === 'li') {
                     elements.push(new Paragraph({
                         text: li.textContent.trim(),
-                        bullet: tagName === 'ul' ? { level: 0 } : { level: 0 }
+                        bullet: { level: 0 }
                     }));
                 }
             });

package/src/html-dom-processor.js

@@ -145,18 +145,18 @@ function fixDefinitionListStructure(html) {
   function collectDtDdGroup(startNode) {
     const group = [];
     let currentNode = startNode;
-    
+
     // Collect the dt and all following dd elements
     while (currentNode && (currentNode.tagName === 'DT' || currentNode.tagName === 'DD')) {
       group.push(currentNode);
       currentNode = currentNode.nextSibling;
-      
+
       // Skip text nodes (whitespace) between elements
       while (currentNode && currentNode.nodeType === 3 && !currentNode.textContent.trim()) {
         currentNode = currentNode.nextSibling;
       }
     }
-    
+
     return group;
   }
 
@@ -166,7 +166,7 @@ function fixDefinitionListStructure(html) {
     if (dt.parentElement !== mainDl) {
       // Collect the dt and its associated dd elements
       const group = collectDtDdGroup(dt);
-      
+
       // Move all elements in the group to the main dl
       group.forEach(element => {
         if (element.parentNode) {
@@ -190,15 +190,15 @@ function fixDefinitionListStructure(html) {
   // Process all subsequent content
   while (currentNode) {
     // Save the next node before potentially modifying the DOM
-    const nextNode = currentNode.nextSibling;
+    let nextNode = currentNode.nextSibling;
 
     // Handle different node types
     if (currentNode.nodeType === 1) { // 1 = Element node
       if (currentNode.tagName === 'DL') {
         // Check if this is a reference list (contains dt elements with id="ref:...")
-        const hasRefIds = currentNode.innerHTML.includes('id="ref:') || 
-                          currentNode.classList.contains('reference-list');
-        
+        const hasRefIds = currentNode.innerHTML.includes('id="ref:') ||
+          currentNode.classList.contains('reference-list');
+
         if (!hasRefIds) {
           // Only move non-reference definition lists - move all its children to the main dl
           while (currentNode.firstChild) {
@@ -212,11 +212,11 @@ function fixDefinitionListStructure(html) {
       else if (currentNode.tagName === 'DT') {
         // Check if this dt has a ref: id (spec reference)
         const hasRefId = currentNode.id?.startsWith('ref:');
-        
+
         if (!hasRefId) {
           // Collect the dt and its associated dd elements
           const group = collectDtDdGroup(currentNode);
-          
+
           // Move all elements in the group to the main dl
           group.forEach(element => {
             if (element.parentNode) {
@@ -225,7 +225,7 @@ function fixDefinitionListStructure(html) {
               element.parentNode.removeChild(element);
             }
           });
-          
+
           // Skip the nodes we just processed
           let skipNodes = group.length - 1; // -1 because currentNode will be advanced anyway
           while (skipNodes > 0 && nextNode) {
@@ -241,7 +241,7 @@ function fixDefinitionListStructure(html) {
         // Handle orphaned dd elements - move them to the main dl if they don't belong to a reference
         const dtBefore = currentNode.previousSibling;
         let hasAssociatedDt = false;
-        
+
         // Check if there's a dt before this dd (walking backwards through siblings)
         let checkNode = currentNode.previousSibling;
         while (checkNode) {
@@ -250,7 +250,7 @@ function fixDefinitionListStructure(html) {
             checkNode = checkNode.previousSibling;
             continue;
           }
-          
+
           if (checkNode.tagName === 'DT') {
             hasAssociatedDt = true;
             break;
@@ -258,10 +258,10 @@ function fixDefinitionListStructure(html) {
             // Found a non-dt, non-dd element, so this dd is orphaned
             break;
           }
-          
+
           checkNode = checkNode.previousSibling;
         }
-        
+
         // If this dd doesn't have an associated dt in the same context, move it to main dl
         if (!hasAssociatedDt) {
           const ddClone = currentNode.cloneNode(true);

package/src/install-from-boilerplate/boilerplate/.github/workflows/menu.yml

@@ -9,16 +9,16 @@ on:
         required: true
         default: 'Render specification'
         options:
-          # - Edit specification
+          - Add content
           - Render specification
-          # - Develop specification
+          - Export to PDF
+          - Export to DOCX
           - Collect external references
-          - Convert to PDF
+          - Add, remove or view xref source
+          - Configure
+          - Run health check
+          - Open documentation website
           - Freeze specification
-          # - List references
-          # - Show help
-          # - Add/remove xref source
-          # - Configure specification
           - Custom update
 
 jobs:
@@ -59,9 +59,11 @@ jobs:
           MY_PAT: ${{ secrets.MY_PAT }} # Make the secret available as an env var
         run: |
           case "${{ github.event.inputs.script }}" in
-            # "Edit specification")
-            #   node -e "require('spec-up-t')()"
-            #   ;;
+            "Add content")
+              echo "You can start adding your content to the markdown files in the 'spec' directory."
+              echo "You can do this by editing local files in an editor or by going to your repository on GitHub."
+              echo "More info: https://blockchainbird.github.io/spec-up-t-website/docs/various-roles/content-authors-guide/introduction"
+              ;;
             "Render specification")
               node --no-warnings -e "require('spec-up-t/index.js')({ nowatch: true })"
               git config --global user.email "actions@github.com"
@@ -70,9 +72,15 @@ jobs:
               git commit -m "Render specification: Update files" || echo "No changes to commit"
               git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
               ;;
-            # "Develop specification")
-            #   node -e "require('spec-up-t')({ dev: true })"
-            #   ;;
+            # ...existing code...
+            "Export to DOCX")
+              node -e "require('spec-up-t/src/create-docx.js')"
+              git config --global user.email "actions@github.com"
+              git config --global user.name "GitHub Actions"
+              git add .
+              git commit -m "Export to DOCX" || echo "No changes to commit"
+              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
+              ;;
             "Collect external references")
               node --no-warnings -e "require('spec-up-t/src/collect-external-references.js').collectExternalReferences({ pat: process.env.MY_PAT })"
               git config --global user.email "actions@github.com"
@@ -81,12 +89,12 @@ jobs:
               git commit -m "Collect external references" || echo "No changes to commit"
               git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
               ;;
-            "Convert to PDF")
+            "Export to PDF")
               node -e "require('spec-up-t/src/create-pdf.js')"
               git config --global user.email "actions@github.com"
               git config --global user.name "GitHub Actions"
               git add .
-              git commit -m "Convert to PDF" || echo "No changes to commit"
+              git commit -m "Export to PDF" || echo "No changes to commit"
               git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
               ;;
             "Freeze specification")
@@ -97,18 +105,34 @@ jobs:
               git commit -m "Freeze specification" || echo "No changes to commit"
               git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
               ;;
-            # "List references")
-            #   node -e "require('spec-up-t/src/references.js')"
-            #   ;;
-            # "Show help")
-            #   cat ./node_modules/spec-up-t/src/install-from-boilerplate/help.txt || echo "Help file not found"
-            #   ;;
-            # "Add/remove xref source")
-            #   node --no-warnings -e "require('spec-up-t/src/add-remove-xref-source.js')"
-            #   ;;
-            # "Configure specification")
-            #   node --no-warnings -e "require('spec-up-t/src/configure.js')"
-            #   ;;
+            "Add, remove or view xref source")
+              node --no-warnings -e "require('spec-up-t/src/add-remove-xref-source.js')"
+              git config --global user.email "actions@github.com"
+              git config --global user.name "GitHub Actions"
+              git add .
+              git commit -m "Add, remove or view xref source" || echo "No changes to commit"
+              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
+              ;;
+            "Configure")
+              node --no-warnings -e "require('spec-up-t/src/configure.js')"
+              git config --global user.email "actions@github.com"
+              git config --global user.name "GitHub Actions"
+              git add .
+              git commit -m "Configure" || echo "No changes to commit"
+              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
+              ;;
+            "Run health check")
+              node --no-warnings -e "require('spec-up-t/src/health-check.js')"
+              git config --global user.email "actions@github.com"
+              git config --global user.name "GitHub Actions"
+              git add .
+              git commit -m "Run health check" || echo "No changes to commit"
+              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
+              ;;
+            "Open documentation website")
+              echo "Opening documentation website: https://blockchainbird.github.io/spec-up-t-website/"
+              echo "Please visit the URL manually: https://blockchainbird.github.io/spec-up-t-website/"
+              ;;
             "Custom update")
               npm update && node -e "require('spec-up-t/src/install-from-boilerplate/custom-update.js')"
               git config --global user.email "actions@github.com"
@@ -124,7 +148,7 @@ jobs:
           esac
 
       - name: Deploy to GitHub Pages
-        if: success() && github.event.inputs.script != 'Show help' && github.event.inputs.script != 'Show menu'
+        if: success() && github.event.inputs.script != 'Add content' && github.event.inputs.script != 'Open documentation website' && github.event.inputs.script != 'Configure' && github.event.inputs.script != 'Run health check'
         uses: peaceiris/actions-gh-pages@v3.7.3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

package/test-default-definitions.js

@@ -1,55 +0,0 @@
-const { fixMarkdownFiles } = require('./src/fix-markdown-files');
-const fs = require('fs');
-const path = require('path');
-
-// Test cases for the default definition functionality
-function testDefaultDefinitions() {
-    console.log('Running tests for default definition functionality...');
-
-    const testContent = [
-        '[[def: test-term, test-term]]',
-        '',
-        '[[tref: another-term, another-term]]',
-        '',
-        '[[def: term-with-def, term-with-def]]',
-        '',
-        '~ This term already has a definition',
-        '',
-        '[[tref: final-term, final-term]]'
-    ].join('\n');
-
-    // Write test content to a temp file
-    const tempFile = './temp-test.md';
-    fs.writeFileSync(tempFile, testContent, 'utf8');
-
-    // Process the file
-    fixMarkdownFiles('.');
-
-    // Read and verify results
-    const result = fs.readFileSync(tempFile, 'utf8');
-    console.log('Test result:');
-    console.log(result);
-
-    // Clean up
-    fs.unlinkSync(tempFile);
-
-    // Verify expected content
-    const lines = result.split('\n');
-    let hasDefaultDefs = 0;
-    
-    for (let i = 0; i < lines.length; i++) {
-        if (lines[i] === '~ No local definition found.') {
-            hasDefaultDefs++;
-        }
-    }
-
-    console.log(`Found ${hasDefaultDefs} default definitions`);
-    
-    if (hasDefaultDefs === 3) { // Should be 3: test-term, another-term, final-term
-        console.log('✅ Test passed: All terms without definitions got default definitions');
-    } else {
-        console.log('❌ Test failed: Expected 3 default definitions');
-    }
-}
-
-testDefaultDefinitions();

package/test-edge-cases.md

@@ -1,20 +0,0 @@
-[[def: term1, term1]]
-
-~ No local definition found.
-
-[[def: term2, term2]]
-
-~ This term has a definition
-
-[[tref: term3, term3]]
-
-~ No local definition found.
-
-[[def: term4, term4]]
-
-~ This term also has a definition
-~ With multiple lines
-
-[[tref: term5, term5]]
-
-~ No local definition found.

package/test-fix-markdown.js

@@ -1,11 +0,0 @@
-const { fixMarkdownFiles } = require('./src/fix-markdown-files');
-const fs = require('fs');
-const path = require('path');
-
-// Test the functionality on our test files
-console.log('Testing fix-markdown-files functionality...');
-
-// Process test files directly by calling fixMarkdownFiles on the current directory
-fixMarkdownFiles('.');
-
-console.log('Processing complete. Check the test files for results.');

package/test-no-def.md

@@ -1,22 +0,0 @@
-# Test File for Terms Without Definitions
-
-This file contains terms that have no definitions to test the default definition functionality.
-
-[[def: xip, xip]]
-
-~ No local definition found.
-
-[[tref:toip1, SSI]]
-
-~ No local definition found.
-
-Some other content here.
-
-[[def: weight, weight]]
-
-~ an optional field map in the Edge section that provides edge weight property that enables directed weighted edges and operators that use weights.  
-~ Source: Dr. S.Smith
-
-[[def: another-term, another-term]]
-
-~ No local definition found.