spec-up-t 1.1.42 → 1.1.44

package/assets/compiled/body.js

@@ -132,8 +132,9 @@ var Notyf=function(){"use strict";var t,i=function(){return(i=Object.assign||fun
 function showModal(e){const n=document.createElement("div");n.className="spec-up-t-modal-overlay";const c=document.createElement("div");c.className="spec-up-t-modal";const t=document.createElement("button");function o(){document.body.removeChild(n)}t.className="spec-up-t-modal-close",t.innerHTML="×",t.onclick=o,c.innerHTML=e,c.appendChild(t),n.appendChild(c),document.body.appendChild(n),n.onclick=function(e){e.target===n&&o()},document.addEventListener("keydown",(function(e){"Escape"===e.key&&o()}),{once:!0})}
 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"),e.target="_blank",e.rel="noopener noreferrer",e.href="index.pdf",e.title="Download this page as a PDF",e.innerHTML="PDF",document.querySelector("#container-search-h7vc6omi2hr2880").appendChild(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){var r;e&&e.xtrefs?(r=e,document.querySelectorAll("dt span.transcluded-xref-term").forEach(e=>{const n=Array.from(e.childNodes).filter(e=>e.nodeType===Node.TEXT_NODE).map(e=>e.textContent.trim()).join(""),t=r.xtrefs.find(e=>e.term===n);if(!t)return;const o=document.createElement("dd");o.classList.add("transcluded-xref-term","transcluded-xref-term-embedded");let d=t.content.replace(/\[\[def: ([^,]+),.*?\]\]/g,"").split("\n").map(e=>e.replace(/^\s*~\s*/,"")).join("\n").replace(/\[\[ref:/g,"").replace(/\]\]/g,"");o.innerHTML=md.render(d);const s=document.createElement("dd");s.classList.add("transcluded-xref-term","meta-info-content-wrapper");const a=`\n| Property | Value |\n| -------- | ----- |\n| Owner | ${t.avatarUrl?`![avatar](${t.avatarUrl})`:""} ${t.owner||"Unknown"} |\n| Repo | ${t.repo&&t.repoUrl?`[${t.repo}](${t.repoUrl})`:"Unknown"} |\n| Commit hash | ${t.commitHash||"Unknown"} |\n         `;s.innerHTML=md.render(a);const l=e.closest("dt");if(l){const e=l.parentNode;e.insertBefore(s,l.nextSibling),e.insertBefore(o,s.nextSibling)}})):console.error("allXTrefs is undefined or missing xtrefs property")}document.addEventListener("DOMContentLoaded",()=>{insertTrefs(allXTrefs)});
 function collapseDefinitions(){const t=document.querySelectorAll("#content dl.terms-and-definitions-list > dd"),e=document.querySelectorAll("#content dl.terms-and-definitions-list > dt"),n=document.querySelectorAll(".collapse-all-defs-button");e.forEach(t=>{const e=document.createElement("button");e.classList.add("collapse-all-defs-button","btn","p-0","fs-5","d-flex","align-items-center","justify-content-center"),e.innerHTML="▲",e.setAttribute("id","toggleButton"),t.appendChild(e)}),document.addEventListener("click",e=>{e.target.classList.contains("collapse-all-defs-button")&&(!function(){const e=t[0].classList.contains("hidden");t.forEach(t=>{t.classList.toggle("hidden",!e),t.classList.toggle("visible",e)}),n.forEach(t=>{t.innerHTML=e?"▲":"▼",t.title=e?"Collapse all definitions":"Expand all definitions"})}(),e.target.scrollIntoView({behavior:"smooth",block:"start",inline:"nearest"}),setTimeout(()=>{window.scrollBy({top:-100,behavior:"smooth"})},500))})}document.addEventListener("DOMContentLoaded",(function(){collapseDefinitions()}));
-function createToggleButton(t){const e=document.createElement("button");e.classList.add("meta-info-toggle-button","btn"),e.textContent="ℹ️",e.title="Meta info",e.addEventListener("click",(function(){t.classList.toggle("collapsed"),t.classList.contains("collapsed"),this.textContent="ℹ️"}));let n=t.previousElementSibling;for(;n&&"DT"!==n.tagName;)n=n.previousElementSibling;n?n.appendChild(e):t.insertBefore(e,t.firstChild)}document.addEventListener("DOMContentLoaded",(function(){document.querySelectorAll("dl > dd:has(table)").forEach((function(t){const e=document.createElement("div");for(e.classList.add("meta-info-content-wrapper");t.firstChild&&t.firstChild!==t.querySelector(".meta-info-toggle-button");)e.appendChild(t.firstChild);t.querySelector(".meta-info-toggle-button")||createToggleButton(t),t.appendChild(e),t.classList.add("collapsed")}))}));
+function createToggleButton(t){const e=document.createElement("button");e.classList.add("meta-info-toggle-button","btn"),e.textContent="ℹ️",e.title="Meta info",e.addEventListener("click",(function(){t.classList.toggle("collapsed"),t.classList.contains("collapsed"),this.textContent="ℹ️"}));let n=t.previousElementSibling;for(;n&&"DT"!==n.tagName;)n=n.previousElementSibling;n?n.appendChild(e):t.insertBefore(e,t.firstChild)}document.addEventListener("DOMContentLoaded",(function(){document.querySelectorAll("dl > dd:has(table)").forEach((function(t){const e=document.createElement("div");for(;t.firstChild&&t.firstChild!==t.querySelector(".meta-info-toggle-button");)e.appendChild(t.firstChild);t.querySelector(".meta-info-toggle-button")||createToggleButton(t),t.appendChild(e),t.classList.add("collapsed")}))}));
 /**
  * @file This file adds an href attribute to the snapshot link on the page via client side JS DOM manipulation.
  * @author Kor Dwarshuis
@@ -142,7 +143,7 @@ function createToggleButton(t){const e=document.createElement("button");e.classL
  * @since 2024-09-25
  */
 function addHrefToSnapshotLink(){const e=document.querySelector("#snapshotLink"),t=window.location.href,n=t.match(/^(https?:\/\/[^\/]+(?:\/[^\/]+)*)\/versions\/(?:[^\/]+\/)?/);let o;if(n)o=n[1]+"/versions/";else{o=t.split("#")[0].replace(/\/index\.html$/,"").replace(/\/$/,"")+"/versions/"}e&&e.setAttribute("href",o)}document.addEventListener("DOMContentLoaded",(function(){addHrefToSnapshotLink()}));
-function adjustFontSize(){const e=document.body,t=parseFloat(window.getComputedStyle(e).fontSize);function n(t){let n=parseFloat(window.getComputedStyle(e).fontSize)+t;n>=10&&n<=50&&(e.style.fontSize=n+"px")}document.getElementById("decreaseBtn").addEventListener("click",()=>n(-2)),document.getElementById("increaseBtn").addEventListener("click",()=>n(2)),document.getElementById("resetBtn").addEventListener("click",(function(){document.body.style.fontSize=t+"px"}))}document.addEventListener("DOMContentLoaded",(function(){adjustFontSize()}));
+function adjustFontSize(){const e=document.body;parseFloat(window.getComputedStyle(e).fontSize);function t(t){let n=parseFloat(window.getComputedStyle(e).fontSize)+t;n>=10&&n<=50&&(e.style.fontSize=n+"px")}document.getElementById("decreaseBtn").addEventListener("click",()=>t(-2)),document.getElementById("increaseBtn").addEventListener("click",()=>t(2))}document.addEventListener("DOMContentLoaded",(function(){adjustFontSize()}));
 function closeOffCanvasMenu(){document.querySelectorAll("#sidebarMenu a").forEach(e=>{e.addEventListener("click",(function(){const e=document.querySelector("#sidebarMenu");bootstrap.Offcanvas.getOrCreateInstance(e).hide()}))})}document.addEventListener("DOMContentLoaded",(function(){closeOffCanvasMenu()}));
 !function(){var e=window.markdownit();let t=specConfig.source;t&&"github"===t.host&&fetch(`https://api.github.com/repos/${t.account+"/"+t.repo}/issues`).then(e=>e.json()).then(t=>{let n=t.length;document.querySelectorAll("[issue-count]").forEach(e=>{e.setAttribute("issue-count",n)}),repo_issue_list.innerHTML=t.map(t=>`<li class="repo-issue">\n              <detail-box>\n                <section>${e.render(t.body||"")}</section>\n                <header class="repo-issue-title">\n                  <span class="repo-issue-number">${t.number}</span>\n                  <span class="repo-issue-link">\n                    <a href="${t.html_url}" target="_blank">${t.title}</a>\n                  </span>\n                  <span detail-box-toggle></span>\n                </header>\n              </detail-box>\n            </li>`).join(""),Prism.highlightAllUnder(repo_issue_list)}),mermaid.initialize({startOnLoad:!0,theme:"neutral"}),document.querySelectorAll(".chartjs").forEach(e=>{new Chart(e,JSON.parse(e.textContent))});let n=new WeakMap;delegateEvent("pointerover",".term-reference, .spec-reference",(e,t)=>{const r=t.getAttribute("data-local-href")||t.getAttribute("href")||"";let s=document.getElementById(r.replace("#",""));if(!s||n.has(t))return;let i=s.closest("dt, td:first-child");if(!i)return;let l={allowHTML:!0,inlinePositioning:!0};switch(i.tagName){case"DT":l.content=i.nextElementSibling.textContent;break;case"TD":let e=i.closest("table"),t=Array.from(i.closest("tr").children);if(t.shift(),e){let n=Array.from(e.querySelectorAll("thead th"));n.shift(),n.length&&(l.content=`\n            <header>${i.textContent}</header>\n            <table>\n              ${n.map((e,n)=>`<tr><td>${e.textContent}:</td><td>${t[n]?t[n].textContent:""}</td></tr>`).join("")}\n            </table>`)}}l.content&&n.set(t,tippy(t,l))},{passive:!0})}();
 function addClassToTranscludedTerms(){document.querySelectorAll("span.transcluded-xref-term").forEach(e=>{const t=e.closest("dt");if(t){t.classList.add("transcluded-xref-term");let e=t.nextElementSibling;for(;e&&"DT"!==e.tagName&&"DL"!==e.tagName;)"DD"===e.tagName&&e.classList.add("transcluded-xref-term"),e=e.nextElementSibling}})}document.addEventListener("DOMContentLoaded",(function(){addClassToTranscludedTerms()}));

package/assets/compiled/head.css

@@ -8,11 +8,11 @@ code[class*=language-],pre[class*=language-]{color:#ccc;background:0 0;font-fami
 #back-to-top-a1zncgtqfpzsig8{position:fixed;bottom:20px;text-decoration:none;left:calc(100% - 1.8em);width:1.5em;height:1.5em;margin:0;padding:0;background-color:#1e6eae;color:#222;border-radius:50px;text-align:center;font-size:30px;color:#fff;box-shadow:0 0 1.3px rgba(0,0,0,.07),0 0 3.6px rgba(0,0,0,.1),0 0 8.7px rgba(0,0,0,.13),0 0 29px rgba(0,0,0,.2);cursor:pointer;border:none;display:none;align-items:center;justify-content:center}
 @-webkit-keyframes notyf-fadeinup{0%{opacity:0;transform:translateY(25%)}to{opacity:1;transform:translateY(0)}}@keyframes notyf-fadeinup{0%{opacity:0;transform:translateY(25%)}to{opacity:1;transform:translateY(0)}}@-webkit-keyframes notyf-fadeinleft{0%{opacity:0;transform:translateX(25%)}to{opacity:1;transform:translateX(0)}}@keyframes notyf-fadeinleft{0%{opacity:0;transform:translateX(25%)}to{opacity:1;transform:translateX(0)}}@-webkit-keyframes notyf-fadeoutright{0%{opacity:1;transform:translateX(0)}to{opacity:0;transform:translateX(25%)}}@keyframes notyf-fadeoutright{0%{opacity:1;transform:translateX(0)}to{opacity:0;transform:translateX(25%)}}@-webkit-keyframes notyf-fadeoutdown{0%{opacity:1;transform:translateY(0)}to{opacity:0;transform:translateY(25%)}}@keyframes notyf-fadeoutdown{0%{opacity:1;transform:translateY(0)}to{opacity:0;transform:translateY(25%)}}@-webkit-keyframes ripple{0%{transform:scale(0) translateY(-45%) translateX(13%)}to{transform:scale(1) translateY(-45%) translateX(13%)}}@keyframes ripple{0%{transform:scale(0) translateY(-45%) translateX(13%)}to{transform:scale(1) translateY(-45%) translateX(13%)}}.notyf{position:fixed;top:0;left:0;height:100%;width:100%;color:#fff;z-index:9999;display:flex;flex-direction:column;align-items:flex-end;justify-content:flex-end;pointer-events:none;box-sizing:border-box;padding:20px}.notyf__icon--error,.notyf__icon--success{height:21px;width:21px;background:#fff;border-radius:50%;display:block;margin:0 auto;position:relative}.notyf__icon--error:after,.notyf__icon--error:before{content:"";background:currentColor;display:block;position:absolute;width:3px;border-radius:3px;left:9px;height:12px;top:5px}.notyf__icon--error:after{transform:rotate(-45deg)}.notyf__icon--error:before{transform:rotate(45deg)}.notyf__icon--success:after,.notyf__icon--success:before{content:"";background:currentColor;display:block;position:absolute;width:3px;border-radius:3px}.notyf__icon--success:after{height:6px;transform:rotate(-45deg);top:9px;left:6px}.notyf__icon--success:before{height:11px;transform:rotate(45deg);top:5px;left:10px}.notyf__toast{display:block;overflow:hidden;pointer-events:auto;-webkit-animation:notyf-fadeinup .3s ease-in forwards;animation:notyf-fadeinup .3s ease-in forwards;box-shadow:0 3px 7px 0 rgba(0,0,0,.25);position:relative;padding:0 15px;border-radius:2px;max-width:300px;transform:translateY(25%);box-sizing:border-box;flex-shrink:0}.notyf__toast--disappear{transform:translateY(0);-webkit-animation:notyf-fadeoutdown .3s forwards;animation:notyf-fadeoutdown .3s forwards;-webkit-animation-delay:.25s;animation-delay:.25s}.notyf__toast--disappear .notyf__icon,.notyf__toast--disappear .notyf__message{-webkit-animation:notyf-fadeoutdown .3s forwards;animation:notyf-fadeoutdown .3s forwards;opacity:1;transform:translateY(0)}.notyf__toast--disappear .notyf__dismiss{-webkit-animation:notyf-fadeoutright .3s forwards;animation:notyf-fadeoutright .3s forwards;opacity:1;transform:translateX(0)}.notyf__toast--disappear .notyf__message{-webkit-animation-delay:.05s;animation-delay:.05s}.notyf__toast--upper{margin-bottom:20px}.notyf__toast--lower{margin-top:20px}.notyf__toast--dismissible .notyf__wrapper{padding-right:30px}.notyf__ripple{height:400px;width:400px;position:absolute;transform-origin:bottom right;right:0;top:0;border-radius:50%;transform:scale(0) translateY(-51%) translateX(13%);z-index:5;-webkit-animation:ripple .4s ease-out forwards;animation:ripple .4s ease-out forwards}.notyf__wrapper{display:flex;align-items:center;padding-top:17px;padding-bottom:17px;padding-right:15px;border-radius:3px;position:relative;z-index:10}.notyf__icon{width:22px;text-align:center;font-size:1.3em;opacity:0;-webkit-animation:notyf-fadeinup .3s forwards;animation:notyf-fadeinup .3s forwards;-webkit-animation-delay:.3s;animation-delay:.3s;margin-right:13px}.notyf__dismiss{position:absolute;top:0;right:0;height:100%;width:26px;margin-right:-15px;-webkit-animation:notyf-fadeinleft .3s forwards;animation:notyf-fadeinleft .3s forwards;-webkit-animation-delay:.35s;animation-delay:.35s;opacity:0}.notyf__dismiss-btn{background-color:rgba(0,0,0,.25);border:none;cursor:pointer;transition:opacity .2s ease,background-color .2s ease;outline:0;opacity:.35;height:100%;width:100%}.notyf__dismiss-btn:after,.notyf__dismiss-btn:before{content:"";background:#fff;height:12px;width:2px;border-radius:3px;position:absolute;left:calc(50% - 1px);top:calc(50% - 5px)}.notyf__dismiss-btn:after{transform:rotate(-45deg)}.notyf__dismiss-btn:before{transform:rotate(45deg)}.notyf__dismiss-btn:hover{opacity:.7;background-color:rgba(0,0,0,.15)}.notyf__dismiss-btn:active{opacity:.8}.notyf__message{vertical-align:middle;position:relative;opacity:0;-webkit-animation:notyf-fadeinup .3s forwards;animation:notyf-fadeinup .3s forwards;-webkit-animation-delay:.25s;animation-delay:.25s;line-height:1.5em}@media only screen and (max-width:480px){.notyf{padding:0}.notyf__ripple{height:600px;width:600px;-webkit-animation-duration:.5s;animation-duration:.5s}.notyf__toast{max-width:none;border-radius:0;box-shadow:0 -2px 7px 0 rgba(0,0,0,.13);width:100%}.notyf__dismiss{width:56px}}
 #content dl dd.hidden{display:none}#content dl dd.visible{display:block}.collapse-all-defs-button{float:right}
-dl>dd:has(table)>.meta-info-content-wrapper{max-height:100px;transition:max-height .3s ease-out}dl>dd:has(table).collapsed>.meta-info-content-wrapper{padding-top:0;padding-bottom:0;overflow:hidden;transition:max-height .3s ease-out;max-height:0}
+dl>dd:has(table).meta-info-content-wrapper{max-height:10em;transition:max-height .3s ease-out}dl>dd:has(table).collapsed.meta-info-content-wrapper{padding-top:0;padding-bottom:0;overflow:hidden;transition:max-height .3s ease-out;max-height:0;line-height:0}
 .spec-up-t-modal-overlay{position:fixed;top:0;left:0;width:100%;height:100%;background-color:rgba(0,0,0,.5);display:flex;justify-content:center;align-items:center;z-index:1000}.spec-up-t-modal{background-color:#fff;padding:2rem 20px 20px;border-radius:8px;max-width:80%;max-height:80%;overflow-y:auto;position:relative;box-shadow:0 2px 10px rgba(0,0,0,.1)}.spec-up-t-modal-close{position:absolute;top:0;right:5px;background-color:transparent;border:none;font-size:2rem;line-height:1;cursor:pointer}
 .alphabet-index-container{margin-bottom:1em}.alphabet-index-container,.number-of-terms{font-size:.8em;text-align:center;width:100%}.alphabet-index-container a{background-color:#f5f5f5;border:1px solid #e0e0e0;border-radius:50%;color:#333;display:inline-block;font-size:.9rem;height:30px;line-height:30px;margin:2px;text-align:center;text-decoration:none;width:30px}
 .button-pdf-download{padding-left:.1em;padding-right:.1em;border:none;background:red;color:#fff;box-shadow:2.8px 2.8px 2.2px rgba(0,0,0,.02),6.7px 6.7px 5.3px rgba(0,0,0,.028),12.5px 12.5px 10px rgba(0,0,0,.035),22.3px 22.3px 17.9px rgba(0,0,0,.042),41.8px 41.8px 33.4px rgba(0,0,0,.05),100px 100px 80px rgba(0,0,0,.07)}
-h2,h3,h4,h5,h6{margin-top:1.5em!important}.toc-anchor{font-size:.875em;color:inherit;text-decoration:none;color:#73c2df;transition:opacity .3s ease}.toc-anchor:hover{opacity:1}#terminology-section-utility-container{display:flex;flex-wrap:wrap;justify-content:center;margin:1em auto;padding:0;width:100%}@media (min-width:576px){#terminology-section-utility-container{position:sticky;top:3.5em}}.transcluded-xref-term{background:#a9dde03b!important;padding:.5em;margin:1em 0}.transclusion-heading{font-size:1.3em;font-weight:700;margin:1em 0 .5em}.btn,.no-xref-found-message{font-variant:small-caps;text-transform:uppercase}.no-xref-found-message{background:#f8c481!important;color:#03365f!important;margin:0 .5em;padding:0 .8em;border-radius:.25rem;font-size:.8rem}dl.terms-and-definitions-list{margin:0;padding:0}dl.terms-and-definitions-list>dt{font-weight:700;margin:0;background-color:var(--card-bg-dt);border:1px solid var(--card-border);padding:.1rem 1.25rem;border-radius:.375rem .375rem 0 0;box-shadow:0 .125rem .25rem var(--card-shadow);color:var(--card-text)}dl.terms-and-definitions-list>dd{margin:0;background-color:var(--card-bg);border:1px solid var(--card-border);border-top:none;padding:1rem 1.25rem;box-shadow:0 .125rem .25rem var(--card-shadow);color:var(--card-text);overflow:scroll;width:100%}dl.terms-and-definitions-list dd p{margin:0;color:var(--card-text)}dl.terms-and-definitions-list dt+dd{border-bottom:none}dl.terms-and-definitions-list dd+dd{border-top:none;border-bottom:none}dl.terms-and-definitions-list dd+dt{margin-top:1.5rem}dl.terms-and-definitions-list dd.last-dd{border-radius:0 0 .375rem .375rem;border-bottom:1px solid var(--card-border)}dl.terms-and-definitions-list>dt:hover{background-color:var(--card-hover-bg);transition:background-color .2s ease-in-out}
+h2,h3,h4,h5,h6{margin-top:1.5em!important}.toc-anchor{font-size:.875em;color:inherit;text-decoration:none;color:#73c2df;transition:opacity .3s ease}.toc-anchor:hover{opacity:1}#terminology-section-utility-container{display:flex;flex-wrap:wrap;justify-content:center;margin:1em auto;padding:0;width:100%}@media (min-width:576px){#terminology-section-utility-container{position:sticky;top:3.5em}}.transcluded-xref-term{background:#a9dde03b!important;padding:.5em;margin:1em 0}.transclusion-heading{font-size:1.3em;font-weight:700;margin:1em 0 .5em}dl.terms-and-definitions-list>dd.transcluded-xref-term-embedded{background-image:linear-gradient(45deg,hsl(190deg 60% 95%) 0,hsl(189deg 60% 93%) 8%,hsl(189deg 60% 91%) 17%,hsl(188deg 60% 89%) 25%,hsl(188deg 60% 87%) 33%,hsl(187deg 60% 85%) 42%,hsl(186deg 60% 83%) 50%,hsl(190deg 60% 83%) 58%,hsl(193deg 60% 83%) 67%,hsl(197deg 60% 83%) 75%,hsl(202deg 60% 83%) 83%,hsl(207deg 60% 83%) 92%,hsl(212deg 60% 83%) 100%)!important}.btn,.no-xref-found-message{font-variant:small-caps;text-transform:uppercase}.no-xref-found-message{background:#f8c481!important;color:#03365f!important;margin:0 .5em;padding:0 .8em;border-radius:.25rem;font-size:.8rem}dl.terms-and-definitions-list{margin:0;padding:0}dl.terms-and-definitions-list>dt{font-weight:700;margin:0;background-color:var(--card-bg-dt);border:1px solid var(--card-border);padding:.1rem 1.25rem;border-radius:.375rem .375rem 0 0;box-shadow:0 .125rem .25rem var(--card-shadow);color:var(--card-text)}dl.terms-and-definitions-list>dd{margin:0;background-color:var(--card-bg);border:1px solid var(--card-border);border-top:none;padding:1rem 1.25rem;color:var(--card-text);overflow:scroll;width:100%}dl.terms-and-definitions-list dd p{margin:0;color:var(--card-text)}dl.terms-and-definitions-list dt+dd{border-bottom:none}dl.terms-and-definitions-list dd+dd{border-top:none;border-bottom:none}dl.terms-and-definitions-list dd+dt{margin-top:1.5rem}dl.terms-and-definitions-list dd.last-dd{border-radius:0 0 .375rem .375rem;border-bottom:1px solid var(--card-border)}dl.terms-and-definitions-list>dt:hover{background-color:var(--card-hover-bg);transition:background-color .2s ease-in-out}
 @charset "UTF-8";/*!
  * Bootstrap  v5.3.3 (https://getbootstrap.com/)
  * Copyright 2011-2024 The Bootstrap Authors

package/assets/css/collapse-meta-info.css

@@ -4,17 +4,18 @@
   Description: Make the meta-info tables collapsible
 */
 
-dl>dd:has(table)>.meta-info-content-wrapper {
-  max-height: 100px;
+dl>dd:has(table).meta-info-content-wrapper {
+  max-height: 10em;
   transition: max-height 0.3s ease-out;
   /* This should be higher than the tallest content */
 }
 
-dl>dd:has(table).collapsed>.meta-info-content-wrapper {
+dl>dd:has(table).collapsed.meta-info-content-wrapper {
   padding-top: 0;
   padding-bottom: 0;
 
   overflow: hidden;
   transition: max-height 0.3s ease-out;
   max-height: 0;
+  line-height: 0;
 }

package/assets/css/terms-and-definitions.css

@@ -52,6 +52,26 @@ h2,h3,h4,h5,h6 {
   font-weight: bold;
   margin: 1em 0 0.5em;
 }
+
+dl.terms-and-definitions-list>dd.transcluded-xref-term-embedded {
+  background-image: linear-gradient(45deg,
+      hsl(190deg 60% 95%) 0%,
+      hsl(189deg 60% 93%) 8%,
+      hsl(189deg 60% 91%) 17%,
+      hsl(188deg 60% 89%) 25%,
+      hsl(188deg 60% 87%) 33%,
+      hsl(187deg 60% 85%) 42%,
+      hsl(186deg 60% 83%) 50%,
+      hsl(190deg 60% 83%) 58%,
+      hsl(193deg 60% 83%) 67%,
+      hsl(197deg 60% 83%) 75%,
+      hsl(202deg 60% 83%) 83%,
+      hsl(207deg 60% 83%) 92%,
+      hsl(212deg 60% 83%) 100%) !important;
+
+}
+
+
 /* End Transclusions */
 
 
@@ -98,8 +118,6 @@ dl.terms-and-definitions-list>dd {
   border: 1px solid var(--card-border);
   border-top: none;
   padding: 1rem 1.25rem;
-  /* Consistent Bootstrap card-body padding */
-  box-shadow: 0 0.125rem 0.25rem var(--card-shadow);
   color: var(--card-text);
   overflow: scroll;
   width: 100%;

package/assets/js/collapse-meta-info.js

@@ -42,7 +42,6 @@ document.addEventListener('DOMContentLoaded', function () {
     collapsibles.forEach(function (element) {
         // Wrap content (excluding button) in a div for easy toggling
         const wrapper = document.createElement('div');
-        wrapper.classList.add('meta-info-content-wrapper');
 
         // Move all children except potential existing buttons into wrapper
         while (element.firstChild && element.firstChild !== element.querySelector('.meta-info-toggle-button')) {

package/assets/js/insert-trefs.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Inserts transcluded external references (trefs) into the document.
+ *
+ * This script enhances an HTML document by adding definitions and meta information
+ * for terms marked with `<span class="transcluded-xref-term">` inside `<dt>` elements
+ * within a `<dl>` structure. It matches these terms against an external data source,
+ * renders the corresponding content and meta information from markdown to HTML,
+ * and inserts them as `<dd>` elements following each matching `<dt>`. The script
+ * executes automatically when the DOM is fully loaded via a `DOMContentLoaded` event listener.
+ *
+ * ### Dependencies
+ * - **`allXTrefs`**: A global object containing the external references to be transcluded.
+ * - **`md`**: A markdown renderer object with a `render` method to convert markdown to HTML.
+ *
+ * ### Data Structure
+ * The `allXTrefs` object must have the following structure:
+ * ```javascript
+ * {
+ *   xtrefs: [
+ *     {
+ *       term: string,          // The term to match against the <span> text content
+ *       content: string,       // Markdown content for the definition
+ *       owner: string,         // Owner of the source repository
+ *       repo: string,          // Repository name
+ *       repoUrl: string,       // URL to the repository
+ *       commitHash: string,    // Commit hash of the source
+ *       avatarUrl: string      // URL to the owner's avatar
+ *     },
+ *     // Additional reference objects...
+ *   ]
+ * }
+ * ```
+ *
+ * ### Behavior
+ * The script:
+ * 1. Identifies all `<dt>` elements containing `<span class="transcluded-xref-term">`.
+ * 2. Extracts the text content of each `<span>`.
+ * 3. Searches for a matching `term` in `allXTrefs.xtrefs`.
+ * 4. If a match is found, creates:
+ *    - A `<dd>` element with the rendered `content` (markdown to HTML).
+ *    - A `<dd>` element with meta information (e.g., owner, repo, commit hash) also rendered from markdown.
+ * 5. Inserts these `<dd>` elements after the corresponding `<dt>`.
+ *
+ * ### DOM Modifications
+ * The script modifies the DOM by appending new `<dd>` elements after each matching `<dt>`.
+ *
+ * @requires {Object} allXTrefs - The external data source containing the references.
+ * @requires {Object} md - A markdown renderer with a `render` method (e.g., marked.js or similar).
+ *
+ * @example
+ * // Define dependencies in a <script> tag before this script:
+ * window.allXTrefs = {
+ *   xtrefs: [
+ *     {
+ *       term: "example",
+ *       content: "This is an **example** definition.",
+ *       owner: "user",
+ *       repo: "glossary",
+ *       repoUrl: "https://github.com/user/glossary",
+ *       commitHash: "abc123",
+ *       avatarUrl: "https://github.com/user.png"
+ *     }
+ *   ]
+ * };
+ * window.md = { render: function(markdown) { return "<p>" + markdown + "</p>"; } };
+ *
+ * // HTML example:
+ * // <dl>
+ * //   <dt><span class="transcluded-xref-term">example</span></dt>
+ * // </dl>
+ * // After script execution:
+ * // <dl>
+ * //   <dt><span class="transcluded-xref-term">example</span></dt>
+ * //   <dd> … table with meta info … </dd>
+ * //   <dd><p>This is an <strong>example</strong> definition.</p></dd>
+ * // </dl>
+ */
+
+function insertTrefs(allXTrefs) { // Pass allXTrefs as a parameter
+   function processTerms(xtrefsData) {
+      const termElements = document.querySelectorAll('dt span.transcluded-xref-term');
+
+      termElements.forEach(termElement => {
+         // Get the text content of the element, excluding its child nodes
+         const textContent = Array.from(termElement.childNodes)
+            .filter(node => node.nodeType === Node.TEXT_NODE)
+            .map(node => node.textContent.trim())
+            .join('');
+
+         // Find the first matching xref to avoid duplicates
+         const xref = xtrefsData.xtrefs.find(x => x.term === textContent);
+         if (!xref) return; // Skip if no match
+
+         // Create definition <dd>
+         const ddTrefDef = document.createElement('dd');
+         ddTrefDef.classList.add('transcluded-xref-term', 'transcluded-xref-term-embedded');
+
+         // Clean up markdown content
+         let content = xref.content
+            .replace(/\[\[def: ([^,]+),.*?\]\]/g, '') // Remove [[def: ...]]
+            .split('\n')
+            .map(line => line.replace(/^\s*~\s*/, '')) // Remove leading ~ and spaces
+            .join('\n')
+            .replace(/\[\[ref:/g, '') // Remove [[ref: ...]]
+            .replace(/\]\]/g, '');
+
+         ddTrefDef.innerHTML = md.render(content);
+
+         // Create meta info <dd>
+         const ddMetaInfo = document.createElement('dd');
+         ddMetaInfo.classList.add('transcluded-xref-term', 'meta-info-content-wrapper');
+
+         // Handle missing xref properties
+         const avatar = xref.avatarUrl ? `![avatar](${xref.avatarUrl})` : '';
+         const owner = xref.owner || 'Unknown';
+         const repo = xref.repo && xref.repoUrl ? `[${xref.repo}](${xref.repoUrl})` : 'Unknown';
+         const commitHash = xref.commitHash || 'Unknown';
+
+         const metaInfo = `
+| Property | Value |
+| -------- | ----- |
+| Owner | ${avatar} ${owner} |
+| Repo | ${repo} |
+| Commit hash | ${commitHash} |
+         `;
+         ddMetaInfo.innerHTML = md.render(metaInfo);
+
+         // Insert both <dd> elements in the correct order
+         const dt = termElement.closest('dt');
+         if (dt) {
+            const parent = dt.parentNode;
+            parent.insertBefore(ddMetaInfo, dt.nextSibling); // Meta info first
+            parent.insertBefore(ddTrefDef, ddMetaInfo.nextSibling); // Definition second
+         }
+      });
+   }
+
+   if (allXTrefs && allXTrefs.xtrefs) {
+      processTerms(allXTrefs);
+   } else {
+      console.error('allXTrefs is undefined or missing xtrefs property');
+   }
+}
+
+document.addEventListener('DOMContentLoaded', () => {
+   // Assuming allXTrefs is available globally or fetched elsewhere
+   insertTrefs(allXTrefs); // Adjust based on how allXTrefs is provided
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.1.42",
+  "version": "1.1.44",
   "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": {

package/src/asset-map.json

@@ -54,6 +54,7 @@
       "assets/js/modal.js",
       "assets/js/token-input.js",
       "assets/js/pdf-download.js",
+      "assets/js/insert-trefs.js",
       "assets/js/collapse-definitions.js",
       "assets/js/collapse-meta-info.js",
       "assets/js/add-href-to-snapshot-link.js",

package/src/prepare-tref.js

@@ -1,24 +1,3 @@
-/**
- * @file prepare-tref.js
- * @description This module provides functionality to process markdown files in a directory recursively, 
- * searching for specific `[[tref:]]` references, and replacing them with detailed information 
- * fetched from a local JSON file (`xtrefs-data.json`). The information includes metadata such as 
- * owner, repository, commit hash, and content. If no matching reference is found, a placeholder 
- * message is written to the file.
- * 
- * The module includes:
- * - A helper function `getLocalXTrefContent` to retrieve reference data from the JSON file.
- * - A main function `prepareTref` to process directories and markdown files, replacing tref references.
- * 
- * This is useful for dynamically enriching markdown documentation with external reference details.
- * 
- * @requires fs - Node.js file system module for reading and writing files.
- * @requires path - Node.js path module for handling file paths.
- * @requires dedent - A utility for removing indentation from multi-line strings.
- * 
- * @module prepareTref
- */
-
 const fs = require('fs');
 const path = require('path');
 const dedent = require('dedent');
@@ -68,7 +47,8 @@ function prepareTref(directory) {
 
                         // Variable to store content after the span or tref line
                         let contentAfterSpan = '';
-                        const spanMarker = '<span style="display: none;">End of included external content. Add your optional custom content below.</span>';
+
+                        const spanMarker = '- - -';
                         const spanIndex = data.indexOf(spanMarker);
 
                         if (spanIndex !== -1) {
@@ -101,16 +81,9 @@ function prepareTref(directory) {
 
                                     const readyForWrite = dedent`
 ${match[0]}
-| Property | Value |
-| -------- | ----- |
-| Owner | ![avatar](${localXTrefContent.avatarUrl}) ${localXTrefContent.owner} |
-| Repo | [${localXTrefContent.repo}](${localXTrefContent.repoUrl}) |
-| Commit hash | ${localXTrefContent.commitHash} |
 
-${localXTrefContent.content}
 ${spanMarker}
 
-${contentAfterSpan}
 
 `;