zudoku 0.0.0-e4d0ea8 → 0.0.0-e5559fc

package/dist/lib/util/url.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "vitest";
+import { normalizeRedirectUrl } from "./url.js";
+describe("normalizeRedirectUrl", () => {
+    const mockOrigin = "https://example.com";
+    it("should return original URL if it doesn't start with origin", () => {
+        const result = normalizeRedirectUrl("https://other.com/path", mockOrigin, "/");
+        expect(result).toBe("https://other.com/path");
+    });
+    it("should remove origin when root is /", () => {
+        const result = normalizeRedirectUrl("https://example.com/some/path", mockOrigin, "/");
+        expect(result).toBe("/some/path");
+    });
+    it("should remove origin and root path when root is not /", () => {
+        const result = normalizeRedirectUrl("https://example.com/docs/some/path", mockOrigin, "/docs");
+        expect(result).toBe("/some/path");
+    });
+    it("should only remove origin when URL doesn't match root path", () => {
+        const result = normalizeRedirectUrl("https://example.com/other/path", mockOrigin, "/docs");
+        expect(result).toBe("/other/path");
+    });
+    it("should handle empty root path", () => {
+        const result = normalizeRedirectUrl("https://example.com/path", mockOrigin, "");
+        expect(result).toBe("/path");
+    });
+});
+//# sourceMappingURL=url.test.js.map

package/dist/lib/util/url.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.test.js","sourceRoot":"","sources":["../../../src/lib/util/url.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,UAAU,GAAG,qBAAqB,CAAC;IAEzC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,oBAAoB,CACjC,wBAAwB,EACxB,UAAU,EACV,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,oBAAoB,CACjC,+BAA+B,EAC/B,UAAU,EACV,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG,oBAAoB,CACjC,oCAAoC,EACpC,UAAU,EACV,OAAO,CACR,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,oBAAoB,CACjC,gCAAgC,EAChC,UAAU,EACV,OAAO,CACR,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,oBAAoB,CACjC,0BAA0B,EAC1B,UAAU,EACV,EAAE,CACH,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/util/useExposedProps.d.ts

@@ -0,0 +1,9 @@
+import { type Location, type NavigateFunction, type Params, type SetURLSearchParams } from "react-router";
+export type ExposedComponentProps = {
+    location: Location;
+    navigate: NavigateFunction;
+    searchParams: URLSearchParams;
+    setSearchParams: SetURLSearchParams;
+    params: Params;
+};
+export declare const useExposedProps: () => ExposedComponentProps;

package/dist/lib/util/useExposedProps.js

@@ -0,0 +1,9 @@
+import { useLocation, useNavigate, useParams, useSearchParams, } from "react-router";
+export const useExposedProps = () => {
+    const location = useLocation();
+    const navigate = useNavigate();
+    const [searchParams, setSearchParams] = useSearchParams();
+    const params = useParams();
+    return { location, navigate, params, searchParams, setSearchParams };
+};
+//# sourceMappingURL=useExposedProps.js.map

package/dist/lib/util/useExposedProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExposedProps.js","sourceRoot":"","sources":["../../../src/lib/util/useExposedProps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AAUtB,MAAM,CAAC,MAAM,eAAe,GAAG,GAA0B,EAAE;IACzD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,eAAe,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACvE,CAAC,CAAC"}

package/dist/lib/util/useIsomorphicLayoutEffect.d.ts

@@ -0,0 +1,3 @@
+import { useEffect } from "react";
+declare const useIsomorphicLayoutEffect: typeof useEffect;
+export default useIsomorphicLayoutEffect;

package/dist/lib/util/useIsomorphicLayoutEffect.js

@@ -0,0 +1,4 @@
+import { useEffect, useLayoutEffect } from "react";
+const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+export default useIsomorphicLayoutEffect;
+//# sourceMappingURL=useIsomorphicLayoutEffect.js.map

package/dist/lib/util/useIsomorphicLayoutEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicLayoutEffect.js","sourceRoot":"","sources":["../../../src/lib/util/useIsomorphicLayoutEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACnD,MAAM,yBAAyB,GAC7B,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AAE9D,eAAe,yBAAyB,CAAC"}

package/dist/lib/util/useLatest.d.ts

@@ -0,0 +1 @@
+export declare const useLatest: <T>(current: T) => import("react").RefObject<T>;

package/dist/lib/util/useLatest.js

@@ -0,0 +1,15 @@
+import { useEffect, useRef } from "react";
+// This hook is useful when you need to store a reference to a variable that changes over time,
+// but you don't want to re-run any callbacks that depend on that variable every time it changes.
+// By using a reference to the latest value, you can ensure that any callbacks only run when necessary,
+// without any unnecessary re-renders.
+// Note: It's safe to put the return value of this hook in a dependency array, because it won't change!
+export const useLatest = (current) => {
+    const valueRef = useRef(current);
+    valueRef.current = current;
+    useEffect(() => {
+        valueRef.current = current;
+    }, [current]);
+    return valueRef;
+};
+//# sourceMappingURL=useLatest.js.map

package/dist/lib/util/useLatest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatest.js","sourceRoot":"","sources":["../../../src/lib/util/useLatest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,+FAA+F;AAC/F,iGAAiG;AACjG,uGAAuG;AACvG,sCAAsC;AAEtC,uGAAuG;AACvG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,OAAU,EAAE,EAAE;IACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/lib/util/useOnScreen.d.ts

@@ -0,0 +1,5 @@
+export declare const useOnScreen: <E extends Element = HTMLElement>({ rootMargin, threshold, root, }?: {
+    rootMargin?: string;
+    threshold?: number;
+    root?: Element | null;
+}) => readonly [import("react").RefObject<E | null>, boolean];

package/dist/lib/util/useOnScreen.js

@@ -0,0 +1,19 @@
+import { useEffect, useRef, useState } from "react";
+export const useOnScreen = ({ rootMargin = "0px", threshold, root, } = {}) => {
+    const [isVisible, setIsVisible] = useState(false);
+    const ref = useRef(null);
+    useEffect(() => {
+        const observer = new IntersectionObserver(([entry]) => {
+            if (!entry)
+                return;
+            setIsVisible(entry.isIntersecting);
+        }, { rootMargin, threshold, root });
+        const currentElement = ref.current;
+        if (!currentElement)
+            return;
+        observer.observe(currentElement);
+        return () => observer.unobserve(currentElement);
+    }, [root, rootMargin, threshold]);
+    return [ref, isVisible];
+};
+//# sourceMappingURL=useOnScreen.js.map

package/dist/lib/util/useOnScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOnScreen.js","sourceRoot":"","sources":["../../../src/lib/util/useOnScreen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAkC,EAC3D,UAAU,GAAG,KAAK,EAClB,SAAS,EACT,IAAI,MAKF,EAAE,EAAE,EAAE;IACR,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YACV,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC,EACD,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAChC,CAAC;QAEF,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;QAEnC,IAAI,CAAC,cAAc;YAAE,OAAO;QAE5B,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAClD,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IAElC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAU,CAAC;AACnC,CAAC,CAAC"}

package/dist/lib/util/useScrollToAnchor.d.ts

@@ -1 +1,2 @@
+export declare const useScrollToHash: () => (hash: string) => boolean;
 export declare const useScrollToAnchor: () => void;

package/dist/lib/util/useScrollToAnchor.js

@@ -1,47 +1,52 @@
-import { useEffect } from "react";
-import { useLocation } from "react-router-dom";
+import { useCallback, useEffect, useRef } from "react";
+import { useLocation } from "react-router";
 import { useViewportAnchor } from "../components/context/ViewportAnchorContext.js";
 import { DATA_ANCHOR_ATTR } from "../components/navigation/SidebarItem.js";
-const scrollIntoViewIfNeeded = (element, options = { block: "center" }) => {
-    if (!element)
-        return;
-    const rect = element.getBoundingClientRect();
-    const isInView = rect.top >= 0 &&
-        rect.left >= 0 &&
-        rect.bottom <=
-            (window.innerHeight || document.documentElement.clientHeight) &&
-        rect.right <= (window.innerWidth || document.documentElement.clientWidth);
-    if (isInView)
-        return;
-    element.scrollIntoView(options);
+import { scrollIntoViewIfNeeded } from "./scrollIntoViewIfNeeded.js";
+export const useScrollToHash = () => {
+    const { setActiveAnchor } = useViewportAnchor();
+    const scrollToHash = useCallback((hash) => {
+        const cleanHash = hash.replace(/^#/, "");
+        // Operation list items might have subdivisions that the sidebar doesn't show.
+        // The subdivisions are separated by a slash so we need to remove everything before the slash to get the sidebar correct item.
+        const linkHash = cleanHash.split("/").at(0);
+        const element = document.getElementById(decodeURIComponent(cleanHash));
+        const link = document.querySelector(`[${DATA_ANCHOR_ATTR}="${linkHash}"]`);
+        if (element) {
+            element.scrollIntoView();
+            scrollIntoViewIfNeeded(link);
+            // Set the active anchor after the scroll has happened
+            // so the intersection observer doesn't trigger wrong items
+            requestIdleCallback(() => setActiveAnchor(linkHash));
+            return true;
+        }
+        // Scroll didn't happen
+        return false;
+    }, [setActiveAnchor]);
+    return scrollToHash;
 };
 export const useScrollToAnchor = () => {
     const location = useLocation();
-    const { setActiveAnchor } = useViewportAnchor();
+    const scrollToHash = useScrollToHash();
+    const initialScrolled = useRef(false);
+    useEffect(() => {
+        if (!location.hash || !initialScrolled.current)
+            return;
+        scrollToHash(location.hash);
+    }, [location.hash, scrollToHash]);
     useEffect(() => {
-        if (!location.hash)
+        if (!location.hash) {
+            initialScrolled.current = true;
             return;
-        const hash = decodeURIComponent(location.hash.split("/")[0].slice(1));
-        const scrollToElement = () => {
-            const element = document.getElementById(hash);
-            const link = document.querySelector(`[${DATA_ANCHOR_ATTR}="${hash}"]`);
-            if (element) {
-                element.scrollIntoView();
-                scrollIntoViewIfNeeded(link);
-                requestIdleCallback(() => setActiveAnchor(hash));
-                return true;
-            }
-            return false;
-        };
-        if (!scrollToElement()) {
-            const observer = new MutationObserver((_, obs) => {
-                if (!scrollToElement())
-                    return;
-                obs.disconnect();
-            });
-            observer.observe(document.body, { childList: true, subtree: true });
-            return () => observer.disconnect();
         }
-    }, [location.hash, setActiveAnchor]);
+        const observer = new MutationObserver((_, obs) => {
+            if (!scrollToHash(location.hash))
+                return;
+            initialScrolled.current = true;
+            obs.disconnect();
+        });
+        observer.observe(document.body, { childList: true, subtree: true });
+        return () => observer.disconnect();
+    }, [location.hash, scrollToHash]);
 };
 //# sourceMappingURL=useScrollToAnchor.js.map

package/dist/lib/util/useScrollToAnchor.js.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollToAnchor.js","sourceRoot":"","sources":["../../../src/lib/util/useScrollToAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,sBAAsB,GAAG,CAC7B,OAAuB,EACvB,UAAiC,EAAE,KAAK,EAAE,QAAQ,EAAE,EACpD,EAAE;IACF,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAC7C,MAAM,QAAQ,GACZ,IAAI,CAAC,GAAG,IAAI,CAAC;QACb,IAAI,CAAC,IAAI,IAAI,CAAC;QACd,IAAI,CAAC,MAAM;YACT,CAAC,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC;QAC/D,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAE5E,IAAI,QAAQ;QAAE,OAAO;IAErB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,EAAE,eAAe,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI;YAAE,OAAO;QAE3B,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvE,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,gBAAgB,KAAK,IAAI,IAAI,CAAC,CAAC;YAEvE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,cAAc,EAAE,CAAC;gBACzB,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAC7B,mBAAmB,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEF,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;gBAC/C,IAAI,CAAC,eAAe,EAAE;oBAAE,OAAO;gBAC/B,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC"}
+{"version":3,"file":"useScrollToAnchor.js","sourceRoot":"","sources":["../../../src/lib/util/useScrollToAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,EAAE,eAAe,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAEhD,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,EAAE;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEzC,8EAA8E;QAC9E,8HAA8H;QAC9H,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QAEvE,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CACjC,IAAI,gBAAgB,KAAK,QAAQ,IAAI,CACtC,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,cAAc,EAAE,CAAC;YACzB,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC7B,sDAAsD;YACtD,2DAA2D;YAC3D,mBAAmB,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,uBAAuB;QACvB,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,eAAe,CAAC,CAClB,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO;YAAE,OAAO;QAEvD,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAC/C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO;YACzC,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC"}

package/dist/lib/util/useScrollToTop.js

@@ -1,13 +1,15 @@
 import { useEffect, useRef } from "react";
-import { useLocation } from "react-router-dom";
+import { useLocation } from "react-router";
 export const useScrollToTop = () => {
     const location = useLocation();
     const previousPath = useRef(location.pathname);
     useEffect(() => {
-        if (previousPath.current === location.pathname)
-            return;
-        window.scrollTo(0, 0);
+        const isNewPage = previousPath.current !== location.pathname;
+        const hasAnchor = location.hash !== "";
+        if (isNewPage && !hasAnchor) {
+            window.scrollTo(0, 0);
+        }
         previousPath.current = location.pathname;
-    }, [location.pathname]);
+    }, [location.pathname, location.hash]);
 };
 //# sourceMappingURL=useScrollToTop.js.map

package/dist/lib/util/useScrollToTop.js.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollToTop.js","sourceRoot":"","sources":["../../../src/lib/util/useScrollToTop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,CAAC,OAAO,KAAK,QAAQ,CAAC,QAAQ;YAAE,OAAO;QACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtB,YAAY,CAAC,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC3C,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1B,CAAC,CAAC"}
+{"version":3,"file":"useScrollToTop.js","sourceRoot":"","sources":["../../../src/lib/util/useScrollToTop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,KAAK,QAAQ,CAAC,QAAQ,CAAC;QAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;QAEvC,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,YAAY,CAAC,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC3C,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist/vite/api/SchemaManager.d.ts

@@ -0,0 +1,36 @@
+import type { LoadedConfig } from "../../config/config.js";
+import type { Processor } from "../../config/validators/BuildSchema.js";
+import type { OpenAPIDocument } from "../../lib/oas/parser/index.js";
+type ProcessedSchema = {
+    schema: OpenAPIDocument;
+    version: string;
+    inputPath: string;
+};
+export declare class SchemaManager {
+    private storeDir;
+    private processors;
+    private processedSchemas;
+    private fileToNavigationId;
+    config: LoadedConfig;
+    trackedFiles: Set<string>;
+    schemaMap: Map<string, {
+        filePath: string;
+        processedTime: number;
+    }>;
+    constructor({ storeDir, config, processors, }: {
+        storeDir: string;
+        config: LoadedConfig;
+        processors: Processor[];
+    });
+    private getNavigationIdForFile;
+    processSchema: (input: string) => Promise<{
+        schema: OpenAPIDocument;
+        version: string;
+        inputPath: string;
+    } | undefined>;
+    processAllSchemas: () => Promise<void>;
+    getLatestSchema: (navigationId: string) => ProcessedSchema | undefined;
+    getSchemasForId: (navigationId: string) => ProcessedSchema[] | undefined;
+    private validateSchema;
+}
+export {};

package/dist/vite/api/SchemaManager.js

@@ -0,0 +1,122 @@
+import { $RefParser, } from "@apidevtools/json-schema-ref-parser";
+import { upgrade, validate } from "@scalar/openapi-parser";
+import { merge as mergeAllOf } from "allof-merge";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureArray } from "../../lib/util/ensureArray.js";
+import { generateCode } from "./schema-codegen.js";
+const FALLBACK_VERSION = "default";
+export class SchemaManager {
+    storeDir;
+    processors;
+    processedSchemas = {};
+    fileToNavigationId = new Map();
+    config;
+    trackedFiles = new Set();
+    schemaMap = new Map();
+    constructor({ storeDir, config, processors, }) {
+        this.storeDir = storeDir;
+        this.config = config;
+        this.processors = [
+            ({ schema }) => upgrade(schema).specification,
+            ({ schema }) => mergeAllOf(schema),
+            ...processors,
+        ];
+    }
+    getNavigationIdForFile = (input) => {
+        const filePath = path.resolve(this.config.__meta.rootDir, input);
+        if (this.fileToNavigationId.has(filePath)) {
+            return this.fileToNavigationId.get(filePath);
+        }
+        const apis = ensureArray(this.config.apis ?? []);
+        for (const apiConfig of apis) {
+            if (!apiConfig || apiConfig.type !== "file" || !apiConfig.navigationId)
+                continue;
+            const inputs = ensureArray(apiConfig.input).map((i) => path.resolve(this.config.__meta.rootDir, i));
+            if (inputs.includes(filePath)) {
+                this.fileToNavigationId.set(filePath, apiConfig.navigationId);
+                return apiConfig.navigationId;
+            }
+        }
+    };
+    processSchema = async (input) => {
+        const filePath = path.resolve(this.config.__meta.rootDir, input);
+        const navigationId = this.getNavigationIdForFile(filePath);
+        if (!navigationId) {
+            // eslint-disable-next-line no-console
+            console.warn(`No navigation ID found for file ${input}`);
+            return;
+        }
+        const parser = new $RefParser();
+        const schema = await parser.bundle(filePath);
+        parser.$refs.paths().forEach((file) => this.trackedFiles.add(file));
+        const validatedSchema = await this.validateSchema(schema, filePath);
+        const processedSchema = await this.processors.reduce(async (schema, processor) => processor({
+            schema: await schema,
+            file: filePath,
+            dereference: (schema) => new $RefParser().dereference(schema),
+        }), Promise.resolve(validatedSchema));
+        const processedTime = Date.now();
+        const code = await generateCode(processedSchema, filePath);
+        const processedFilePath = path.posix.join(this.storeDir, `${path.basename(filePath)}.js`);
+        await fs.writeFile(processedFilePath, code);
+        this.schemaMap.set(filePath, {
+            filePath: processedFilePath,
+            processedTime,
+        });
+        const processed = {
+            schema: processedSchema,
+            version: processedSchema.info.version || FALLBACK_VERSION,
+            inputPath: filePath,
+        };
+        const schemas = this.processedSchemas[navigationId];
+        if (!schemas) {
+            throw new Error(`No schemas found for navigation ID ${navigationId}.`);
+        }
+        const index = schemas.findIndex((s) => s.inputPath === filePath);
+        if (index > -1) {
+            schemas[index] = processed;
+        }
+        this.fileToNavigationId.set(filePath, navigationId);
+        return processed;
+    };
+    processAllSchemas = async () => {
+        this.schemaMap.clear();
+        this.trackedFiles.clear();
+        this.fileToNavigationId.clear();
+        this.processedSchemas = {};
+        const apis = ensureArray(this.config.apis ?? []);
+        for (const apiConfig of apis) {
+            if (apiConfig.type !== "file" || !apiConfig.navigationId)
+                continue;
+            const inputs = ensureArray(apiConfig.input);
+            if (inputs.length === 0)
+                throw new Error("No schema found");
+            this.processedSchemas[apiConfig.navigationId] = inputs.map((input) => ({
+                schema: {},
+                version: "",
+                inputPath: path.resolve(this.config.__meta.rootDir, input),
+            }));
+            const results = await Promise.allSettled(inputs.map((input) => this.processSchema(input)));
+            const errors = results.flatMap((r) => r.status === "rejected" ? r.reason : []);
+            if (errors.length > 0) {
+                throw new Error(`Failed to process schemas for ${apiConfig.navigationId}: ${errors.join(", ")}`);
+            }
+        }
+    };
+    getLatestSchema = (navigationId) => this.processedSchemas[navigationId]?.at(0);
+    getSchemasForId = (navigationId) => this.processedSchemas[navigationId];
+    validateSchema = async (schema, filePath) => {
+        const validated = await validate(schema);
+        if (validated.errors?.length) {
+            // eslint-disable-next-line no-console
+            console.warn(`Schema warnings in ${filePath}:`);
+            for (const error of validated.errors) {
+                // eslint-disable-next-line no-console
+                console.warn(error);
+            }
+        }
+        return schema;
+    };
+}
+//# sourceMappingURL=SchemaManager.js.map

package/dist/vite/api/SchemaManager.js.map

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

package/dist/vite/api/SchemaManager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/vite/api/SchemaManager.test.js

@@ -0,0 +1,106 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SchemaManager } from "./SchemaManager.js";
+const mockSchema = {
+    openapi: "3.0.0",
+    info: {
+        title: "Test API",
+        version: "1.0.0",
+    },
+    paths: {},
+};
+describe("SchemaManager", () => {
+    let tempDir;
+    let storeDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "zudoku-test-"));
+        storeDir = path.join(tempDir, "store");
+        await fs.mkdir(storeDir);
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    it("should process schema and store it", async () => {
+        const schemaPath = path.join(tempDir, "openapi.json");
+        await fs.writeFile(schemaPath, JSON.stringify(mockSchema));
+        const config = {
+            __meta: {
+                rootDir: tempDir,
+                moduleDir: path.join(tempDir, "node_modules"),
+                mode: "module",
+                dependencies: [],
+                configPath: path.join(tempDir, "zudoku.config.ts"),
+            },
+            apis: [
+                {
+                    type: "file",
+                    navigationId: "test-api",
+                    input: schemaPath,
+                },
+            ],
+        };
+        const manager = new SchemaManager({ storeDir, config, processors: [] });
+        await manager.processAllSchemas();
+        const latestSchema = manager.getLatestSchema("test-api");
+        expect(latestSchema).toBeDefined();
+        expect(latestSchema?.version).toBe("1.0.0");
+    });
+    it("should handle multiple versions of the same schema", async () => {
+        const schemaPath = path.join(tempDir, "openapi.json");
+        const schemaPathV2 = path.join(tempDir, "openapi-v2.json");
+        await fs.writeFile(schemaPath, JSON.stringify(mockSchema));
+        await fs.writeFile(schemaPathV2, JSON.stringify({
+            ...mockSchema,
+            info: { ...mockSchema.info, version: "2.0.0" },
+        }));
+        const config = {
+            __meta: {
+                rootDir: tempDir,
+                moduleDir: path.join(tempDir, "node_modules"),
+                mode: "module",
+                dependencies: [],
+                configPath: path.join(tempDir, "zudoku.config.ts"),
+            },
+            apis: [
+                {
+                    type: "file",
+                    navigationId: "test-api",
+                    input: [schemaPathV2, schemaPath], // v2 first, then v1
+                },
+            ],
+        };
+        const manager = new SchemaManager({ storeDir, config, processors: [] });
+        await manager.processAllSchemas();
+        const schemas = manager.getSchemasForId("test-api");
+        expect(schemas).toHaveLength(2);
+        expect(schemas?.[0]?.version).toBe("2.0.0"); // v2 first
+        expect(schemas?.[1]?.version).toBe("1.0.0"); // v1 second
+    });
+    it("should track processed files", async () => {
+        const schemaPath = path.join(tempDir, "openapi.json");
+        await fs.writeFile(schemaPath, JSON.stringify(mockSchema));
+        const config = {
+            __meta: {
+                rootDir: tempDir,
+                moduleDir: path.join(tempDir, "node_modules"),
+                mode: "module",
+                dependencies: [],
+                configPath: path.join(tempDir, "zudoku.config.ts"),
+            },
+            apis: [
+                {
+                    type: "file",
+                    navigationId: "test-api",
+                    input: schemaPath,
+                },
+            ],
+        };
+        const manager = new SchemaManager({ storeDir, config, processors: [] });
+        await manager.processAllSchemas();
+        expect(manager.trackedFiles.size).toBeGreaterThan(0);
+        expect(manager.trackedFiles.has(schemaPath)).toBe(true);
+    });
+});
+//# sourceMappingURL=SchemaManager.test.js.map

package/dist/vite/api/SchemaManager.test.js.map

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

package/dist/vite/api/schema-codegen.d.ts

@@ -0,0 +1,12 @@
+import { type RecordAny } from "../../lib/util/traverse.js";
+/**
+ * Generate JavaScript code that exports the schema with all references resolved as variables.
+ *
+ * Handles circular references by:
+ * 1. Creating empty objects first to establish the references
+ * 2. Adding these objects to the reference map
+ * 3. Using Object.assign to populate their properties later
+ *
+ * This ensures object identity throughout the circular references.
+ */
+export declare const generateCode: (schema: RecordAny, filePath?: string) => Promise<string>;