zudoku 0.0.0-fd8f8ad → 0.0.0-feat-bundled-types.1c7f1db

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 isProtected = !shouldBypass &&
+        protectedRoutes.some((path) => matchPath({ path, end: true }, location.pathname));
+    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" &&
+            isProtected &&
+            !auth.isPending &&
+            !auth.isAuthenticated,
+    });
+    if (isProtected && !auth.isAuthenticated) {
+        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 (isProtected && !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

@@ -1,13 +1,32 @@
-import { ReactNode } from "react";
+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";
 import type { SidebarConfig } from "../../config/validators/SidebarSchema.js";
-import { TopNavigationItem } from "../../config/validators/validate.js";
-import { type AuthenticationProvider } from "../authentication/authentication.js";
+import type { FooterSchema, TopNavigationItem } 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 { 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";
+export interface ZudokuEvents {
+    location: (event: {
+        from?: Location;
+        to: Location;
+    }) => void;
+    auth: (auth: {
+        prev: AuthState;
+        next: AuthState;
+    }) => void;
+}
 export interface ApiIdentity {
-    authorizeRequest: (request: Request) => Request;
+    authorizeRequest: (request: Request) => Promise<Request> | Request;
+    authorizationFields?: {
+        headers?: string[];
+        queryParams?: string[];
+    };
     label: string;
     id: string;
 }
@@ -26,13 +45,15 @@ type Metadata = Partial<{
     publisher: string;
 }>;
 type Page = Partial<{
+    dir?: "ltr" | "rtl";
+    showPoweredBy?: boolean;
     pageTitle?: string;
     logo?: {
         src: {
             light: string;
             dark: string;
         };
-        width?: string;
+        width?: string | number;
         alt?: string;
     };
     banner?: {
@@ -40,19 +61,34 @@ type Page = Partial<{
         color?: "note" | "tip" | "info" | "caution" | "danger" | (string & {});
         dismissible?: boolean;
     };
+    footer?: z.infer<typeof FooterSchema>;
 }>;
 export type ZudokuContextOptions = {
+    basePath?: string;
+    canonicalUrlOrigin?: string;
     metadata?: Metadata;
     page?: Page;
-    authentication?: AuthenticationProvider;
+    authentication?: AuthenticationPlugin;
     topNavigation?: TopNavigationItem[];
     sidebars?: SidebarConfig;
     plugins?: ZudokuPlugin[];
-    slotlets?: Slotlets;
+    slots?: Record<string, SlotType>;
+    /**
+     * @deprecated Use `slots` instead
+     */
+    UNSAFE_slotlets?: Record<string, SlotType>;
     mdx?: {
         components?: MdxComponentsType;
     };
     overrides?: ComponentsContextType;
+    protectedRoutes?: string[];
+    syntaxHighlighting?: {
+        highlighter: HighlighterCore;
+        themes?: {
+            light: BundledTheme;
+            dark: BundledTheme;
+        };
+    };
 };
 export declare class ZudokuContext {
     plugins: NonNullable<ZudokuContextOptions["plugins"]>;
@@ -60,11 +96,16 @@ export declare class ZudokuContext {
     topNavigation: NonNullable<ZudokuContextOptions["topNavigation"]>;
     meta: ZudokuContextOptions["metadata"];
     page: ZudokuContextOptions["page"];
-    authentication?: ZudokuContextOptions["authentication"];
-    private navigationPlugins;
-    constructor(config: ZudokuContextOptions);
+    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;
     getPluginSidebar: (path: string) => Promise<import("../../config/validators/SidebarSchema.js").SidebarItem[]>;
     signRequest: (request: Request) => Promise<Request>;
 }

package/dist/lib/core/ZudokuContext.js

@@ -1,5 +1,8 @@
+import { createNanoEvents } from "nanoevents";
+import { useAuthState } from "../authentication/state.js";
 import { joinPath } from "../util/joinPath.js";
-import { isApiIdentityPlugin, isNavigationPlugin, needsInitialization, } from "./plugins.js";
+import { objectEntries } from "../util/objectEntries.js";
+import { isApiIdentityPlugin, isAuthenticationPlugin, isEventConsumerPlugin, isNavigationPlugin, needsInitialization, } from "./plugins.js";
 export class ZudokuContext {
     plugins;
     sidebars;
@@ -7,15 +10,34 @@ export class ZudokuContext {
     meta;
     page;
     authentication;
+    queryClient;
+    options;
     navigationPlugins;
-    constructor(config) {
-        this.plugins = config.plugins ?? [];
-        this.topNavigation = config.topNavigation ?? [];
-        this.sidebars = config.sidebars ?? {};
+    emitter = createNanoEvents();
+    constructor(options, queryClient) {
+        const protectedRoutes = (options.protectedRoutes ?? []).concat(options.plugins?.flatMap((plugin) => isNavigationPlugin(plugin) ? (plugin.getProtectedRoutes?.() ?? []) : []) ?? []);
+        this.queryClient = queryClient;
+        this.options = { ...options, protectedRoutes };
+        this.plugins = options.plugins ?? [];
+        this.topNavigation = options.topNavigation ?? [];
+        this.sidebars = options.sidebars ?? {};
         this.navigationPlugins = this.plugins.filter(isNavigationPlugin);
-        this.authentication = config.authentication;
-        this.meta = config.metadata;
-        this.page = config.page;
+        this.authentication = this.plugins.find(isAuthenticationPlugin);
+        this.meta = options.metadata;
+        this.page = options.page;
+        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
@@ -28,17 +50,21 @@ export class ZudokuContext {
             .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);
+    };
     getPluginSidebar = async (path) => {
-        const navigations = await Promise.all(this.navigationPlugins.map((plugin) => plugin.getSidebar?.(joinPath(path))));
+        const navigations = await Promise.all(this.navigationPlugins.map((plugin) => plugin.getSidebar?.(joinPath(path), this)));
         return navigations.flatMap((nav) => nav ?? []);
     };
     signRequest = async (request) => {
         if (!this.authentication) {
             throw new Error("No authentication provider configured");
         }
-        const accessToken = await this.authentication.getAccessToken();
-        request.headers.set("Authorization", `Bearer ${accessToken}`);
-        return request;
+        return await this.authentication.signRequest(request);
     };
 }
 //# 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":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAElB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AAuDtB,MAAM,OAAO,aAAa;IACjB,OAAO,CAA+C;IACtD,QAAQ,CAAgB;IACxB,aAAa,CAAqD;IAClE,IAAI,CAAmC;IACvC,IAAI,CAA+B;IACnC,cAAc,CAA0C;IACvD,iBAAiB,CAAqB;IAE9C,YAAY,MAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,UAAU,GAAG,KAAK,IAAmB,EAAE;QACrC,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,OAAO;aACT,MAAM,CAAC,mBAAmB,CAAC;aAC3B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAC9C,CAAC;IACJ,CAAC,CAAC;IAEF,gBAAgB,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,IAAI,CAAC,OAAO;aACT,MAAM,CAAC,mBAAmB,CAAC;aAC3B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAC/C,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC;IAEF,gBAAgB,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;QACxC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACpC,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACpC,CACF,CAAC;QAEF,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,WAAW,GAAG,KAAK,EAAE,OAAgB,EAAE,EAAE;QACvC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;QAE/D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,WAAW,EAAE,CAAC,CAAC;QAE9D,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;CACH"}
+{"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,19 @@
-import { type ReactElement } from "react";
-import { type RouteObject } from "react-router-dom";
+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 { MdxComponentsType } from "../util/MdxComponents.js";
-import { ZudokuContext, type ApiIdentity } from "./ZudokuContext.js";
-export type ZudokuPlugin = CommonPlugin | ProfileMenuPlugin | NavigationPlugin | ApiIdentityPlugin | SearchProviderPlugin;
-export type { RouteObject };
+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>;
+    getSidebar?: (path: string, context: ZudokuContext) => Promise<Sidebar>;
+    getProtectedRoutes?: () => string[];
 }
+export declare const createApiIdentityPlugin: (plugin: ApiIdentityPlugin) => ApiIdentityPlugin;
+export declare const createProfileMenuPlugin: (plugin: ProfileMenuPlugin) => ProfileMenuPlugin;
 export interface ApiIdentityPlugin {
     getIdentities: (context: ZudokuContext) => Promise<ApiIdentity[]>;
 }
@@ -24,15 +29,27 @@ export interface ProfileMenuPlugin {
 export type ProfileNavigationItem = {
     label: string;
     path?: string;
+    weight?: number;
+    category?: "top" | "middle" | "bottom";
     children?: ProfileNavigationItem[];
+    icon?: LucideIcon;
 };
 export interface CommonPlugin {
     initialize?: (context: ZudokuContext) => Promise<void | boolean> | void | boolean;
-    getHead?: () => ReactElement | undefined;
+    getHead?: ({ location }: {
+        location: Location;
+    }) => ReactElement | undefined;
     getMdxComponents?: () => MdxComponentsType;
 }
+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;

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,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":"AA6BA,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,10 @@
 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 { ProseClasses } from "../components/Markdown.js";
+import { cn } from "../util/cn.js";
 import { ZudokuError } from "../util/invariant.js";
 export function ErrorAlert({ error }) {
     const message = error instanceof Error ? error.message : "Something went wrong";
@@ -8,6 +12,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-[calc(100vh-var(--header-height))] 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("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: "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;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,OAAO,CACL,cAAK,SAAS,EAAC,wIAAwI,YACrJ,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,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,IAAI,EACb,IAAI,EAAE,WAAW,GACjB,GACE,CACP,IACG,CACP,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,22 @@
+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;
+    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 {};

package/dist/lib/hooks/useEvent.js

@@ -0,0 +1,19 @@
+import { useEffect, useState } from "react";
+import { useZudoku } from "../components/context/ZudokuContext.js";
+export function useEvent(event, callback) {
+    const zudoku = useZudoku();
+    const [latestData, setLatestData] = useState();
+    useEffect(() => {
+        return zudoku.addEventListener(event, ((...args) => {
+            if (callback) {
+                const result = callback(...args);
+                setLatestData(result);
+            }
+            else {
+                setLatestData(args);
+            }
+        }));
+    }, [zudoku, event, callback]);
+    return latestData;
+}
+//# sourceMappingURL=useEvent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEvent.js","sourceRoot":"","sources":["../../../src/lib/hooks/useEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAoBnE,MAAM,UAAU,QAAQ,CACtB,KAAQ,EACR,QAA6C;IAE7C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,EAA0B,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,IAAwB,EAAE,EAAE;YACrE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;gBACjC,aAAa,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAoB,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE9B,OAAO,UAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,100 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { act, renderHook, waitFor } from "@testing-library/react";
+import { assertType, describe, expect, it, vi } from "vitest";
+import { ZudokuProvider } from "../components/context/ZudokuProvider.js";
+import { ZudokuContext } from "../core/ZudokuContext.js";
+import { useEvent } from "./useEvent.js";
+/**
+ * @vitest-environment happy-dom
+ */
+const createTestContext = () => {
+    const queryClient = new QueryClient();
+    const context = new ZudokuContext({}, queryClient);
+    const wrapper = ({ children }) => (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ZudokuProvider, { context: context, children: children }) }));
+    return { context, wrapper };
+};
+const locationData = {
+    pathname: "/test",
+    hash: "",
+    search: "",
+    key: "",
+    state: {},
+};
+describe("useEvent", () => {
+    it("returns latest event data without callback", async () => {
+        const { context, wrapper } = createTestContext();
+        const { result } = renderHook(() => useEvent("location"), { wrapper });
+        await act(() => Promise.resolve());
+        await act(async () => {
+            context.emitEvent("location", { to: locationData });
+        });
+        expect(result.current).toEqual([{ to: locationData }]);
+    });
+    it("transforms event data with callback", async () => {
+        const { context, wrapper } = createTestContext();
+        const { result } = renderHook(() => useEvent("location", ({ to }) => to.pathname), { wrapper });
+        await act(() => Promise.resolve());
+        await act(async () => {
+            context.emitEvent("location", { to: locationData });
+        });
+        await waitFor(() => expect(result.current).toEqual("/test"));
+    });
+    it("handles side effects without return value", async () => {
+        const { context, wrapper } = createTestContext();
+        const sideEffect = vi.fn();
+        const { result } = renderHook(() => useEvent("location", (event) => {
+            sideEffect(event);
+        }), { wrapper });
+        await act(() => Promise.resolve());
+        await act(async () => {
+            context.emitEvent("location", { to: locationData });
+        });
+        expect(result.current).toBeUndefined();
+        expect(sideEffect).toHaveBeenCalledWith({ to: locationData });
+        expect(sideEffect).toHaveBeenCalledTimes(1);
+    });
+    it("removes event listener on cleanup", async () => {
+        const { context, wrapper } = createTestContext();
+        const sideEffect = vi.fn();
+        const { unmount } = renderHook(() => useEvent("location", (event) => {
+            sideEffect(event);
+        }), { wrapper });
+        await act(() => Promise.resolve());
+        // First event emission
+        await act(async () => {
+            context.emitEvent("location", { to: locationData });
+        });
+        expect(sideEffect).toHaveBeenCalledTimes(1);
+        // Unmount the hook
+        unmount();
+        // Second event emission after unmount
+        await act(async () => {
+            context.emitEvent("location", { to: locationData });
+        });
+        // The callback should not have been called again
+        expect(sideEffect).toHaveBeenCalledTimes(1);
+    });
+    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 string type from pathname callback", () => {
+            const hook = renderHook(() => useEvent("location", ({ to }) => to.pathname), { wrapper });
+            assertType(hook.result.current);
+        });
+        it("infers object type from object callback", () => {
+            const hook = renderHook(() => useEvent("location", ({ to }) => ({ query: to.search })), { wrapper });
+            assertType(hook.result.current);
+        });
+        it("infers void type from empty callback", () => {
+            const hook = renderHook(() => useEvent("location", () => { }), {
+                wrapper,
+            });
+            assertType(hook.result.current);
+        });
+    });
+});
+//# sourceMappingURL=useEvent.test.js.map

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

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

package/dist/lib/icons.d.ts

@@ -1 +1,2 @@
 export * from "lucide-react";
+export * from "./MissingIcon.js";

package/dist/lib/icons.js

@@ -1,2 +1,3 @@
 export * from "lucide-react";
+export * from "./MissingIcon.js";
 //# sourceMappingURL=icons.js.map

package/dist/lib/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/lib/icons.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/lib/icons.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/lib/oas/graphql/circular.d.ts

@@ -0,0 +1,3 @@
+import { GraphQLScalarType } from "graphql/index.js";
+export declare const CIRCULAR_REF = "$[Circular Reference]";
+export declare const GraphQLJSONSchema: GraphQLScalarType<unknown, unknown>;