zudoku 0.0.0-ff3751f → 0.0.0-fix-display-option-navigation-items.4bdfe991

package/dist/lib/components/navigation/utils.js

@@ -1,20 +1,21 @@
-import { useLocation } from "react-router-dom";
-import { joinPath } from "../../util/joinPath.js";
+import { cva } from "class-variance-authority";
+import { useLocation } from "react-router";
+import { joinUrl } from "../../util/joinUrl.js";
 import { useCurrentNavigation } from "../context/ZudokuContext.js";
-export const traverseSidebar = (sidebar, callback) => {
-    for (const item of sidebar) {
-        const result = traverseSidebarItem(item, callback);
+export const traverseNavigation = (navigation, callback) => {
+    for (const item of navigation) {
+        const result = traverseNavigationItem(item, callback);
         if (result !== undefined)
             return result;
     }
 };
-export const traverseSidebarItem = (item, callback, parentCategories = []) => {
+export const traverseNavigationItem = (item, callback, parentCategories = []) => {
     const result = callback(item, parentCategories);
     if (result !== undefined)
         return result;
     if (item.type === "category") {
         for (const child of item.items) {
-            const childResult = traverseSidebarItem(child, callback, [
+            const childResult = traverseNavigationItem(child, callback, [
                 ...parentCategories,
                 item,
             ]);
@@ -25,25 +26,24 @@ export const traverseSidebarItem = (item, callback, parentCategories = []) => {
 };
 export const useCurrentItem = () => {
     const location = useLocation();
-    const nav = useCurrentNavigation();
-    const currentSidebar = nav.data.sidebar;
-    return traverseSidebar(currentSidebar, (item) => {
-        if (item.type === "doc" && joinPath(item.id) === location.pathname) {
+    const { navigation } = useCurrentNavigation();
+    return traverseNavigation(navigation, (item) => {
+        if (item.type === "doc" && joinUrl(item.path) === location.pathname) {
             return item;
         }
     });
 };
 export const useIsCategoryOpen = (category) => {
     const location = useLocation();
-    return traverseSidebarItem(category, (item) => {
+    return traverseNavigationItem(category, (item) => {
         if (item.type === "category" && item.link) {
-            const categoryLinkPath = joinPath(item.link.id);
+            const categoryLinkPath = joinUrl(item.link.path);
             if (categoryLinkPath === location.pathname) {
                 return true;
             }
         }
         if (item.type === "doc") {
-            const docPath = joinPath(item.id);
+            const docPath = joinUrl(item.path);
             if (docPath === location.pathname) {
                 return true;
             }
@@ -52,16 +52,15 @@ export const useIsCategoryOpen = (category) => {
 };
 export const usePrevNext = () => {
     const currentId = useLocation().pathname;
-    const nav = useCurrentNavigation();
-    const currentSidebar = nav.data.sidebar;
+    const { navigation } = useCurrentNavigation();
     let prev;
     let next;
     let foundCurrent = false;
-    traverseSidebar(currentSidebar, (item) => {
+    traverseNavigation(navigation, (item) => {
         const itemId = item.type === "doc"
-            ? joinPath(item.id)
+            ? joinUrl(item.path)
             : item.type === "category" && item.link
-                ? joinPath(item.link.id)
+                ? joinUrl(item.link.path)
                 : undefined;
         if (!itemId)
             return;
@@ -78,4 +77,36 @@ export const usePrevNext = () => {
     });
     return { prev, next };
 };
+export const navigationListItem = cva("relative flex items-center gap-2 px-(--padding-nav-item) my-0.5 py-1.5 rounded-lg hover:bg-accent tabular-nums", {
+    variants: {
+        isActive: {
+            true: "bg-accent font-medium",
+            false: "text-foreground/80",
+        },
+        isMuted: {
+            true: "text-foreground/30",
+            false: "",
+        },
+        isPending: {
+            true: "bg-accent animate-pulse",
+            false: "",
+        },
+    },
+    defaultVariants: {
+        isActive: false,
+    },
+});
+export const isHiddenItem = (auth, context) => (item) => {
+    if (typeof item.display === "function") {
+        return item.display({ context, auth });
+    }
+    if (item.display === "hide")
+        return false;
+    if (!item.label)
+        return false;
+    return ((item.display === "auth" && auth.isAuthenticated) ||
+        (item.display === "anon" && !auth.isAuthenticated) ||
+        !item.display ||
+        item.display === "always");
+};
 //# sourceMappingURL=utils.js.map

package/dist/lib/components/navigation/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/lib/components/navigation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAsB,EACtB,QAA6B,EACd,EAAE;IACjB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;IAC1C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAAiB,EACjB,QAA6B,EAC7B,mBAAkC,EAAE,EACrB,EAAE;IACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE;gBACvD,GAAG,gBAAgB;gBACnB,IAAI;aACL,CAAC,CAAC;YACH,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;IAEnC,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;IAExC,OAAO,eAAe,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAA6B,EAAE,EAAE;IACjE,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,gBAAgB,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC3C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,OAAO,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAGzB,EAAE;IACF,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC,QAAQ,CAAC;IACzC,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;IAExC,IAAI,IAAI,CAAC;IACT,IAAI,IAAI,CAAC;IAET,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,eAAe,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,MAAM,GACV,IAAI,CAAC,IAAI,KAAK,KAAK;YACjB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI;gBACrC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,CAAC,CAAC,SAAS,CAAC;QAElB,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/lib/components/navigation/utils.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export declare const SEARCH_PROTECTED_SECTION = "protected";
+export declare const RouteGuard: () => import("react/jsx-runtime").JSX.Element;

package/dist/lib/core/RouteGuard.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useQuery } from "@tanstack/react-query";
+import { Helmet } from "@zudoku/react-helmet-async";
+import { use } from "react";
+import { matchPath, Outlet, useLocation, useNavigate } from "react-router";
+import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, } from "zudoku/ui/Dialog.js";
+import { useAuth } from "../authentication/hook.js";
+import { BypassProtectedRoutesContext } from "../components/context/BypassProtectedRoutesContext.js";
+import { useZudoku } from "../components/context/ZudokuContext.js";
+import { ZudokuError } from "../util/invariant.js";
+import { useLatest } from "../util/useLatest.js";
+export const SEARCH_PROTECTED_SECTION = "protected";
+export const RouteGuard = () => {
+    const auth = useAuth();
+    const zudoku = useZudoku();
+    const navigate = useNavigate();
+    const location = useLocation();
+    const latestPath = useLatest(location.pathname);
+    const shouldBypass = use(BypassProtectedRoutesContext);
+    const { protectedRoutes } = zudoku.options;
+    const authCheckFn = !shouldBypass && protectedRoutes
+        ? Object.entries(protectedRoutes).find(([path]) => matchPath({ path, end: true }, location.pathname))?.[1]
+        : undefined;
+    const isProtectedRoute = authCheckFn !== undefined;
+    const needsToSignIn = isProtectedRoute && !authCheckFn({ auth, context: zudoku });
+    useQuery({
+        queryKey: ["login-redirect"],
+        queryFn: async () => {
+            await new Promise((resolve) => setTimeout(resolve, 1200));
+            await zudoku.authentication?.signIn({
+                redirectTo: latestPath.current,
+            });
+            return true;
+        },
+        enabled: typeof window !== "undefined" && needsToSignIn && !auth.isPending,
+    });
+    if (needsToSignIn) {
+        return (_jsx(Dialog, { open: true, onOpenChange: (open) => {
+                if (!open) {
+                    void navigate(-1);
+                }
+            }, children: _jsxs(DialogContent, { children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: "Logging you in..." }) }), _jsx(DialogDescription, { children: "Please wait while we log you in." })] }) }));
+    }
+    if (isProtectedRoute && !auth.isAuthEnabled) {
+        throw new ZudokuError("Authentication is not enabled", {
+            title: "Authentication is not enabled",
+            developerHint: "To use protectedRoutes you need authentication to be enabled",
+        });
+    }
+    return (_jsxs(_Fragment, { children: [shouldBypass && (_jsx(Helmet, { children: _jsx("meta", { name: "pagefind", "data-pagefind-filter": `section:${SEARCH_PROTECTED_SECTION}`, content: "true" }) })), _jsx(Outlet, {})] }));
+};
+//# sourceMappingURL=RouteGuard.js.map

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

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

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

@@ -0,0 +1,113 @@
+import type { QueryClient } from "@tanstack/react-query";
+import type { ReactNode } from "react";
+import type { Location } from "react-router";
+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 { SlotType } from "../components/context/SlotProvider.js";
+import type { MdxComponentsType } from "../util/MdxComponents.js";
+import { type ProfileNavigationItem, type ZudokuPlugin } from "./plugins.js";
+export interface ZudokuEvents {
+    location: (event: {
+        from?: Location;
+        to: Location;
+    }) => void;
+    auth: (auth: {
+        prev: AuthState;
+        next: AuthState;
+    }) => void;
+}
+export interface ApiIdentity {
+    authorizeRequest: (request: Request) => Promise<Request> | Request;
+    authorizationFields?: {
+        headers?: string[];
+        queryParams?: string[];
+    };
+    label: string;
+    id: string;
+}
+export type ApiKeyCache = "api-keys";
+type Metadata = Partial<{
+    title: string;
+    description: string;
+    logo: string;
+    favicon: string;
+    generator: string;
+    applicationName: string;
+    referrer: string;
+    keywords: string[];
+    authors: string[];
+    creator: string;
+    publisher: string;
+}>;
+type Site = Partial<{
+    dir?: "ltr" | "rtl";
+    showPoweredBy?: boolean;
+    title?: string;
+    logo?: {
+        src: {
+            light: string;
+            dark: string;
+        };
+        width?: string | number;
+        alt?: string;
+        href?: string;
+    };
+    banner?: {
+        message: ReactNode;
+        color?: "note" | "tip" | "info" | "caution" | "danger" | (string & {});
+        dismissible?: boolean;
+    };
+    footer?: z.infer<typeof FooterSchema>;
+}>;
+export type ZudokuContextOptions = {
+    basePath?: string;
+    canonicalUrlOrigin?: string;
+    metadata?: Metadata;
+    site?: Site;
+    authentication?: AuthenticationPlugin;
+    navigation?: Navigation;
+    plugins?: ZudokuPlugin[];
+    slots?: Record<string, SlotType>;
+    /**
+     * @deprecated Use `slots` instead
+     */
+    UNSAFE_slotlets?: Record<string, SlotType>;
+    mdx?: {
+        components?: MdxComponentsType;
+    };
+    overrides?: ComponentsContextType;
+    protectedRoutes?: ProtectedRoutesInput;
+    syntaxHighlighting?: {
+        highlighter: HighlighterCore;
+        themes?: {
+            light: BundledTheme;
+            dark: BundledTheme;
+        };
+    };
+};
+export declare class ZudokuContext {
+    plugins: NonNullable<ZudokuContextOptions["plugins"]>;
+    navigation: Navigation;
+    meta: ZudokuContextOptions["metadata"];
+    site: ZudokuContextOptions["site"];
+    readonly authentication?: ZudokuContextOptions["authentication"];
+    readonly queryClient: QueryClient;
+    readonly options: ZudokuContextOptions;
+    private readonly navigationPlugins;
+    private emitter;
+    constructor(options: ZudokuContextOptions, queryClient: QueryClient);
+    initialize: () => Promise<void>;
+    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;
+    getPluginNavigation: (path: string) => Promise<import("../../config/validators/NavigationSchema.js").NavigationItem[]>;
+    getProfileMenuItems: () => ProfileNavigationItem[];
+    signRequest: (request: Request) => Promise<Request>;
+}
+export {};

package/dist/lib/core/ZudokuContext.js

@@ -0,0 +1,93 @@
+import { createNanoEvents } from "nanoevents";
+import { ProtectedRoutesSchema, } from "../../config/validators/ProtectedRoutesSchema.js";
+import { useAuthState } from "../authentication/state.js";
+import { joinUrl } from "../util/joinUrl.js";
+import { objectEntries } from "../util/objectEntries.js";
+import { isApiIdentityPlugin, isAuthenticationPlugin, isEventConsumerPlugin, isNavigationPlugin, isProfileMenuPlugin, needsInitialization, } from "./plugins.js";
+export class ZudokuContext {
+    plugins;
+    navigation;
+    meta;
+    site;
+    authentication;
+    queryClient;
+    options;
+    navigationPlugins;
+    emitter = createNanoEvents();
+    constructor(options, queryClient) {
+        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.navigation = options.navigation ?? [];
+        this.navigationPlugins = this.plugins.filter(isNavigationPlugin);
+        this.authentication = this.plugins.find(isAuthenticationPlugin);
+        this.meta = options.metadata;
+        this.site = options.site;
+        this.plugins.forEach((plugin) => {
+            if (!isEventConsumerPlugin(plugin))
+                return;
+            objectEntries(plugin.events).forEach(([event, handler]) => {
+                this.emitter.on(event, handler);
+            });
+        });
+        useAuthState.subscribe((state, prevState) => {
+            this.emitEvent("auth", {
+                prev: prevState,
+                next: state,
+            });
+        });
+    }
+    initialize = async () => {
+        await Promise.all(this.plugins
+            .filter(needsInitialization)
+            .map((plugin) => plugin.initialize?.(this)));
+    };
+    getApiIdentities = async () => {
+        const keys = await Promise.all(this.plugins
+            .filter(isApiIdentityPlugin)
+            .map((plugin) => plugin.getIdentities(this)));
+        return keys.flat();
+    };
+    addEventListener(event, callback) {
+        return this.emitter.on(event, callback);
+    }
+    emitEvent = (event, ...data) => {
+        return this.emitter.emit(event, ...data);
+    };
+    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");
+        }
+        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

@@ -0,0 +1 @@
+{"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,16 +1,22 @@
-import { type ReactElement } from "react";
-import { type RouteObject } from "react-router-dom";
-import type { Sidebar } from "../../config/validators/SidebarSchema.js";
-import { MdxComponentsType } from "../util/MdxComponents.js";
-import { DevPortalContext, type ApiIdentity } from "./DevPortalContext.js";
-export type DevPortalPlugin = CommonPlugin | ProfileMenuPlugin | NavigationPlugin | ApiIdentityPlugin | SearchProviderPlugin;
-export type { RouteObject };
+import type { LucideIcon } from "lucide-react";
+import type { ReactElement } from "react";
+import type { Location, RouteObject } from "react-router";
+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 | AuthenticationPlugin;
+export type { AuthenticationPlugin, RouteObject };
 export interface NavigationPlugin {
     getRoutes: () => RouteObject[];
-    getSidebar?: (path: string) => 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;
 export interface ApiIdentityPlugin {
-    getIdentities: (context: DevPortalContext) => Promise<ApiIdentity[]>;
+    getIdentities: (context: ZudokuContext) => Promise<ApiIdentity[]>;
 }
 export interface SearchProviderPlugin {
     renderSearch: (o: {
@@ -19,22 +25,34 @@ export interface SearchProviderPlugin {
     }) => React.JSX.Element | null;
 }
 export interface ProfileMenuPlugin {
-    getProfileMenuItems: (context: DevPortalContext) => ProfileNavigationItem[];
+    getProfileMenuItems: (context: ZudokuContext) => ProfileNavigationItem[];
 }
 export type ProfileNavigationItem = {
     label: string;
     path?: string;
+    weight?: number;
+    category?: "top" | "middle" | "bottom";
     children?: ProfileNavigationItem[];
+    icon?: LucideIcon;
 };
 export interface CommonPlugin {
-    initialize?: (context: DevPortalContext) => Promise<void | boolean> | void | boolean;
-    getHead?: () => ReactElement | undefined;
+    initialize?: (context: ZudokuContext) => Promise<void | boolean> | void | boolean;
+    getHead?: ({ location }: {
+        location: Location;
+    }) => ReactElement | undefined;
     getMdxComponents?: () => MdxComponentsType;
 }
-export declare const isProfileMenuPlugin: (obj: DevPortalPlugin) => obj is ProfileMenuPlugin;
-export declare const isNavigationPlugin: (obj: DevPortalPlugin) => obj is NavigationPlugin;
-export declare const isSearchPlugin: (obj: DevPortalPlugin) => obj is SearchProviderPlugin;
-export declare const needsInitialization: (obj: DevPortalPlugin) => obj is CommonPlugin;
-export declare const hasHead: (obj: DevPortalPlugin) => obj is CommonPlugin;
-export declare const isMdxProviderPlugin: (obj: DevPortalPlugin) => obj is CommonPlugin;
-export declare const isApiIdentityPlugin: (obj: DevPortalPlugin) => obj is ApiIdentityPlugin;
+export type EventConsumerPlugin<Event extends ZudokuEvents = ZudokuEvents> = {
+    events: {
+        [K in keyof Event]?: Event[K];
+    };
+};
+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;
+export declare const isMdxProviderPlugin: (obj: ZudokuPlugin) => obj is CommonPlugin;
+export declare const isApiIdentityPlugin: (obj: ZudokuPlugin) => obj is ApiIdentityPlugin;

package/dist/lib/core/plugins.js

@@ -1,5 +1,9 @@
+export const createApiIdentityPlugin = (plugin) => plugin;
+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":"AAiDA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAoB,EACM,EAAE,CAC5B,qBAAqB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAoB,EACK,EAAE,CAC3B,WAAW,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC;AAE5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,GAAoB,EACS,EAAE,CAC/B,cAAc,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAoB,EACC,EAAE,CACvB,YAAY,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAoB,EAAuB,EAAE,CACnE,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAoB,EACC,EAAE,CACvB,kBAAkB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAoB,EACM,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

@@ -1,6 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
+import { SyntaxHighlight } from "zudoku/ui/SyntaxHighlight.js";
 import { DeveloperHint } from "../components/DeveloperHint.js";
+import { Heading } from "../components/Heading.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";
@@ -8,6 +11,7 @@ export function ErrorAlert({ error }) {
     const title = error instanceof ZudokuError ? error.title : "Something went wrong";
     const stack = error instanceof Error ? error.stack : undefined;
     const cause = error instanceof Error ? error.cause : undefined;
-    return (_jsx("div", { className: "flex h-screen max-h-screen min-h-full items-center justify-center bg-primary-background px-4 py-16 lg:px-8", children: _jsxs("div", { className: "mx-auto max-w-[85%] sm:max-w-[50%]", children: [_jsx("h1", { className: "text-4xl font-bold tracking-tight text-h1-text sm:text-5xl", children: title }), _jsx("p", { className: "mt-5 text-h1-text", children: message }), hint && _jsx(DeveloperHint, { className: "mb-4", children: hint }), cause instanceof Error ? (_jsx("pre", { className: "mt-5 max-h-[400px] w-full overflow-scroll rounded-md border border-input-border bg-input-background p-3 text-property-name-text text-red-700", children: cause.stack })) : stack ? (_jsx("pre", { className: "mt-5 max-h-[400px] w-full overflow-scroll rounded-md border border-input-border bg-input-background p-3 text-property-name-text text-red-700", children: stack })) : null] }) }));
+    const stringError = cause instanceof Error ? String(cause.stack) : stack;
+    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,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,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;IAClE,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,OAAO,CACL,cAAK,SAAS,EAAC,4GAA4G,YACzH,eAAK,SAAS,EAAC,oCAAoC,aACjD,aAAI,SAAS,EAAC,4DAA4D,YACvE,KAAK,GACH,EACL,YAAG,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAK,EAC7C,IAAI,IAAI,KAAC,aAAa,IAAC,SAAS,EAAC,MAAM,YAAE,IAAI,GAAiB,EAC9D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CACxB,cAAK,SAAS,EAAC,8IAA8I,YAC1J,KAAK,CAAC,KAAK,GACR,CACP,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACV,cAAK,SAAS,EAAC,8IAA8I,YAC1J,KAAK,GACF,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,GACF,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/errors/RouterError.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { isRouteErrorResponse, useRouteError } from "react-router-dom";
+import { isRouteErrorResponse, useRouteError } from "react-router";
 import { NotFoundPage } from "../components/NotFoundPage.js";
 import { ErrorAlert } from "./ErrorAlert.js";
 export function RouterError() {

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

@@ -1 +1 @@
-{"version":3,"file":"RouterError.js","sourceRoot":"","sources":["../../../src/lib/errors/RouterError.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAE9B,IAAI,oBAAoB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACxD,OAAO,KAAC,YAAY,KAAG,CAAC;IAC1B,CAAC;IAED,OAAO,KAAC,UAAU,IAAC,KAAK,EAAE,KAAK,GAAI,CAAC;AACtC,CAAC"}
+{"version":3,"file":"RouterError.js","sourceRoot":"","sources":["../../../src/lib/errors/RouterError.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAE9B,IAAI,oBAAoB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACxD,OAAO,KAAC,YAAY,KAAG,CAAC;IAC1B,CAAC;IAED,OAAO,KAAC,UAAU,IAAC,KAAK,EAAE,KAAK,GAAI,CAAC;AACtC,CAAC"}

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

@@ -0,0 +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

@@ -0,0 +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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,11 @@
+import type { ZudokuEvents } from "../core/ZudokuContext.js";
+type EventParameters<Event extends keyof ZudokuEvents> = Parameters<ZudokuEvents[Event]>;
+/**
+ * Hook to subscribe to Zudoku events with automatic cleanup
+ * @param event The event to subscribe to
+ * @param callback Optional callback to be called when the event is emitted
+ * @returns The latest event data if no callback is provided, or the callback's return value if it returns something
+ */
+export declare function useEvent<E extends keyof ZudokuEvents>(event: E): EventParameters<E>;
+export declare function useEvent<E extends keyof ZudokuEvents, R>(event: E, callback: (...args: EventParameters<E>) => R): R;
+export {};