hdoc-tools 0.41.5 → 0.41.7

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "hdoc-tools",
-	"version": "0.41.5",
+	"version": "0.41.7",
 	"description": "Hornbill HDocBook Development Support Tool",
 	"main": "hdoc.js",
 	"bin": {

package/ui/css/theme-default/styles/base.css

@@ -36,6 +36,8 @@ main {
   display: block;
 }
 
+
+/* NWJ - comment out while test gerrys chatgpt styles
 h1,
 h2,
 h3,
@@ -44,9 +46,10 @@ h5,
 h6 {
   margin: 0;
   line-height: normal;
-  font-size: revert; /* let browser handle it */
+  font-size: revert; 
   font-weight: 400;
 }
+*/
 
 p {
   margin: 0;
@@ -229,3 +232,59 @@ p {
   overflow-wrap: break-word;
 }
 
+/* billythefish */
+/* styles from gerrys chatgpt recommendation */
+/* Base (adjust if your body size differs) */
+html { font-size: 16px; }
+:root{
+  /* Tweak the min/max to taste; ratio ≈ 1.25 across levels */
+  --h1-min: 2.0rem;  --h1-max: 3.0rem;   /* 32–48 */
+  --h2-min: 1.6rem;  --h2-max: 2.25rem;  /* 25.6–36 */
+  --h3-min: 1.35rem; --h3-max: 1.8rem;   /* 21.6–28.8 */
+  --h4-min: 1.15rem; --h4-max: 1.45rem;  /* 18.4–23.2 */
+  --h5-min: 1.05rem; --h5-max: 1.2rem;   /* 16.8–19.2 */
+  --h6-min: 0.95rem; --h6-max: 1.05rem;  /* 15.2–16.8 */
+}
+h1,h2,h3,h4,h5,h6{
+  font-family: var(--hb-heading, inherit);
+  line-height: 1.15;
+  margin-top: 2.2em;      /* consistent vertical rhythm */
+  margin-bottom: 0.6em;
+  letter-spacing: 0;
+}
+h1{
+  font-size: clamp(var(--h1-min), 2vw + 1rem, var(--h1-max));
+  font-weight: 750;       /* strong but not shouty */
+  line-height: 1.1;
+  margin-top: 0;          /* article title at top */
+}
+h2{
+  font-size: clamp(var(--h2-min), 1.5vw + 0.9rem, var(--h2-max));
+  font-weight: 700;
+  border-bottom: 1px solid color-mix(in srgb, currentColor 12%, transparent);
+  padding-bottom: 0.2em;
+}
+h3{
+  font-size: clamp(var(--h3-min), 1.2vw + 0.7rem, var(--h3-max));
+  font-weight: 650;
+}
+h4{
+  font-size: clamp(var(--h4-min), 0.8vw + 0.65rem, var(--h4-max));
+  font-weight: 600;
+}
+h5{
+  font-size: clamp(var(--h5-min), 0.6vw + 0.6rem, var(--h5-max));
+  font-weight: 550;
+  color: color-mix(in srgb, currentColor 85%, #000 15%);
+}
+h6{
+  font-size: clamp(var(--h6-min), 0.4vw + 0.55rem, var(--h6-max));
+  font-weight: 600;
+  text-transform: uppercase;       /* differentiate without shrinking */
+  letter-spacing: 0.06em;
+  color: color-mix(in srgb, currentColor 70%, #000 30%);
+}
+/* Better anchor linking with fixed headers/ToC */
+:where(h1,h2,h3,h4,h5,h6){ scroll-margin-top: 96px; }
+/* Tighten multi-line large headings */
+h1, h2 { hyphens: auto; }

package/ui/css/theme-default/styles/components/api-doc.css

@@ -51,16 +51,27 @@ api-param-name {
     font-style: italic;
     font-weight: 600;
   }
+
   api-param-optional:before {
     content: "Optional [default=";
     font-style: normal;
     font-weight: 400;
   }
+
   api-param-optional:after {
-    font-style: normal;
     content: "]";
+    font-style: normal;
     font-weight: 400;
   }
+
+  /* If no default provided */
+  api-param-optional[no-default-value]:before {
+    content: "Optional";
+  }
+
+  api-param-optional[no-default-value]:after {
+    content: "";
+  }
   
   /* API parameter description block */
   api-param-desc {

package/ui/css/theme-default/styles/components/htl-doc.css

@@ -2,6 +2,7 @@
  * Headings
  * -------------------------------------------------------------------------- */
 
+ /* NWJ - comment out while test gerrys chatgpt styles
 .HTL-doc h1,
 .HTL-doc h2,
 .HTL-doc h3,
@@ -39,10 +40,8 @@
   font-size: 18px;
   left: -25px;
   top: 52%;
-  width: 32px;
-  /*so will over lap headre slightly - stops flicker when hover out of header into anchor */
+  width: 32px;  
   opacity: 0;
-  /*hidden */
 }
 
 .HTL-doc h3 .header-anchor {
@@ -51,10 +50,9 @@
   left: -25px;
   top: 5px;
   width: 32px;
-  /*so will over lap headre slightly - stops flicker when hover out of header into anchor */
   opacity: 0;
-  /*hidden */
 }
+*/
 
 
 .HTL-doc h1:hover .header-anchor,
@@ -66,6 +64,7 @@
   opacity: 1;
 }
 
+/* NWJ - comment out while test gerrys chatgpt styles
 @media (min-width: 768px) {
   .HTL-doc h1 {
     letter-spacing: -0.02em;
@@ -73,6 +72,7 @@
     font-size: 32px;
   }
 }
+*/
 
 /**
   * Paragraph and inline elements

package/ui/index.html

@@ -47,6 +47,16 @@
             }
             customElements.define("api-param-name", APIParamName);
 
+            class ApiParamOptional extends HTMLElement {
+                connectedCallback() {
+                    const text = (this.textContent || '').trim();
+                    if (!text) {
+                    this.innerHTML = ''; // remove content
+                    this.setAttribute('no-default-value', '');
+                    }
+                }
+            }
+            customElements.define('api-param-optional', ApiParamOptional);
 
             var ThemePreference = localStorage.getItem('hdocbook-theme-appearance') || '';
             const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches

package/ui/js/doc.hornbill.js

@@ -258,8 +258,12 @@ function loadContentUrl(
 	fromPopState,
 	fromBook = true,
 ) {
-	
-	
+	let downloadFile = false;
+	if (linkRef.includes('_books/')) {
+		downloadFile = linkRef.split('').length > 1;
+		console.log('downloadFile', downloadFile);
+	}
+
 	//-- clear table of contents
 	view.docApp.tableOfContents = [];
 	let clean_linkRef = linkRef;
@@ -271,23 +275,30 @@ function loadContentUrl(
 	clean_linkRef = removeTrailingSlash(clean_linkRef);
 	//-- remove starting / if link starts with it
 	clean_linkRef = removeStartingSlash(clean_linkRef);
-
-	//-- update url in browser
-	if (fromBook)
-		setBrowserViewUrl(clean_linkRef, {}, fromPageRefresh, fromPopState);
-	//-- destroy any existing content children and events properly
-	jqContentContainer.empty();
-	jqDocumentHeader.find(".document-title").empty();
-
-	//-- for now just load whatever the href prop is (we can add actions to perform specific processing and then load content based on element atts etc)
-	let frontmatterData = {};
+	
 	let booksLinkRef = clean_linkRef;
 	if (fromBook) {
 		booksLinkRef = clean_linkRef.includes("_books/")
 			? clean_linkRef
 			: `_books/${clean_linkRef}`;
 	}
-	fetch(booksLinkRef)
+
+	if (downloadFile) {
+		//-- open in new tab to download
+		window.open(booksLinkRef, '_blank');
+	} else {
+		//-- update url in browser
+		if (fromBook) {
+			setBrowserViewUrl(clean_linkRef, {}, fromPageRefresh, fromPopState);
+		}
+		
+		//-- destroy any existing content children and events properly
+		jqContentContainer.empty();
+		jqDocumentHeader.find(".document-title").empty();
+	
+		//-- for now just load whatever the href prop is (we can add actions to perform specific processing and then load content based on element atts etc)
+		let frontmatterData = {};
+		fetch(booksLinkRef)
 		.then((response) => {
 			if (response.headers.has("X-frontmatter")) {
 				frontmatterData = response.headers.get("X-frontmatter");
@@ -417,6 +428,8 @@ function loadContentUrl(
 
 			listenForHrefClicks();
 		});
+	}
+	
 }
 
 function setGitHubBookUrl(linkRef) {
@@ -625,6 +638,7 @@ Vue.component("nav-section-component", {
 	},
 });
 
+
 const hslDocLog = {
 	_entry: [],
 	log: function (strMessage, varData) {