@farming-labs/docs 0.1.62 → 0.1.64

package/dist/cli/index.mjs

@@ -77,10 +77,10 @@ async function main() {
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-CcgI3D7-.mjs");
+		const { init } = await import("../init-BFhnsS7P.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-VD41gGZC.mjs");
+		const { dev } = await import("../dev-Cj7kSQsB.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
 		const { runMcp } = await import("../mcp-BANLcwQ0.mjs");
@@ -139,7 +139,7 @@ ${pc.dim("Usage:")}
 
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
-  ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.cloud.json")}
+  ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.json")}
   ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
   ${pc.cyan("mcp")}      Run the built-in docs MCP server over stdio

package/dist/{dev-VD41gGZC.mjs → dev-Cj7kSQsB.mjs}

@@ -1,4 +1,4 @@
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-2M1vfnf-.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-BLSQ8EwL.mjs";
 import { i as detectPackageManagerFromLockfile } from "./utils-DSMXVnEu.mjs";
 import fs from "node:fs";
 import path from "node:path";
@@ -63,7 +63,8 @@ function printDevBanner({ name = "@farming-labs/docs", version = "v0.0.0", port,
 
 //#endregion
 //#region src/cli/dev.ts
-const MANAGED_CONFIG_FILE = "docs.cloud.json";
+const PRIMARY_MANAGED_CONFIG_FILE = "docs.json";
+const LEGACY_MANAGED_CONFIG_FILE = "docs.cloud.json";
 const DEFAULT_RUNTIME_ROOT = ".docs/site";
 const DEFAULT_DOCS_ROOT = "docs";
 const DEFAULT_API_REFERENCE_ROOT = "api-reference";
@@ -134,6 +135,12 @@ const THEME_PRESETS = {
 		importPath: "@farming-labs/theme/shiny",
 		factory: "shiny"
 	},
+	ledger: {
+		configName: "ledger",
+		templateTheme: "ledger",
+		importPath: "@farming-labs/theme/ledger",
+		factory: "ledger"
+	},
 	greentree: {
 		configName: "greentree",
 		templateTheme: "greentree",
@@ -426,19 +433,31 @@ function detectNearestPackageManager(startDir) {
 		current = parent;
 	}
 }
+function resolveManagedConfigPath(projectRoot) {
+	const primaryPath = path.join(projectRoot, PRIMARY_MANAGED_CONFIG_FILE);
+	if (fs.existsSync(primaryPath)) return {
+		configPath: primaryPath,
+		configFileName: PRIMARY_MANAGED_CONFIG_FILE
+	};
+	const legacyPath = path.join(projectRoot, LEGACY_MANAGED_CONFIG_FILE);
+	if (fs.existsSync(legacyPath)) return {
+		configPath: legacyPath,
+		configFileName: LEGACY_MANAGED_CONFIG_FILE
+	};
+	throw new Error(`Could not find ${PRIMARY_MANAGED_CONFIG_FILE} in ${projectRoot}. Frameworkless dev expects ${PRIMARY_MANAGED_CONFIG_FILE}, ${DEFAULT_DOCS_ROOT}/, and optionally ${DEFAULT_API_REFERENCE_ROOT}/. ${LEGACY_MANAGED_CONFIG_FILE} is still supported for older repos.`);
+}
 function readManagedDocsProject(projectRoot) {
-	const configPath = path.join(projectRoot, MANAGED_CONFIG_FILE);
-	if (!fs.existsSync(configPath)) throw new Error(`Could not find ${MANAGED_CONFIG_FILE} in ${projectRoot}. Frameworkless dev expects ${MANAGED_CONFIG_FILE}, ${DEFAULT_DOCS_ROOT}/, and optionally ${DEFAULT_API_REFERENCE_ROOT}/.`);
+	const { configPath, configFileName } = resolveManagedConfigPath(projectRoot);
 	let parsedJson;
 	try {
 		parsedJson = JSON.parse(fs.readFileSync(configPath, "utf-8"));
 	} catch (error) {
-		throw new Error(`Could not parse ${MANAGED_CONFIG_FILE}. The file must be valid JSON.${error instanceof Error ? ` ${error.message}` : ""}`);
+		throw new Error(`Could not parse ${configFileName}. The file must be valid JSON.${error instanceof Error ? ` ${error.message}` : ""}`);
 	}
 	const parsed = managedConfigSchema.safeParse(parsedJson);
-	if (!parsed.success) throw new Error(`Invalid ${MANAGED_CONFIG_FILE}: ${formatZodError(parsed.error)}`);
+	if (!parsed.success) throw new Error(`Invalid ${configFileName}: ${formatZodError(parsed.error)}`);
 	const docsConfig = parsed.data.docs;
-	if (("mode" in docsConfig ? docsConfig.mode : docsConfig.framework === "managed" ? "frameworkless" : "framework") !== "frameworkless") throw new Error(`${MANAGED_CONFIG_FILE} uses docs.mode = "framework". ${pc.cyan("docs dev")} only supports frameworkless projects right now.`);
+	if (("mode" in docsConfig ? docsConfig.mode : docsConfig.framework === "managed" ? "frameworkless" : "framework") !== "frameworkless") throw new Error(`${configFileName} uses docs.mode = "framework". ${pc.cyan("docs dev")} only supports frameworkless projects right now.`);
 	const runtimeFramework = "runtime" in docsConfig && docsConfig.runtime ? docsConfig.runtime : "nextjs";
 	if (runtimeFramework !== "nextjs") throw new Error(`Frameworkless ${pc.cyan("docs dev")} currently supports only docs.runtime = "nextjs".`);
 	const docsRoot = parsed.data.content?.docsRoot ?? DEFAULT_DOCS_ROOT;
@@ -452,6 +471,7 @@ function readManagedDocsProject(projectRoot) {
 	const theme = resolveThemePreset(parsed.data.theme?.preset);
 	return {
 		configPath,
+		configFileName,
 		projectRoot,
 		runtimeDir,
 		runtimeFramework,
@@ -665,7 +685,7 @@ function validateManagedOpenApiSpec(project) {
 	if (!sourcePath) return;
 	if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isFile()) {
 		const relativePath = path.relative(project.projectRoot, sourcePath) || sourcePath;
-		throw new Error(`OpenAPI source not found at ${relativePath}. Update ${MANAGED_CONFIG_FILE} or add the spec file and try again.`);
+		throw new Error(`OpenAPI source not found at ${relativePath}. Update ${project.configFileName} or add the spec file and try again.`);
 	}
 }
 function renderAlternateSectionLayout(configImportPath) {
@@ -895,7 +915,7 @@ function materializeManagedRuntime(projectRoot) {
 	const hasDocsMarkdown = directoryHasMarkdown(docsSourceDir);
 	const hasApiReferenceMarkdown = directoryHasMarkdown(apiReferenceSourceDir);
 	validateManagedOpenApiSpec(project);
-	if (!hasDocsMarkdown && !hasApiReferenceMarkdown && !hasOpenApiSpec) throw new Error(`No docs content found. Add markdown files under ${project.docsRoot}/ or ${project.apiReferenceRoot}/, or point content.openapi at an OpenAPI file in ${MANAGED_CONFIG_FILE}.`);
+	if (!hasDocsMarkdown && !hasApiReferenceMarkdown && !hasOpenApiSpec) throw new Error(`No docs content found. Add markdown files under ${project.docsRoot}/ or ${project.apiReferenceRoot}/, or point content.openapi at an OpenAPI file in ${project.configFileName}.`);
 	const templateConfig = {
 		entry: "docs",
 		theme: project.theme.templateTheme,
@@ -1140,9 +1160,9 @@ async function dev(options = {}) {
 	const runtimeInstallStamp = getRuntimeInstallStamp(project);
 	console.log(pc.dim("Preparing local preview..."));
 	if (options.verbose) {
-		logLine("source", `${pc.cyan(MANAGED_CONFIG_FILE)} drives ${pc.cyan(`${project.docsRoot}/`)} and ${pc.cyan(`${project.apiReferenceRoot}/`)}`);
+		logLine("source", `${pc.cyan(project.configFileName)} drives ${pc.cyan(`${project.docsRoot}/`)} and ${pc.cyan(`${project.apiReferenceRoot}/`)}`);
 		logLine("runtime", `Generated runtime at ${pc.cyan(path.relative(projectRoot, project.runtimeDir) || project.runtimeDir)}`);
-		logLine("watch", `Watching ${project.docsRoot}/, ${project.apiReferenceRoot}/, and ${MANAGED_CONFIG_FILE}`);
+		logLine("watch", `Watching ${project.docsRoot}/, ${project.apiReferenceRoot}/, and ${project.configFileName}`);
 		logLine("sync", `Loaded ${initial.docs.pageCount} docs page${initial.docs.pageCount === 1 ? "" : "s"} and ${initial.apiReference.pageCount} api-reference page${initial.apiReference.pageCount === 1 ? "" : "s"}`);
 	}
 	if (!fs.existsSync(runtimeNodeModules) || !fs.existsSync(runtimeInstallMarker) || fs.readFileSync(runtimeInstallMarker, "utf-8") !== runtimeInstallStamp) {

package/dist/{init-CcgI3D7-.mjs → init-BFhnsS7P.mjs}

@@ -1,4 +1,4 @@
-import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-2M1vfnf-.mjs";
+import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-BLSQ8EwL.mjs";
 import { a as devInstallCommand, c as installCommand, d as writeFileSafe, i as detectPackageManagerFromLockfile, l as readFileSafe, n as detectGlobalCssFiles, o as exec, r as detectNextAppDir, s as fileExists, t as detectFramework, u as spawnAndWaitFor } from "./utils-DSMXVnEu.mjs";
 import fs from "node:fs";
 import path from "node:path";
@@ -377,6 +377,11 @@ async function init(options = {}) {
 			label: "Shiny",
 			hint: "Glossy, modern look with subtle shimmer effects"
 		},
+		{
+			value: "ledger",
+			label: "Ledger",
+			hint: "Stripe Docs-inspired product docs shell with navy code panels"
+		},
 		{
 			value: "greentree",
 			label: "GreenTree",
@@ -1037,6 +1042,7 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 		colorful: "colorful",
 		darkbold: "darkbold",
 		shiny: "shiny",
+		ledger: "ledger",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",
@@ -1093,6 +1099,7 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		colorful: "colorful",
 		darkbold: "darkbold",
 		shiny: "shiny",
+		ledger: "ledger",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",
@@ -1136,6 +1143,7 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		colorful: "colorful",
 		darkbold: "darkbold",
 		shiny: "shiny",
+		ledger: "ledger",
 		greentree: "greentree",
 		concrete: "concrete",
 		"command-grid": "command-grid",

package/dist/{templates-2M1vfnf-.mjs → templates-BLSQ8EwL.mjs}

@@ -68,6 +68,17 @@ const THEME_INFO = {
 		astroCssTheme: "shiny",
 		nuxtCssTheme: "shiny"
 	},
+	ledger: {
+		factory: "ledger",
+		nextImport: "@farming-labs/theme/ledger",
+		svelteImport: "@farming-labs/svelte-theme/ledger",
+		astroImport: "@farming-labs/astro-theme/ledger",
+		nuxtImport: "@farming-labs/nuxt-theme/ledger",
+		nextCssImport: "ledger",
+		svelteCssTheme: "ledger",
+		astroCssTheme: "ledger",
+		nuxtCssTheme: "ledger"
+	},
 	greentree: {
 		factory: "greentree",
 		nextImport: "@farming-labs/theme/greentree",

package/package.json

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