zudoku 0.0.0-fed343e → 0.0.0-feda542

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

@@ -1,8 +1,8 @@
 import { cva } from "class-variance-authority";
 import type { ClassValue } from "clsx";
 import * as React from "react";
-import type { JSX } from "react/jsx-runtime";
-declare const createVariantComponent: <E extends keyof React.ReactHTML, C extends ReturnType<typeof cva>>(tag: E, cvx: ClassValue | C) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.IntrinsicElements[E] & {
+import { type HTMLElementType, type JSX } from "react";
+declare const createVariantComponent: <E extends HTMLElementType, C extends ReturnType<typeof cva>>(tag: E, cvx: ClassValue | C) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.IntrinsicElements[E] & {
     className?: ClassValue;
     asChild?: boolean;
 }> & React.RefAttributes<HTMLElement>>;

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

@@ -0,0 +1 @@
+export declare function detectOS(): "Windows" | "macOS" | "Linux" | undefined;

package/dist/lib/util/detectOS.js

@@ -0,0 +1,11 @@
+export function detectOS() {
+    const userAgent = navigator.userAgent.toLowerCase();
+    if (userAgent.includes("win"))
+        return "Windows";
+    if (userAgent.includes("mac"))
+        return "macOS";
+    if (userAgent.includes("linux"))
+        return "Linux";
+    return undefined;
+}
+//# sourceMappingURL=detectOS.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectOS.js","sourceRoot":"","sources":["../../../src/lib/util/detectOS.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ;IACtB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IAEpD,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEhD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -4,3 +4,12 @@ export default function invariant(condition: any,
  * the message takes a fair amount of effort to compute
  */
 message?: string | (() => string)): asserts condition;
+export declare class ZudokuError extends Error {
+    developerHint: string | undefined;
+    title: string | undefined;
+    constructor(message: string, { developerHint, title, cause, }?: {
+        developerHint?: string;
+        title?: string;
+        cause?: Error;
+    });
+}

package/dist/lib/util/invariant.js

@@ -12,10 +12,14 @@ message) {
     const provided = typeof message === "function" ? message() : message;
     throw new ZudokuError(provided ?? "Invariant failed");
 }
-class ZudokuError extends Error {
-    constructor(message) {
-        super(message);
+export class ZudokuError extends Error {
+    developerHint;
+    title;
+    constructor(message, { developerHint, title, cause, } = {}) {
+        super(message, { cause });
         this.name = "ZudokuError";
+        this.title = title;
+        this.developerHint = developerHint;
     }
 }
 //# sourceMappingURL=invariant.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../../src/lib/util/invariant.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,SAAc;AACd,gFAAgF;AAChF;;;GAGG;AACH,OAAiC;IAEjC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,uBAAuB;IAEvB,MAAM,QAAQ,GACZ,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAEtD,MAAM,IAAI,WAAW,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,WAAY,SAAQ,KAAK;IAC7B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../../src/lib/util/invariant.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,SAAc;AACd,gFAAgF;AAChF;;;GAGG;AACH,OAAiC;IAEjC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,uBAAuB;IAEvB,MAAM,QAAQ,GACZ,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAEtD,MAAM,IAAI,WAAW,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC7B,aAAa,CAAqB;IAClC,KAAK,CAAqB;IAEjC,YACE,OAAe,EACf,EACE,aAAa,EACb,KAAK,EACL,KAAK,MACwD,EAAE;QAEjE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}

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

@@ -1 +1,4 @@
+/**
+ * @deprecated Use `joinUrl` instead.
+ */
 export declare const joinPath: (...parts: Array<string | null | undefined | boolean>) => string;

package/dist/lib/util/joinPath.js

@@ -1,3 +1,6 @@
+/**
+ * @deprecated Use `joinUrl` instead.
+ */
 export const joinPath = (...parts) => {
     const cleanPath = parts
         .filter((part) => Boolean(part))

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

@@ -1 +1 @@
-{"version":3,"file":"joinPath.js","sourceRoot":"","sources":["../../../src/lib/util/joinPath.tsx"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,GAAG,KAAiD,EACpD,EAAE;IACF,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,qCAAqC;SACrF,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE/B,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC3C,CAAC,CAAC"}
+{"version":3,"file":"joinPath.js","sourceRoot":"","sources":["../../../src/lib/util/joinPath.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,GAAG,KAAiD,EACpD,EAAE;IACF,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,qCAAqC;SACrF,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE/B,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC3C,CAAC,CAAC"}

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

@@ -0,0 +1 @@
+export declare const joinUrl: (...parts: Array<string | number | null | undefined | false>) => string;

package/dist/lib/util/joinUrl.js

@@ -0,0 +1,40 @@
+// Mostly adapted from https://github.com/moxystudio/js-proper-url-join
+const defaultUrlRegExp = /^(\w+:\/\/[^/?]+)?([^?]*)(\?.*)?$/;
+const normalizeParts = (parts) => parts
+    .filter((part) => part !== null &&
+    part !== undefined &&
+    part !== false &&
+    (typeof part === "string" || typeof part === "number"))
+    .map((part) => `${part}`)
+    .filter((part) => part);
+const parseParts = (parts) => {
+    const partsStr = parts.join("/");
+    const [, prefix = "", pathname = ""] = partsStr.match(defaultUrlRegExp) ?? [];
+    return {
+        prefix,
+        pathname: pathname.split("/").filter((part) => part !== ""),
+    };
+};
+const buildUrl = (parsedParts) => {
+    const { prefix, pathname } = parsedParts;
+    let url = prefix;
+    if (pathname.length > 0) {
+        if (url) {
+            url += "/";
+        }
+        else {
+            url = "/";
+        }
+        url += pathname.join("/");
+    }
+    else if (!url) {
+        url = "/";
+    }
+    return url;
+};
+export const joinUrl = (...parts) => {
+    const normalizedParts = normalizeParts(parts);
+    const parsedParts = parseParts(normalizedParts);
+    return buildUrl(parsedParts);
+};
+//# sourceMappingURL=joinUrl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"joinUrl.js","sourceRoot":"","sources":["../../../src/lib/util/joinUrl.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAE7D,MAAM,cAAc,GAAG,CACrB,KAAqD,EAC3C,EAAE,CACZ,KAAK;KACF,MAAM,CACL,CAAC,IAAI,EAA2B,EAAE,CAChC,IAAI,KAAK,IAAI;IACb,IAAI,KAAK,SAAS;IAClB,IAAI,KAAK,KAAK;IACd,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CACzD;KACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;KACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAO5B,MAAM,UAAU,GAAG,CAAC,KAAe,EAAe,EAAE;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAE9E,OAAO;QACL,MAAM;QACN,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,WAAwB,EAAU,EAAE;IACpD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;IACzC,IAAI,GAAG,GAAG,MAAM,CAAC;IAEjB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,IAAI,GAAG,CAAC;QACb,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,GAAG,CAAC;QACZ,CAAC;QACD,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QAChB,GAAG,GAAG,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,GAAG,KAAwD,EACnD,EAAE;IACV,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAChD,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/dist/lib/util/joinUrl.test.d.ts

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

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

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "vitest";
+import { joinUrl } from "./joinUrl.js";
+describe("joinUrl", () => {
+    test("handles basic URL joining", () => {
+        expect(joinUrl("https://example.com", "path")).toBe("https://example.com/path");
+        expect(joinUrl("https://example.com/", "path")).toBe("https://example.com/path");
+        expect(joinUrl("https://example.com/", "/path")).toBe("https://example.com/path");
+    });
+    test("handles multiple path segments", () => {
+        expect(joinUrl("https://example.com", "api", "v1", "users")).toBe("https://example.com/api/v1/users");
+    });
+    // test("handles query parameters", () => {
+    //   expect(joinUrl("https://example.com", "path?query=1")).toBe(
+    //     "https://example.com/path?query=1",
+    //   );
+    //   expect(joinUrl("https://example.com?base=1", "path?query=1")).toBe(
+    //     "https://example.com/path?query=1",
+    //   );
+    // });
+    // test("handles repeated dots and question marks", () => {
+    //   expect(joinUrl("https://example.com", "path/../../../test")).toBe(
+    //     "https://example.com/path/../../../test",
+    //   );
+    //   expect(joinUrl("https://example.com", "test????a=1")).toBe(
+    //     "https://example.com/test????a=1",
+    //   );
+    // });
+    test("handles falsy values", () => {
+        expect(joinUrl("https://example.com", null, undefined, false, "path")).toBe("https://example.com/path");
+    });
+    test("handles numeric values", () => {
+        expect(joinUrl("https://example.com", "api", 123, "test")).toBe("https://example.com/api/123/test");
+    });
+    test("handles relative paths", () => {
+        expect(joinUrl("/api", "v1", "users")).toBe("/api/v1/users");
+        expect(joinUrl("api", "v1", "users")).toBe("/api/v1/users");
+    });
+    test("handles empty input", () => {
+        expect(joinUrl()).toBe("/");
+        expect(joinUrl("")).toBe("/");
+    });
+});
+//# sourceMappingURL=joinUrl.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"joinUrl.test.js","sourceRoot":"","sources":["../../../src/lib/util/joinUrl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CACjD,0BAA0B,CAC3B,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAClD,0BAA0B,CAC3B,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CACnD,0BAA0B,CAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAC/D,kCAAkC,CACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,iEAAiE;IACjE,0CAA0C;IAC1C,OAAO;IACP,wEAAwE;IACxE,0CAA0C;IAC1C,OAAO;IACP,MAAM;IAEN,2DAA2D;IAC3D,uEAAuE;IACvE,gDAAgD;IAChD,OAAO;IACP,gEAAgE;IAChE,yCAAyC;IACzC,OAAO;IACP,MAAM;IAEN,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CACzE,0BAA0B,CAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAC7D,kCAAkC,CACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1 @@
+export declare const scrollIntoViewIfNeeded: (element: Element | null, options?: ScrollIntoViewOptions) => void;

package/dist/lib/util/scrollIntoViewIfNeeded.js

@@ -0,0 +1,14 @@
+export 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);
+};
+//# sourceMappingURL=scrollIntoViewIfNeeded.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollIntoViewIfNeeded.js","sourceRoot":"","sources":["../../../src/lib/util/scrollIntoViewIfNeeded.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,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"}

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

@@ -0,0 +1,3 @@
+import type { JsonValue, RecordAny } from "./types.js";
+export type { RecordAny };
+export declare const traverse: <T extends JsonValue = RecordAny>(specification: RecordAny, transform: (specification: RecordAny) => T) => RecordAny | T;

package/dist/lib/util/traverse.js

@@ -0,0 +1,22 @@
+export const traverse = (specification, transform) => {
+    const transformed = transform(specification);
+    if (typeof transformed !== "object" || transformed === null) {
+        return transformed;
+    }
+    const result = Array.isArray(transformed) ? [] : {};
+    for (const [key, value] of Object.entries(transformed)) {
+        if (Array.isArray(value)) {
+            result[key] = value.map((item) => typeof item === "object" && item != null
+                ? traverse(item, transform)
+                : item);
+        }
+        else if (typeof value === "object" && value != null) {
+            result[key] = traverse(value, transform);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=traverse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../../src/lib/util/traverse.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,aAAwB,EACxB,SAA0C,EAC1C,EAAE;IACF,MAAM,WAAW,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QAC5D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAc,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI;gBACtC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAC3B,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+export type RecordAny = Record<string, any>;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonArray = JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;

package/dist/lib/util/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/util/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+import type { ExposedComponentProps } from "../components/SlotletProvider.js";
+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,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,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,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,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/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>;

package/dist/vite/api/schema-codegen.js

@@ -0,0 +1,85 @@
+import { $RefParser } from "@apidevtools/json-schema-ref-parser";
+import { getAllOperations, getAllSlugs } from "../../lib/oas/graphql/index.js";
+import { traverse } from "../../lib/util/traverse.js";
+const unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
+const getSegmentsFromPath = (path) => path.split("/").slice(1).map(unescapeJsonPointer);
+// Find all $ref occurrences in the schema and assign them unique variable names
+const createLocalRefMap = (obj) => {
+    const refMap = new Map();
+    let refCounter = 0;
+    traverse(obj, (node) => {
+        if (typeof node.$ref === "string" && node.$ref.startsWith("#/")) {
+            if (!refMap.has(node.$ref)) {
+                refMap.set(node.$ref, refCounter++);
+            }
+        }
+        return node;
+    });
+    return refMap;
+};
+// Replace all $ref occurrences with a special marker that will be transformed into a reference to the __refMap lookup
+const setRefMarkers = (obj, refMap) => traverse(obj, (node) => {
+    if (node.$ref && typeof node.$ref === "string" && refMap.has(node.$ref)) {
+        return `__refMap:${node.$ref}`;
+    }
+    return node;
+});
+// Replace the marker strings with actual __refMap lookups in the generated code
+const replaceRefMarkers = (code) => code?.replace(/"__refMap:(.*?)"/g, '__refMap["$1"]');
+const lookup = (schema, path, filePath) => {
+    const parts = getSegmentsFromPath(path);
+    let val = schema;
+    for (const part of parts) {
+        while (val.$ref?.startsWith("#/")) {
+            val = val.$ref === path ? val : lookup(schema, val.$ref, filePath);
+        }
+        if (val[part] === undefined) {
+            throw new Error(`Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path}`);
+        }
+        val = val[part];
+    }
+    return val;
+};
+/**
+ * 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 const generateCode = async (schema, filePath) => {
+    const refMap = createLocalRefMap(schema);
+    const lines = [];
+    const str = (obj, indent = 2) => JSON.stringify(obj, null, indent);
+    lines.push(`const __refs = Array.from({ length: ${refMap.size} }, () => ({}));`);
+    lines.push("const __refMap = {", Array.from(refMap)
+        .map(([refPath, index]) => `  "${refPath}": __refs[${index}]`)
+        .join(",\n"), "};", "const __refMapPaths = Object.keys(__refMap);");
+    for (const [refPath, index] of refMap) {
+        const value = lookup(schema, refPath, filePath);
+        // This shouldn't happen but to be safe we log a warning
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (!value) {
+            // eslint-disable-next-line no-console
+            console.warn(`Could not find value for refPath: ${refPath}`);
+            continue;
+        }
+        const transformedValue = setRefMarkers(value, refMap);
+        lines.push(
+        // Use assign so that the object identity is maintained and correctly resolves circular references
+        `Object.assign(__refs[${index}], ${replaceRefMarkers(str(transformedValue))});`, `Object.defineProperty(__refs[${index}], "__$ref", { value: __refMapPaths[${index}], enumerable: false });`);
+    }
+    const transformed = setRefMarkers(schema, refMap);
+    lines.push(`export const schema = ${replaceRefMarkers(str(transformed))};`);
+    // slugify is quite expensive for big schemas, so we pre-generate the slugs here to shave off time
+    const dereferencedSchema = await $RefParser.dereference(schema);
+    const slugs = getAllSlugs(getAllOperations(dereferencedSchema.paths), dereferencedSchema.tags);
+    lines.push(`export const slugs = {`);
+    lines.push(`  operations: ${str(slugs.operations, 0)},`, `  tags: ${str(slugs.tags, 0)},`);
+    lines.push(`};`);
+    return lines.join("\n");
+};
+//# sourceMappingURL=schema-codegen.js.map

package/dist/vite/api/schema-codegen.js.map

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

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

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