@t8/docsgen 0.4.20 → 0.4.22

package/dist/bin.js

@@ -432,12 +432,16 @@ function getPreviewContent(url, title) {
   let { pathname, searchParams } = new URL(url);
   let sandboxId = pathname.split("/").at(-1);
   let file = searchParams.get("file");
+  let height = searchParams.get("h");
   let previewURL = new URL(`https://codesandbox.io/embed/${sandboxId}`);
-  let previewContent = title ? `<legend>${title}</legend>` : "";
+  let content = title ? `<legend>${title}</legend>` : "";
   previewURL.searchParams.set("view", "preview");
   if (file) previewURL.searchParams.set("module", file);
-  previewContent += `<iframe src="${previewURL.href}"${title ? ` title="${title}"` : ""} sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts" loading="lazy"></iframe>`;
-  return previewContent;
+  let attrs = [`src="${previewURL.href}"`];
+  if (title) attrs.push(`title="${title}"`);
+  if (height) attrs.push(`style="height: ${height}px;"`);
+  content += `<iframe ${attrs.join(" ")} sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts" loading="lazy"></iframe>`;
+  return content;
 }
 function getSectionPostprocess(linkMap) {
   return (content) => {
@@ -445,11 +449,17 @@ function getSectionPostprocess(linkMap) {
     for (let a of document.querySelectorAll("a")) {
       let href = a.getAttribute("href");
       if (href === null) continue;
-      if (isPreviewURL(href) && a.parentElement) {
+      if (isPreviewURL(href)) {
         let preview = document.createElement("fieldset");
         preview.innerHTML = getPreviewContent(href, a.innerHTML);
-        a.parentElement.insertBefore(preview, a);
-        a.remove();
+        let p = a.closest("p");
+        if (p?.parentElement) {
+          p.parentElement.insertBefore(preview, p);
+          if (a.nextElementSibling?.matches("br"))
+            a.nextElementSibling.remove();
+          a.remove();
+          if (p.innerHTML.trim() === "") p.remove();
+        }
       } else {
         let nextHref = linkMap[href] ?? href;
         a.setAttribute("href", nextHref);

package/dist/css/section.css

@@ -252,6 +252,7 @@ main h2:first-child {
 }
 main fieldset {
   border: 0.05em solid var(--secondary-color);
+  margin: var(--block-margin-y) 0;
 }
 main fieldset legend {
   font-size: 0.8em;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/docsgen",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "description": "",
   "main": "dist/bin.js",
   "type": "module",

package/src/bin/parsing/getSectionPostprocess.ts

@@ -7,18 +7,25 @@ function isPreviewURL(url: string) {
 function getPreviewContent(url: string, title?: string) {
   let { pathname, searchParams } = new URL(url);
   let sandboxId = pathname.split("/").at(-1);
+
   let file = searchParams.get("file");
+  let height = searchParams.get("h");
 
   let previewURL = new URL(`https://codesandbox.io/embed/${sandboxId}`);
-  let previewContent = title ? `<legend>${title}</legend>` : "";
+  let content = title ? `<legend>${title}</legend>` : "";
 
   previewURL.searchParams.set("view", "preview");
 
   if (file) previewURL.searchParams.set("module", file);
 
-  previewContent += `<iframe src="${previewURL.href}"${title ? ` title="${title}"` : ""} sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts" loading="lazy"></iframe>`;
+  let attrs = [`src="${previewURL.href}"`];
+
+  if (title) attrs.push(`title="${title}"`);
+  if (height) attrs.push(`style="height: ${height}px;"`);
 
-  return previewContent;
+  content += `<iframe ${attrs.join(" ")} sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts" loading="lazy"></iframe>`;
+
+  return content;
 }
 
 export function getSectionPostprocess(
@@ -32,17 +39,28 @@ export function getSectionPostprocess(
 
       if (href === null) continue;
 
-      if (isPreviewURL(href) && a.parentElement) {
+      if (isPreviewURL(href)) {
         let preview = document.createElement("fieldset");
 
         preview.innerHTML = getPreviewContent(href, a.innerHTML);
 
-        a.parentElement.insertBefore(preview, a);
-        a.remove();
+        let p = a.closest("p");
+
+        if (p?.parentElement) {
+          p.parentElement.insertBefore(preview, p);
+
+          if (a.nextElementSibling?.matches("br"))
+            a.nextElementSibling.remove();
+
+          a.remove();
+
+          if (p.innerHTML.trim() === "") p.remove();
+        }
       } else {
         let nextHref = linkMap[href] ?? href;
 
         a.setAttribute("href", nextHref);
+
         if (/^(https?:)?\/\//.test(nextHref))
           a.setAttribute("target", "_blank");
       }

package/src/css/section.css

@@ -252,6 +252,7 @@ main h2:first-child {
 }
 main fieldset {
   border: 0.05em solid var(--secondary-color);
+  margin: var(--block-margin-y) 0;
 }
 main fieldset legend {
   font-size: 0.8em;