create-dox 0.4.0 → 0.5.0

package/dist/{chunk-YY5QPPAG.js → chunk-23YWNWTH.js}

@@ -19,9 +19,9 @@ function shouldInclude(path) {
   }
   return true;
 }
-async function downloadTemplate(targetDir) {
+async function downloadTemplate(targetDir, siteName) {
   console.log("");
-  console.log("  \u23F3 Downloading Dox template...");
+  console.log(`  \u23F3 Creating ${siteName?.trim() || "your docs site"}...`);
   const response = await fetch(TARBALL_URL);
   if (!response.ok) {
     throw new Error(`Failed to download template: ${response.status} ${response.statusText}`);
@@ -135,6 +135,11 @@ function buildStarterDocsJson({
   i18nLocales
 }) {
   const config = {};
+  config.theme = "sharp";
+  config.fonts = {
+    body: { family: "Plus Jakarta Sans", weight: ["400", "500", "600", "700"] },
+    heading: { family: "Outfit", weight: ["600", "700"] }
+  };
   if (enableAiChat) {
     config.ai = { chat: true };
   }
@@ -201,20 +206,15 @@ function updateSiteConfig(targetDir, projectName, description, brandPreset, repo
     /const brandPreset:\s*BrandPresetKey\s*=\s*'[^']*'/,
     `const brandPreset: BrandPresetKey = '${brandPreset}'`
   );
-  if (repoUrl) {
-    source = source.replace(
-      /repoUrl:\s*'[^']*'/,
-      `repoUrl: '${repoUrl}'`
-    );
-    source = source.replace(
-      /\{\s*label:\s*'GitHub',\s*href:\s*'[^']*'\s*\}/,
-      `{ label: 'GitHub', href: '${repoUrl}' }`
-    );
-    source = source.replace(
-      /\{\s*label:\s*'Support',\s*href:\s*'[^']*'\s*\}/,
-      `{ label: 'Support', href: '${repoUrl}/issues/new' }`
-    );
-  }
+  source = source.replace(/repoUrl:\s*'[^']*'/, `repoUrl: '${repoUrl}'`);
+  source = source.replace(
+    /\{\s*label:\s*'GitHub',\s*href:\s*'[^']*'\s*\}/,
+    `{ label: 'GitHub', href: '${repoUrl}' }`
+  );
+  source = source.replace(
+    /\{\s*label:\s*'Support',\s*href:\s*'[^']*'\s*\}/,
+    `{ label: 'Support', href: '${repoUrl ? `${repoUrl}/issues/new` : ""}' }`
+  );
   writeFileSync(siteFile, source, "utf8");
 }
 function patchApiReferenceGuard(targetDir) {
@@ -366,7 +366,7 @@ async function scaffold(options) {
   }
   mkdirSync2(targetDir, { recursive: true });
   const slug = slugify(projectName);
-  await downloadTemplate(targetDir);
+  await downloadTemplate(targetDir, projectName);
   writeStarterContent(targetDir, projectName, slug, enableAiChat, repoUrl, i18nLocales);
   updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl);
   patchApiReferenceGuard(targetDir);

package/dist/{chunk-QB4U3KFX.js → chunk-GVYVHLAP.js}

@@ -3,7 +3,7 @@ import {
   initGit,
   installDeps,
   scaffold
-} from "./chunk-YY5QPPAG.js";
+} from "./chunk-23YWNWTH.js";
 
 // src/migrate/index.ts
 import { mkdirSync as mkdirSync2, copyFileSync as copyFileSync2, readFileSync as readFileSync3, writeFileSync, existsSync as existsSync3, mkdtempSync, rmSync } from "fs";

package/dist/index.js

@@ -2,13 +2,13 @@
 import {
   migrateDocs,
   parseGitHubUrl
-} from "./chunk-QB4U3KFX.js";
+} from "./chunk-GVYVHLAP.js";
 import {
   logo,
   scaffold,
   slugify,
   success
-} from "./chunk-YY5QPPAG.js";
+} from "./chunk-23YWNWTH.js";
 
 // src/index.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
@@ -99,6 +99,7 @@ async function gatherAnswers(dirArg, useDefaults) {
 // src/check.ts
 import { existsSync, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
 import { join as join2, extname, relative } from "path";
+import { execFileSync } from "child_process";
 import matter from "gray-matter";
 import { parse as parseYaml } from "yaml";
 
@@ -116,6 +117,57 @@ function writeDocsJson(projectDir, config) {
 }
 
 // src/check.ts
+function gitLocal(projectDir, args2) {
+  try {
+    const out = execFileSync("git", args2, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return { ok: true, out: out.trim() };
+  } catch {
+    return { ok: false, out: "" };
+  }
+}
+function checkDrift(projectDir, file, data, issues) {
+  const sources = data.sources;
+  const verifiedCommit = data.verifiedCommit;
+  if (!Array.isArray(sources) || sources.length === 0 || typeof verifiedCommit !== "string" || !verifiedCommit.trim()) {
+    return;
+  }
+  const commit = verifiedCommit.trim();
+  if (!gitLocal(projectDir, ["cat-file", "-e", `${commit}^{commit}`]).ok) {
+    issues.push({
+      severity: "warning",
+      message: `Cannot verify freshness: verifiedCommit "${commit.slice(0, 8)}" is not in git history \u2014 run with a full clone (fetch-depth: 0).`,
+      file
+    });
+    return;
+  }
+  for (const src of sources) {
+    if (typeof src !== "string" || !src.trim()) continue;
+    const colon = src.indexOf(":");
+    let filePath = src;
+    if (colon > 0) {
+      const alias = src.slice(0, colon);
+      if (alias !== "." && alias !== "self") {
+        issues.push({
+          severity: "warning",
+          message: `Cross-repo source "${src}" \u2014 drift check skipped (needs the referenced repo; see multi-repo setup).`,
+          file
+        });
+        continue;
+      }
+      filePath = src.slice(colon + 1);
+    }
+    filePath = filePath.replace(/^\.\//, "").replace(/#.*$/, "");
+    const changed = gitLocal(projectDir, ["log", "--format=%H", `${commit}..HEAD`, "--", filePath]).out;
+    if (changed) {
+      const n = changed.split("\n").filter(Boolean).length;
+      issues.push({
+        severity: "warning",
+        message: `Drift: source "${src}" changed in ${n} commit(s) since it was verified \u2014 this page may be stale.`,
+        file
+      });
+    }
+  }
+}
 function collectNavPageIds(groups, seen, duplicates) {
   for (const page of groups) {
     if (typeof page === "string") {
@@ -294,6 +346,7 @@ async function runCheck(projectDir, options) {
     if (!data.title) issues.push({ severity: "warning", message: `Missing "title" in frontmatter`, file: rel2 });
     if (!data.description) issues.push({ severity: "warning", message: `Missing "description" in frontmatter`, file: rel2 });
     if (content.trim().length < 50) issues.push({ severity: "warning", message: `Very short body (${content.trim().length} chars) \u2014 page may be empty`, file: rel2 });
+    if (options.drift) checkDrift(projectDir, rel2, data, issues);
     const path = pageIdToPath(pageId);
     const anchors = extractHeadingAnchors(content);
     validPaths.add(path);
@@ -704,7 +757,8 @@ async function runCheckCommand() {
   const exitCode = await runCheck(projectDir, {
     fix: flags.includes("--fix"),
     ci: flags.includes("--ci"),
-    external: flags.includes("--external")
+    external: flags.includes("--external"),
+    drift: flags.includes("--drift")
   });
   process.exit(exitCode);
 }

package/dist/migrate/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-QB4U3KFX.js";
-import "../chunk-YY5QPPAG.js";
+} from "../chunk-GVYVHLAP.js";
+import "../chunk-23YWNWTH.js";
 export {
   migrateDocs
 };

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-YY5QPPAG.js";
+} from "./chunk-23YWNWTH.js";
 export {
   scaffold
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dox",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Scaffold a new Dox documentation project",
   "type": "module",
   "engines": {