zudoku 0.0.0-e4d0ea8 → 0.0.0-e5be921

package/dist/config/validators/SidebarSchema.js

@@ -2,68 +2,109 @@ import { glob } from "glob";
 import matter from "gray-matter";
 import fs from "node:fs/promises";
 const extractTitleFromContent = (content) => content.match(/^\s*#\s(.*)$/m)?.at(1);
-export const resolveSidebar = async (rootDir, sidebar) => {
-    const resolveDoc = async (id, categoryLabel) => {
+const isSidebarItem = (item) => item !== undefined;
+export class SidebarManager {
+    sidebars;
+    switchQueue = [];
+    constructor(rootDir, sidebarConfig) {
+        this.sidebars = Object.entries(sidebarConfig ?? {}).map(([parent, items]) => new SidebarClass(this, rootDir, parent, items));
+    }
+    async resolveSidebars() {
+        await Promise.all(this.sidebars.map((sidebar) => sidebar.resolve()));
+        // switch all collected items
+        for (const { from, to, item } of this.switchQueue) {
+            const fromSidebar = this.sidebars.find((s) => s.parent === from);
+            const toSidebar = this.sidebars.find((s) => s.parent === to);
+            if (!fromSidebar || !toSidebar) {
+                throw new Error(`Sidebar ${from} or ${to} not found`);
+            }
+            fromSidebar.resolvedItems = fromSidebar.resolvedItems.filter((resolvedItem) => resolvedItem !== item);
+            toSidebar.resolvedItems.push(item);
+        }
+        return Object.fromEntries(this.sidebars.map((sidebar) => [sidebar.parent, sidebar.resolvedItems]));
+    }
+    switchSidebar(from, to, item) {
+        this.switchQueue.push({ from, to, item });
+    }
+}
+export class SidebarClass {
+    manager;
+    rootDir;
+    parent;
+    items;
+    resolvedItems = [];
+    constructor(manager, rootDir, parent, items) {
+        this.manager = manager;
+        this.rootDir = rootDir;
+        this.parent = parent;
+        this.items = items;
+    }
+    async resolve() {
+        const resolvedSidebar = (await Promise.all(this.items.map((item) => this.resolveItem(item)))).filter(isSidebarItem);
+        this.resolvedItems = resolvedSidebar;
+    }
+    async resolveDoc(id, categoryLabel) {
         const foundMatches = await glob(`/**/${id}.{md,mdx}`, {
             ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
-            root: rootDir,
+            root: this.rootDir,
         });
         if (foundMatches.length === 0) {
             throw new Error(`File not found for document '${id}'. Check your sidebar configuration.`);
         }
         const file = await fs.readFile(foundMatches.at(0));
         const { data, content } = matter(file);
-        const label = data.sidebar_label ?? data.title ?? extractTitleFromContent(content);
+        const label = data.sidebar_label ??
+            data.title ??
+            extractTitleFromContent(content) ??
+            id;
         const icon = data.sidebar_icon;
-        if (typeof label !== "string") {
-            throw new Error(`Error determining title for document '${id}'. Check that the document has a H1 header or title frontmatter.`);
-        }
-        return {
+        const doc = {
             type: "doc",
             id,
             label,
             icon,
             categoryLabel,
         };
-    };
-    const resolveLink = async (id) => {
-        const doc = await resolveDoc(id);
-        return {
-            type: "doc",
-            id: id,
-            label: doc.label,
-            icon: doc.icon,
-        };
-    };
-    const resolveSidebarItemCategoryLinkDoc = async (item) => {
+        if (data.sidebar && data.sidebar !== this.parent) {
+            this.manager.switchSidebar(this.parent, data.sidebar, doc);
+            return undefined;
+        }
+        return doc;
+    }
+    async resolveLink(id) {
+        const doc = await this.resolveDoc(id);
+        return doc
+            ? { type: "doc", id: id, label: doc.label, icon: doc.icon }
+            : undefined;
+    }
+    async resolveItemCategoryLinkDoc(item) {
         if (typeof item === "string") {
-            return resolveLink(item);
+            return this.resolveLink(item);
         }
-        const { label, icon } = await resolveDoc(item.id);
-        return { ...item, label, icon };
-    };
-    const resolveSidebarItemDoc = async (item, categoryLabel) => {
+        const doc = await this.resolveDoc(item.id);
+        return doc ? { ...item, label: doc.label, icon: doc.icon } : undefined;
+    }
+    async resolveSidebarItemDoc(item, categoryLabel) {
         if (typeof item === "string") {
-            return resolveDoc(item, categoryLabel);
+            return this.resolveDoc(item, categoryLabel);
         }
-        const doc = await resolveDoc(item.id, categoryLabel);
-        const label = item.label ?? doc.label;
-        return { ...item, label, categoryLabel };
-    };
-    const resolveSidebarItem = async (item, categoryLabel) => {
+        const doc = await this.resolveDoc(item.id, categoryLabel);
+        return doc ? { ...doc, ...item } : undefined;
+    }
+    async resolveItem(item, categoryLabel) {
         if (typeof item === "string") {
-            return resolveDoc(item, categoryLabel);
+            return this.resolveDoc(item, categoryLabel);
         }
         switch (item.type) {
             case "doc":
-                return resolveSidebarItemDoc(item, categoryLabel);
+                return this.resolveSidebarItemDoc(item, categoryLabel);
             case "link":
                 return item;
             case "category": {
                 const categoryItem = item;
-                const items = await Promise.all(categoryItem.items.map((subItem) => resolveSidebarItem(subItem, categoryItem.label)));
+                const items = (await Promise.all(categoryItem.items.map((subItem) => this.resolveItem(subItem, categoryItem.label)))).filter((item) => item !== undefined);
                 const resolvedLink = categoryItem.link
-                    ? await resolveSidebarItemCategoryLinkDoc(categoryItem.link)
+                    ? await this.resolveItemCategoryLinkDoc(categoryItem.link)
                     : undefined;
                 return {
                     ...categoryItem,
@@ -72,7 +113,6 @@ export const resolveSidebar = async (rootDir, sidebar) => {
                 };
             }
         }
-    };
-    return Promise.all(sidebar.map((item) => resolveSidebarItem(item)));
-};
+    }
+}
 //# sourceMappingURL=SidebarSchema.js.map

package/dist/config/validators/SidebarSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarSchema.js","sourceRoot":"","sources":["../../../src/config/validators/SidebarSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SidebarSchema.js","sourceRoot":"","sources":["../../../src/config/validators/SidebarSchema.ts"],"names":[],"mappings":"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"}