@t8/docsgen 0.1.36 → 0.1.38

package/dist/bin.js

@@ -24,57 +24,90 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // node_modules/args-json/dist/index.js
-function d(e) {
-  let i = e.replace(/^[-_.\s~+]|[-_.\s~+]$/g, "");
-  return /[-_.\s~+]/.test(i) ? i.toLowerCase().replace(/[-_.\s~+](\S)/g, (r, o) => o.toUpperCase()) : i.slice(0, 1).toLowerCase() + i.slice(1);
-}
-function p(e) {
-  if (e) {
-    if (e.startsWith("--") && e.length > 2) return d(e.slice(2));
-    if (e.startsWith("-") && e.length === 2) return d(e.slice(1));
+function toCamelCase(x) {
+  let s = x.replace(/^[-_.\s~+]|[-_.\s~+]$/g, "");
+  if (!/[-_.\s~+]/.test(s)) return s.slice(0, 1).toLowerCase() + s.slice(1);
+  return s.toLowerCase().replace(/[-_.\s~+](\S)/g, (_, match) => match.toUpperCase());
+}
+function toKey(x) {
+  if (x) {
+    if (x.startsWith("--") && x.length > 2) return toCamelCase(x.slice(2));
+    if (x.startsWith("-") && x.length === 2) return toCamelCase(x.slice(1));
   }
 }
-function h(e) {
-  let i = [], r = "", o = false, n = false;
-  for (let s = 0; s < e.length; s++) {
-    let t = e[s];
-    if (/^\s/.test(t) && !o && !n) {
-      r && i.push(r), r = "";
+function split(x) {
+  let words = [], word = "";
+  let hasOpenSingleQuote = false;
+  let hasOpenDoubleQuote = false;
+  for (let i = 0; i < x.length; i++) {
+    let c = x[i];
+    if (/^\s/.test(c) && !hasOpenSingleQuote && !hasOpenDoubleQuote) {
+      if (word) words.push(word);
+      word = "";
       continue;
     }
-    t === "'" && e[s - 1] !== "\\" && (o = !o), t === '"' && e[s - 1] !== "\\" && (n = !n), r += t;
+    if (c === "'" && x[i - 1] !== "\\")
+      hasOpenSingleQuote = !hasOpenSingleQuote;
+    if (c === '"' && x[i - 1] !== "\\")
+      hasOpenDoubleQuote = !hasOpenDoubleQuote;
+    word += c;
   }
-  return r && i.push(r), i;
-}
-function c() {
-  return typeof process === void 0 ? [] : process.argv;
-}
-function A(e, i) {
-  let r, o;
-  e === void 0 ? r = c() : typeof e == "string" ? r = h(e) : Array.isArray(e) ? r = e.map((t) => String(t)) : e !== null && typeof e == "object" ? (r = c(), o = e) : r = [], r = r.map((t) => {
-    let f = t.trim(), l = f.indexOf("=");
-    return l === -1 ? f : [f.slice(0, l), f.slice(l + 1)];
-  }).flat(), i && (o = i);
-  let n = "", s = {};
-  for (let t of r) {
-    t = t.trim(), (t.startsWith('"') && t.endsWith('"') || t.startsWith("'") && t.endsWith("'")) && (t = t.slice(1, -1));
-    let f = p(t);
-    if (f !== void 0) {
-      let g = o?.[f] ?? f;
-      n && g !== n && s[n] === void 0 && (s[n] = true), n = g;
+  if (word) words.push(word);
+  return words;
+}
+function getDefaultInput() {
+  return typeof process === "undefined" ? [] : process.argv;
+}
+function parseArgs(input, map) {
+  let normalizedInput;
+  let normalizedMap;
+  if (input === void 0) normalizedInput = getDefaultInput();
+  else if (typeof input === "string") normalizedInput = split(input);
+  else if (Array.isArray(input)) normalizedInput = input.map((x) => String(x));
+  else if (input !== null && typeof input === "object") {
+    normalizedInput = getDefaultInput();
+    normalizedMap = input;
+  } else normalizedInput = [];
+  normalizedInput = normalizedInput.flatMap((item) => {
+    let normalizedItem = item.trim();
+    let k = normalizedItem.indexOf("=");
+    if (k === -1) return normalizedItem;
+    return [normalizedItem.slice(0, k), normalizedItem.slice(k + 1)];
+  });
+  if (map) normalizedMap = map;
+  let key = "";
+  let parsedArgs = {};
+  for (let rawValue of normalizedInput) {
+    rawValue = rawValue.trim();
+    if (rawValue.startsWith('"') && rawValue.endsWith('"'))
+      rawValue = rawValue.slice(1, -1);
+    else if (rawValue.startsWith("'") && rawValue.endsWith("'"))
+      rawValue = rawValue.slice(1, -1);
+    let parsedKey = toKey(rawValue);
+    if (parsedKey !== void 0) {
+      let nextKey = normalizedMap?.[parsedKey] ?? parsedKey;
+      if (key && nextKey !== key && parsedArgs[key] === void 0)
+        parsedArgs[key] = true;
+      key = nextKey;
       continue;
     }
-    let l;
-    if (t) try {
-      l = JSON.parse(t);
-    } catch {
-      l = t;
-    }
-    else l = true;
-    let a = s[n], u;
-    a === void 0 ? u = l : Array.isArray(a) ? u = [...a, l] : u = [a, l], s[n] = u;
+    let parsedValue;
+    if (rawValue) {
+      try {
+        parsedValue = JSON.parse(rawValue);
+      } catch {
+        parsedValue = rawValue;
+      }
+    } else parsedValue = true;
+    let prevValue = parsedArgs[key];
+    let value;
+    if (prevValue === void 0) value = parsedValue;
+    else if (Array.isArray(prevValue)) value = [...prevValue, parsedValue];
+    else value = [prevValue, parsedValue];
+    parsedArgs[key] = value;
   }
-  return n && s[n] === void 0 && (s[n] = true), s;
+  if (key && parsedArgs[key] === void 0) parsedArgs[key] = true;
+  return parsedArgs;
 }
 
 // src/bin/fetchText.ts
@@ -188,7 +221,7 @@ async function getConfig() {
     root: "/",
     contentDir: "x",
     ...localConfig,
-    ...A(args)
+    ...parseArgs(args)
   };
   if (config.entries)
     config.entries = await Promise.all(config.entries.map(reviseConfig));
@@ -337,12 +370,14 @@ async function getNav(ctx, navItems) {
   }
   if (navItems.length > 1) {
     for (let { id, title, items } of navItems) {
+      let itemLink = `${root}${contentDir}/${encodeURIComponent(id)}`;
       s += `
-<li data-id="${id}"><a href="${root}${contentDir}/${id}">${title}</a>`;
+<li data-id="${id}"><a href="${itemLink}">${title}</a>`;
       if (items.length !== 0) {
         s += "\n  <ul>";
-        for (let { title: title2 } of items) s += `
-    <li>${title2}</li>`;
+        for (let { id: id2, title: title2 } of items)
+          s += `
+    <li><a href="${itemLink}#${encodeURIComponent(id2)}">${title2}</a></li>`;
         s += "\n  </ul>\n";
       }
       s += "</li>";
@@ -396,44 +431,48 @@ function buildNav(ctx, dom) {
   let navItem = null;
   let nav = [];
   if (singlePage)
-    nav.push({
+    navItem = {
       id: "Overview",
       title: "Overview",
       items: []
-    });
-  else {
-    let headings = dom.window.document.body.querySelectorAll("h2, h3, h4, h5, h6");
-    for (let element of headings) {
-      let tagName = element.tagName.toLowerCase();
-      let isSectionTitle = tagName === "h2";
-      let isSubsectionTitle = tagName === "h3";
-      let sectionId = isSectionTitle ? getSlug(element.textContent) : navItem?.id ?? "";
-      let elementId = element.id;
-      if (!elementId)
-        elementId = getSlug(element.textContent).toLowerCase().replace(/_/g, "-");
-      if (elementId) {
-        element.id = elementId;
-        let link = `${root}${contentDir}/${sectionId}`;
-        if (!isSectionTitle) link += `#${elementId}`;
-        linkMap[`#${elementId}`] = link;
-      }
-      if (isSectionTitle) {
-        if (navItem) nav.push(navItem);
-        navItem = {
+    };
+  let headings = dom.window.document.body.querySelectorAll("h2, h3, h4, h5, h6");
+  for (let element of headings) {
+    let tagName = element.tagName.toLowerCase();
+    let isSectionTitle = tagName === "h2";
+    let isSubsectionTitle = tagName === "h3";
+    let sectionId = isSectionTitle ? getSlug(element.textContent) : navItem?.id ?? "";
+    let elementId = element.id;
+    if (!elementId)
+      elementId = getSlug(element.textContent).toLowerCase().replace(/_/g, "-");
+    if (elementId) {
+      element.id = elementId;
+      let link = `${root}${contentDir}/${sectionId}`;
+      if (!isSectionTitle) link += `#${elementId}`;
+      linkMap[`#${elementId}`] = link;
+    }
+    if (singlePage && isSectionTitle) {
+      if (navItem)
+        navItem.items.push({
           id: getSlug(element.textContent),
-          title: element.innerHTML.trim(),
-          items: []
-        };
-      } else if (isSubsectionTitle) {
-        if (navItem)
-          navItem.items.push({
-            id: getSlug(element.textContent),
-            title: element.innerHTML.trim()
-          });
-      }
+          title: element.innerHTML.trim()
+        });
+    } else if (isSectionTitle) {
+      if (navItem) nav.push(navItem);
+      navItem = {
+        id: getSlug(element.textContent),
+        title: element.innerHTML.trim(),
+        items: []
+      };
+    } else if (isSubsectionTitle) {
+      if (navItem)
+        navItem.items.push({
+          id: getSlug(element.textContent),
+          title: element.innerHTML.trim()
+        });
     }
-    if (navItem) nav.push(navItem);
   }
+  if (navItem) nav.push(navItem);
   return {
     nav,
     linkMap

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@t8/docsgen",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "",
   "main": "dist/bin.js",
   "bin": {
     "docsgen": "dist/bin.js"
   },
   "scripts": {
-    "build": "npx npm-run-all clean build-bin -p build-css",
+    "build": "npx npm-run-all clean build-bin build-css",
     "build-bin": "npx esbuild ./src/bin/run.ts --bundle --outfile=dist/bin.js --platform=node --external:jsdom --external:markdown-it",
     "build-css": "node -e \"require('node:fs').cpSync('src/css', 'dist/css', { force: true, recursive: true });\"",
     "build-schema": "npx ts-json-schema-generator -p src/types/Config.ts -t Config -o schema.json --minify",
@@ -30,7 +30,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "args-json": "^1.2.4",
+    "args-json": "^1.2.5",
     "jsdom": "^27.0.0",
     "markdown-it": "^14.1.0"
   }

package/src/bin/getNav.ts

@@ -32,12 +32,15 @@ export async function getNav(ctx: Context, navItems: NavItem[]) {
 
   if (navItems.length > 1) {
     for (let { id, title, items } of navItems) {
-      s += `\n<li data-id="${id}"><a href="${root}${contentDir}/${id}">${title}</a>`;
+      let itemLink = `${root}${contentDir}/${encodeURIComponent(id)}`;
+
+      s += `\n<li data-id="${id}"><a href="${itemLink}">${title}</a>`;
 
       if (items.length !== 0) {
         s += "\n  <ul>";
 
-        for (let { title } of items) s += `\n    <li>${title}</li>`;
+        for (let { id, title } of items)
+          s += `\n    <li><a href="${itemLink}#${encodeURIComponent(id)}">${title}</a></li>`;
 
         s += "\n  </ul>\n";
       }

package/src/bin/getParsedContent.ts

@@ -22,61 +22,66 @@ function buildNav(ctx: Context, dom: JSDOM) {
   let nav: NavItem[] = [];
 
   if (singlePage)
-    nav.push({
+    navItem = {
       id: "Overview",
       title: "Overview",
       items: [],
-    });
-  else {
-    let headings =
-      dom.window.document.body.querySelectorAll("h2, h3, h4, h5, h6");
+    };
 
-    for (let element of headings) {
-      let tagName = element.tagName.toLowerCase();
+  let headings =
+    dom.window.document.body.querySelectorAll("h2, h3, h4, h5, h6");
 
-      let isSectionTitle = tagName === "h2";
-      let isSubsectionTitle = tagName === "h3";
+  for (let element of headings) {
+    let tagName = element.tagName.toLowerCase();
 
-      let sectionId = isSectionTitle
-        ? getSlug(element.textContent)
-        : (navItem?.id ?? "");
-      let elementId = element.id;
+    let isSectionTitle = tagName === "h2";
+    let isSubsectionTitle = tagName === "h3";
 
-      if (!elementId)
-        elementId = getSlug(element.textContent)
-          .toLowerCase()
-          .replace(/_/g, "-");
+    let sectionId = isSectionTitle
+      ? getSlug(element.textContent)
+      : (navItem?.id ?? "");
+    let elementId = element.id;
 
-      if (elementId) {
-        element.id = elementId;
+    if (!elementId)
+      elementId = getSlug(element.textContent)
+        .toLowerCase()
+        .replace(/_/g, "-");
 
-        let link = `${root}${contentDir}/${sectionId}`;
+    if (elementId) {
+      element.id = elementId;
 
-        if (!isSectionTitle) link += `#${elementId}`;
+      let link = `${root}${contentDir}/${sectionId}`;
 
-        linkMap[`#${elementId}`] = link;
-      }
+      if (!isSectionTitle) link += `#${elementId}`;
 
-      if (isSectionTitle) {
-        if (navItem) nav.push(navItem);
+      linkMap[`#${elementId}`] = link;
+    }
 
-        navItem = {
+    if (singlePage && isSectionTitle) {
+      if (navItem)
+        navItem.items.push({
           id: getSlug(element.textContent),
           title: element.innerHTML.trim(),
-          items: [],
-        };
-      } else if (isSubsectionTitle) {
-        if (navItem)
-          navItem.items.push({
-            id: getSlug(element.textContent),
-            title: element.innerHTML.trim(),
-          });
-      }
+        });
+    } else if (isSectionTitle) {
+      if (navItem) nav.push(navItem);
+
+      navItem = {
+        id: getSlug(element.textContent),
+        title: element.innerHTML.trim(),
+        items: [],
+      };
+    } else if (isSubsectionTitle) {
+      if (navItem)
+        navItem.items.push({
+          id: getSlug(element.textContent),
+          title: element.innerHTML.trim(),
+        });
     }
-
-    if (navItem) nav.push(navItem);
   }
 
+  if (navItem) nav.push(navItem);
+
   return {
     nav,
     linkMap,