@farming-labs/docs 0.0.2-beta.4 → 0.0.2-beta.6

package/dist/cli/index.mjs

@@ -128,14 +128,41 @@ function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
 
 //#endregion
 //#region src/cli/templates.ts
+const THEME_INFO = {
+	fumadocs: {
+		factory: "fumadocs",
+		nextImport: "@farming-labs/theme",
+		svelteImport: "@farming-labs/svelte-theme",
+		nextCssImport: "default",
+		svelteCssTheme: "fumadocs"
+	},
+	darksharp: {
+		factory: "darksharp",
+		nextImport: "@farming-labs/theme/darksharp",
+		svelteImport: "@farming-labs/svelte-theme/darksharp",
+		nextCssImport: "darksharp",
+		svelteCssTheme: "darksharp"
+	},
+	"pixel-border": {
+		factory: "pixelBorder",
+		nextImport: "@farming-labs/theme/pixel-border",
+		svelteImport: "@farming-labs/svelte-theme/pixel-border",
+		nextCssImport: "pixel-border",
+		svelteCssTheme: "pixel-border"
+	}
+};
+function getThemeInfo(theme) {
+	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
+}
 function docsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/theme";
+import { ${t.factory} } from "${t.nextImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -209,7 +236,7 @@ export default function RootLayout({
 function globalCssTemplate(theme) {
 	return `\
 @import "tailwindcss";
-@import "@farming-labs/${theme}/css";
+@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";
 `;
 }
 /**
@@ -217,8 +244,9 @@ function globalCssTemplate(theme) {
 * Returns the modified content, or null if already present.
 */
 function injectCssImport(existingContent, theme) {
-	const importLine = `@import "@farming-labs/${theme}/css";`;
+	const importLine = `@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";`;
 	if (existingContent.includes(importLine)) return null;
+	if (existingContent.includes("@farming-labs/theme/") && existingContent.includes("/css")) return null;
 	const lines = existingContent.split("\n");
 	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
 	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
@@ -307,6 +335,7 @@ Start by reading the [Installation](/${cfg.entry}/installation) guide, then foll
 `;
 }
 function installationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Installation"
@@ -333,11 +362,11 @@ Your project includes a \`docs.config.ts\` at the root:
 
 \`\`\`ts
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/theme";
+import { ${t.factory} } from "${t.nextImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: { colors: { primary: "#6366f1" } },
   }),
 });
@@ -364,6 +393,7 @@ Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your f
 `;
 }
 function quickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Quickstart"
@@ -426,7 +456,7 @@ console.log(greet("World"));
 Edit \`docs.config.ts\` to change colors, typography, and component defaults:
 
 \`\`\`ts
-theme: fumadocs({
+theme: ${t.factory}({
   ui: {
     colors: { primary: "#22c55e" },
   },
@@ -445,14 +475,15 @@ Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
 function svelteDocsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/svelte-theme";
+import { ${t.factory} } from "${t.svelteImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -475,7 +506,7 @@ export default defineDocs({
 function svelteDocsServerTemplate(cfg) {
 	return `\
 import { createDocsServer } from "@farming-labs/svelte/server";
-import config from "../../docs.config.js";
+import config from "$lib/docs.config.js";
 
 export const { load, GET, POST } = createDocsServer(config);
 `;
@@ -484,7 +515,7 @@ function svelteDocsLayoutTemplate(cfg) {
 	return `\
 <script>
   import { DocsLayout } from "@farming-labs/svelte-theme";
-  import config from "../../../docs.config.js";
+  import config from "$lib/docs.config.js";
 
   let { data, children } = $props();
 <\/script>
@@ -503,7 +534,7 @@ function svelteDocsPageTemplate(cfg) {
 	return `\
 <script>
   import { DocsContent } from "@farming-labs/svelte-theme";
-  import config from "../../../../docs.config.js";
+  import config from "$lib/docs.config.js";
 
   let { data } = $props();
 <\/script>
@@ -573,6 +604,7 @@ Start by reading the [Installation](/${cfg.entry}/installation) guide, then foll
 `;
 }
 function svelteInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Installation"
@@ -596,16 +628,16 @@ pnpm add @farming-labs/docs @farming-labs/svelte @farming-labs/svelte-theme
 
 ## Configuration
 
-Your project includes a \`docs.config.ts\` at the root:
+Your project includes a \`docs.config.ts\` in \`src/lib/\`:
 
-\`\`\`ts title="docs.config.ts"
+\`\`\`ts title="src/lib/docs.config.ts"
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/svelte-theme";
+import { ${t.factory} } from "${t.svelteImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
   contentDir: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: { colors: { primary: "#6366f1" } },
   }),
 });
@@ -622,6 +654,7 @@ ${cfg.entry}/                   # Markdown content
     page.md                    # /${cfg.entry}/quickstart
 src/
   lib/
+    docs.config.ts             # Docs configuration
     docs.server.ts             # Server-side docs loader
   routes/
     ${cfg.entry}/
@@ -629,7 +662,6 @@ src/
       +layout.server.js        # Layout data loader
       [...slug]/
         +page.svelte           # Dynamic doc page
-docs.config.ts                 # Docs configuration
 \`\`\`
 
 ## What's Next?
@@ -638,6 +670,7 @@ Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your f
 `;
 }
 function svelteQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Quickstart"
@@ -685,10 +718,10 @@ console.log(greet("World"));
 
 ## Customizing the Theme
 
-Edit \`docs.config.ts\` to change colors, typography, and component defaults:
+Edit \`src/lib/docs.config.ts\` to change colors, typography, and component defaults:
 
-\`\`\`ts title="docs.config.ts"
-theme: fumadocs({
+\`\`\`ts title="src/lib/docs.config.ts"
+theme: ${t.factory}({
   ui: {
     colors: { primary: "#22c55e" },
   },
@@ -712,30 +745,49 @@ Deploy to Vercel, Netlify, or any Node.js hosting platform.
 async function init() {
 	const cwd = process.cwd();
 	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
-	const framework = detectFramework(cwd);
-	if (!framework) {
-		p.log.error("Could not detect a supported framework.\n  Make sure you have a " + pc.cyan("package.json") + " with " + pc.cyan("next") + " or " + pc.cyan("@sveltejs/kit") + " installed.\n  Supported frameworks: Next.js, SvelteKit");
-		p.outro(pc.red("Init cancelled."));
-		process.exit(1);
+	let framework = detectFramework(cwd);
+	if (framework) {
+		const frameworkName = framework === "nextjs" ? "Next.js" : "SvelteKit";
+		p.log.success(`Detected framework: ${pc.cyan(frameworkName)}`);
+	} else {
+		p.log.warn("Could not auto-detect a framework from " + pc.cyan("package.json") + ".");
+		const picked = await p.select({
+			message: "Which framework are you using?",
+			options: [{
+				value: "nextjs",
+				label: "Next.js",
+				hint: "React framework with App Router"
+			}, {
+				value: "sveltekit",
+				label: "SvelteKit",
+				hint: "Svelte framework with file-based routing"
+			}]
+		});
+		if (p.isCancel(picked)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		framework = picked;
 	}
-	const frameworkName = framework === "nextjs" ? "Next.js" : "SvelteKit";
-	p.log.success(`Detected framework: ${pc.cyan(frameworkName)}`);
-	const themeOptions = framework === "sveltekit" ? [{
-		value: "default",
-		label: "Default",
-		hint: "Clean, modern docs theme with sidebar, search, and dark mode"
-	}, {
-		value: "pixel-border",
-		label: "Pixel Border",
-		hint: "Sharp pixel-art inspired theme with monospace text"
-	}] : [{
-		value: "fumadocs",
-		label: "Fumadocs",
-		hint: "Clean, modern docs theme with sidebar, search, and dark mode"
-	}];
 	const theme = await p.select({
 		message: "Which theme would you like to use?",
-		options: themeOptions
+		options: [
+			{
+				value: "fumadocs",
+				label: "Fumadocs (Default)",
+				hint: "Clean, modern docs theme with sidebar, search, and dark mode"
+			},
+			{
+				value: "darksharp",
+				label: "Darksharp",
+				hint: "All-black, sharp edges, zero-radius look"
+			},
+			{
+				value: "pixel-border",
+				label: "Pixel Border",
+				hint: "Rounded borders, pixel-perfect spacing, refined sidebar"
+			}
+		]
 	});
 	if (p.isCancel(theme)) {
 		p.outro(pc.red("Init cancelled."));
@@ -920,7 +972,7 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	write(`app/${cfg.entry}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
 }
 function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written) {
-	write("docs.config.ts", svelteDocsConfigTemplate(cfg));
+	write("src/lib/docs.config.ts", svelteDocsConfigTemplate(cfg));
 	write("src/lib/docs.server.ts", svelteDocsServerTemplate(cfg));
 	write(`src/routes/${cfg.entry}/+layout.svelte`, svelteDocsLayoutTemplate(cfg));
 	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate());
@@ -929,9 +981,10 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	const cssTheme = {
-		default: "fumadocs",
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
 		"pixel-border": "pixel-border",
-		fumadocs: "fumadocs"
+		default: "fumadocs"
 	}[cfg.theme] || "fumadocs";
 	if (existingGlobalCss) {
 		const injected = injectSvelteCssImport(existingGlobalCss, cssTheme);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.2-beta.4",
+  "version": "0.0.2-beta.6",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "type": "module",
   "main": "./dist/index.mjs",