@farming-labs/theme 0.1.3 → 0.1.5

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,39 @@ 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]);
+		rootCandidates.add(process.cwd());
+		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 +501,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 +516,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 +572,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/dist/docs-command-search.mjs

@@ -405,6 +405,22 @@ function DocsCommandSearch({ api = "/api/docs", locale }) {
 			setActiveIndex(0);
 		}
 	}, [open]);
+	useEffect(() => {
+		if (!open) return;
+		const { body, documentElement } = document;
+		const previousBodyOverflow = body.style.overflow;
+		const previousBodyPaddingRight = body.style.paddingRight;
+		const previousHtmlOverflow = documentElement.style.overflow;
+		const scrollbarWidth = window.innerWidth - documentElement.clientWidth;
+		body.style.overflow = "hidden";
+		documentElement.style.overflow = "hidden";
+		if (scrollbarWidth > 0) body.style.paddingRight = `${scrollbarWidth}px`;
+		return () => {
+			body.style.overflow = previousBodyOverflow;
+			body.style.paddingRight = previousBodyPaddingRight;
+			documentElement.style.overflow = previousHtmlOverflow;
+		};
+	}, [open]);
 	useEffect(() => {
 		if (!open) return;
 		function handler(e) {
@@ -482,6 +498,7 @@ function DocsCommandSearch({ api = "/api/docs", locale }) {
 	}), /* @__PURE__ */ jsxs("div", {
 		className: "omni-content",
 		role: "dialog",
+		"aria-modal": "true",
 		"aria-label": "Search documentation",
 		children: [
 			/* @__PURE__ */ jsx("div", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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.5"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",

package/styles/omni.css

@@ -80,6 +80,7 @@
     0 0 0 1px rgba(255, 255, 255, 0.04);
   outline: none;
   overflow: hidden;
+  overscroll-behavior: contain;
   animation: omni-scale-in 200ms cubic-bezier(0.16, 1, 0.3, 1);
 }
 
@@ -148,6 +149,7 @@
 .omni-body {
   max-height: 60vh;
   overflow: auto;
+  overscroll-behavior: contain;
   padding: 0.25rem;
 }
 .omni-body::-webkit-scrollbar {