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

package/dist/cli/index.mjs

@@ -154,6 +154,30 @@ const THEME_INFO = {
 function getThemeInfo(theme) {
 	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
 }
+/** Config import for Next.js app/layout.tsx → root docs.config */
+function nextRootLayoutConfigImport(useAlias) {
+	return useAlias ? "@/docs.config" : "../docs.config";
+}
+/** Config import for Next.js app/{entry}/layout.tsx → root docs.config */
+function nextDocsLayoutConfigImport(useAlias) {
+	return useAlias ? "@/docs.config" : "../../docs.config";
+}
+/** Config import for SvelteKit src/lib/docs.server.ts → src/lib/docs.config.js */
+function svelteServerConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config.js" : "./docs.config.js";
+}
+/** Config import for SvelteKit src/routes/{entry}/+layout.svelte → src/lib/docs.config.js */
+function svelteLayoutConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config.js" : "../../lib/docs.config.js";
+}
+/** Config import for SvelteKit src/routes/{entry}/[...slug]/+page.svelte → src/lib/docs.config.js */
+function sveltePageConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config.js" : "../../../lib/docs.config.js";
+}
+/** Server import for SvelteKit +layout.server.js → src/lib/docs.server.js */
+function svelteLayoutServerImport(useAlias) {
+	return useAlias ? "$lib/docs.server.js" : "../../lib/docs.server.js";
+}
 function docsConfigTemplate(cfg) {
 	const t = getThemeInfo(cfg.theme);
 	return `\
@@ -199,7 +223,7 @@ function nextConfigMergedTemplate(existingContent) {
 	}
 	return lines.join("\n");
 }
-function rootLayoutTemplate(globalCssRelPath = "app/globals.css") {
+function rootLayoutTemplate(cfg, globalCssRelPath = "app/globals.css") {
 	let cssImport;
 	if (globalCssRelPath.startsWith("app/")) cssImport = "./" + globalCssRelPath.slice(4);
 	else if (globalCssRelPath.startsWith("src/app/")) cssImport = "./" + globalCssRelPath.slice(8);
@@ -207,7 +231,7 @@ function rootLayoutTemplate(globalCssRelPath = "app/globals.css") {
 	return `\
 import type { Metadata } from "next";
 import { RootProvider } from "@farming-labs/theme";
-import docsConfig from "@/docs.config";
+import docsConfig from "${nextRootLayoutConfigImport(cfg.useAlias)}";
 import "${cssImport}";
 
 export const metadata: Metadata = {
@@ -239,10 +263,6 @@ function globalCssTemplate(theme) {
 @import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";
 `;
 }
-/**
-* Inject the fumadocs CSS import into an existing global.css.
-* Returns the modified content, or null if already present.
-*/
 function injectCssImport(existingContent, theme) {
 	const importLine = `@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";`;
 	if (existingContent.includes(importLine)) return null;
@@ -253,9 +273,9 @@ function injectCssImport(existingContent, theme) {
 	else lines.unshift(importLine);
 	return lines.join("\n");
 }
-function docsLayoutTemplate() {
+function docsLayoutTemplate(cfg) {
 	return `\
-import docsConfig from "@/docs.config";
+import docsConfig from "${nextDocsLayoutConfigImport(cfg.useAlias)}";
 import { createDocsLayout } from "@farming-labs/theme";
 
 export default createDocsLayout(docsConfig);
@@ -506,7 +526,7 @@ export default defineDocs({
 function svelteDocsServerTemplate(cfg) {
 	return `\
 import { createDocsServer } from "@farming-labs/svelte/server";
-import config from "$lib/docs.config.js";
+import config from "${svelteServerConfigImport(cfg.useAlias)}";
 
 export const { load, GET, POST } = createDocsServer(config);
 `;
@@ -515,7 +535,7 @@ function svelteDocsLayoutTemplate(cfg) {
 	return `\
 <script>
   import { DocsLayout } from "@farming-labs/svelte-theme";
-  import config from "$lib/docs.config.js";
+  import config from "${svelteLayoutConfigImport(cfg.useAlias)}";
 
   let { data, children } = $props();
 <\/script>
@@ -525,16 +545,16 @@ function svelteDocsLayoutTemplate(cfg) {
 </DocsLayout>
 `;
 }
-function svelteDocsLayoutServerTemplate() {
+function svelteDocsLayoutServerTemplate(cfg) {
 	return `\
-export { load } from "$lib/docs.server.js";
+export { load } from "${svelteLayoutServerImport(cfg.useAlias)}";
 `;
 }
 function svelteDocsPageTemplate(cfg) {
 	return `\
 <script>
   import { DocsContent } from "@farming-labs/svelte-theme";
-  import config from "$lib/docs.config.js";
+  import config from "${sveltePageConfigImport(cfg.useAlias)}";
 
   let { data } = $props();
 <\/script>
@@ -793,6 +813,15 @@ async function init() {
 		p.outro(pc.red("Init cancelled."));
 		process.exit(0);
 	}
+	const aliasHint = framework === "nextjs" ? `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)` : `Uses ${pc.cyan("$lib/")} prefix (SvelteKit built-in)`;
+	const useAlias = await p.confirm({
+		message: `Use path aliases for imports? ${pc.dim(aliasHint)}`,
+		initialValue: false
+	});
+	if (p.isCancel(useAlias)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
 	const entry = await p.text({
 		message: "Where should your docs live?",
 		placeholder: "docs",
@@ -843,12 +872,14 @@ async function init() {
 		}
 		globalCssRelPath = cssPath;
 	}
-	const pkgJson = JSON.parse(readFileSafe(path.join(cwd, "package.json")));
+	const pkgJsonContent = readFileSafe(path.join(cwd, "package.json"));
+	const pkgJson = pkgJsonContent ? JSON.parse(pkgJsonContent) : { name: "my-project" };
 	const cfg = {
 		entry: entryPath,
 		theme,
 		projectName: pkgJson.name || "My Project",
-		framework
+		framework,
+		useAlias
 	};
 	const s = p.spinner();
 	s.start("Scaffolding docs files");
@@ -954,7 +985,7 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 			written.push(configFile + " (updated)");
 		} else skipped.push(configFile + " (already configured)");
 	} else write("next.config.ts", nextConfigTemplate());
-	write("app/layout.tsx", rootLayoutTemplate(globalCssRelPath));
+	write("app/layout.tsx", rootLayoutTemplate(cfg, globalCssRelPath));
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	if (existingGlobalCss) {
@@ -964,7 +995,7 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
 	} else write(globalCssRelPath, globalCssTemplate(cfg.theme));
-	write(`app/${cfg.entry}/layout.tsx`, docsLayoutTemplate());
+	write(`app/${cfg.entry}/layout.tsx`, docsLayoutTemplate(cfg));
 	write("postcss.config.mjs", postcssConfigTemplate());
 	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate());
 	write(`app/${cfg.entry}/page.mdx`, welcomePageTemplate(cfg));
@@ -975,7 +1006,7 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 	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());
+	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
 	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
 	if (!readFileSafe(path.join(cwd, "src/routes/+layout.svelte"))) write("src/routes/+layout.svelte", svelteRootLayoutTemplate(globalCssRelPath));
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);

package/package.json

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