zudoku 0.0.0-e53033e → 0.0.0-e5be921

package/dist/config/validators/InputSidebarSchema.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { IconNames } from "./icon-types.js";
 export declare const BaseInputSidebarItemCategoryLinkDocSchema: z.ZodObject<{
     type: z.ZodLiteral<"doc">;
     id: z.ZodString;
@@ -29,71 +30,81 @@ export declare const InputSidebarItemCategoryLinkDocSchema: z.ZodUnion<[z.ZodObj
 export declare const BaseInputSidebarItemDocSchema: z.ZodObject<{
     type: z.ZodLiteral<"doc">;
     id: z.ZodString;
-    icon: z.ZodOptional<z.ZodType<"default", z.ZodTypeDef, "default">>;
+    icon: z.ZodOptional<z.ZodType<IconNames, z.ZodTypeDef, IconNames>>;
     label: z.ZodOptional<z.ZodString>;
     badge: z.ZodOptional<z.ZodObject<{
         label: z.ZodString;
         color: z.ZodEnum<["green", "blue", "yellow", "red", "purple", "indigo", "gray"]>;
+        placement: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "doc";
     id: string;
-    label?: string | undefined;
-    icon?: "default" | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
+    label?: string | undefined;
+    icon?: IconNames | undefined;
 }, {
     type: "doc";
     id: string;
-    label?: string | undefined;
-    icon?: "default" | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
+    label?: string | undefined;
+    icon?: IconNames | undefined;
 }>;
 export type BaseInputSidebarItemDoc = z.infer<typeof BaseInputSidebarItemDocSchema>;
 export declare const InputSidebarItemDocSchema: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"doc">;
     id: z.ZodString;
-    icon: z.ZodOptional<z.ZodType<"default", z.ZodTypeDef, "default">>;
+    icon: z.ZodOptional<z.ZodType<IconNames, z.ZodTypeDef, IconNames>>;
     label: z.ZodOptional<z.ZodString>;
     badge: z.ZodOptional<z.ZodObject<{
         label: z.ZodString;
         color: z.ZodEnum<["green", "blue", "yellow", "red", "purple", "indigo", "gray"]>;
+        placement: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "doc";
     id: string;
-    label?: string | undefined;
-    icon?: "default" | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
+    label?: string | undefined;
+    icon?: IconNames | undefined;
 }, {
     type: "doc";
     id: string;
-    label?: string | undefined;
-    icon?: "default" | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
+    label?: string | undefined;
+    icon?: IconNames | undefined;
 }>, z.ZodString]>;
 export declare const InputSidebarItemLinkSchema: z.ZodObject<{
     type: z.ZodLiteral<"link">;
@@ -103,36 +114,41 @@ export declare const InputSidebarItemLinkSchema: z.ZodObject<{
     badge: z.ZodOptional<z.ZodObject<{
         label: z.ZodString;
         color: z.ZodEnum<["green", "blue", "yellow", "red", "purple", "indigo", "gray"]>;
+        placement: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }, {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "link";
     label: string;
     href: string;
+    description?: string | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
-    description?: string | undefined;
 }, {
     type: "link";
     label: string;
     href: string;
+    description?: string | undefined;
     badge?: {
         label: string;
         color: "green" | "blue" | "yellow" | "red" | "purple" | "indigo" | "gray";
+        placement?: "start" | "end" | undefined;
     } | undefined;
-    description?: string | undefined;
 }>;
 export type InputSidebarItemLink = z.infer<typeof InputSidebarItemLinkSchema>;
 export declare const BaseInputSidebarItemCategorySchema: z.ZodObject<{
     type: z.ZodLiteral<"category">;
-    icon: z.ZodOptional<z.ZodType<"default", z.ZodTypeDef, "default">>;
+    icon: z.ZodOptional<z.ZodType<IconNames, z.ZodTypeDef, IconNames>>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     collapsible: z.ZodOptional<z.ZodBoolean>;
@@ -153,25 +169,25 @@ export declare const BaseInputSidebarItemCategorySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "category";
     label: string;
-    icon?: "default" | undefined;
+    description?: string | undefined;
     link?: string | {
         type: "doc";
         id: string;
         label?: string | undefined;
     } | undefined;
-    description?: string | undefined;
+    icon?: IconNames | undefined;
     collapsible?: boolean | undefined;
     collapsed?: boolean | undefined;
 }, {
     type: "category";
     label: string;
-    icon?: "default" | undefined;
+    description?: string | undefined;
     link?: string | {
         type: "doc";
         id: string;
         label?: string | undefined;
     } | undefined;
-    description?: string | undefined;
+    icon?: IconNames | undefined;
     collapsible?: boolean | undefined;
     collapsed?: boolean | undefined;
 }>;
@@ -182,5 +198,5 @@ export type InputSidebarItemCategory = z.infer<typeof BaseInputSidebarItemCatego
 };
 export declare const InputSidebarItemCategorySchema: z.ZodType<InputSidebarItemCategory>;
 export declare const InputSidebarSchema: z.ZodArray<z.ZodType<InputSidebarItem, z.ZodTypeDef, InputSidebarItem>, "many">;
-export type InputSidebar = z.infer<typeof InputSidebarSchema>;
-export type ConfigSidebar = Record<string, InputSidebar>;
+export type SidebarEntry = z.infer<typeof InputSidebarSchema>;
+export type SidebarConfig = Record<string, SidebarEntry>;

package/dist/config/validators/InputSidebarSchema.js

@@ -1,4 +1,9 @@
 import { z } from "zod";
+const BadgeSchema = z.object({
+    label: z.string(),
+    color: z.enum(["green", "blue", "yellow", "red", "purple", "indigo", "gray"]),
+    placement: z.enum(["start", "end"]).optional(),
+});
 export const BaseInputSidebarItemCategoryLinkDocSchema = z.object({
     type: z.literal("doc"),
     id: z.string(),
@@ -13,20 +18,7 @@ export const BaseInputSidebarItemDocSchema = z.object({
     id: z.string(),
     icon: z.custom().optional(),
     label: z.string().optional(),
-    badge: z
-        .object({
-        label: z.string(),
-        color: z.enum([
-            "green",
-            "blue",
-            "yellow",
-            "red",
-            "purple",
-            "indigo",
-            "gray",
-        ]),
-    })
-        .optional(),
+    badge: BadgeSchema.optional(),
 });
 export const InputSidebarItemDocSchema = z.union([
     BaseInputSidebarItemDocSchema,
@@ -37,20 +29,7 @@ export const InputSidebarItemLinkSchema = z.object({
     label: z.string(),
     href: z.string(),
     description: z.string().optional(),
-    badge: z
-        .object({
-        label: z.string(),
-        color: z.enum([
-            "green",
-            "blue",
-            "yellow",
-            "red",
-            "purple",
-            "indigo",
-            "gray",
-        ]),
-    })
-        .optional(),
+    badge: BadgeSchema.optional(),
 });
 export const BaseInputSidebarItemCategorySchema = z.object({
     type: z.literal("category"),

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

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

package/dist/config/validators/SidebarSchema.d.ts

@@ -1,5 +1,6 @@
 import { type LucideIcon } from "lucide-react";
 import type { BaseInputSidebarItemCategoryLinkDoc, BaseInputSidebarItemDoc, InputSidebarItem, InputSidebarItemCategory, InputSidebarItemLink } from "./InputSidebarSchema.js";
+import type { ZudokuConfig } from "./validate.js";
 export type SidebarItemDoc = Omit<BaseInputSidebarItemDoc, "icon"> & {
     label: string;
     categoryLabel?: string;
@@ -18,6 +19,28 @@ export type SidebarItemCategory = Omit<InputSidebarItemCategory, "items" | "link
     icon?: LucideIcon | string;
 };
 export type SidebarItem = SidebarItemDoc | SidebarItemLink | SidebarItemCategory;
-export declare const resolveSidebar: (rootDir: string, parentId: string, sidebar: InputSidebarItem[]) => Promise<SidebarItem[]>;
+export declare class SidebarManager {
+    sidebars: SidebarClass[];
+    private switchQueue;
+    constructor(rootDir: string, sidebarConfig: ZudokuConfig["sidebar"]);
+    resolveSidebars(): Promise<{
+        [k: string]: SidebarItem[];
+    }>;
+    switchSidebar(from: string, to: string, item: SidebarItem): void;
+}
+export declare class SidebarClass {
+    private manager;
+    rootDir: string;
+    parent: string;
+    private items;
+    resolvedItems: SidebarItem[];
+    constructor(manager: SidebarManager, rootDir: string, parent: string, items: InputSidebarItem[]);
+    resolve(): Promise<void>;
+    private resolveDoc;
+    private resolveLink;
+    private resolveItemCategoryLinkDoc;
+    private resolveSidebarItemDoc;
+    private resolveItem;
+}
 export type Sidebar = SidebarItem[];
 export type SidebarConfig = Record<string, Sidebar>;

package/dist/config/validators/SidebarSchema.js

@@ -2,72 +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, parentId, sidebar) => {
-    const resolveDoc = async (globId, categoryLabel) => {
-        const foundMatches = await glob(`/**/${globId}.{md,mdx}`, {
-            root: rootDir,
+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: this.rootDir,
         });
         if (foundMatches.length === 0) {
-            throw new Error(`File not found for document '${globId}'. Check your sidebar configuration.`);
+            throw new Error(`File not found for document '${id}'. Check your sidebar configuration.`);
         }
-        // Strip parent id if it's prefixed
-        // E.g. docs/introduction should work as well as introduction
-        const id = globId.startsWith(parentId)
-            ? globId.slice(parentId.length)
-            : globId;
         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,
@@ -76,7 +113,6 @@ export const resolveSidebar = async (rootDir, parentId, 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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"}