@farming-labs/theme 0.1.3 → 0.1.4

package/dist/docs-api.d.mts

@@ -26,8 +26,11 @@ interface AIOptions {
   maxResults?: number;
 }
 interface DocsAPIOptions {
+  rootDir?: string;
   /** Docs entry folder (default: read from docs.config) */
   entry?: string;
+  /** Override the docs content directory when it does not live in app/<entry>. */
+  contentDir?: string;
   /** Search language (default: "english") */
   language?: string;
   /** AI chat configuration */
@@ -67,6 +70,10 @@ interface DocsMCPAPIOptions {
  *
  * @param options - Optional overrides (entry, language, ai config)
  */
+/**
+ * @deprecated Prefer `createDocsAPI` from `@farming-labs/next/api` in Next.js apps.
+ * The `@farming-labs/theme/api` path is kept for compatibility and will be phased out.
+ */
 declare function createDocsAPI(options?: DocsAPIOptions): {
   /**
    * GET handler — search, llms.txt, or llms-full.txt depending on query params.
@@ -84,6 +91,10 @@ declare function createDocsAPI(options?: DocsAPIOptions): {
  *
  * Returns `{ GET, POST, DELETE }` for use in a Next.js route handler.
  */
+/**
+ * @deprecated Prefer `createDocsMCPAPI` from `@farming-labs/next/api` in Next.js apps.
+ * The `@farming-labs/theme/api` path is kept for compatibility and will be phased out.
+ */
 declare function createDocsMCPAPI(options?: DocsMCPAPIOptions): {
   GET(request: Request): Promise<Response>;
   POST(request: Request): Promise<Response>;

package/dist/docs-api.mjs

@@ -454,14 +454,38 @@ function generateLlmsTxt(indexes, options) {
 *
 * @param options - Optional overrides (entry, language, ai config)
 */
+/**
+* @deprecated Prefer `createDocsAPI` from `@farming-labs/next/api` in Next.js apps.
+* The `@farming-labs/theme/api` path is kept for compatibility and will be phased out.
+*/
 function createDocsAPI(options) {
-	const root = process.cwd();
+	const root = options?.rootDir ?? process.cwd();
 	const entry = options?.entry ?? readEntry(root);
 	const appDir = getNextAppDir(root);
+	const contentDir = options?.contentDir ?? path.join(appDir, entry);
 	const i18n = resolveDocsI18n(options?.i18n ?? readI18nConfig(root));
 	const aiConfig = options?.ai ?? readAIConfig(root);
 	const searchConfig = options?.search;
 	const llmsConfig = readLlmsTxtConfig(root);
+	function resolveDocsDirCandidates(locale) {
+		const relativeCandidates = /* @__PURE__ */ new Set();
+		if (path.isAbsolute(contentDir)) return [locale ? path.join(contentDir, locale) : contentDir];
+		relativeCandidates.add(contentDir);
+		relativeCandidates.add(path.join("app", entry));
+		relativeCandidates.add(path.join("src", "app", entry));
+		const rootCandidates = new Set([root]);
+		if (path.basename(root) === "server") rootCandidates.add(path.resolve(root, "..", ".."));
+		else {
+			rootCandidates.add(path.join(root, ".next", "server"));
+			rootCandidates.add(path.join(root, ".next-build", "server"));
+		}
+		const resolved = /* @__PURE__ */ new Set();
+		for (const base of rootCandidates) for (const relative of relativeCandidates) {
+			const candidate = path.join(base, relative);
+			resolved.add(locale ? path.join(candidate, locale) : candidate);
+		}
+		return [...resolved];
+	}
 	function resolveLocaleFromRequest(request) {
 		if (!i18n) return void 0;
 		const direct = resolveDocsLocale(new URL(request.url).searchParams, i18n);
@@ -476,13 +500,13 @@ function createDocsAPI(options) {
 	function resolveContextFromRequest(request) {
 		if (!i18n) return {
 			entryPath: entry,
-			docsDir: path.join(root, appDir, entry)
+			docsDirs: resolveDocsDirCandidates()
 		};
 		const locale = resolveLocaleFromRequest(request) ?? i18n.defaultLocale;
 		return {
 			entryPath: entry,
 			locale,
-			docsDir: path.join(root, appDir, entry, locale)
+			docsDirs: resolveDocsDirCandidates(locale)
 		};
 	}
 	const indexesByLocale = /* @__PURE__ */ new Map();
@@ -491,7 +515,11 @@ function createDocsAPI(options) {
 		const key = ctx.locale ?? "__default__";
 		const cached = indexesByLocale.get(key);
 		if (cached) return cached;
-		const next = scanDocsDir(ctx.docsDir, ctx.entryPath, ctx.locale);
+		let next = [];
+		for (const docsDir of ctx.docsDirs) {
+			next = scanDocsDir(docsDir, ctx.entryPath, ctx.locale);
+			if (next.length > 0) break;
+		}
 		indexesByLocale.set(key, next);
 		return next;
 	}
@@ -543,6 +571,10 @@ function createDocsAPI(options) {
 *
 * Returns `{ GET, POST, DELETE }` for use in a Next.js route handler.
 */
+/**
+* @deprecated Prefer `createDocsMCPAPI` from `@farming-labs/next/api` in Next.js apps.
+* The `@farming-labs/theme/api` path is kept for compatibility and will be phased out.
+*/
 function createDocsMCPAPI(options = {}) {
 	const rootDir = options.rootDir ?? process.cwd();
 	const entry = options.entry ?? readEntry(rootDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -127,7 +127,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.3"
+    "@farming-labs/docs": "0.1.4"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",