zudoku 0.0.0-e097cbb → 0.0.0-e0ffac16

package/dist/config/validators/InputNavigationSchema.js

@@ -0,0 +1,74 @@
+import { z } from "zod/v4";
+import { IconNames } from "./icon-types.js";
+const IconSchema = z.enum(IconNames);
+const BadgeSchema = z.object({
+    label: z.string(),
+    // prettier-ignore
+    color: z.enum(["green", "blue", "yellow", "red", "purple", "indigo", "gray", "outline"]),
+});
+const InputNavigationCategoryLinkDocSchema = z.union([
+    z.string(),
+    z.object({
+        type: z.literal("doc"),
+        file: z.string(),
+        label: z.string().optional(),
+    }),
+]);
+export const DisplaySchema = z
+    .union([
+    z.enum(["auth", "anon", "always", "hide"]),
+    z.custom((val) => typeof val === "function"),
+])
+    .default("always")
+    .optional();
+const InputNavigationDocSchema = z.union([
+    z.string(),
+    z.object({
+        type: z.literal("doc"),
+        file: z.string(),
+        // Custom URL path for this document (overrides file-based path)
+        path: z.string().optional(),
+        icon: IconSchema.optional(),
+        label: z.string().optional(),
+        badge: BadgeSchema.optional(),
+        display: DisplaySchema,
+    }),
+]);
+const InputNavigationLinkSchema = z.object({
+    type: z.literal("link"),
+    to: z.string(),
+    label: z.string(),
+    icon: IconSchema.optional(),
+    badge: BadgeSchema.optional(),
+    display: DisplaySchema,
+});
+const InputNavigationCustomPageSchema = z.object({
+    type: z.literal("custom-page"),
+    path: z.string(),
+    label: z.string().optional(),
+    element: z.any(),
+    icon: IconSchema.optional(),
+    badge: BadgeSchema.optional(),
+    display: DisplaySchema,
+});
+// Base category schema without items
+const BaseInputNavigationCategorySchema = z.object({
+    type: z.literal("category"),
+    icon: IconSchema.optional(),
+    label: z.string(),
+    collapsible: z.boolean().optional(),
+    collapsed: z.boolean().optional(),
+    link: InputNavigationCategoryLinkDocSchema.optional(),
+    display: DisplaySchema,
+});
+const InputNavigationCategorySchema = BaseInputNavigationCategorySchema.extend({
+    items: z.lazy(() => InputNavigationItemSchema.array()),
+});
+const InputNavigationItemSchema = z.union([
+    InputNavigationDocSchema,
+    InputNavigationLinkSchema,
+    InputNavigationCustomPageSchema,
+    InputNavigationCategorySchema,
+]);
+export const InputNavigationSchema = InputNavigationItemSchema.array();
+//# sourceMappingURL=InputNavigationSchema.js.map

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

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

package/dist/config/validators/InputNavigationSchema.test-d.js

@@ -0,0 +1,145 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { assertType, describe, expectTypeOf, it } from "vitest";
+describe("InputNavigationSchema types", () => {
+    it("infers correct types for navigation items", () => {
+        // Test that TypeScript correctly infers the types using satisfies
+        const docString = "path/to/doc.md";
+        const docObject = {
+            type: "doc",
+            file: "path/to/doc.md",
+            label: "My Doc",
+            icon: "book",
+            badge: { label: "New", color: "green" },
+            display: "always",
+        };
+        const linkObject = {
+            type: "link",
+            label: "External Link",
+            to: "https://example.com",
+            icon: "external-link",
+            badge: { label: "External", color: "blue" },
+            display: "auth",
+        };
+        const customPage = {
+            type: "custom-page",
+            path: "/custom",
+            label: "Custom Page",
+            element: null,
+            icon: "star",
+            badge: { label: "Custom", color: "purple" },
+            display: "anon",
+        };
+        // Test that these are assignable to InputNavigationItem
+        assertType(docString);
+        assertType(docObject);
+        assertType(linkObject);
+        assertType(customPage);
+    });
+    it("prevents items array from being unknown[]", () => {
+        // Core test: ensure items are properly typed
+        const category = {
+            type: "category",
+            label: "Test Category",
+            items: [
+                "doc.md",
+                { type: "doc", file: "test.md" },
+                { type: "link", label: "Link", to: "https://example.com" },
+                { type: "category", label: "Nested", items: ["nested.md"] },
+            ],
+        };
+        // Key assertions - items must be InputNavigationItem[], not unknown[]
+        assertType(category.items);
+        expectTypeOf(category.items).not.toEqualTypeOf();
+        expectTypeOf(category.items).not.toEqualTypeOf();
+    });
+    it("validates nested structure maintains type safety", () => {
+        const navigation = [
+            {
+                type: "category",
+                label: "Parent",
+                items: [
+                    {
+                        type: "category",
+                        label: "Child",
+                        items: ["nested.md", { type: "doc", file: "nested.md" }],
+                    },
+                ],
+            },
+        ];
+        const parent = navigation[0];
+        assertType(parent.items);
+        const child = parent.items[0];
+        assertType(child.items);
+        expectTypeOf(child.items).not.toEqualTypeOf();
+    });
+    it("validates union types work correctly", () => {
+        // Test that all valid types are assignable
+        assertType("doc.md");
+        assertType({ type: "doc", file: "test.md" });
+        assertType({ type: "link", label: "Link", to: "/" });
+        assertType({
+            type: "category",
+            label: "C",
+            items: [],
+        });
+        // Test type constraints
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().not.toEqualTypeOf();
+        expectTypeOf().not.toEqualTypeOf();
+    });
+    it("validates individual type exports", () => {
+        const doc = {
+            type: "doc",
+            file: "test.md",
+            label: "Test Doc",
+        };
+        assertType(doc);
+        const link = {
+            type: "link",
+            label: "Test Link",
+            to: "https://example.com",
+        };
+        assertType(link);
+        const customPage = {
+            type: "custom-page",
+            path: "/test",
+            label: "Test Page",
+            element: null,
+        };
+        assertType(customPage);
+        const category = {
+            type: "category",
+            label: "Test Category",
+            items: ["test.md"],
+        };
+        assertType(category);
+        assertType(category.items);
+    });
+    it("validates constrained properties", () => {
+        const validDisplayValues = ["auth", "anon", "always", "hide"];
+        for (const display of validDisplayValues) {
+            const item = {
+                type: "doc",
+                file: "test.md",
+                display,
+            };
+            assertType(item);
+        }
+    });
+    it("rejects invalid types", () => {
+        // Test that invalid values fail at compile time
+        // @ts-expect-error - number not assignable to InputNavigationItem
+        assertType(0);
+        // @ts-expect-error - missing required 'file' property
+        assertType({ type: "doc" });
+        // @ts-expect-error - missing required 'href' property
+        assertType({ type: "link", label: "Invalid Link" });
+        assertType({
+            type: "category",
+            label: "Test",
+            // @ts-expect-error - items should not accept unknown[]
+            items: [],
+        });
+    });
+});
+//# sourceMappingURL=InputNavigationSchema.test-d.js.map

package/dist/config/validators/InputNavigationSchema.test-d.js.map

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

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

@@ -0,0 +1,44 @@
+import { type LucideIcon } from "lucide-react";
+import type { ConfigWithMeta } from "../loader.js";
+import type { InputNavigationCategory, InputNavigationCategoryLinkDoc, InputNavigationCustomPage, InputNavigationDoc, InputNavigationLink } from "./InputNavigationSchema.js";
+type ReplaceFields<Base, Overrides> = Omit<Base, keyof Overrides> & Overrides;
+type ResolvedIcon = {
+    icon?: LucideIcon | string;
+};
+type FinalNavigationDoc = Extract<InputNavigationDoc, {
+    type: "doc";
+}>;
+type FinalNavigationCategoryLinkDoc = Extract<InputNavigationCategoryLinkDoc, {
+    type: "doc";
+}>;
+export type NavigationDoc = ReplaceFields<FinalNavigationDoc, {
+    label: string;
+    categoryLabel?: string;
+    path: string;
+} & ResolvedIcon>;
+export type NavigationLink = ReplaceFields<InputNavigationLink, ResolvedIcon>;
+export type NavigationCategoryLinkDoc = ReplaceFields<FinalNavigationCategoryLinkDoc, {
+    label: string;
+    path: string;
+} & ResolvedIcon>;
+export type NavigationCategory = ReplaceFields<InputNavigationCategory, {
+    items: NavigationItem[];
+    link?: NavigationCategoryLinkDoc;
+} & ResolvedIcon>;
+export type NavigationCustomPage = ReplaceFields<InputNavigationCustomPage, ResolvedIcon>;
+export type NavigationItem = NavigationDoc | NavigationLink | NavigationCategory | NavigationCustomPage;
+export type Navigation = NavigationItem[];
+export declare class NavigationResolver {
+    private rootDir;
+    private globPatterns;
+    private globFiles;
+    private items;
+    constructor(config: ConfigWithMeta);
+    resolve(): Promise<NavigationItem[]>;
+    private resolveDoc;
+    private resolveLink;
+    private resolveItemCategoryLinkDoc;
+    private resolveNavigationItemDoc;
+    private resolveItem;
+}
+export {};

package/dist/config/validators/NavigationSchema.js

@@ -0,0 +1,98 @@
+import { glob } from "glob";
+import matter from "gray-matter";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { DocsConfigSchema } from "./validate.js";
+const extractTitleFromContent = (content) => content.match(/^\s*#\s(.*)$/m)?.at(1);
+const isNavigationItem = (item) => item !== undefined;
+const toPosixPath = (filePath) => filePath.split(path.win32.sep).join(path.posix.sep);
+export class NavigationResolver {
+    rootDir;
+    globPatterns;
+    globFiles = [];
+    items = [];
+    constructor(config) {
+        this.rootDir = config.__meta.rootDir;
+        this.globPatterns = DocsConfigSchema.parse(config.docs ?? {}).files;
+        this.items = config.navigation ?? [];
+    }
+    async resolve() {
+        this.globFiles = await glob(this.globPatterns, {
+            root: this.rootDir,
+            ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+        }).then((files) => files.map(toPosixPath));
+        const resolvedItems = await Promise.all(this.items.map((item) => this.resolveItem(item)));
+        return resolvedItems.filter(isNavigationItem);
+    }
+    async resolveDoc(filePath, categoryLabel) {
+        const fileNoExt = toPosixPath(filePath).replace(/\.mdx?$/, "");
+        const foundMatches = this.globFiles.find((file) => file.endsWith(`${fileNoExt}.md`) || file.endsWith(`${fileNoExt}.mdx`));
+        if (!foundMatches) {
+            throw new Error(`File not found for document '${filePath}'. Navigation items of type 'doc' must point to a valid .md or .mdx file. Do you mean 'link' or 'custom-page'? Check navigation configuration documentation for more information: https://zudoku.dev/docs/configuration/navigation`);
+        }
+        const fileContent = await fs.readFile(foundMatches);
+        const { data, content } = matter(fileContent);
+        const label = data.navigation_label ??
+            data.sidebar_label ??
+            data.title ??
+            extractTitleFromContent(content) ??
+            filePath;
+        const icon = data.navigation_icon ?? data.sidebar_icon;
+        const doc = {
+            type: "doc",
+            file: filePath,
+            label,
+            icon,
+            categoryLabel,
+            path: fileNoExt,
+        };
+        return doc;
+    }
+    async resolveLink(file) {
+        const doc = await this.resolveDoc(file);
+        return doc
+            ? { type: "doc", file, label: doc.label, icon: doc.icon, path: doc.path }
+            : undefined;
+    }
+    async resolveItemCategoryLinkDoc(item) {
+        if (typeof item === "string") {
+            return this.resolveLink(item);
+        }
+        const doc = await this.resolveDoc(item.file);
+        return doc
+            ? { ...item, label: doc.label, icon: doc.icon, path: doc.path }
+            : undefined;
+    }
+    async resolveNavigationItemDoc(item, categoryLabel) {
+        if (typeof item === "string") {
+            return this.resolveDoc(item, categoryLabel);
+        }
+        const doc = await this.resolveDoc(item.file, categoryLabel);
+        return doc ? { ...doc, ...item, path: item.path ?? doc.path } : undefined;
+    }
+    async resolveItem(item, categoryLabel) {
+        if (typeof item === "string") {
+            return this.resolveDoc(item, categoryLabel);
+        }
+        switch (item.type) {
+            case "doc":
+                return this.resolveNavigationItemDoc(item, categoryLabel);
+            case "link":
+            case "custom-page":
+                return item;
+            case "category": {
+                const categoryItem = item;
+                const items = (await Promise.all(categoryItem.items.map((subItem) => this.resolveItem(subItem, categoryItem.label)))).filter(isNavigationItem);
+                const resolvedLink = categoryItem.link
+                    ? await this.resolveItemCategoryLinkDoc(categoryItem.link)
+                    : undefined;
+                return {
+                    ...categoryItem,
+                    items,
+                    link: resolvedLink,
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=NavigationSchema.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { z } from "zod/v4";
+import type { UseAuthReturn } from "../../lib/authentication/hook.js";
+import type { ZudokuContext } from "../../lib/core/ZudokuContext.js";
+type CallbackContext = {
+    auth: UseAuthReturn;
+    context: ZudokuContext;
+};
+type ProtectedRouteCallback = (c: CallbackContext) => boolean;
+export type ProtectedRoutesInput = z.input<typeof ProtectedRoutesSchema>;
+export type ProtectedRoutes = z.output<typeof ProtectedRoutesSchema>;
+export declare const ProtectedRoutesSchema: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodRecord<z.ZodString, z.ZodCustom<ProtectedRouteCallback, ProtectedRouteCallback>>]>>, z.ZodTransform<Record<string, ProtectedRouteCallback> | undefined, string[] | Record<string, ProtectedRouteCallback> | undefined>>;
+export {};

package/dist/config/validators/ProtectedRoutesSchema.js

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+export const ProtectedRoutesSchema = z
+    .union([
+    z.string().array(),
+    z.record(z.string(), z.custom((val) => typeof val === "function")),
+])
+    .optional()
+    .transform((val) => {
+    if (!val)
+        return undefined;
+    if (Array.isArray(val)) {
+        return Object.fromEntries(val.map((route) => [
+            route,
+            (c) => c.auth.isAuthenticated,
+        ]));
+    }
+    return val;
+});
+//# sourceMappingURL=ProtectedRoutesSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProtectedRoutesSchema.js","sourceRoot":"","sources":["../../../src/config/validators/ProtectedRoutesSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAS3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,KAAK,CAAC;IACL,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;IAClB,CAAC,CAAC,MAAM,CACN,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,CAAC,CACrE;CACF,CAAC;KACD,QAAQ,EAAE;KACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,WAAW,CACvB,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YACjB,KAAK;YACL,CAAC,CAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe;SAC/C,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,CAAC"}