@t8/docsgen 0.4.21 → 0.4.23

package/dist/bin.js

@@ -432,12 +432,37 @@ 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 isEmpty(element) {
+  return element.innerHTML.trim() === "";
+}
+function insertPreview(preview, a) {
+  let p = a.closest("p");
+  if (p?.parentElement) {
+    p.parentElement.insertBefore(preview, p);
+    if (a.nextElementSibling?.matches("br")) a.nextElementSibling.remove();
+    a.remove();
+    if (isEmpty(p)) p.remove();
+    return;
+  }
+  let li = a.closest("li");
+  let list = li?.closest("ul, ol");
+  if (li && list?.parentElement) {
+    list.parentElement.insertBefore(preview, list);
+    a.remove();
+    if (isEmpty(li)) li.remove();
+    if (isEmpty(list)) list.remove();
+  }
 }
 function getSectionPostprocess(linkMap) {
   return (content) => {
@@ -448,14 +473,7 @@ function getSectionPostprocess(linkMap) {
       if (isPreviewURL(href)) {
         let preview = document.createElement("fieldset");
         preview.innerHTML = getPreviewContent(href, a.innerHTML);
-        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();
-        }
+        insertPreview(preview, a);
       } else {
         let nextHref = linkMap[href] ?? href;
         a.setAttribute("href", nextHref);

package/package.json

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

package/src/bin/parsing/getSectionPostprocess.ts

@@ -7,18 +7,57 @@ 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;"`);
+
+  content += `<iframe ${attrs.join(" ")} sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts" loading="lazy"></iframe>`;
 
-  return previewContent;
+  return content;
+}
+
+function isEmpty(element: Element) {
+  return element.innerHTML.trim() === "";
+}
+
+function insertPreview(preview: HTMLElement, a: HTMLAnchorElement) {
+  let p: HTMLElement | null = a.closest("p");
+
+  if (p?.parentElement) {
+    p.parentElement.insertBefore(preview, p);
+
+    if (a.nextElementSibling?.matches("br")) a.nextElementSibling.remove();
+
+    a.remove();
+
+    if (isEmpty(p)) p.remove();
+
+    return;
+  }
+
+  let li = a.closest("li");
+  let list = li?.closest("ul, ol");
+
+  if (li && list?.parentElement) {
+    list.parentElement.insertBefore(preview, list);
+
+    a.remove();
+
+    if (isEmpty(li)) li.remove();
+    if (isEmpty(list)) list.remove();
+  }
 }
 
 export function getSectionPostprocess(
@@ -37,22 +76,12 @@ export function getSectionPostprocess(
 
         preview.innerHTML = getPreviewContent(href, a.innerHTML);
 
-        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();
-        }
+        insertPreview(preview, a);
       } else {
         let nextHref = linkMap[href] ?? href;
 
         a.setAttribute("href", nextHref);
+
         if (/^(https?:)?\/\//.test(nextHref))
           a.setAttribute("target", "_blank");
       }