create-zudo-doc 0.2.0 → 0.2.1

package/templates/base/src/plugins/rehype-heading-links.ts

@@ -1,53 +0,0 @@
-import type { Root, Element } from "hast";
-import GithubSlugger from "github-slugger";
-import { visit } from "unist-util-visit";
-import { extractText } from "./hast-utils";
-
-/**
- * Rehype plugin that adds Docusaurus-style anchor links to headings (h2-h6).
- *
- * Generates heading IDs (via github-slugger) and appends:
- *   <a href="#id" class="hash-link" aria-label="Direct link to ..."></a>
- *
- * The "#" symbol is rendered via CSS ::after to avoid polluting
- * heading text extraction (used for TOC).
- *
- * Sets heading IDs itself (via github-slugger); skips headings that already
- * have an ID assigned upstream.
- */
-
-const headingTags = new Set(["h2", "h3", "h4", "h5", "h6"]);
-
-export function rehypeHeadingLinks() {
-  return (tree: Root) => {
-    const slugger = new GithubSlugger();
-
-    visit(tree, "element", (node: Element) => {
-      if (!headingTags.has(node.tagName)) return;
-
-      const text = node.children
-        .map((c) => extractText(c))
-        .join("");
-
-      const id =
-        (node.properties?.id as string | undefined) || slugger.slug(text);
-
-      // Set the id if not already present
-      if (!node.properties) node.properties = {};
-      if (!node.properties.id) node.properties.id = id;
-
-      const link: Element = {
-        type: "element",
-        tagName: "a",
-        properties: {
-          href: `#${id}`,
-          className: ["hash-link"],
-          "aria-label": `Direct link to ${text}`,
-        },
-        children: [],
-      };
-
-      node.children.push(link);
-    });
-  };
-}

package/templates/base/src/plugins/rehype-mermaid.ts

@@ -1,41 +0,0 @@
-import type { Root, Element } from "hast";
-import { visit } from "unist-util-visit";
-import { extractText } from "./hast-utils";
-
-/**
- * Rehype plugin that transforms mermaid code blocks into renderable containers.
- *
- * After Shiki processes code blocks, mermaid blocks become:
- *   <pre data-language="mermaid"><code><span>...</span></code></pre>
- *
- * This plugin converts them to:
- *   <div class="mermaid" data-mermaid>graph LR; A-->B</div>
- */
-
-export function rehypeMermaid() {
-  return (tree: Root) => {
-    visit(tree, "element", (node: Element, index, parent) => {
-      if (
-        node.tagName !== "pre" ||
-        !parent ||
-        index === undefined
-      ) return;
-
-      // Match Shiki-processed mermaid blocks (data-language="mermaid")
-      if (node.properties?.dataLanguage !== "mermaid") return;
-
-      // Extract all text content recursively from the code/span tree
-      const text = node.children
-        .map((c) => extractText(c))
-        .join("");
-
-      // Replace the <pre> with a <div class="mermaid">
-      (parent as Element).children[index] = {
-        type: "element",
-        tagName: "div",
-        properties: { className: ["mermaid"], "data-mermaid": true },
-        children: [{ type: "text", value: text }],
-      };
-    });
-  };
-}

package/templates/base/src/plugins/url-utils.ts

@@ -1,4 +0,0 @@
-/** Check if a URL is external (has a protocol scheme). */
-export function isExternal(url: string): boolean {
-  return /^[a-z][a-z0-9+.-]*:/i.test(url);
-}

package/templates/base/src/utils/dedent.ts

@@ -1,24 +0,0 @@
-/**
- * Strip common leading whitespace from all lines of a template literal string.
- * Similar to Python's textwrap.dedent().
- */
-export function dedent(text: string): string {
-  const lines = text.split('\n');
-
-  // Find minimum indentation (ignoring empty/whitespace-only lines)
-  let minIndent = Infinity;
-  for (const line of lines) {
-    if (line.trim().length === 0) continue;
-    const indent = line.match(/^(\s*)/)?.[1]?.length ?? 0;
-    if (indent < minIndent) minIndent = indent;
-  }
-
-  if (minIndent === 0 || minIndent === Infinity) {
-    return text.trim();
-  }
-
-  return lines
-    .map((line) => (line.trim().length === 0 ? '' : line.slice(minIndent)))
-    .join('\n')
-    .trim();
-}

package/templates/features/docHistory/files/src/utils/doc-history.ts

@@ -1,180 +0,0 @@
-import { execFileSync } from "node:child_process";
-import path from "node:path";
-import type { DocHistoryEntry, DocHistoryData } from "@/types/doc-history";
-import { collectMdFiles } from "./content-files";
-
-/** Shared options to suppress git stderr noise */
-const QUIET: { encoding: "utf-8"; stdio: ["pipe", "pipe", "pipe"] } = {
-  encoding: "utf-8",
-  stdio: ["pipe", "pipe", "pipe"],
-};
-
-/** Cache the repo root to avoid repeated git calls */
-let repoRootCache: string | null = null;
-
-function getRepoRoot(): string {
-  if (repoRootCache) return repoRootCache;
-  repoRootCache = execFileSync("git", ["rev-parse", "--show-toplevel"], {
-    encoding: "utf-8",
-  }).trim();
-  return repoRootCache;
-}
-
-/** Convert an absolute path to a repo-relative path for git commands */
-function toRepoRelative(absolutePath: string): string {
-  return path.relative(getRepoRoot(), absolutePath);
-}
-
-/**
- * Get the list of commit hashes that touched a file, newest first.
- * Uses --follow to track renames.
- * Limits to maxEntries commits (default 50).
- */
-export function getFileCommits(
-  filePath: string,
-  maxEntries = 50,
-): string[] {
-  try {
-    const output = execFileSync(
-      "git",
-      [
-        "log",
-        "--follow",
-        "--format=%H",
-        "-n",
-        String(maxEntries),
-        "--",
-        filePath,
-      ],
-      QUIET,
-    ).trim();
-    return output ? [...new Set(output.split("\n"))] : [];
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Get metadata for a specific commit on a file.
- * Returns { hash, date, author, message } with full hash for unique identification.
- */
-export function getCommitInfo(
-  hash: string,
-  filePath: string,
-): Omit<DocHistoryEntry, "content"> {
-  try {
-    const output = execFileSync(
-      "git",
-      ["log", "-1", "--format=%H%n%aI%n%aN%n%s", hash, "--", filePath],
-      QUIET,
-    ).trim();
-    const lines = output.split("\n");
-    return {
-      hash: lines[0] ?? hash,
-      date: lines[1] ?? "",
-      author: lines[2] ?? "",
-      message: lines[3] ?? "",
-    };
-  } catch {
-    return { hash, date: "", author: "", message: "" };
-  }
-}
-
-/**
- * Get the file content at a specific commit.
- * Accepts absolute paths and converts to repo-relative for git show.
- * Handles renamed files by falling back to the old path via git log --follow.
- */
-export function getFileAtCommit(hash: string, filePath: string): string {
-  const relPath = path.isAbsolute(filePath)
-    ? toRepoRelative(filePath)
-    : filePath;
-
-  try {
-    return execFileSync("git", ["show", `${hash}:${relPath}`], QUIET);
-  } catch {
-    // File may have been renamed — find the old path at this commit
-    try {
-      const oldPath = execFileSync(
-        "git",
-        [
-          "log",
-          "-1",
-          "--follow",
-          "--diff-filter=R",
-          "--format=",
-          "--name-only",
-          hash,
-          "--",
-          relPath,
-        ],
-        QUIET,
-      ).trim();
-      if (oldPath) {
-        return execFileSync("git", ["show", `${hash}:${oldPath}`], QUIET);
-      }
-    } catch {
-      // ignore
-    }
-
-    // Last resort: use git log --follow to find the path at this revision
-    try {
-      const followOutput = execFileSync(
-        "git",
-        [
-          "log",
-          "--follow",
-          "--format=%H",
-          "--name-only",
-          "--diff-filter=AMRC",
-          "--",
-          relPath,
-        ],
-        QUIET,
-      ).trim();
-      const lines = followOutput.split("\n").filter(Boolean);
-      // Lines alternate: hash, filename, hash, filename...
-      for (let i = 0; i < lines.length - 1; i += 2) {
-        if (lines[i] === hash && lines[i + 1]) {
-          return execFileSync(
-            "git",
-            ["show", `${hash}:${lines[i + 1]}`],
-            QUIET,
-          );
-        }
-      }
-    } catch {
-      // ignore
-    }
-
-    return "";
-  }
-}
-
-/**
- * Get the complete history for a document file.
- * Returns DocHistoryData with all entries populated.
- */
-export function getDocHistory(
-  filePath: string,
-  slug: string,
-  maxEntries = 50,
-): DocHistoryData {
-  const commits = getFileCommits(filePath, maxEntries);
-  const entries: DocHistoryEntry[] = commits.map((hash) => {
-    const info = getCommitInfo(hash, filePath);
-    const content = getFileAtCommit(hash, filePath);
-    return { ...info, content };
-  });
-  return { slug, filePath, entries };
-}
-
-/**
- * Collect all MDX/md files in a content directory.
- * Delegates to the shared collectMdFiles utility from content-files.ts.
- */
-export function collectContentFiles(
-  contentDir: string,
-): Array<{ filePath: string; slug: string }> {
-  return collectMdFiles(contentDir);
-}

package/templates/features/sidebarResizer/files/src/scripts/sidebar-resizer.ts

@@ -1,198 +0,0 @@
-export function initSidebarResizer() {
-  const sidebar = document.getElementById("desktop-sidebar");
-  if (!sidebar || sidebar.querySelector("[data-sidebar-resizer]")) return;
-  // Only attach to the real fixed desktop panel. On hide_sidebar pages the
-  // aside renders sr-only (position:absolute) purely for the ARIA landmark; a
-  // position:fixed handle would escape sr-only's clip and show a stray strip
-  // (below lg the panel is display:none but still fixed — handle appended, not rendered). zudolab/zudo-doc#1821
-  if (getComputedStyle(sidebar).position !== "fixed") return;
-
-  // Resizer allows a wider range (192–448px) than the CSS default
-  // (clamp(14rem, 20vw, 22rem) = 224–352px at 16px base).
-  // CSS provides the responsive initial width; the resizer lets users
-  // go beyond that range when explicitly dragging or using keyboard arrows.
-  const MIN_W = 192;
-  const MAX_W = 448;
-  const STEP = 10;
-  const LS_KEY = "zudo-doc-sidebar-width";
-  const CSS_PROP = "--zd-sidebar-w";
-  const ACCENT_BG = "var(--zd-accent, rgba(128,128,128,0.3))";
-  const ACCENT_OUTLINE = "2px solid var(--zd-accent, rgba(128,128,128,0.5))";
-  const ACCENT_GHOST = "var(--zd-accent, rgba(128,128,128,0.5))";
-
-  function readCurrentWidth(): number {
-    const raw = getComputedStyle(document.documentElement).getPropertyValue(CSS_PROP);
-    return raw ? parseFloat(raw) || MIN_W : MIN_W;
-  }
-
-  let cachedWidth = readCurrentWidth();
-
-  const handle = document.createElement("div");
-  handle.setAttribute("data-sidebar-resizer", "");
-  handle.setAttribute("tabindex", "0");
-  handle.setAttribute("role", "separator");
-  handle.setAttribute("aria-orientation", "vertical");
-  handle.setAttribute("aria-label", "Resize sidebar");
-  handle.setAttribute("aria-valuemin", String(MIN_W));
-  handle.setAttribute("aria-valuemax", String(MAX_W));
-  handle.setAttribute("aria-valuenow", String(Math.round(cachedWidth)));
-  // position:fixed (not absolute) pins the handle to the viewport so it spans
-  // the sidebar's full height even while #desktop-sidebar scrolls. As an
-  // absolute child of the overflow-y:auto sidebar the handle scrolled away with
-  // the content and its height:100% only resolved to the visible padding box,
-  // so the bottom of the sidebar lost its grab strip once scrolled. zudolab/zudo-doc#1821
-  //
-  // top:3.5rem + left:calc mirror the doc-layout #desktop-sidebar geometry
-  // (top-[3.5rem], left:0, width:var(--zd-sidebar-w)) — those layout constants
-  // live in the same package's doc-layout.tsx. 20px is wider than every common
-  // native y-scrollbar (~12-17px on Win/Linux classic; 0 on macOS overlay) so a
-  // draggable strip always remains visible to the LEFT of the scrollbar when
-  // sidebar content overflows. zudolab/zudo-doc#1660
-  Object.assign(handle.style, {
-    position: "fixed",
-    top: "3.5rem",
-    bottom: "0",
-    left: "calc(var(--zd-sidebar-w) - 20px)",
-    width: "20px",
-    cursor: "col-resize",
-    zIndex: "10",
-    transition: "background 0.15s",
-  });
-
-  let dragging = false;
-
-  function applyWidth(w: number) {
-    cachedWidth = Math.max(MIN_W, Math.min(MAX_W, w));
-    document.documentElement.style.setProperty(CSS_PROP, cachedWidth + "px");
-    try { localStorage.setItem(LS_KEY, String(Math.round(cachedWidth))); } catch {}
-    handle.setAttribute("aria-valuenow", String(Math.round(cachedWidth)));
-  }
-
-  let focused = false;
-
-  function updateHandleVisual() {
-    if (dragging || focused) {
-      handle.style.background = ACCENT_BG;
-    } else {
-      handle.style.background = "";
-    }
-    handle.style.outline = focused && !dragging ? ACCENT_OUTLINE : "";
-    handle.style.outlineOffset = focused && !dragging ? "1px" : "";
-  }
-
-  handle.addEventListener("focus", () => {
-    focused = true;
-    updateHandleVisual();
-  });
-  handle.addEventListener("blur", () => {
-    focused = false;
-    updateHandleVisual();
-  });
-
-  handle.addEventListener("keydown", (e: KeyboardEvent) => {
-    let w = cachedWidth;
-    switch (e.key) {
-      case "ArrowLeft":
-        w = Math.max(MIN_W, w - STEP);
-        break;
-      case "ArrowRight":
-        w = Math.min(MAX_W, w + STEP);
-        break;
-      case "Home":
-        w = MIN_W;
-        break;
-      case "End":
-        w = MAX_W;
-        break;
-      default:
-        return;
-    }
-    e.preventDefault();
-    applyWidth(w);
-  });
-
-  handle.addEventListener("mouseenter", () => {
-    if (!dragging && !focused) handle.style.background = ACCENT_BG;
-  });
-  handle.addEventListener("mouseleave", () => {
-    if (!dragging && !focused) handle.style.background = "";
-  });
-
-  handle.addEventListener("pointerdown", (e: PointerEvent) => {
-    e.preventDefault();
-    handle.setPointerCapture(e.pointerId);
-    dragging = true;
-    updateHandleVisual();
-    document.documentElement.style.cursor = "col-resize";
-    document.documentElement.style.userSelect = "none";
-
-    // Ghost line — cheap to move (no reflow), shows target position
-    const ghost = document.createElement("div");
-    Object.assign(ghost.style, {
-      position: "fixed",
-      top: "0",
-      width: "2px",
-      height: "100vh",
-      background: ACCENT_GHOST,
-      pointerEvents: "none",
-      zIndex: "9999",
-    });
-    const sidebarRect = sidebar.getBoundingClientRect();
-    const sidebarLeft = sidebarRect.left;
-    ghost.style.left = (sidebarLeft + sidebarRect.width) + "px";
-    document.body.appendChild(ghost);
-    let targetWidth = 0;
-    let cleaned = false;
-
-    const onMove = (ev: PointerEvent) => {
-      targetWidth = Math.max(MIN_W, Math.min(MAX_W, ev.clientX - sidebarLeft));
-      ghost.style.left = (sidebarLeft + targetWidth) + "px";
-    };
-
-    const cleanup = () => {
-      if (cleaned) return;
-      cleaned = true;
-      dragging = false;
-      updateHandleVisual();
-      document.documentElement.style.cursor = "";
-      document.documentElement.style.userSelect = "";
-      ghost.remove();
-      handle.removeEventListener("pointermove", onMove);
-      handle.removeEventListener("pointerup", onUp);
-      handle.removeEventListener("pointercancel", onCancel);
-      handle.removeEventListener("lostpointercapture", onLost);
-    };
-
-    const commit = () => {
-      if (targetWidth > 0) applyWidth(targetWidth);
-    };
-
-    // pointerup: normal end-of-drag. Commit, then teardown.
-    const onUp = () => {
-      commit();
-      cleanup();
-    };
-
-    // lostpointercapture: per spec fires AFTER pointerup, but browsers reorder
-    // these in edge cases (cursor near y-scrollbar, fast drags, OS handoff).
-    // Commit here too so a real drag still applies if pointerup is dropped.
-    // Idempotent with onUp via the `cleaned` guard.
-    const onLost = () => {
-      commit();
-      cleanup();
-    };
-
-    // pointercancel: actual user/OS cancellation (touch interrupted, etc.).
-    // Do NOT commit — caller intent was to abort.
-    const onCancel = () => {
-      cleanup();
-    };
-
-    handle.addEventListener("pointermove", onMove);
-    handle.addEventListener("pointerup", onUp);
-    handle.addEventListener("pointercancel", onCancel);
-    handle.addEventListener("lostpointercapture", onLost);
-  });
-
-  sidebar.appendChild(handle);
-}