spec-up-t 1.3.0 → 1.3.1

package/assets/compiled/body.js

@@ -102,12 +102,12 @@ function inPageSearch(){const t=document.querySelector(".terms-and-definitions-l
 function highlightMenuItems(){let e=null;function t(e){document.querySelectorAll("#toc_list a").forEach((e=>{e.classList.remove("highlight-cfib41dyhcd99sm")}));const t=document.querySelector(`#toc_list a[href="#${e.id}"]`);t&&(t.classList.add("highlight-cfib41dyhcd99sm"),t.scrollIntoView({behavior:"smooth",block:"center"}),document.dispatchEvent(new CustomEvent("highlight-menu-item",{detail:{menuItem:t,headingId:e.id}})))}const n=new IntersectionObserver(((n,o)=>{const i=n.filter((e=>e.isIntersecting)).map((e=>e.target));i.length>0?(e=i[0],t(e)):e&&t(e)}),{root:null,rootMargin:"0px",threshold:.1});document.querySelectorAll("h2, h3, h4, h5, h6").forEach((e=>n.observe(e)))}document.addEventListener("DOMContentLoaded",(function(){highlightMenuItems()}));
 function initCollapsibleMenu(){const e=document.getElementById("toc");if(!e)return void console.warn("TOC container not found");e.querySelectorAll(".collapse-toggle").forEach((e=>e.remove()));e.querySelectorAll("ul li").forEach(((e,t)=>{const l=e.querySelector("ul");if(l){e.classList.add("has-children");const a=document.createElement("button");a.className="collapse-toggle",a.setAttribute("aria-label","Toggle section"),a.setAttribute("type","button"),a.id=`toc-toggle-${t}`;const i=e.querySelector(":scope > a");if(i){const e=i.textContent.trim();a.setAttribute("aria-label",`Toggle ${e} section`),i.parentNode.insertBefore(a,i.nextSibling),l.setAttribute("role","group"),l.setAttribute("aria-labelledby",i.id||`toc-item-${t}`),i.id||(i.id=`toc-item-${t}`)}else e.appendChild(a);a.setAttribute("aria-controls",`toc-children-${t}`),l.id=`toc-children-${t}`,a.addEventListener("click",(t=>{t.preventDefault(),t.stopPropagation();e.classList.contains("collapsed")?(e.classList.remove("collapsed"),a.classList.remove("collapsed"),a.setAttribute("aria-expanded","true")):(e.classList.add("collapsed"),a.classList.add("collapsed"),a.setAttribute("aria-expanded","false"))})),a.addEventListener("keydown",(e=>{"Enter"!==e.key&&" "!==e.key||(e.preventDefault(),a.click())}));e.querySelector("a.highlight-cfib41dyhcd99sm, a.active")?a.setAttribute("aria-expanded","true"):(e.classList.add("collapsed"),a.classList.add("collapsed"),a.setAttribute("aria-expanded","false"))}}))}document.addEventListener("DOMContentLoaded",(()=>{initCollapsibleMenu()})),document.addEventListener("highlight-menu-item",initCollapsibleMenu);
 function backToTop(){const n=document.createElement("a");n.id="back-to-top-a1zncgtqfpzsig8",n.href="#content",n.innerHTML="↑",document.body.appendChild(n);const t=function(n,t){let e;return function(){const o=this,c=arguments;clearTimeout(e),e=setTimeout((()=>n.apply(o,c)),t)}}((function(){window.scrollY>300?n.style.display="flex":n.style.display="none"}),600);window.addEventListener("scroll",(function(){t()}))}document.addEventListener("DOMContentLoaded",(function(){backToTop()}));
-function addAnchorsToTerms(){document.querySelectorAll('dt:has(> span[id^="term:"])').forEach((e=>{const t=function(e){const t=e.querySelector('span.transcluded-xref-term[id^="term:"]');if(t)return t;let r=e;for(;r.querySelector('span[id^="term:"]');)r=r.querySelector('span[id^="term:"]');return r}(e),r=t.getAttribute("id"),n=document.createElement("a");n.setAttribute("href",`#${r}`),n.setAttribute("class","toc-anchor d-print-none"),n.innerHTML="# ",t.parentNode.insertBefore(n,t)}))}document.addEventListener("DOMContentLoaded",(function(){addAnchorsToTerms()}));
+function addAnchorsToTerms(){document.querySelectorAll('dt:has(> span[id^="term:"])').forEach((e=>{const t=function(e){const t=e.querySelector('span.transcluded-xref-term[id^="term:"]');if(t)return t;let r=e;for(;r.querySelector('span[id^="term:"]');)r=r.querySelector('span[id^="term:"]');return r}(e),r=t.getAttribute("id"),n=document.createElement("a");n.setAttribute("href",`#${r}`),n.setAttribute("class","toc-anchor d-print-none"),n.innerHTML=(window.specConfig.anchor_symbol||"§")+" ",t.parentNode.insertBefore(n,t)}))}document.addEventListener("DOMContentLoaded",(function(){addAnchorsToTerms()}));
 function copyAnchorToCliboard(){document.addEventListener("click",(function(o){if(o.target.classList.contains("toc-anchor")){const c=o.target.href;navigator.clipboard.writeText(c).then((()=>{console.log("Anchor copied to clipboard"),notyf.success(`Anchor copied to clipboard: ${c}`)})).catch((o=>{console.error("Failed to copy anchor to clipboard",o)}))}}))}document.addEventListener("DOMContentLoaded",(function(){copyAnchorToCliboard()}));
 var Notyf=function(){"use strict";var t,i=function(){return(i=Object.assign||function(t){for(var i,e=1,n=arguments.length;e<n;e++)for(var o in i=arguments[e])Object.prototype.hasOwnProperty.call(i,o)&&(t[o]=i[o]);return t}).apply(this,arguments)},e=(n.prototype.on=function(t,i){var e=this.listeners[t]||[];this.listeners[t]=e.concat([i])},n.prototype.triggerEvent=function(t,i){var e=this;(this.listeners[t]||[]).forEach((function(t){return t({target:e,event:i})}))},n);function n(t){this.options=t,this.listeners={}}(s=t=t||{})[s.Add=0]="Add",s[s.Remove=1]="Remove";var o,s,a=(r.prototype.push=function(i){this.notifications.push(i),this.updateFn(i,t.Add,this.notifications)},r.prototype.splice=function(i,e){return e=this.notifications.splice(i,e)[0],this.updateFn(e,t.Remove,this.notifications),e},r.prototype.indexOf=function(t){return this.notifications.indexOf(t)},r.prototype.onUpdate=function(t){this.updateFn=t},r);function r(){this.notifications=[]}(s=o=o||{}).Dismiss="dismiss";var c={types:[{type:"success",className:"notyf__toast--success",backgroundColor:"#3dc763",icon:{className:"notyf__icon--success",tagName:"i"}},{type:"error",className:"notyf__toast--error",backgroundColor:"#ed3d3d",icon:{className:"notyf__icon--error",tagName:"i"}}],duration:2e3,ripple:!0,position:{x:"right",y:"bottom"},dismissible:!(s.Click="click")},p=(d.prototype.on=function(t,e){var n;this.events=i(i({},this.events),((n={})[t]=e,n))},d.prototype.update=function(i,e){e===t.Add?this.addNotification(i):e===t.Remove&&this.removeNotification(i)},d.prototype.removeNotification=function(t){var i,e,n=this;(t=this._popRenderedNotification(t))&&((e=t.node).classList.add("notyf__toast--disappear"),e.addEventListener(this.animationEndEventName,i=function(t){t.target===e&&(e.removeEventListener(n.animationEndEventName,i),n.container.removeChild(e))}))},d.prototype.addNotification=function(t){var i=this._renderNotification(t);this.notifications.push({notification:t,node:i}),this._announce(t.options.message||"Notification")},d.prototype._renderNotification=function(t){var i=this._buildNotificationCard(t),e=t.options.className;return e&&(t=i.classList).add.apply(t,e.split(" ")),this.container.appendChild(i),i},d.prototype._popRenderedNotification=function(t){for(var i=-1,e=0;e<this.notifications.length&&i<0;e++)this.notifications[e].notification===t&&(i=e);if(-1!==i)return this.notifications.splice(i,1)[0]},d.prototype.getXPosition=function(t){return(null===(t=null==t?void 0:t.position)||void 0===t?void 0:t.x)||"right"},d.prototype.getYPosition=function(t){return(null===(t=null==t?void 0:t.position)||void 0===t?void 0:t.y)||"bottom"},d.prototype.adjustContainerAlignment=function(t){var i=this.X_POSITION_FLEX_MAP[this.getXPosition(t)],e=this.Y_POSITION_FLEX_MAP[this.getYPosition(t)];(t=this.container.style).setProperty("justify-content",e),t.setProperty("align-items",i)},d.prototype._buildNotificationCard=function(t){var i=this,e=t.options,n=e.icon;this.adjustContainerAlignment(e);var s=this._createHTMLElement({tagName:"div",className:"notyf__toast"}),a=this._createHTMLElement({tagName:"div",className:"notyf__ripple"}),r=this._createHTMLElement({tagName:"div",className:"notyf__wrapper"}),c=this._createHTMLElement({tagName:"div",className:"notyf__message"});c.innerHTML=e.message||"";var p,d,l,u,f=e.background||e.backgroundColor;return n&&(p=this._createHTMLElement({tagName:"div",className:"notyf__icon"}),("string"==typeof n||n instanceof String)&&(p.innerHTML=new String(n).valueOf()),"object"==typeof n&&(d=n.tagName,l=n.className,u=n.text,n=void 0===(n=n.color)?f:n,u=this._createHTMLElement({tagName:void 0===d?"i":d,className:l,text:u}),n&&(u.style.color=n),p.appendChild(u)),r.appendChild(p)),r.appendChild(c),s.appendChild(r),f&&(e.ripple?(a.style.background=f,s.appendChild(a)):s.style.background=f),e.dismissible&&(a=this._createHTMLElement({tagName:"div",className:"notyf__dismiss"}),f=this._createHTMLElement({tagName:"button",className:"notyf__dismiss-btn"}),a.appendChild(f),r.appendChild(a),s.classList.add("notyf__toast--dismissible"),f.addEventListener("click",(function(e){var n,s;null!==(s=(n=i.events)[o.Dismiss])&&void 0!==s&&s.call(n,{target:t,event:e}),e.stopPropagation()}))),s.addEventListener("click",(function(e){var n,s;return null===(s=(n=i.events)[o.Click])||void 0===s?void 0:s.call(n,{target:t,event:e})})),e="top"===this.getYPosition(e)?"upper":"lower",s.classList.add("notyf__toast--"+e),s},d.prototype._createHTMLElement=function(t){var i=t.tagName,e=t.className;t=t.text,i=document.createElement(i);return e&&(i.className=e),i.textContent=t||null,i},d.prototype._createA11yContainer=function(){var t=this._createHTMLElement({tagName:"div",className:"notyf-announcer"});t.setAttribute("aria-atomic","true"),t.setAttribute("aria-live","polite"),t.style.border="0",t.style.clip="rect(0 0 0 0)",t.style.height="1px",t.style.margin="-1px",t.style.overflow="hidden",t.style.padding="0",t.style.position="absolute",t.style.width="1px",t.style.outline="0",document.body.appendChild(t),this.a11yContainer=t},d.prototype._announce=function(t){var i=this;this.a11yContainer.textContent="",setTimeout((function(){i.a11yContainer.textContent=t}),100)},d.prototype._getAnimationEndEventName=function(){var t,i=document.createElement("_fake"),e={MozTransition:"animationend",OTransition:"oAnimationEnd",WebkitTransition:"webkitAnimationEnd",transition:"animationend"};for(t in e)if(void 0!==i.style[t])return e[t];return"animationend"},d);function d(){this.notifications=[],this.events={},this.X_POSITION_FLEX_MAP={left:"flex-start",center:"center",right:"flex-end"},this.Y_POSITION_FLEX_MAP={top:"flex-start",center:"center",bottom:"flex-end"};var t=document.createDocumentFragment(),i=this._createHTMLElement({tagName:"div",className:"notyf"});t.appendChild(i),document.body.appendChild(t),this.container=i,this.animationEndEventName=this._getAnimationEndEventName(),this._createA11yContainer()}function l(t){var e=this;this.dismiss=this._removeNotification,this.notifications=new a,this.view=new p;var n=this.registerTypes(t);this.options=i(i({},c),t),this.options.types=n,this.notifications.onUpdate((function(t,i){return e.view.update(t,i)})),this.view.on(o.Dismiss,(function(t){var i=t.target;t=t.event;e._removeNotification(i),i.triggerEvent(o.Dismiss,t)})),this.view.on(o.Click,(function(t){var i=t.target;t=t.event;return i.triggerEvent(o.Click,t)}))}return l.prototype.error=function(t){return t=this.normalizeOptions("error",t),this.open(t)},l.prototype.success=function(t){return t=this.normalizeOptions("success",t),this.open(t)},l.prototype.open=function(t){var n=this.options.types.find((function(i){return i.type===t.type}))||{};n=i(i({},n),t);return this.assignProps(["ripple","position","dismissible"],n),n=new e(n),this._pushNotification(n),n},l.prototype.dismissAll=function(){for(;this.notifications.splice(0,1););},l.prototype.assignProps=function(t,i){var e=this;t.forEach((function(t){i[t]=(null==i[t]?e.options:i)[t]}))},l.prototype._pushNotification=function(t){var i=this;this.notifications.push(t);var e=(void 0!==t.options.duration?t:this).options.duration;e&&setTimeout((function(){return i._removeNotification(t)}),e)},l.prototype._removeNotification=function(t){-1!==(t=this.notifications.indexOf(t))&&this.notifications.splice(t,1)},l.prototype.normalizeOptions=function(t,e){return t={type:t},"string"==typeof e?t.message=e:"object"==typeof e&&(t=i(i({},t),e)),t},l.prototype.registerTypes=function(t){var e=(t&&t.types||[]).slice();return c.types.map((function(t){var n=-1;e.forEach((function(i,e){i.type===t.type&&(n=e)}));var o=-1!==n?e.splice(n,1)[0]:{};return i(i({},t),o)})).concat(e)},l}(),notyf=new Notyf({types:[{type:"success",background:"#1D6DAE",duration:3e3},{type:"error",background:"orange",duration:1e7,dismissible:!0}]});
 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="&times;",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","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(){"use strict";const e=e=>document.querySelector(e);async function t(){const t=e(".service-menu");if(!t)return;const n=[{href:"./index.pdf",title:"Download this page as a PDF",cls:"button-pdf-download"},{href:"./index.docx",title:"Download this page as a DOCX",cls:"button-docx-download"}],o=await Promise.all(n.map((e=>{return t=e.href,fetch(t,{method:"HEAD"}).then((e=>e.ok)).catch((()=>!1));var t})));let r=t.firstElementChild;n.forEach(((n,a)=>{if(!o[a])return;if(s=n.cls,e(`.service-menu .${s}`))return;var s;const c=function(e,t,n){const o=document.createElement("a");return o.classList.add(n,"btn","d-block","btn-sm","btn-outline-secondary"),o.target="_blank",o.rel="noopener noreferrer",o.href=e,o.title=t,o.setAttribute("aria-label",t),o.innerHTML='<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">      <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"/>    </svg>',o}(n.href,n.title,n.cls);t.insertBefore(c,r),r=c}))}window.SpecUpDownloads={addButtons:t},document.addEventListener("DOMContentLoaded",t,{once:!1});try{document.dispatchEvent(new CustomEvent("specup-downloads-ready"))}catch(e){}}();
 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.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()}));

package/assets/compiled/head.css

@@ -19,7 +19,7 @@ h2,h3,h4,h5,h6{margin-top:1.5em!important}#terminology-section-utility-container
 .hide-local-terms #content dl.terms-and-definitions-list>dd:not(.transcluded-xref-term),.hide-local-terms #content dl.terms-and-definitions-list>dt:not(.transcluded-xref-term){display:none!important}.hide-external-terms #content dl.terms-and-definitions-list>dd.transcluded-xref-term,.hide-external-terms #content dl.terms-and-definitions-list>dt.transcluded-xref-term{display:none!important}
 .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{transition:all .2s ease;border-radius:4px;cursor:pointer;font-weight:500;box-shadow:0 1px 3px rgba(0,0,0,.1);padding:5px}.button-pdf-download:hover{background-color:#e74c3c!important;border-color:#e74c3c!important;color:#fff!important;transform:translateY(-1px);box-shadow:0 3px 5px rgba(0,0,0,.15)}.button-pdf-download svg{vertical-align:middle;margin-right:4px}.button-pdf-download:active{transform:translateY(0);box-shadow:0 1px 2px rgba(0,0,0,.1)}
+.button-docx-download,.button-pdf-download{transition:all .2s ease;border-radius:4px;cursor:pointer;font-weight:500;box-shadow:0 1px 3px rgba(0,0,0,.1);padding:5px}.button-docx-download:hover,.button-pdf-download:hover{background-color:#e74c3c!important;border-color:#e74c3c!important;color:#fff!important;transform:translateY(-1px);box-shadow:0 3px 5px rgba(0,0,0,.15)}.button-docx-download svg,.button-pdf-download svg{vertical-align:middle;margin-right:4px}.button-docx-download:active,.button-pdf-download:active{transform:translateY(0);box-shadow:0 1px 2px rgba(0,0,0,.1)}
 .loader{width:20px;height:20px;margin:auto;display:block;text-align:center;border:8px solid #ccc;border-top-color:#3498db;border-radius:50%;animation:spin 1s linear infinite}.loadertext{text-align:center;margin:.5em 0}@keyframes spin{0%{transform:rotate(0)}100%{transform:rotate(360deg)}}
 article a[href^="https://"]:not(.btn)::after,article a[href^=http]:not(.btn)::after{content:'';width:12px;height:12px;margin-left:4px;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='currentColor' viewBox='0 0 16 16'%3E%3Cpath fill-rule='evenodd' d='M8.636 3.5a.5.5 0 0 0-.5-.5H1.5A1.5 1.5 0 0 0 0 4.5v10A1.5 1.5 0 0 0 1.5 16h10a1.5 1.5 0 0 0 1.5-1.5V7.864a.5.5 0 0 0-1 0V14.5a.5.5 0 0 1-.5.5h-10a.5.5 0 0 1-.5-.5v-10a.5.5 0 0 1 .5-.5h6.636a.5.5 0 0 0 .5-.5z'/%3E%3Cpath fill-rule='evenodd' d='M16 .5a.5.5 0 0 0-.5-.5h-5a.5.5 0 0 0 0 1h3.793L6.146 9.146a.5.5 0 1 0 .708.708L15 1.707V5.5a.5.5 0 0 0 1 0v-5z'/%3E%3C/svg%3E");background-position:center;background-repeat:no-repeat;background-size:contain;display:inline-block}
 #repo_issues>header{background:#eee;border-bottom:1px solid #ddd}#repo_issues>header span:first-of-type{font-weight:700;padding-top:.1em}#repo_issues>header .repo-issue-toggle{margin-left:auto;color:inherit;font-weight:700;text-decoration:none}#repo_issue_list{list-style:none;margin:0;padding:0 1.25em 1.25em;font-size:.85em;overflow:auto;-ms-overflow-style:none;scrollbar-width:none}#repo_issue_list::-webkit-scrollbar{display:none}#repo_issue_list:empty:before{content:"No issues found";display:block;text-align:center;font-size:1.1em;color:#aaa;margin:1em 0 0}.repo-issue detail-box{display:flex;flex-direction:column;padding:1em 0;border-bottom:1px solid #ddd}.repo-issue detail-box>section{order:1}.repo-issue detail-box>section:empty+.repo-issue-title [detail-box-toggle]{display:none}.repo-issue-title{display:flex;align-items:center}.repo-issue-link{flex:1;margin:0 0 0 .5em}.repo-issue-number{height:1em;margin:0 .4em 0 0;padding:.3em .25em 0;border-radius:3px;font-weight:700;background:#eee;border:1px solid #ddd;text-align:center;line-height:1em}.repo-issue-number:before{content:"#";font-weight:400;margin:0 .1em 0 0}.repo-issue [detail-box-toggle]{margin:0 0 0 1em;opacity:.35;transition:opacity .4s}.repo-issue [detail-box-toggle]:hover,.repo-issue detail-box[open] [detail-box-toggle]{opacity:1}
@@ -28,5 +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}}
+#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 .toc-anchor::after{counter-increment:main-section;content:" " counter(main-section) ".";font-weight:700}main article h3 .toc-anchor::after{counter-increment:main-subsection;content:" " counter(main-section) "." counter(main-subsection);font-weight:700}main article h4 .toc-anchor::after{counter-increment:main-subsubsection;content:" " counter(main-section) "." counter(main-subsection) "." counter(main-subsubsection);font-weight:700}main article h5::before,main article h6::before{font-weight:700;margin-right:.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 .toc-anchor::after,main article h3 .toc-anchor::after,main article h4 .toc-anchor::after{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

@@ -53,29 +53,23 @@ main article h3 {
   counter-reset: main-subsubsection;
 }
 
-/* Add numbering to main content headings */
-main article h2::before {
+/* Add numbering to main content headings after the anchor */
+main article h2 .toc-anchor::after {
   counter-increment: main-section;
-  content: counter(main-section) ". ";
+  content: " " counter(main-section) ".";
   font-weight: bold;
-  margin-right: 0.5em;
-  color: #007bff;
 }
 
-main article h3::before {
+main article h3 .toc-anchor::after {
   counter-increment: main-subsection;
-  content: counter(main-section) "." counter(main-subsection) " ";
+  content: " " counter(main-section) "." counter(main-subsection);
   font-weight: bold;
-  margin-right: 0.5em;
-  color: #007bff;
 }
 
-main article h4::before {
+main article h4 .toc-anchor::after {
   counter-increment: main-subsubsection;
-  content: counter(main-section) "." counter(main-subsection) "." counter(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 */
@@ -83,12 +77,6 @@ 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 */
@@ -96,9 +84,9 @@ main article h6::before {
   #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 {
+  main article h2 .toc-anchor::after,
+  main article h3 .toc-anchor::after,
+  main article h4 .toc-anchor::after {
     color: #000 !important;
   }
 }

package/assets/css/{pdf-download.css → download-pdf-docx.css}

@@ -1,7 +1,8 @@
 /**
- * PDF Download Button Styles
+ * Download Buttons (PDF/DOCX)
  */
-.button-pdf-download {
+.button-pdf-download,
+.button-docx-download {
   transition: all 0.2s ease;
   border-radius: 4px;
   cursor: pointer;
@@ -10,7 +11,8 @@
   padding: 5px;
 }
 
-.button-pdf-download:hover {
+.button-pdf-download:hover,
+.button-docx-download:hover {
   background-color: #e74c3c !important;
   border-color: #e74c3c !important;
   color: white !important;
@@ -18,12 +20,14 @@
   box-shadow: 0 3px 5px rgba(0,0,0,0.15);
 }
 
-.button-pdf-download svg {
+.button-pdf-download svg,
+.button-docx-download svg {
   vertical-align: middle;
   margin-right: 4px;
 }
 
-.button-pdf-download:active {
+.button-pdf-download:active,
+.button-docx-download:active {
   transform: translateY(0);
   box-shadow: 0 1px 2px rgba(0,0,0,0.1);
 }

package/assets/js/addAnchorsToTerms.js

@@ -28,7 +28,7 @@ function addAnchorsToTerms() {
         const a = document.createElement('a');
         a.setAttribute('href', `#${id}`);
         a.setAttribute('class', 'toc-anchor d-print-none');
-        a.innerHTML = '# '; // was '§';
+        a.innerHTML = (window.specConfig.anchor_symbol || '§') + ' ';
         dt.parentNode.insertBefore(a, dt);
     });
 }

package/assets/js/download-pdf-docx.js

@@ -0,0 +1,68 @@
+/**
+ * Adds download buttons for PDF and DOCX (when files exist next to the page).
+ * Buttons are inserted at the start of .service-menu, left-to-right as: PDF, DOCX.
+ * Idempotent: safe to call multiple times.
+ */
+(function () {
+  "use strict";
+
+  /** Small helpers */
+  const qs = (sel) => document.querySelector(sel);
+  const buttonExists = (cls) => !!qs(`.service-menu .${cls}`);
+  const checkExists = (url) =>
+    fetch(url, { method: "HEAD" })
+      .then((r) => r.ok)
+      .catch(() => false);
+
+  const fileIconSvg =
+    '<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">\
+      <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"/>\
+    </svg>';
+
+  function createButton(href, title, cls) {
+    const a = document.createElement("a");
+    a.classList.add(cls, "btn", "d-block", "btn-sm", "btn-outline-secondary");
+    a.target = "_blank";
+    a.rel = "noopener noreferrer";
+    a.href = href;
+    a.title = title;
+    a.setAttribute("aria-label", title);
+    a.innerHTML = fileIconSvg;
+    return a;
+  }
+
+  async function addButtons() {
+    const container = qs(".service-menu");
+    if (!container) return;
+
+    const items = [
+      { href: "./index.pdf", title: "Download this page as a PDF", cls: "button-pdf-download" },
+      { href: "./index.docx", title: "Download this page as a DOCX", cls: "button-docx-download" },
+    ];
+
+    const exists = await Promise.all(items.map((i) => checkExists(i.href)));
+
+    // Insert at the start keeping order as defined in items
+    let anchor = container.firstElementChild;
+    items.forEach((item, idx) => {
+      if (!exists[idx]) return;
+      if (buttonExists(item.cls)) return;
+      const btn = createButton(item.href, item.title, item.cls);
+      container.insertBefore(btn, anchor);
+      anchor = btn;
+    });
+  }
+
+  // Expose minimal global for backward compatibility shims
+  window.SpecUpDownloads = { addButtons };
+
+  // Auto-run on DOM ready (safe if called multiple times)
+  document.addEventListener("DOMContentLoaded", addButtons, { once: false });
+
+  // Signal readiness for shims that want to call in response
+  try {
+    document.dispatchEvent(new CustomEvent("specup-downloads-ready"));
+  } catch (_) {
+    // no-op: older browsers without CustomEvent constructor support
+  }
+})();

package/config/asset-map.json

@@ -18,7 +18,7 @@
       "assets/css/create-term-filter.css",
       "assets/css/modal.css",
       "assets/css/create-alphabet-index.css",
-      "assets/css/pdf-download.css",
+      "assets/css/download-pdf-docx.css",
       "assets/css/loader.css",
       "assets/css/external-links.css",
       "assets/css/repo-issues.css",
@@ -60,7 +60,7 @@
       "assets/js/notyf.js",
       "assets/js/modal.js",
       "assets/js/token-input.js",
-      "assets/js/pdf-download.js",
+      "assets/js/download-pdf-docx.js",
       "assets/js/insert-trefs.js",
       "assets/js/collapse-definitions.js",
       "assets/js/create-term-filter.js",

package/index.js

@@ -191,7 +191,7 @@ module.exports = async function (options = {}) {
         tocFirstLevel: 2,
         tocLastLevel: 4,
         tocCallback: (_md, _tokens, html) => toc = html,
-        anchorLinkSymbol: '#', // was: §
+        anchorLinkSymbol: config.specs[0].anchor_symbol || '§',
         anchorClassName: 'toc-anchor d-print-none'
       })
       .use(require('@traptitech/markdown-it-katex'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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/install-from-boilerplate/boilerplate/.github/workflows/menu.yml

@@ -3,23 +3,27 @@ name: Run Menu
 on:
   workflow_dispatch:
     inputs:
-      script:
-        description: 'Select the script to run'
-        type: choice
+      action_type:
+        description: 'Action to perform'
         required: true
-        default: 'Render specification'
+        default: 'render'
+        type: choice
         options:
-          - Add content
-          - Render specification
-          - Export to PDF
-          - Export to DOCX
-          - Collect external references
-          - Add, remove or view xref source
-          - Configure
-          - Run health check
-          - Open documentation website
-          - Freeze specification
-          - Custom update
+          - render
+          - topdf
+          - todocx
+          - freeze
+          - custom-update
+          - collectExternalReferences
+      repository:
+        description: 'Repository'
+        required: false
+      branch:
+        description: 'Branch'
+        required: false
+      triggered_by:
+        description: 'Triggered by'
+        required: false
 
 jobs:
   build-and-deploy-spec:
@@ -58,106 +62,79 @@ jobs:
         env:
           MY_PAT: ${{ secrets.MY_PAT }} # Make the secret available as an env var
         run: |
-          case "${{ github.event.inputs.script }}" in
-            "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"
+          case "${{ github.event.inputs.action_type }}" in
+            render)
+              npm run render
               ;;
-            "Render specification")
-              node --no-warnings -e "require('spec-up-t/index.js')({ nowatch: true })"
-              git config --global user.email "actions@github.com"
-              git config --global user.name "GitHub Actions"
-              git add .
-              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
+            topdf)
+              npm run topdf
               ;;
-            # ...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
+            todocx)
+              npm run todocx
               ;;
-            "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"
-              git config --global user.name "GitHub Actions"
-              git add .
-              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
+            freeze)
+              npm run freeze
               ;;
-            "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 "Export to PDF" || echo "No changes to commit"
-              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
+            custom-update)
+              npm run custom-update
               ;;
-            "Freeze specification")
-              node -e "require('spec-up-t/src/freeze.js')"
-              git config --global user.email "actions@github.com"
-              git config --global user.name "GitHub Actions"
-              git add .
-              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
+            collectExternalReferences)
+              npm run collectExternalReferences
+              ;;
+            *)
+              echo "Unknown action_type: ${{ github.event.inputs.action_type }}"
+              exit 1
+              ;;
+          esac
+
+      - name: Commit and push changes
+        if: success()
+        run: |
+          git config --global user.email "actions@github.com"
+          git config --global user.name "GitHub Actions"
+          
+          # Add all changes
+          git add .
+          
+          # Commit with appropriate message
+          case "${{ github.event.inputs.action_type }}" in
+            render)
+              git commit -m "Render specification: Update files" || echo "No changes to commit"
               ;;
-            "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
+            topdf)
+              git commit -m "Export to PDF" || echo "No changes to commit"
               ;;
-            "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
+            todocx)
+              git commit -m "Export to DOCX" || echo "No changes to commit"
               ;;
-            "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
+            collectExternalReferences)
+              git commit -m "Collect external references" || echo "No changes to commit"
               ;;
-            "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/"
+            freeze)
+              git commit -m "Freeze specification" || echo "No changes to commit"
               ;;
-            "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"
-              git config --global user.name "GitHub Actions"
-              git add .
+            custom-update)
               git commit -m "Custom update: Copy files from spec-up-t" || echo "No changes to commit"
-              git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
               ;;
             *)
-              echo "Unknown script: ${{ github.event.inputs.script }}"
-              exit 1
+              git commit -m "Update files: ${{ github.event.inputs.action_type }}" || echo "No changes to commit"
               ;;
           esac
+          
+          # Push changes
+          git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
 
-      - name: Deploy to GitHub Pages
-        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 }}
-          publish_dir: ${{ env.OUTPUT_PATH }}
-          allow_empty_commit: true
-          force_orphan: true
+      - name: Commit output files
+        if: success()
+        run: |
+          git config --global user.email "actions@github.com"
+          git config --global user.name "GitHub Actions"
+          git add "$OUTPUT_PATH"
+          git commit -m "Update output files in $OUTPUT_PATH" || echo "No changes to commit in output directory"
+          git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:main
 
       - name: Clean up
         if: always()
         run: |
           echo "Cleaning up..."
-          rm -rf node_modules
+          rm -rf node_modules

package/src/install-from-boilerplate/boilerplate/spec/spec-head.md

@@ -4,4 +4,4 @@
 
 This is a default Spec-Up-T installation. Find information on the [Spec-Up-T documentation website](https://blockchainbird.github.io/spec-up-t-website/).
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+This is a demo site for Spec-Up-T. The subject matter – gardening and related terms – is used purely as an example to demonstrate how the system works. You can replace these demo terms and definitions with your own content to suit your documentation needs.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/composability.md

@@ -0,0 +1,3 @@
+[[tref: KERISuite, composability ]]
+
+~ Note: composability is not the same as compostability.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/compost.md

@@ -0,0 +1,3 @@
+[[def: compost, composting, Compost]]
+
+~ Compost is a mixture of decayed organic matter used to fertilize soil. It is created through the process of composting, where materials like leaves, food scraps, and grass clippings break down over time. Compost improves soil structure and provides nutrients for plants. See also [[ref: Mulch]], [[ref: Soil]], [[ref: Fertilizer]], [[ref: Seedling]], [[ref: Watering]].

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/fertilizer.md

@@ -0,0 +1,3 @@
+[[def: fertilizer, fertilizing, Fertilizer]]
+
+~ Fertilizer is a substance added to soil or plants to supply essential nutrients and promote growth. Fertilizers can be organic, like compost, or synthetic. Proper fertilizing ensures healthy plant development. See also [[ref: Compost]], [[ref: Mulch]], [[ref: Soil]], [[ref: Watering]], [[ref: Seedling]].

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/mulch.md

@@ -0,0 +1,3 @@
+[[def: mulch, mulching, Mulch]]
+
+~ Mulch is a layer of material, such as wood chips or straw, spread on the surface of soil to retain moisture, suppress weeds, and regulate temperature. Mulching helps improve plant health and soil quality. Related terms: [[ref: Compost]], [[ref: Soil]], [[ref: Fertilizer]].

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/pruning.md

@@ -0,0 +1,3 @@
+[[def: pruning, Pruning]]
+
+~ Pruning is the practice of trimming plants by cutting away dead or overgrown branches or stems. Pruning encourages healthy growth and improves the shape of plants. See also [[ref: Seedling]], [[ref: Watering]].

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/seedling.md

@@ -0,0 +1,3 @@
+[[def: seedling, seedlings, Seedling]]
+
+~ A seedling is a young plant that has recently sprouted from a seed. Seedlings are delicate and require proper soil, water, and light to grow into mature plants. See also [[ref: Soil]], [[ref: Compost]], [[ref: Watering]].

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/soil.md

@@ -0,0 +1,11 @@
+[[def: soil, soils, Soil]]
+
+~ Soil is the upper layer of earth in which plants grow. It consists of a mixture of organic matter, minerals, gases, liquids, and organisms that together support life. Healthy soil is essential for gardening and agriculture.
+
+~ Refs examples: [[ref: Compost]], [[ref: Mulch]], [[ref: Fertilizer]].
+
+~ Xref example: [[xref: KERISuite, composability ]]
+
+~ This Xref example does not work: [[xref: does-not-exist, Foo]]
+
+~ Soil quality affects water retention, nutrient availability, and plant health. Amending soil with compost or mulch can improve its structure and fertility. Fertilizer may be added to supplement nutrients as needed.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/watering.md

@@ -0,0 +1,3 @@
+[[def: watering, Watering]]
+
+~ Watering is the act of supplying water to plants to help them grow. Proper watering is essential for healthy roots and overall plant development. Overwatering or underwatering can harm plants. See also [[ref: Soil]], [[ref: Seedling]], [[ref: Mulch]].

package/src/install-from-boilerplate/boilerplate/specs.json

@@ -23,19 +23,32 @@
             },
             "external_specs": [
                 {
-                    "external_spec": "test-1",
-                    "gh_page": "https://blockchainbird.github.io/spec-up-xref-test-1/",
-                    "url": "https://github.com/blockchainbird/spec-up-xref-test-1",
-                    "terms_dir": "spec/term-definitions"
+                    "external_spec": "vLEI",
+                    "gh_page": "https://henkvancann.github.io/vlei-glossary/",
+                    "url": "https://github.com/henkvancann/vlei-glossary",
+                    "terms_dir": "spec/terms-definitions"
                 },
                 {
-                    "external_spec": "test-2",
-                    "gh_page": "https://blockchainbird.github.io/spec-up-xref-test-2/",
-                    "url": "https://github.com/blockchainbird/spec-up-xref-test-2",
-                    "terms_dir": "spec/term-definitions"
+                    "external_spec": "KERISuite",
+                    "gh_page": "https://weboftrust.github.io/kerisuite-glossary/",
+                    "url": "https://github.com/weboftrust/kerisuite-glossary",
+                    "terms_dir": "spec/terms-definitions"
+                },
+                {
+                    "external_spec": "ToIP",
+                    "gh_page": "https://glossary.trustoverip.org/",
+                    "url": "https://github.com/trustoverip/ctwg-main-glossary",
+                    "terms_dir": "spec/terms-definitions"
+                },
+                {
+                    "external_spec": "GenIT",
+                    "gh_page": "https://trustoverip.github.io/ctwg-general-glossary/",
+                    "url": "https://github.com/trustoverip/ctwg-general-glossary",
+                    "terms_dir": "spec/terms-definitions"
                 }
             ],
-            "katex": false
+            "katex": false,
+            "anchor_symbol": "§"
         }
     ]
 }

package/src/install-from-boilerplate/config-system-files.js

@@ -2,7 +2,6 @@ const systemFiles = [
     'README.md',
     '.env.example',
     '.github/workflows/menu.yml',
-    '.github/workflows/render-specs.yml',
     '.github/workflows/set-gh-pages.yml',
     'assets/test.json',
     'assets/test.text',

package/assets/js/pdf-download.js

@@ -1,46 +0,0 @@
-/**
- * @author Kor Dwarshuis
- * @contact kor@dwarshuis.com
- * @created 2024-09-07
- * @description This script adds a button next to the search bar that allows users to download the page as a PDF.
- */
-
-function pdfDownload() {
-   fetch('./index.pdf', { method: 'HEAD' })
-      .then(response => {
-         if (response.ok) {
-            let buttonPdfDownload = document.createElement("a");
-            buttonPdfDownload.classList.add("button-pdf-download");
-            buttonPdfDownload.classList.add("btn", "d-block", "btn-sm", "btn-outline-secondary");
-            buttonPdfDownload.target = "_blank";
-            buttonPdfDownload.rel = "noopener noreferrer";
-            buttonPdfDownload.href = "./index.pdf";
-            buttonPdfDownload.title = "Download this page as a PDF";
-            
-            // Add PDF icon with transparent fill and text for better visual representation
-            buttonPdfDownload.innerHTML = `
-               <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">
-                  <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"/>
-                  <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"/>
-               </svg>
-            `;
-            
-            // Add additional styling directly to the button
-            buttonPdfDownload.style.display = "inline-flex";
-            buttonPdfDownload.style.alignItems = "center";
-            buttonPdfDownload.style.justifyContent = "center";
-            
-            document.querySelector('.service-menu').prepend(buttonPdfDownload);
-         } else {
-            console.log('PDF file does not exist. No PDF download button will be added.');
-         }
-      })
-      .catch(error => {
-         console.error('Error checking PDF file:', error);
-      });
-
-}
-
-document.addEventListener("DOMContentLoaded", function () {
-   pdfDownload();
-});

package/src/install-from-boilerplate/boilerplate/.github/workflows/fetch-and-push-xrefs.yml.old

@@ -1,42 +0,0 @@
-
-name: fetch and push xrefs
-
-on:
-  # push:
-  #   branches:
-  #     - main
-  workflow_dispatch:
-
-jobs:
-  build-and-deploy-spec:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - name: Checkout 🛎️
-        uses: actions/checkout@v3
-        with:
-          persist-credentials: false
-
-      - name: Install and Build 🔧 # This example project is built using npm and outputs the result to the 'build' folder. Replace with the commands required to build your project, or remove this step entirely if your site is pre-built.
-        run: |
-          echo "start install"
-          npm install
-          echo "end install"
-          echo "Spec-Up-T version:"
-          npm list spec-up-t
-          echo "start fetching xrefs"
-          node -e "require('spec-up-t/src/get-xrefs-data.js').updateXrefs()"
-          rm -rf node_modules
-      
-      - name: Commit and Push Changes
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
-          git add .
-          git commit -m "Update Xrefs data via Github Action" || echo "No changes to commit"
-          git push https://x-access-token:${GITHUB_TOKEN}@github.com/${{ github.repository }} HEAD:refs/heads/main
-
-          

package/src/install-from-boilerplate/boilerplate/.github/workflows/render-specs.yml

@@ -1,47 +0,0 @@
-
-name: spec-up-t render
-
-on:
-  # push:
-  #   branches:
-  #     - main
-  workflow_dispatch:
-
-jobs:
-  build-and-deploy-spec:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - name: Checkout 🛎️
-        uses: actions/checkout@v2
-        with:
-          persist-credentials: false
-      - name: Extract output_path from JSON
-        # TODO: .specs[0] is a hack to get the first spec. This should be fixed.
-        run: |
-          OUTPUT_PATH=$(jq -r '.specs[0].output_path' specs.json)
-          echo "OUTPUT_PATH=$OUTPUT_PATH" >> $GITHUB_ENV
-
-      - name: Install and Build 🔧 # This example project is built using npm and outputs the result to the 'build' folder. Replace with the commands required to build your project, or remove this step entirely if your site is pre-built.
-        run: |
-          echo "start install"
-          npm install
-          echo "end install"
-          echo "Spec-Up-T version:"
-          npm list spec-up-t
-          echo "start render"
-          node -e "require('spec-up-t')({ nowatch: true })"
-          echo "end render"
-          rm -rf node_modules
-
-      # This is a GitHub Action to deploy your static files to GitHub Pages
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3.7.3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ${{ env.OUTPUT_PATH }} # Use the OUTPUT_PATH environment variable
-          allow_empty_commit: true
-          force_orphan: true
-
-          

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/term-1.md

@@ -1,13 +0,0 @@
-[[def: term 1, term one, Term One]]
-
-~ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum faucibus volutpat justo, sed ornare velit.
-
-~ Refs examples: [[ref: Term 2]], [[ref: Term Two]], [[ref: Term 3]].
-
-~ Xref example: [[xref: test-1, Aal]]
-
-~ This Xref example does not work: [[xref: does-not-exist, Foo]]
-
-~ Donec aliquam et ligula id congue. Sed eu urna et tellus placerat viverra. Quisque ut posuere magna, nec accumsan augue. Nullam mauris tortor, semper finibus elementum maximus, imperdiet in felis. Suspendisse quis imperdiet nibh, eget ultrices justo. Pellentesque vitae malesuada justo. Vestibulum quis scelerisque lectus, non rutrum odio. Aenean leo orci, semper non massa sed, facilisis ornare ipsum. Morbi at sem orci. Integer eros mi, faucibus sed lorem id, pharetra imperdiet nisl. Integer viverra enim vel luctus lobortis. Ut turpis tellus, consequat nec lectus et, dictum elementum nunc. Integer rhoncus venenatis molestie. Donec egestas condimentum ligula in porttitor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
-
-~ Extra text for testing purposes.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/term-2.md

@@ -1,3 +0,0 @@
-[[def: term 2, term two, Term Two]]
-
-~ Pellentesque suscipit ipsum varius, mattis diam in, elementum nunc [[ref: Term 1]], [[ref: Term Three]], [[ref: Term 3]], [[ref: Term 4]]. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec placerat, elit sed tempor viverra, magna ligula porttitor tortor, eget suscipit erat enim vel nisl. Integer vel urna in quam viverra dignissim at in orci. Aliquam erat volutpat. Nam vitae neque nibh. In sollicitudin felis vitae ex finibus, in eleifend lectus efficitur. Vestibulum enim ex, condimentum nec accumsan ut, vestibulum at lacus. Maecenas non vulputate ante. Sed porttitor et eros sit amet venenatis.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/term-3.md

@@ -1,3 +0,0 @@
-[[def: term 3, term three, Term Three]]
-
-~ Nam euismod augue sed tempus imperdiet. Pellentesque ac porta ipsum, sed sodales leo. Suspendisse molestie est sit amet est porta, sit amet molestie dolor pharetra. Duis porta mollis sem vel aliquam. Maecenas laoreet turpis nunc, vitae mattis urna auctor ac. Donec mattis quis urna nec porta. Sed sit amet viverra ligula. Vivamus vitae sem sodales, malesuada dui sit amet, viverra lectus. Integer ullamcorper molestie ante, in blandit nunc tempus auctor.

package/src/install-from-boilerplate/boilerplate/spec/terms-definitions/term-4.md

@@ -1,3 +0,0 @@
-[[def: term 4, term four, Term Four]]
-
-~ Sed lorem nunc, ultricies nec nibh eu, bibendum sollicitudin arcu. Nullam porttitor condimentum elit ac commodo. Aenean ac augue quis arcu congue aliquam vitae in massa. Aliquam erat volutpat. Curabitur lobortis, sapien vitae mattis dignissim, risus augue iaculis risus, sed tempus sapien ex nec massa. Integer quis maximus nunc. Nunc ultrices sapien erat, at congue augue mattis sit amet. Aliquam condimentum luctus nunc, ut euismod augue commodo in.