@t8/docsgen 0.1.2 → 0.1.4

package/dist/bin.js

@@ -152,7 +152,7 @@ async function getConfig() {
 
 // src/bin/runEntry.ts
 var import_node_child_process2 = require("node:child_process");
-var import_promises6 = require("node:fs/promises");
+var import_promises7 = require("node:fs/promises");
 var import_node_util2 = require("node:util");
 
 // src/bin/cleanup.ts
@@ -166,6 +166,9 @@ async function cleanup({ dir = "" }) {
   );
 }
 
+// src/bin/createFiles.ts
+var import_promises6 = require("node:fs/promises");
+
 // src/bin/setCName.ts
 var import_promises3 = require("node:fs/promises");
 var import_node_path2 = require("node:path");
@@ -266,19 +269,22 @@ async function getNav(ctx, navItems) {
     }
   }
   if (!s && !navContent) return "";
-  let repoLink = getRepoLink(ctx);
   s = s.trim() ? `<section><ul>${s}
 </ul></section>` : "";
-  s = `${s}
+  let repoLink = getRepoLink(ctx);
+  let refContent = "";
+  if (repoLink || backstory)
+    refContent = `
 <section class="ref">
   <ul>
-    <li>${repoLink}</li>
+    ${repoLink ? `<li>${repoLink}</li>` : ""}
     ${backstory ? `<li><a href="${backstory}">Backstory</a></li>` : ""}
   </ul>
 </section>
-${navContent}`;
+`;
   return `<nav>
-${s}
+${s}${refContent}
+${navContent}
 </nav>`;
 }
 
@@ -680,13 +686,22 @@ function getIcon(baseColor = "gray") {
 }
 
 // src/bin/setImages.ts
-async function setImages({ dir = "", colorScheme }) {
+async function setImages({ dir = "", colorScheme, favicon }) {
+  if (favicon) return;
   await (0, import_promises5.writeFile)((0, import_node_path4.join)(dir, "./favicon.svg"), `${getIcon(colorScheme)}
 `);
 }
 
 // src/bin/createFiles.ts
 async function createFiles(ctx) {
+  let { dir } = ctx;
+  if (dir) {
+    try {
+      await (0, import_promises6.access)(dir);
+    } catch {
+      await (0, import_promises6.mkdir)(dir);
+    }
+  }
   await Promise.all([setCName(ctx), setContent(ctx), setImages(ctx)]);
 }
 
@@ -695,7 +710,7 @@ var exec2 = (0, import_node_util2.promisify)(import_node_child_process2.exec);
 var stdout = async (cmd) => (await exec2(cmd)).stdout.trim();
 async function isGitDir() {
   try {
-    await (0, import_promises6.access)("./.git");
+    await (0, import_promises7.access)("./.git");
     return true;
   } catch {
     return false;

package/package.json

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

package/src/bin/createFiles.ts

@@ -1,8 +1,19 @@
+import { access, mkdir } from "node:fs/promises";
 import type { Context } from "../types/Context";
 import { setCName } from "./setCName";
 import { setContent } from "./setContent";
 import { setImages } from "./setImages";
 
 export async function createFiles(ctx: Context) {
+  let { dir } = ctx;
+
+  if (dir) {
+    try {
+      await access(dir);
+    } catch {
+      await mkdir(dir);
+    }
+  }
+
   await Promise.all([setCName(ctx), setContent(ctx), setImages(ctx)]);
 }

package/src/bin/getNav.ts

@@ -48,17 +48,20 @@ export async function getNav(ctx: Context, navItems: NavItem[]) {
 
   if (!s && !navContent) return "";
 
+  s = s.trim() ? `<section><ul>${s}\n</ul></section>` : "";
+
   let repoLink = getRepoLink(ctx);
+  let refContent = "";
 
-  s = s.trim() ? `<section><ul>${s}\n</ul></section>` : "";
-  s = `${s}
+  if (repoLink || backstory)
+    refContent = `
 <section class="ref">
   <ul>
-    <li>${repoLink}</li>
+    ${repoLink ? `<li>${repoLink}</li>` : ""}
     ${backstory ? `<li><a href="${backstory}">Backstory</a></li>` : ""}
   </ul>
 </section>
-${navContent}`;
+`;
 
-  return `<nav>\n${s}\n</nav>`;
+  return `<nav>\n${s}${refContent}\n${navContent}\n</nav>`;
 }

package/src/bin/setImages.ts

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

package/src/types/EntryConfig.ts

@@ -37,9 +37,11 @@ export type EntryConfig = {
   backstory?: string;
   /** URL of an HTML file inserted into the navigation bar. */
   nav?: string;
-  /** Scope URL */
+  /** Favicon URL. */
+  favicon?: string;
+  /** Scope URL. */
   scope?: string;
-  /** Redirection URL */
+  /** Redirection URL. */
   redirect?: string;
   /** Whether to remove the GitHub Pages branch and quit. */
   remove?: boolean;