@t8/docsgen 0.1.17 → 0.1.19

package/dist/bin.js

@@ -104,6 +104,15 @@ function getLocation(ctx, path, preferredLocation) {
   return path;
 }
 
+// src/bin/stripHTML.ts
+var import_jsdom = require("jsdom");
+function stripHTML(content) {
+  try {
+    return new import_jsdom.JSDOM(content).window.document.body.textContent;
+  } catch {
+  }
+}
+
 // src/bin/toRepoURL.ts
 function toRepoURL(x) {
   if (!x) return "";
@@ -143,6 +152,22 @@ async function addMetadata(config2) {
     return config2;
   }
 }
+function deriveMissingProps(config2) {
+  let { dir, root, title, htmlTitle } = config2;
+  if (htmlTitle && !title) title = stripHTML(htmlTitle);
+  if (dir && !root) root = `/${dir}/`;
+  if (!root?.endsWith("/")) root = `${root ?? ""}/`;
+  return {
+    ...config2,
+    dir,
+    root,
+    title,
+    htmlTitle
+  };
+}
+async function reviseConfig(config2) {
+  return deriveMissingProps(await addMetadata(config2));
+}
 var config = null;
 async function getConfig() {
   if (config) return config;
@@ -165,9 +190,8 @@ async function getConfig() {
     ...A(args)
   };
   if (config.entries)
-    config.entries = await Promise.all(config.entries.map(addMetadata));
-  else await addMetadata(config);
-  if (!config.root?.endsWith("/")) config.root = `${config.root ?? ""}/`;
+    config.entries = await Promise.all(config.entries.map(reviseConfig));
+  else config = await reviseConfig(config);
   return config;
 }
 
@@ -268,7 +292,7 @@ function getIcon({ favicon, faviconType }) {
 }
 
 // src/bin/getNav.ts
-var import_jsdom = require("jsdom");
+var import_jsdom2 = require("jsdom");
 
 // src/bin/getRepoLink.ts
 function getRepoLink({ repo }, className) {
@@ -283,7 +307,7 @@ async function getNav(ctx, navItems) {
   let navContent = await fetchText(nav);
   let s = "";
   if (navContent) {
-    let navDom = new import_jsdom.JSDOM(navContent).window.document.body;
+    let navDom = new import_jsdom2.JSDOM(navContent).window.document.body;
     for (let link of navDom.querySelectorAll("a")) {
       if (link.dataset.name === name) {
         let parent = link.parentElement;
@@ -331,7 +355,7 @@ ${navContent}
 }
 
 // src/bin/getParsedContent.ts
-var import_jsdom2 = require("jsdom");
+var import_jsdom3 = require("jsdom");
 var import_markdown_it = __toESM(require("markdown-it"));
 
 // src/bin/getSlug.ts
@@ -415,7 +439,7 @@ function getSectionPostprocess(linkMap) {
   };
 }
 function postprocessBadges(content) {
-  let { document } = new import_jsdom2.JSDOM(content).window;
+  let { document } = new import_jsdom3.JSDOM(content).window;
   for (let img of document.querySelectorAll("img")) {
     let parent = img.parentElement;
     if (!parent) continue;
@@ -430,7 +454,7 @@ async function getParsedContent(ctx) {
   let { singlePage } = ctx;
   let rawContent = await fetchText(getLocation(ctx, "README.md", ctx.source));
   let content = md.render(rawContent);
-  let dom = new import_jsdom2.JSDOM(content);
+  let dom = new import_jsdom3.JSDOM(content);
   let { nav, linkMap } = buildNav(ctx, dom);
   let badges = [];
   let title = "";
@@ -520,7 +544,7 @@ var exec = (0, import_node_util.promisify)(import_node_child_process.exec);
 async function setContent(ctx) {
   let {
     dir = "",
-    colorScheme,
+    baseColor,
     theme,
     root,
     contentDir = "",
@@ -537,8 +561,7 @@ async function setContent(ctx) {
   let packageUrl = `https://unpkg.com/${packageName}@${packageVersion}`;
   let rootAttrs = "";
   if (theme) rootAttrs += ` data-theme="${escapeHTML(theme)}"`;
-  if (colorScheme)
-    rootAttrs += ` style="--color-scheme: ${escapeHTML(colorScheme)}"`;
+  if (baseColor) rootAttrs += ` style="--base-color: ${escapeHTML(baseColor)}"`;
   let icon = getIcon(ctx);
   let iconTag = icon.url ? `<link rel="icon"${icon.type ? ` type="${icon.type}"` : ""} href="${icon.url}">` : "";
   if (redirect) {
@@ -737,13 +760,10 @@ function getIconContent(baseColor = "gray") {
 }
 
 // src/bin/setImages.ts
-async function setImages({ dir = "", colorScheme, favicon }) {
+async function setImages({ dir = "", baseColor, favicon }) {
   if (favicon) return;
-  await (0, import_promises5.writeFile)(
-    (0, import_node_path4.join)(dir, "./favicon.svg"),
-    `${getIconContent(colorScheme)}
-`
-  );
+  await (0, import_promises5.writeFile)((0, import_node_path4.join)(dir, "./favicon.svg"), `${getIconContent(baseColor)}
+`);
 }
 
 // src/bin/createFiles.ts

package/dist/css/base.css

@@ -2,7 +2,7 @@
   color-scheme: light dark;
 
   --b0: light-dark(white, #1a1a1a);
-  --b1: var(--color-scheme, gray);
+  --b1: var(--base-color, gray);
   --link-color: light-dark(royalblue, deepskyblue);
   --button-color: light-dark(royalblue, royalblue);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/docsgen",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "",
   "main": "dist/bin.js",
   "bin": {

package/src/bin/getConfig.ts

@@ -4,6 +4,7 @@ import type { EntryConfig } from "../types/EntryConfig";
 import type { PackageMetadata } from "../types/PackageMetadata";
 import { fetchText } from "./fetchText";
 import { getLocation } from "./getLocation";
+import { stripHTML } from "./stripHTML";
 import { toConfig } from "./toConfig";
 
 async function addMetadata(config: EntryConfig) {
@@ -20,6 +21,26 @@ async function addMetadata(config: EntryConfig) {
   }
 }
 
+function deriveMissingProps(config: EntryConfig) {
+  let { dir, root, title, htmlTitle } = config;
+
+  if (htmlTitle && !title) title = stripHTML(htmlTitle);
+  if (dir && !root) root = `/${dir}/`;
+  if (!root?.endsWith("/")) root = `${root ?? ""}/`;
+
+  return {
+    ...config,
+    dir,
+    root,
+    title,
+    htmlTitle,
+  };
+}
+
+async function reviseConfig(config: EntryConfig) {
+  return deriveMissingProps(await addMetadata(config));
+}
+
 let config: BinConfig | null = null;
 
 export async function getConfig(): Promise<BinConfig> {
@@ -48,10 +69,8 @@ export async function getConfig(): Promise<BinConfig> {
   };
 
   if (config.entries)
-    config.entries = await Promise.all(config.entries.map(addMetadata));
-  else await addMetadata(config);
-
-  if (!config.root?.endsWith("/")) config.root = `${config.root ?? ""}/`;
+    config.entries = await Promise.all(config.entries.map(reviseConfig));
+  else config = await reviseConfig(config);
 
   return config;
 }

package/src/bin/setContent.ts

@@ -19,7 +19,7 @@ const exec = promisify(defaultExec);
 export async function setContent(ctx: Context) {
   let {
     dir = "",
-    colorScheme,
+    baseColor,
     theme,
     root,
     contentDir = "",
@@ -45,8 +45,7 @@ export async function setContent(ctx: Context) {
 
   if (theme) rootAttrs += ` data-theme="${escapeHTML(theme)}"`;
 
-  if (colorScheme)
-    rootAttrs += ` style="--color-scheme: ${escapeHTML(colorScheme)}"`;
+  if (baseColor) rootAttrs += ` style="--base-color: ${escapeHTML(baseColor)}"`;
 
   let icon = getIcon(ctx);
   let iconTag = icon.url

package/src/bin/setImages.ts

@@ -3,11 +3,8 @@ import { join } from "node:path";
 import type { Context } from "../types/Context";
 import { getIconContent } from "../utils/getIconContent";
 
-export async function setImages({ dir = "", colorScheme, favicon }: Context) {
+export async function setImages({ dir = "", baseColor, favicon }: Context) {
   if (favicon) return;
 
-  await writeFile(
-    join(dir, "./favicon.svg"),
-    `${getIconContent(colorScheme)}\n`,
-  );
+  await writeFile(join(dir, "./favicon.svg"), `${getIconContent(baseColor)}\n`);
 }

package/src/bin/stripHTML.ts

@@ -0,0 +1,7 @@
+import { JSDOM } from "jsdom";
+
+export function stripHTML(content: string) {
+  try {
+    return new JSDOM(content).window.document.body.textContent;
+  } catch {}
+}

package/src/css/base.css

@@ -2,7 +2,7 @@
   color-scheme: light dark;
 
   --b0: light-dark(white, #1a1a1a);
-  --b1: var(--color-scheme, gray);
+  --b1: var(--base-color, gray);
   --link-color: light-dark(royalblue, deepskyblue);
   --button-color: light-dark(royalblue, royalblue);
 

package/src/types/EntryConfig.ts

@@ -4,7 +4,7 @@ export type EntryConfig = {
   id?: string;
   source?: string;
   dir?: string;
-  colorScheme?: string;
+  baseColor?: string;
   theme?: Theme;
   name?: string;
   title?: string;