@farming-labs/docs 0.0.16 → 0.0.18

package/dist/cli/index.mjs

@@ -1699,21 +1699,75 @@ const VALID_TEMPLATES = [
 async function init(options = {}) {
 	const cwd = process.cwd();
 	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
-	if (options.template) {
-		const template = options.template.toLowerCase();
-		if (!VALID_TEMPLATES.includes(template)) {
-			p.log.error(`Invalid ${pc.cyan("--template")}. Use one of: ${VALID_TEMPLATES.map((t) => pc.cyan(t)).join(", ")}`);
-			process.exit(1);
+	let projectType = "existing";
+	if (!options.template) {
+		const projectTypeAnswer = await p.select({
+			message: "Are you adding docs to an existing project or starting fresh?",
+			options: [{
+				value: "existing",
+				label: "Existing project",
+				hint: "Add docs to the current app in this directory"
+			}, {
+				value: "fresh",
+				label: "Fresh project",
+				hint: "Bootstrap a new app from a template (Next, Nuxt, SvelteKit, Astro)"
+			}]
+		});
+		if (p.isCancel(projectTypeAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		projectType = projectTypeAnswer;
+	}
+	if (projectType === "fresh" || options.template) {
+		let template;
+		if (options.template) {
+			template = options.template.toLowerCase();
+			if (!VALID_TEMPLATES.includes(template)) {
+				p.log.error(`Invalid ${pc.cyan("--template")}. Use one of: ${VALID_TEMPLATES.map((t) => pc.cyan(t)).join(", ")}`);
+				process.exit(1);
+			}
+		} else {
+			const templateAnswer = await p.select({
+				message: "Which framework would you like to use?",
+				options: [
+					{
+						value: "next",
+						label: "Next.js",
+						hint: "React with App Router"
+					},
+					{
+						value: "nuxt",
+						label: "Nuxt",
+						hint: "Vue 3 with file-based routing"
+					},
+					{
+						value: "sveltekit",
+						label: "SvelteKit",
+						hint: "Svelte with file-based routing"
+					},
+					{
+						value: "astro",
+						label: "Astro",
+						hint: "Content-focused with islands"
+					}
+				]
+			});
+			if (p.isCancel(templateAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			template = templateAnswer;
 		}
+		const defaultProjectName = "my-docs";
 		let projectName = options.name?.trim();
 		if (!projectName) {
 			const nameAnswer = await p.text({
 				message: "Project name? (we'll create this folder and bootstrap the app here)",
-				placeholder: "my-docs",
-				defaultValue: "my-docs",
+				placeholder: defaultProjectName,
+				defaultValue: defaultProjectName,
 				validate: (value) => {
 					const v = (value ?? "").trim();
-					if (!v) return "Project name is required";
 					if (v.includes("/") || v.includes("\\")) return "Project name cannot contain path separators";
 					if (v.includes(" ")) return "Project name cannot contain spaces";
 				}
@@ -1722,7 +1776,7 @@ async function init(options = {}) {
 				p.outro(pc.red("Init cancelled."));
 				process.exit(0);
 			}
-			projectName = nameAnswer.trim();
+			projectName = nameAnswer.trim() || defaultProjectName;
 		}
 		const templateLabel = template === "next" ? "Next.js" : template === "nuxt" ? "Nuxt" : template === "sveltekit" ? "SvelteKit" : "Astro";
 		const targetDir = path.join(cwd, projectName);
@@ -1834,25 +1888,25 @@ async function init(options = {}) {
 		p.outro(pc.red("Init cancelled."));
 		process.exit(0);
 	}
+	const defaultThemeName = "my-theme";
 	let customThemeName;
 	if (theme === "custom") {
 		const nameAnswer = await p.text({
 			message: "Theme name? (we'll create themes/<name>.ts and themes/<name>.css)",
-			placeholder: "my-theme",
-			defaultValue: "my-theme",
+			placeholder: defaultThemeName,
+			defaultValue: defaultThemeName,
 			validate: (value) => {
 				const v = (value ?? "").trim().replace(/\.(ts|css)$/i, "");
-				if (!v) return "Theme name is required";
 				if (v.includes("/") || v.includes("\\")) return "Theme name cannot contain path separators";
 				if (v.includes(" ")) return "Theme name cannot contain spaces";
-				if (!/^[a-z0-9_-]+$/i.test(v)) return "Use only letters, numbers, hyphens, and underscores";
+				if (v && !/^[a-z0-9_-]+$/i.test(v)) return "Use only letters, numbers, hyphens, and underscores";
 			}
 		});
 		if (p.isCancel(nameAnswer)) {
 			p.outro(pc.red("Init cancelled."));
 			process.exit(0);
 		}
-		customThemeName = nameAnswer.trim().replace(/\.(ts|css)$/i, "");
+		customThemeName = nameAnswer.trim().replace(/\.(ts|css)$/i, "") || defaultThemeName;
 	}
 	const aliasHint = framework === "nextjs" ? `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)` : framework === "sveltekit" ? `Uses ${pc.cyan("$lib/")} prefix (SvelteKit built-in)` : framework === "nuxt" ? `Uses ${pc.cyan("~/")} prefix (Nuxt built-in)` : `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)`;
 	const useAlias = await p.confirm({
@@ -1894,21 +1948,22 @@ async function init(options = {}) {
 		}
 		astroAdapter = adapter;
 	}
+	const defaultEntry = "docs";
 	const entry = await p.text({
 		message: "Where should your docs live?",
-		placeholder: "docs",
-		defaultValue: "docs",
+		placeholder: defaultEntry,
+		defaultValue: defaultEntry,
 		validate: (value) => {
-			if (!value) return "Entry path is required";
-			if (value.startsWith("/")) return "Use a relative path (no leading /)";
-			if (value.includes(" ")) return "Path cannot contain spaces";
+			const v = (value ?? "").trim();
+			if (v.startsWith("/")) return "Use a relative path (no leading /)";
+			if (v.includes(" ")) return "Path cannot contain spaces";
 		}
 	});
 	if (p.isCancel(entry)) {
 		p.outro(pc.red("Init cancelled."));
 		process.exit(0);
 	}
-	const entryPath = entry;
+	const entryPath = entry.trim() || defaultEntry;
 	const detectedCssFiles = detectGlobalCssFiles(cwd);
 	let globalCssRelPath;
 	const defaultCssPath = framework === "sveltekit" ? "src/app.css" : framework === "astro" ? "src/styles/global.css" : framework === "nuxt" ? "assets/css/main.css" : "app/globals.css";
@@ -1929,20 +1984,20 @@ async function init(options = {}) {
 		}
 		globalCssRelPath = picked;
 	} else {
-		const cssPath = await p.text({
+		const cssPathAnswer = await p.text({
 			message: "Where is your global CSS file?",
 			placeholder: defaultCssPath,
 			defaultValue: defaultCssPath,
 			validate: (value) => {
-				if (!value) return "CSS file path is required";
-				if (!value.endsWith(".css")) return "Path must end with .css";
+				const v = (value ?? "").trim();
+				if (v && !v.endsWith(".css")) return "Path must end with .css";
 			}
 		});
-		if (p.isCancel(cssPath)) {
+		if (p.isCancel(cssPathAnswer)) {
 			p.outro(pc.red("Init cancelled."));
 			process.exit(0);
 		}
-		globalCssRelPath = cssPath;
+		globalCssRelPath = cssPathAnswer.trim() || defaultCssPath;
 	}
 	const pkgJsonContent = readFileSafe(path.join(cwd, "package.json"));
 	const pkgJson = pkgJsonContent ? JSON.parse(pkgJsonContent) : { name: "my-project" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",