zudoku 0.0.0-ee328ec → 0.0.0-efc60ba6

package/dist/lib/core/ZudokuContext.d.ts

@@ -1,15 +1,17 @@
 import type { QueryClient } from "@tanstack/react-query";
 import type { ReactNode } from "react";
 import type { Location } from "react-router";
-import type { z } from "zod";
-import type { FooterSchema, TopNavigationItem } from "../../config/validators/common.js";
-import type { SidebarConfig } from "../../config/validators/SidebarSchema.js";
-import type { AuthenticationProvider } from "../authentication/authentication.js";
+import type { BundledTheme, HighlighterCore } from "shiki";
+import type { z } from "zod/v4";
+import type { Navigation } from "../../config/validators/NavigationSchema.js";
+import { type ProtectedRoutesInput } from "../../config/validators/ProtectedRoutesSchema.js";
+import type { FooterSchema } from "../../config/validators/validate.js";
+import type { AuthenticationPlugin } from "../authentication/authentication.js";
 import { type AuthState } from "../authentication/state.js";
 import type { ComponentsContextType } from "../components/context/ComponentsContext.js";
-import type { Slotlets } from "../components/SlotletProvider.js";
+import type { SlotType } from "../components/context/SlotProvider.js";
 import type { MdxComponentsType } from "../util/MdxComponents.js";
-import { type ZudokuPlugin } from "./plugins.js";
+import { type ProfileNavigationItem, type ZudokuPlugin } from "./plugins.js";
 export interface ZudokuEvents {
     location: (event: {
         from?: Location;
@@ -43,10 +45,10 @@ type Metadata = Partial<{
     creator: string;
     publisher: string;
 }>;
-type Page = Partial<{
+type Site = Partial<{
     dir?: "ltr" | "rtl";
     showPoweredBy?: boolean;
-    pageTitle?: string;
+    title?: string;
     logo?: {
         src: {
             light: string;
@@ -54,6 +56,7 @@ type Page = Partial<{
         };
         width?: string | number;
         alt?: string;
+        href?: string;
     };
     banner?: {
         message: ReactNode;
@@ -66,27 +69,36 @@ export type ZudokuContextOptions = {
     basePath?: string;
     canonicalUrlOrigin?: string;
     metadata?: Metadata;
-    page?: Page;
-    authentication?: AuthenticationProvider;
-    topNavigation?: TopNavigationItem[];
-    sidebars?: SidebarConfig;
+    site?: Site;
+    authentication?: AuthenticationPlugin;
+    navigation?: Navigation;
     plugins?: ZudokuPlugin[];
-    slotlets?: Slotlets;
+    slots?: Record<string, SlotType>;
+    /**
+     * @deprecated Use `slots` instead
+     */
+    UNSAFE_slotlets?: Record<string, SlotType>;
     mdx?: {
         components?: MdxComponentsType;
     };
     overrides?: ComponentsContextType;
-    protectedRoutes?: string[];
+    protectedRoutes?: ProtectedRoutesInput;
+    syntaxHighlighting?: {
+        highlighter: HighlighterCore;
+        themes?: {
+            light: BundledTheme;
+            dark: BundledTheme;
+        };
+    };
 };
 export declare class ZudokuContext {
-    readonly options: ZudokuContextOptions;
-    readonly queryClient: QueryClient;
     plugins: NonNullable<ZudokuContextOptions["plugins"]>;
-    sidebars: SidebarConfig;
-    topNavigation: NonNullable<ZudokuContextOptions["topNavigation"]>;
+    navigation: Navigation;
     meta: ZudokuContextOptions["metadata"];
-    page: ZudokuContextOptions["page"];
-    authentication?: ZudokuContextOptions["authentication"];
+    site: ZudokuContextOptions["site"];
+    readonly authentication?: ZudokuContextOptions["authentication"];
+    readonly queryClient: QueryClient;
+    readonly options: ZudokuContextOptions;
     private readonly navigationPlugins;
     private emitter;
     constructor(options: ZudokuContextOptions, queryClient: QueryClient);
@@ -94,7 +106,8 @@ export declare class ZudokuContext {
     getApiIdentities: () => Promise<ApiIdentity[]>;
     addEventListener<E extends keyof ZudokuEvents>(event: E, callback: ZudokuEvents[E]): import("nanoevents").Unsubscribe;
     emitEvent: <E extends keyof ZudokuEvents>(event: E, ...data: Parameters<ZudokuEvents[E]>) => void;
-    getPluginSidebar: (path: string) => Promise<import("../../config/validators/SidebarSchema.js").SidebarItem[]>;
+    getPluginNavigation: (path: string) => Promise<import("../../config/validators/NavigationSchema.js").NavigationItem[]>;
+    getProfileMenuItems: () => ProfileNavigationItem[];
     signRequest: (request: Request) => Promise<Request>;
 }
 export {};

package/dist/lib/core/ZudokuContext.js

@@ -1,29 +1,40 @@
 import { createNanoEvents } from "nanoevents";
+import { ProtectedRoutesSchema, } from "../../config/validators/ProtectedRoutesSchema.js";
 import { useAuthState } from "../authentication/state.js";
-import { joinPath } from "../util/joinPath.js";
+import { joinUrl } from "../util/joinUrl.js";
 import { objectEntries } from "../util/objectEntries.js";
-import { isApiIdentityPlugin, isEventConsumerPlugin, isNavigationPlugin, needsInitialization, } from "./plugins.js";
+import { isApiIdentityPlugin, isAuthenticationPlugin, isEventConsumerPlugin, isNavigationPlugin, isProfileMenuPlugin, needsInitialization, } from "./plugins.js";
 export class ZudokuContext {
-    options;
-    queryClient;
     plugins;
-    sidebars;
-    topNavigation;
+    navigation;
     meta;
-    page;
+    site;
     authentication;
+    queryClient;
+    options;
     navigationPlugins;
     emitter = createNanoEvents();
     constructor(options, queryClient) {
-        this.options = options;
+        const pluginProtectedRoutes = Object.fromEntries((options.plugins ?? []).flatMap((plugin) => {
+            if (!isNavigationPlugin(plugin))
+                return [];
+            const routes = plugin.getProtectedRoutes?.();
+            if (!routes)
+                return [];
+            return Object.entries(ProtectedRoutesSchema.parse(routes) ?? {});
+        }));
+        const protectedRoutes = {
+            ...pluginProtectedRoutes,
+            ...ProtectedRoutesSchema.parse(options.protectedRoutes),
+        };
         this.queryClient = queryClient;
+        this.options = { ...options, protectedRoutes };
         this.plugins = options.plugins ?? [];
-        this.topNavigation = options.topNavigation ?? [];
-        this.sidebars = options.sidebars ?? {};
+        this.navigation = options.navigation ?? [];
         this.navigationPlugins = this.plugins.filter(isNavigationPlugin);
-        this.authentication = options.authentication;
+        this.authentication = this.plugins.find(isAuthenticationPlugin);
         this.meta = options.metadata;
-        this.page = options.page;
+        this.site = options.site;
         this.plugins.forEach((plugin) => {
             if (!isEventConsumerPlugin(plugin))
                 return;
@@ -55,10 +66,18 @@ export class ZudokuContext {
     emitEvent = (event, ...data) => {
         return this.emitter.emit(event, ...data);
     };
-    getPluginSidebar = async (path) => {
-        const navigations = await Promise.all(this.navigationPlugins.map((plugin) => plugin.getSidebar?.(joinPath(path), this)));
+    getPluginNavigation = async (path) => {
+        const navigations = await Promise.all(this.navigationPlugins.map((plugin) => plugin.getNavigation?.(joinUrl(path), this)));
         return navigations.flatMap((nav) => nav ?? []);
     };
+    getProfileMenuItems = () => {
+        const accountItems = this.plugins
+            .filter((p) => isProfileMenuPlugin(p))
+            .flatMap((p) => p.getProfileMenuItems(this))
+            .sort(sortByCategory(["top", "middle", "bottom"]))
+            .sort((i) => i.weight ?? 0);
+        return accountItems;
+    };
     signRequest = async (request) => {
         if (!this.authentication) {
             throw new Error("No authentication provider configured");
@@ -66,4 +85,9 @@ export class ZudokuContext {
         return await this.authentication.signRequest(request);
     };
 }
+const sortByCategory = (categories) => (a, b) => {
+    const aIndex = categories.indexOf(a.category ?? "middle");
+    const bIndex = categories.indexOf(b.category ?? "middle");
+    return aIndex - bIndex;
+};
 //# sourceMappingURL=ZudokuContext.js.map

package/dist/lib/core/ZudokuContext.js.map

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

package/dist/lib/core/plugins.d.ts

@@ -1,14 +1,17 @@
 import type { LucideIcon } from "lucide-react";
 import type { ReactElement } from "react";
 import type { Location, RouteObject } from "react-router";
-import type { Sidebar } from "../../config/validators/SidebarSchema.js";
+import type { Navigation } from "../../config/validators/NavigationSchema.js";
+import type { ProtectedRoutesInput } from "../../config/validators/ProtectedRoutesSchema.js";
+import type { AuthenticationPlugin } from "../authentication/authentication.js";
 import type { MdxComponentsType } from "../util/MdxComponents.js";
 import type { ApiIdentity, ZudokuContext, ZudokuEvents } from "./ZudokuContext.js";
-export type ZudokuPlugin = CommonPlugin | ProfileMenuPlugin | NavigationPlugin | ApiIdentityPlugin | SearchProviderPlugin | EventConsumerPlugin;
-export type { RouteObject };
+export type ZudokuPlugin = CommonPlugin | ProfileMenuPlugin | NavigationPlugin | ApiIdentityPlugin | SearchProviderPlugin | EventConsumerPlugin | AuthenticationPlugin;
+export type { AuthenticationPlugin, RouteObject };
 export interface NavigationPlugin {
     getRoutes: () => RouteObject[];
-    getSidebar?: (path: string, context: ZudokuContext) => Promise<Sidebar>;
+    getNavigation?: (path: string, context: ZudokuContext) => Promise<Navigation>;
+    getProtectedRoutes?: () => ProtectedRoutesInput;
 }
 export declare const createApiIdentityPlugin: (plugin: ApiIdentityPlugin) => ApiIdentityPlugin;
 export declare const createProfileMenuPlugin: (plugin: ProfileMenuPlugin) => ProfileMenuPlugin;
@@ -47,6 +50,7 @@ export type EventConsumerPlugin<Event extends ZudokuEvents = ZudokuEvents> = {
 export declare const isEventConsumerPlugin: (obj: ZudokuPlugin) => obj is EventConsumerPlugin;
 export declare const isProfileMenuPlugin: (obj: ZudokuPlugin) => obj is ProfileMenuPlugin;
 export declare const isNavigationPlugin: (obj: ZudokuPlugin) => obj is NavigationPlugin;
+export declare const isAuthenticationPlugin: (obj: ZudokuPlugin) => obj is AuthenticationPlugin;
 export declare const isSearchPlugin: (obj: ZudokuPlugin) => obj is SearchProviderPlugin;
 export declare const needsInitialization: (obj: ZudokuPlugin) => obj is CommonPlugin;
 export declare const hasHead: (obj: ZudokuPlugin) => obj is CommonPlugin;

package/dist/lib/core/plugins.js

@@ -3,6 +3,7 @@ export const createProfileMenuPlugin = (plugin) => plugin;
 export const isEventConsumerPlugin = (obj) => "events" in obj && typeof obj.events === "object";
 export const isProfileMenuPlugin = (obj) => "getProfileMenuItems" in obj && typeof obj.getProfileMenuItems === "function";
 export const isNavigationPlugin = (obj) => "getRoutes" in obj && typeof obj.getRoutes === "function";
+export const isAuthenticationPlugin = (obj) => "signUp" in obj && typeof obj.signUp === "function";
 export const isSearchPlugin = (obj) => "renderSearch" in obj && typeof obj.renderSearch === "function";
 export const needsInitialization = (obj) => "initialize" in obj && typeof obj.initialize === "function";
 export const hasHead = (obj) => "getHead" in obj && typeof obj.getHead === "function";

package/dist/lib/core/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/lib/core/plugins.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAyB,EACN,EAAE,CAAC,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAyB,EACN,EAAE,CAAC,MAAM,CAAC;AAsC/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAiB,EACW,EAAE,CAC9B,QAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAiB,EACS,EAAE,CAC5B,qBAAqB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAiB,EACQ,EAAE,CAC3B,WAAW,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC;AAE5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,GAAiB,EACY,EAAE,CAC/B,cAAc,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAC5E,YAAY,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAChE,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAC5E,kBAAkB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAiB,EACS,EAAE,CAC5B,eAAe,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/lib/core/plugins.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAyB,EACN,EAAE,CAAC,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAyB,EACN,EAAE,CAAC,MAAM,CAAC;AAsC/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAiB,EACW,EAAE,CAC9B,QAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAiB,EACS,EAAE,CAC5B,qBAAqB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAiB,EACQ,EAAE,CAC3B,WAAW,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAiB,EACY,EAAE,CAC/B,QAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,GAAiB,EACY,EAAE,CAC/B,cAAc,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAC5E,YAAY,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAChE,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAiB,EAAuB,EAAE,CAC5E,kBAAkB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAiB,EACS,EAAE,CAC5B,eAAe,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU,CAAC"}

package/dist/lib/errors/ErrorAlert.js

@@ -3,8 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { SyntaxHighlight } from "zudoku/ui/SyntaxHighlight.js";
 import { DeveloperHint } from "../components/DeveloperHint.js";
 import { Heading } from "../components/Heading.js";
-import { ProseClasses } from "../components/Markdown.js";
-import { cn } from "../util/cn.js";
+import { Typography } from "../components/Typography.js";
 import { ZudokuError } from "../util/invariant.js";
 export function ErrorAlert({ error }) {
     const message = error instanceof Error ? error.message : "Something went wrong";
@@ -13,6 +12,6 @@ export function ErrorAlert({ error }) {
     const stack = error instanceof Error ? error.stack : undefined;
     const cause = error instanceof Error ? error.cause : undefined;
     const stringError = cause instanceof Error ? String(cause.stack) : stack;
-    return (_jsxs("div", { className: cn(ProseClasses, "grid grid-cols-1 !max-w-none pt-[--padding-content-top]"), children: [_jsx(Heading, { level: 1, children: title }), "Error: ", message, hint && _jsx(DeveloperHint, { className: "mb-4", children: hint }), stringError && (_jsx("div", { children: _jsx(SyntaxHighlight, { className: "max-h-[400px] border mt-2", language: "jsstacktrace", code: stringError }) }))] }));
+    return (_jsxs(Typography, { className: "grid grid-cols-1 !max-w-none pt-(--padding-content-top)", children: [_jsx(Heading, { level: 1, children: title }), "Error: ", message, hint && _jsx(DeveloperHint, { className: "mb-4", children: hint }), stringError && (_jsx(SyntaxHighlight, { className: "max-h-[400px] [&>pre]:p-4", language: "js", code: stringError }))] }));
 }
 //# sourceMappingURL=ErrorAlert.js.map

package/dist/lib/errors/ErrorAlert.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorAlert.js","sourceRoot":"","sources":["../../../src/lib/errors/ErrorAlert.tsx"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAsB;IACtD,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAElE,MAAM,IAAI,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,KAAK,GACT,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC;IACtE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzE,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,YAAY,EACZ,yDAAyD,CAC1D,aAED,KAAC,OAAO,IAAC,KAAK,EAAE,CAAC,YAAG,KAAK,GAAW,aAC5B,OAAO,EACd,IAAI,IAAI,KAAC,aAAa,IAAC,SAAS,EAAC,MAAM,YAAE,IAAI,GAAiB,EAC9D,WAAW,IAAI,CACd,wBACE,KAAC,eAAe,IACd,SAAS,EAAC,2BAA2B,EACrC,QAAQ,EAAC,cAAc,EACvB,IAAI,EAAE,WAAW,GACjB,GACE,CACP,IACG,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ErrorAlert.js","sourceRoot":"","sources":["../../../src/lib/errors/ErrorAlert.tsx"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAsB;IACtD,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAElE,MAAM,IAAI,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,KAAK,GACT,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC;IACtE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzE,OAAO,CACL,MAAC,UAAU,IAAC,SAAS,EAAC,yDAAyD,aAC7E,KAAC,OAAO,IAAC,KAAK,EAAE,CAAC,YAAG,KAAK,GAAW,aAC5B,OAAO,EACd,IAAI,IAAI,KAAC,aAAa,IAAC,SAAS,EAAC,MAAM,YAAE,IAAI,GAAiB,EAC9D,WAAW,IAAI,CACd,KAAC,eAAe,IACd,SAAS,EAAC,2BAA2B,EACrC,QAAQ,EAAC,IAAI,EACb,IAAI,EAAE,WAAW,GACjB,CACH,IACU,CACd,CAAC;AACJ,CAAC"}

package/dist/lib/hooks/index.d.ts

@@ -1,3 +1,28 @@
+import { useMDXComponents as useMDXComponentsImport } from "@mdx-js/react";
+import { CACHE_KEYS } from "../components/cache.js";
 import { useEvent as useEventImport } from "./useEvent.js";
 export declare const useEvent: typeof useEventImport;
 export declare const useTheme: () => import("next-themes").UseThemeProps;
+export declare const useExposedProps: () => import("../util/useExposedProps.js").ExposedComponentProps;
+export declare const useMDXComponents: typeof useMDXComponentsImport;
+export declare const useAuth: () => {
+    login: () => Promise<void>;
+    logout: () => Promise<void>;
+    signup: () => Promise<void>;
+    isAuthenticated: boolean;
+    isPending: boolean;
+    profile: import("../authentication/state.js").UserProfile | null;
+    providerData: unknown;
+    setAuthenticationPending: () => void;
+    setLoggedOut: () => void;
+    setLoggedIn: ({ profile, providerData, }: {
+        profile: import("../authentication/state.js").UserProfile;
+        providerData: unknown;
+    }) => void;
+    isAuthEnabled: boolean;
+};
+export declare const useZudoku: () => import("../core/ZudokuContext.js").ZudokuContext;
+export declare const useCache: () => {
+    invalidateCache: (key: keyof typeof CACHE_KEYS) => Promise<void>;
+};
+export { CACHE_KEYS };

package/dist/lib/hooks/index.js

@@ -1,5 +1,16 @@
+import { useMDXComponents as useMDXComponentsImport } from "@mdx-js/react";
 import { useTheme as useThemeImport } from "next-themes";
+import { useAuth as useAuthImport } from "../authentication/hook.js";
+import { CACHE_KEYS, useCache as useCacheImport } from "../components/cache.js";
+import { useZudoku as useZudokuImport } from "../components/context/ZudokuContext.js";
+import { useExposedProps as useExposedPropsImport } from "../util/useExposedProps.js";
 import { useEvent as useEventImport } from "./useEvent.js";
 export const useEvent = /*@__PURE__*/ useEventImport;
 export const useTheme = /*@__PURE__*/ useThemeImport;
+export const useExposedProps = /*@__PURE__*/ useExposedPropsImport;
+export const useMDXComponents = /*@__PURE__*/ useMDXComponentsImport;
+export const useAuth = /*@__PURE__*/ useAuthImport;
+export const useZudoku = /*@__PURE__*/ useZudokuImport;
+export const useCache = /*@__PURE__*/ useCacheImport;
+export { CACHE_KEYS };
 //# sourceMappingURL=index.js.map

package/dist/lib/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,eAAe,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC,qBAAqB,CAAC;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC,sBAAsB,CAAC;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC,eAAe,CAAC;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/hooks/useEvent.test.js

@@ -77,9 +77,11 @@ describe("useEvent", () => {
     });
     describe("types", () => {
         const { wrapper } = createTestContext();
-        it("infers event type when no callback is provided", () => {
-            const hook = renderHook(() => useEvent("location"), { wrapper });
-            assertType(hook.result.current);
+        it("infers event type when no callback is provided", async () => {
+            await act(async () => {
+                const hook = renderHook(() => useEvent("location"), { wrapper });
+                assertType(hook.result.current);
+            });
         });
         it("infers string type from pathname callback", () => {
             const hook = renderHook(() => useEvent("location", ({ to }) => to.pathname), { wrapper });

package/dist/lib/hooks/useEvent.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEvent.test.js","sourceRoot":"","sources":["../../../src/lib/hooks/useEvent.test.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"useEvent.test.js","sourceRoot":"","sources":["../../../src/lib/hooks/useEvent.test.tsx"],"names":[],"mappings":"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"}

package/dist/lib/hooks/useHotkey.d.ts

@@ -0,0 +1,4 @@
+export declare const useHotkey: (hotkey: string, callback: () => void) => {
+    trigger: () => void;
+    label: string[];
+};

package/dist/lib/hooks/useHotkey.js

@@ -0,0 +1,58 @@
+import { useEffect, useRef } from "react";
+import { isAppleDevice } from "../util/os.js";
+const keymap = {
+    other: {
+        alt: "Alt",
+        meta: "Ctrl",
+        ctrl: "Ctrl",
+        shift: "⇧",
+        option: "Alt",
+    },
+    apple: {
+        alt: "⌥",
+        meta: "⌘",
+        ctrl: "Ctrl",
+        shift: "⇧",
+        option: "⌥",
+    },
+};
+export const useHotkey = (hotkey, callback) => {
+    const hotkeySanitized = hotkey.toLowerCase().split("+");
+    const meta = hotkeySanitized.includes("meta");
+    const shift = hotkeySanitized.includes("shift");
+    const alt = hotkeySanitized.includes("option") || hotkeySanitized.includes("alt");
+    const ctrl = hotkeySanitized.includes("ctrl");
+    const key = hotkey.split("+").pop();
+    const callbackRef = useRef(callback);
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    useEffect(() => {
+        const handler = (event) => {
+            if ((event.code === `Key${key?.toUpperCase()}` ||
+                event.code.toLowerCase() === key?.toLowerCase()) &&
+                event.metaKey === meta &&
+                event.shiftKey === shift &&
+                event.altKey === alt &&
+                event.ctrlKey === ctrl) {
+                event.preventDefault();
+                callbackRef.current();
+            }
+        };
+        window.addEventListener("keydown", handler);
+        return () => {
+            window.removeEventListener("keydown", handler);
+        };
+    }, [key, meta, shift, alt, ctrl]);
+    return {
+        trigger: () => callbackRef.current(),
+        label: hotkeySanitized.map((key) => key === "meta" ||
+            key === "ctrl" ||
+            key === "alt" ||
+            key === "shift" ||
+            key === "option"
+            ? keymap[isAppleDevice() ? "apple" : "other"][key]
+            : key),
+    };
+};
+//# sourceMappingURL=useHotkey.js.map

package/dist/lib/hooks/useHotkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkey.js","sourceRoot":"","sources":["../../../src/lib/hooks/useHotkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,GAAG;IACb,KAAK,EAAE;QACL,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,KAAK;KACd;IACD,KAAK,EAAE;QACL,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;KACZ;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,QAAoB,EAAE,EAAE;IAChE,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,GAAG,GACP,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAEpC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,CAAC,KAAoB,EAAE,EAAE;YACvC,IACE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,GAAG,EAAE,WAAW,EAAE,EAAE;gBACxC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,WAAW,EAAE,CAAC;gBAClD,KAAK,CAAC,OAAO,KAAK,IAAI;gBACtB,KAAK,CAAC,QAAQ,KAAK,KAAK;gBACxB,KAAK,CAAC,MAAM,KAAK,GAAG;gBACpB,KAAK,CAAC,OAAO,KAAK,IAAI,EACtB,CAAC;gBACD,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;QACpC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CACzC,GAAG,KAAK,MAAM;YACd,GAAG,KAAK,MAAM;YACd,GAAG,KAAK,KAAK;YACb,GAAG,KAAK,OAAO;YACf,GAAG,KAAK,QAAQ;YACd,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,GAAG,CACR;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/oas/graphql/circular.js

@@ -1,32 +1,37 @@
 import { GraphQLJSON } from "graphql-type-json";
 import { GraphQLScalarType } from "graphql/index.js";
 export const CIRCULAR_REF = "$[Circular Reference]";
-const handleCircularRefs = (obj, visited = new Map(), path = []) => {
-    if (obj === CIRCULAR_REF)
-        return CIRCULAR_REF;
+const OPENAPI_PROPS = new Set([
+    "properties",
+    "items",
+    "additionalProperties",
+    "allOf",
+    "anyOf",
+    "oneOf",
+]);
+const handleCircularRefs = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj, visited = new WeakSet(), refs = new WeakMap(), path = []) => {
     if (obj === null || typeof obj !== "object")
         return obj;
-    const currentPath = path.join(".");
-    if (obj.type === "object" && obj.properties) {
-        const schemaKey = Object.keys(obj.properties).sort().join("-");
-        if (visited.has(schemaKey)) {
-            const prevPaths = visited.get(schemaKey);
-            if (prevPaths.some((prev) => currentPath.startsWith(prev))) {
-                return CIRCULAR_REF;
-            }
-            visited.set(schemaKey, [...prevPaths, currentPath]);
-        }
-        else {
-            visited.set(schemaKey, [currentPath]);
-        }
+    if (visited.has(obj)) {
+        const cached = refs.get(obj);
+        if (cached)
+            return cached;
+        const circularProp = path.find((p) => !OPENAPI_PROPS.has(p)) || path[0];
+        return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
     }
+    visited.add(obj);
     if (Array.isArray(obj)) {
-        return obj.map((item, index) => handleCircularRefs(item, visited, [...path, `${index}`]));
+        const result = obj.map((item, index) => handleCircularRefs(item, visited, refs, [...path, index.toString()]));
+        refs.set(obj, result);
+        return result;
     }
     const result = {};
     for (const [key, value] of Object.entries(obj)) {
-        result[key] = handleCircularRefs(value, visited, [...path, key]);
+        result[key] = handleCircularRefs(value, visited, refs, [...path, key]);
     }
+    refs.set(obj, result);
     return result;
 };
 export const GraphQLJSONSchema = new GraphQLScalarType({

package/dist/lib/oas/graphql/circular.js.map

@@ -1 +1 @@
-{"version":3,"file":"circular.js","sourceRoot":"","sources":["../../../../src/lib/oas/graphql/circular.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAEpD,MAAM,kBAAkB,GAAG,CACzB,GAAQ,EACR,UAAU,IAAI,GAAG,EAAoB,EACrC,OAAiB,EAAE,EACd,EAAE;IACP,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAC9C,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/D,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC7B,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;IACrD,GAAG,WAAW;IACd,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6DAA6D;IAC1E,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE,CAC5B,WAAW,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;CACnD,CAAC,CAAC"}
+{"version":3,"file":"circular.js","sourceRoot":"","sources":["../../../../src/lib/oas/graphql/circular.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAEpD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,YAAY;IACZ,OAAO;IACP,sBAAsB;IACtB,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG;AACzB,8DAA8D;AAC9D,GAAQ,EACR,OAAO,GAAG,IAAI,OAAO,EAAE,EACvB,IAAI,GAAG,IAAI,OAAO,EAAE,EACpB,OAAiB,EAAE,EAEd,EAAE;IACP,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAExE,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEjB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACrC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CACrE,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;IACrD,GAAG,WAAW;IACd,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6DAA6D;IAC1E,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE,CAC5B,WAAW,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;CACnD,CAAC,CAAC"}

package/dist/lib/plugins/api-catalog/Catalog.d.ts

@@ -1,4 +1,4 @@
 import { type ApiCatalogPluginOptions } from "./index.js";
-export declare const Catalog: ({ items, filterCatalogItems, label, categoryLabel, }: Omit<ApiCatalogPluginOptions, "navigationId"> & {
+export declare const Catalog: ({ items, filterCatalogItems, label, categoryLabel, }: Omit<ApiCatalogPluginOptions, "path"> & {
     categoryLabel?: string;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/lib/plugins/api-catalog/Catalog.js

@@ -18,7 +18,7 @@ export const Catalog = ({ items, filterCatalogItems = (items) => items, label =
     });
     // Only index the overview page, ignore the rest
     const dataSet = activeCategory ? { "data-pagefind-ignore": "all" } : {};
-    return (_jsxs("section", { className: "pt-[--padding-content-top]", ...dataSet, children: [_jsx(Helmet, { children: _jsxs("title", { children: [categoryLabel ? `${categoryLabel} - ` : "", label] }) }), _jsxs("div", { className: "grid gap-4", children: [_jsxs(Heading, { level: 2, children: [label, categoryLabel && ` - ${categoryLabel}`] }), _jsx("div", { className: "grid grid-cols-2 gap-4", children: catalogItems.data
+    return (_jsxs("section", { className: "pt-(--padding-content-top)", ...dataSet, children: [_jsx(Helmet, { children: _jsxs("title", { children: [categoryLabel ? `${categoryLabel} - ` : "", label] }) }), _jsxs("div", { className: "grid gap-4", children: [_jsxs(Heading, { level: 2, children: [label, categoryLabel && ` - ${categoryLabel}`] }), _jsx("div", { className: "grid grid-cols-2 gap-4", children: catalogItems.data
                             .filter((api) => !activeCategory ||
                             api.categories.find((c) => c.tags.find((t) => getKey(c.label, t) === activeCategory)))
                             .map((api) => (_jsx(Link, { to: joinUrl(api.path), className: "no-underline hover:!text-foreground", children: _jsxs("div", { className: "border h-full rounded-lg p-4 flex flex-col gap-2 cursor-pointer hover:bg-border/20 font-normal", children: [_jsx("span", { className: "font-semibold", children: api.label }), _jsx(Markdown, { className: "text-sm whitespace-pre-wrap mb-6 line-clamp-2", content: api.description })] }) }, api.path))) })] })] }));

package/dist/lib/plugins/api-catalog/index.d.ts

@@ -12,20 +12,20 @@ export type CatalogCategory = {
     tags: string[];
 };
 export type ApiCatalogPluginOptions = {
-    navigationId: string;
+    path: string;
     label: string;
     categories?: CatalogCategory[];
     items: ApiCatalogItem[];
-    filterCatalogItems?: filterCatalogItems;
+    filterCatalogItems?: FilterCatalogItemsFn;
 };
 export type CatalogContext<ProviderData = unknown> = {
     auth: AuthState<ProviderData>;
 };
-export type filterCatalogItems<ProviderData = unknown> = (items: ApiCatalogItem[], { auth }: CatalogContext<ProviderData>) => ApiCatalogItem[];
-export declare const apiCatalogPlugin: ({ navigationId, items, label, categories, filterCatalogItems, }: {
-    navigationId: string;
+export type FilterCatalogItemsFn<ProviderData = unknown> = (items: ApiCatalogItem[], { auth }: CatalogContext<ProviderData>) => ApiCatalogItem[];
+export declare const apiCatalogPlugin: ({ path, items, label, categories, filterCatalogItems, }: {
+    path: string;
     label: string;
     categories?: CatalogCategory[];
     items: ApiCatalogItem[];
-    filterCatalogItems?: filterCatalogItems;
+    filterCatalogItems?: FilterCatalogItemsFn;
 }) => ZudokuPlugin;

package/dist/lib/plugins/api-catalog/index.js

@@ -4,24 +4,24 @@ import { matchPath } from "react-router";
 import { joinUrl } from "../../util/joinUrl.js";
 import { Catalog } from "./Catalog.js";
 export const getKey = (category, tag) => slugify(`${category}-${tag}`);
-export const apiCatalogPlugin = ({ navigationId, items, label, categories = [], filterCatalogItems, }) => {
+export const apiCatalogPlugin = ({ path, items, label, categories = [], filterCatalogItems, }) => {
     const paths = Object.fromEntries(categories.flatMap((category) => [undefined, ...category.tags].map((tag) => [
-        joinUrl(navigationId, tag ? getKey(category.label, tag) : undefined),
+        joinUrl(path, tag ? getKey(category.label, tag) : undefined),
         tag,
     ])));
     return {
-        getSidebar: async (currentPath) => {
+        getNavigation: async (currentPath) => {
             const matches = Object.keys(paths).some((path) => matchPath(path, currentPath));
             if (!matches) {
                 return [];
             }
-            const sidebar = categories.map((category) => ({
+            const navigation = categories.map((category) => ({
                 type: "category",
                 label: category.label,
                 collapsible: false,
                 items: category.tags.map((tag) => ({
-                    type: "doc",
-                    id: joinUrl(navigationId, getKey(category.label, tag)),
+                    type: "link",
+                    to: joinUrl(path, getKey(category.label, tag)),
                     label: tag,
                     badge: {
                         label: String(items.filter((api) => api.categories.find((c) => c.tags.includes(tag))).length),
@@ -29,13 +29,13 @@ export const apiCatalogPlugin = ({ navigationId, items, label, categories = [],
                     },
                 })),
             }));
-            sidebar.unshift({
-                type: "doc",
-                id: joinUrl(navigationId),
+            navigation.unshift({
+                type: "link",
+                to: joinUrl(path),
                 label: "Overview",
                 badge: { label: String(items.length), color: "outline" },
             });
-            return sidebar;
+            return navigation;
         },
         getRoutes: () => Object.entries(paths).map(([path, tag]) => ({
             path,