@farming-labs/docs 0.0.5-beta.1 → 0.0.5

package/dist/cli/index.d.mts

@@ -1 +1,5 @@
-export { };
+//#region src/cli/index.d.ts
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro (exported for tests). */
+declare function parseFlags(argv: string[]): Record<string, string | undefined>;
+//#endregion
+export { parseFlags };

package/dist/cli/index.mjs

@@ -286,7 +286,7 @@ function nextConfigMergedTemplate(existingContent) {
 	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("import ") ? i : acc, -1);
 	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
 	else lines.unshift(importLine, "");
-	const adjustedExportIdx = exportIdx + (lastImportIdx >= 0 && exportIdx > lastImportIdx ? 1 : 0);
+	const adjustedExportIdx = exportIdx + (lastImportIdx >= 0 ? exportIdx > lastImportIdx ? 1 : 0 : 2);
 	const simpleMatch = lines[adjustedExportIdx].match(/^(\s*export\s+default\s+)(.*?)(;?\s*)$/);
 	if (simpleMatch) {
 		const [, prefix, value, suffix] = simpleMatch;
@@ -328,6 +328,32 @@ export default function RootLayout({
 }
 `;
 }
+/**
+* Injects RootProvider (import + wrapper) into an existing root layout without overwriting.
+* Returns the modified content, or null if RootProvider is already present or injection isn't possible.
+*/
+function injectRootProviderIntoLayout(content) {
+	if (!content || content.includes("RootProvider")) return null;
+	let out = content;
+	const themeImport = "import { RootProvider } from \"@farming-labs/theme\";";
+	if (!out.includes("@farming-labs/theme")) {
+		const lines = out.split("\n");
+		let lastImportIdx = -1;
+		for (let i = 0; i < lines.length; i++) {
+			const trimmed = lines[i].trimStart();
+			if (trimmed.startsWith("import ") || trimmed.startsWith("import type ")) lastImportIdx = i;
+		}
+		if (lastImportIdx >= 0) {
+			lines.splice(lastImportIdx + 1, 0, themeImport);
+			out = lines.join("\n");
+		} else out = themeImport + "\n" + out;
+	}
+	if (!out.includes("<RootProvider>")) {
+		const childrenPattern = /\{children\}/;
+		if (childrenPattern.test(out)) out = out.replace(childrenPattern, "<RootProvider>{children}</RootProvider>");
+	}
+	return out === content ? null : out;
+}
 function globalCssTemplate(theme) {
 	return `\
 @import "tailwindcss";
@@ -347,9 +373,19 @@ function injectCssImport(existingContent, theme) {
 function docsLayoutTemplate(cfg) {
 	return `\
 import docsConfig from "${nextDocsLayoutConfigImport(cfg.useAlias)}";
-import { createDocsLayout } from "@farming-labs/theme";
+import { createDocsLayout, createDocsMetadata } from "@farming-labs/theme";
+
+export const metadata = createDocsMetadata(docsConfig);
+
+const DocsLayout = createDocsLayout(docsConfig);
 
-export default createDocsLayout(docsConfig);
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <DocsLayout>{children}</DocsLayout>
+    </>
+  );
+}
 `;
 }
 function postcssConfigTemplate() {
@@ -1820,7 +1856,7 @@ async function init(options = {}) {
 			});
 		});
 	} catch (err) {
-		const manualCmd = framework === "sveltekit" ? "npx vite dev" : framework === "astro" ? "npx astro dev" : framework === "nuxt" ? "npx nuxt dev" : "npx next dev --webpack";
+		const manualCmd = framework === "sveltekit" ? "npx vite dev" : framework === "astro" ? "npx astro dev" : framework === "nuxt" ? "npx nuxt dev" : "pnpm dev";
 		p.log.error(`Could not start dev server. Try running manually:
   ${pc.cyan(manualCmd)}`);
 		p.outro(pc.yellow("Setup complete. Start the server manually."));
@@ -1838,7 +1874,16 @@ 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(cfg, globalCssRelPath));
+	const rootLayoutPath = path.join(cwd, "app/layout.tsx");
+	const existingRootLayout = readFileSafe(rootLayoutPath);
+	if (!existingRootLayout) write("app/layout.tsx", rootLayoutTemplate(cfg, globalCssRelPath), true);
+	else if (!existingRootLayout.includes("RootProvider")) {
+		const injected = injectRootProviderIntoLayout(existingRootLayout);
+		if (injected) {
+			writeFileSafe(rootLayoutPath, injected, true);
+			written.push("app/layout.tsx (injected RootProvider)");
+		} else skipped.push("app/layout.tsx (could not inject RootProvider)");
+	} else skipped.push("app/layout.tsx (already has RootProvider)");
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	if (existingGlobalCss) {
@@ -1988,6 +2033,15 @@ function presetFromFramework(fw) {
 function frameworkFromPreset(preset) {
 	return preset === "next" ? "nextjs" : preset;
 }
+/** Return package list for a framework (for testing and CLI). */
+function getPackagesForFramework(framework) {
+	return PACKAGES_BY_FRAMEWORK[framework];
+}
+/** Build the install command for upgrade (for testing). */
+function buildUpgradeCommand(framework, tag, pm) {
+	const packagesWithTag = PACKAGES_BY_FRAMEWORK[framework].map((name) => `${name}@${tag}`);
+	return `${installCommand(pm)} ${packagesWithTag.join(" ")}`;
+}
 async function upgrade(options = {}) {
 	const cwd = process.cwd();
 	const tag = options.tag ?? "latest";
@@ -2015,9 +2069,9 @@ async function upgrade(options = {}) {
 		}
 		preset = presetFromFramework(framework);
 	}
-	const packages = PACKAGES_BY_FRAMEWORK[framework];
-	const packagesWithTag = packages.map((name) => `${name}@${tag}`);
-	const cmd = `${installCommand(detectPackageManager(cwd))} ${packagesWithTag.join(" ")}`;
+	const pm = detectPackageManager(cwd);
+	const cmd = buildUpgradeCommand(framework, tag, pm);
+	const packages = getPackagesForFramework(framework);
 	p.log.step(`Upgrading ${preset} docs packages to ${tag}...`);
 	p.log.message(pc.dim(packages.join(", ")));
 	try {
@@ -2034,7 +2088,7 @@ async function upgrade(options = {}) {
 //#region src/cli/index.ts
 const args = process.argv.slice(2);
 const command = args[0];
-/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro */
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs, --framework astro (exported for tests). */
 function parseFlags(argv) {
 	const flags = {};
 	for (let i = 0; i < argv.length; i++) {
@@ -2110,4 +2164,4 @@ main().catch((err) => {
 });
 
 //#endregion
-export {  };
+export { parseFlags };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.5-beta.1",
+  "version": "0.0.5",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -34,11 +34,14 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }