zudoku 0.0.0-eff6f9b → 0.0.0-f06d326

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

@@ -1,15 +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 { DevPortalContext, type ApiIdentity } from "./DevPortalContext.js";
-export type DevPortalPlugin = CommonPlugin | ProfileMenuPlugin | NavigationPlugin | ApiIdentityPlugin | SearchProviderPlugin;
+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 interface NavigationPlugin {
     getRoutes: () => RouteObject[];
-    getSidebar?: (path: string) => Promise<Sidebar>;
+    getSidebar?: (path: string, context: ZudokuContext) => Promise<Sidebar>;
 }
+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: {
@@ -18,22 +22,33 @@ 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 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,3 +1,6 @@
+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 isSearchPlugin = (obj) => "renderSearch" in obj && typeof obj.renderSearch === "function";

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

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

package/dist/lib/errors/ErrorAlert.d.ts

@@ -1,3 +1,3 @@
 export declare function ErrorAlert({ error }: {
-    error: any;
+    error: unknown;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/lib/errors/ErrorAlert.js

@@ -1,8 +1,18 @@
 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?.message ?? "Something went wrong";
-    const stack = error?.stack;
-    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: "Something went wrong" }), _jsx("p", { className: "mt-5 text-h1-text", children: message }), 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 message = error instanceof Error ? error.message : "Something went wrong";
+    const hint = error instanceof ZudokuError ? error.developerHint : undefined;
+    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;
+    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 }) }))] }));
 }
 //# 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,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAkB;IAClD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,sBAAsB,CAAC;IACzD,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;IAE3B,OAAO,CACL,cAAK,SAAS,EAAC,4GAA4G,YACzH,eAAK,SAAS,EAAC,oCAAoC,aACjD,aAAI,SAAS,EAAC,4DAA4D,qCAErE,EACL,YAAG,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAK,EAC7C,KAAK,CAAC,CAAC,CAAC,CACP,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,cAAc,EACvB,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,3 @@
+import { useEvent as useEventImport } from "./useEvent.js";
+export declare const useEvent: typeof useEventImport;
+export declare const useTheme: () => import("next-themes").UseThemeProps;

package/dist/lib/hooks/index.js

@@ -0,0 +1,5 @@
+import { useTheme as useThemeImport } from "next-themes";
+import { useEvent as useEventImport } from "./useEvent.js";
+export const useEvent = /*@__PURE__*/ useEventImport;
+export const useTheme = /*@__PURE__*/ useThemeImport;
+//# 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,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"}

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>;

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

@@ -0,0 +1,38 @@
+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;
+    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 (Array.isArray(obj)) {
+        return obj.map((item, index) => handleCircularRefs(item, visited, [...path, `${index}`]));
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        result[key] = handleCircularRefs(value, visited, [...path, key]);
+    }
+    return result;
+};
+export const GraphQLJSONSchema = new GraphQLScalarType({
+    ...GraphQLJSON,
+    name: "JSONSchema",
+    description: "OpenAPI schema scalar type that handles circular references",
+    serialize: (value) => GraphQLJSON.serialize(handleCircularRefs(value)),
+});
+//# sourceMappingURL=circular.js.map

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

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

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

@@ -1,3 +1,4 @@
+import { type CountableSlugify } from "@sindresorhus/slugify";
 import { type YogaServerOptions } from "graphql-yoga";
 import { type EncodingObject, type ExampleObject, type OpenAPIDocument, type OperationObject, type ParameterObject, type PathsObject, type SchemaObject, type TagObject } from "../parser/index.js";
 export type { EncodingObject, ExampleObject, OpenAPIDocument, OperationObject, ParameterObject, PathsObject, SchemaObject, TagObject, };
@@ -7,6 +8,30 @@ type OperationLike = {
     path: string;
     method: string;
 };
-export declare const slugifyOperation: (operation: OperationLike, tag?: string) => string;
+export declare const createOperationSlug: (slugify: CountableSlugify, operation: OperationLike) => string;
+export type SchemaImport = () => Promise<{
+    schema: OpenAPIDocument;
+    slugs: ReturnType<typeof getAllSlugs>;
+}>;
+export type SchemaImports = Record<string, SchemaImport>;
+type GraphQLOperationObject = OperationObject & {
+    path: string;
+    method: string;
+    slug?: string;
+    parentTag?: string;
+};
+export declare const getAllTags: (schema: OpenAPIDocument, slugs: ReturnType<typeof getAllSlugs>["tags"]) => Array<Omit<TagObject, "name"> & {
+    name?: string;
+    slug?: string;
+}>;
+export declare const getAllSlugs: (ops: GraphQLOperationObject[], schemaTags?: TagObject[]) => {
+    operations: {
+        [k: string]: string;
+    };
+    tags: {
+        [k: string]: string;
+    };
+};
+export declare const getAllOperations: (paths?: PathsObject) => GraphQLOperationObject[];
 export declare const schema: import("graphql").GraphQLSchema;
 export declare const createGraphQLServer: (options?: Omit<YogaServerOptions<any, any>, "schema">) => import("graphql-yoga").YogaServerInstance<any, any>;