@farming-labs/theme 0.0.2-beta.13 → 0.0.2-beta.14

package/dist/docs-layout.mjs

@@ -34,6 +34,7 @@ function hasChildPages(dir) {
 function buildTree(config) {
 	const docsDir = path.join(process.cwd(), "app", config.entry);
 	const icons = config.icons;
+	const ordering = config.ordering;
 	const rootChildren = [];
 	if (fs.existsSync(path.join(docsDir, "page.mdx"))) {
 		const data = readFrontmatter(path.join(docsDir, "page.mdx"));
@@ -44,52 +45,87 @@ function buildTree(config) {
 			icon: resolveIcon(data.icon, icons)
 		});
 	}
-	/**
-	* Recursively scan a directory and return tree nodes.
-	*
-	* - If a subdirectory has its own children (nested pages), it becomes a
-	*   **folder** node with collapsible children. Its own `page.mdx` becomes
-	*   the folder's `index` page.
-	* - Otherwise it becomes a simple **page** node.
-	*/
-	function scan(dir, baseSlug) {
+	function buildNode(dir, name, baseSlug, slugOrder) {
+		const full = path.join(dir, name);
+		if (!fs.statSync(full).isDirectory()) return null;
+		const pagePath = path.join(full, "page.mdx");
+		if (!fs.existsSync(pagePath)) return null;
+		const data = readFrontmatter(pagePath);
+		const slug = [...baseSlug, name];
+		const url = `/${config.entry}/${slug.join("/")}`;
+		const icon = resolveIcon(data.icon, icons);
+		const displayName = data.title ?? name.replace(/-/g, " ");
+		if (hasChildPages(full)) {
+			const folderChildren = scanDir(full, slug, slugOrder);
+			return {
+				type: "folder",
+				name: displayName,
+				icon,
+				index: {
+					type: "page",
+					name: displayName,
+					url,
+					icon
+				},
+				children: folderChildren
+			};
+		}
+		return {
+			type: "page",
+			name: displayName,
+			url,
+			icon
+		};
+	}
+	function scanDir(dir, baseSlug, slugOrder) {
 		if (!fs.existsSync(dir)) return [];
-		const nodes = [];
 		const entries = fs.readdirSync(dir).sort();
-		for (const name of entries) {
-			const full = path.join(dir, name);
-			if (!fs.statSync(full).isDirectory()) continue;
-			const pagePath = path.join(full, "page.mdx");
-			if (!fs.existsSync(pagePath)) continue;
-			const data = readFrontmatter(pagePath);
-			const slug = [...baseSlug, name];
-			const url = `/${config.entry}/${slug.join("/")}`;
-			const icon = resolveIcon(data.icon, icons);
-			const displayName = data.title ?? name.replace(/-/g, " ");
-			if (hasChildPages(full)) {
-				const folderChildren = scan(full, slug);
-				nodes.push({
-					type: "folder",
-					name: displayName,
-					icon,
-					index: {
-						type: "page",
-						name: displayName,
-						url,
-						icon
-					},
-					children: folderChildren
+		if (slugOrder) {
+			const nodes = [];
+			const slugMap = /* @__PURE__ */ new Map();
+			for (const item of slugOrder) slugMap.set(item.slug, item);
+			for (const item of slugOrder) {
+				if (!entries.includes(item.slug)) continue;
+				const node = buildNode(dir, item.slug, baseSlug, item.children);
+				if (node) nodes.push(node);
+			}
+			for (const name of entries) {
+				if (slugMap.has(name)) continue;
+				const node = buildNode(dir, name, baseSlug);
+				if (node) nodes.push(node);
+			}
+			return nodes;
+		}
+		if (ordering === "numeric") {
+			const nodes = [];
+			for (const name of entries) {
+				const full = path.join(dir, name);
+				if (!fs.statSync(full).isDirectory()) continue;
+				const pagePath = path.join(full, "page.mdx");
+				if (!fs.existsSync(pagePath)) continue;
+				const data = readFrontmatter(pagePath);
+				const order = typeof data.order === "number" ? data.order : Infinity;
+				const node = buildNode(dir, name, baseSlug);
+				if (node) nodes.push({
+					order,
+					node
 				});
-			} else nodes.push({
-				type: "page",
-				name: displayName,
-				url,
-				icon
+			}
+			nodes.sort((a, b) => {
+				if (a.order === b.order) return 0;
+				return a.order - b.order;
 			});
+			return nodes.map((n) => n.node);
+		}
+		const nodes = [];
+		for (const name of entries) {
+			const node = buildNode(dir, name, baseSlug);
+			if (node) nodes.push(node);
 		}
 		return nodes;
 	}
-	rootChildren.push(...scan(docsDir, []));
+	const rootSlugOrder = Array.isArray(ordering) ? ordering : void 0;
+	rootChildren.push(...scanDir(docsDir, [], rootSlugOrder));
 	return {
 		name: "Docs",
 		children: rootChildren

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.0.2-beta.13",
+  "version": "0.0.2-beta.14",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -74,7 +74,7 @@
     "next": ">=14.0.0",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.0.2-beta.13"
+    "@farming-labs/docs": "0.0.2-beta.14"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",

package/styles/pixel-border.css

@@ -186,6 +186,12 @@ code:not(pre code) {
   border-top: none;
 }
 
+/* Last item: bottom border */
+.dark aside .overscroll-contain > div > a[data-active]:last-child,
+.dark aside .overscroll-contain > div > div:last-child {
+  border-bottom: 1px solid hsl(0 0% 12%);
+}
+
 /* ── Sidebar links (all levels) ──────────────────────────────────── */
 
 .dark aside a[data-active] {