zudoku 0.0.0-f01b653 → 0.0.0-f0602bf

package/dist/lib/plugins/openapi/schema/SchemaView.js

@@ -1,57 +1,45 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { InfoIcon } from "lucide-react";
 import { Markdown, ProseClasses } from "../../../components/Markdown.js";
-import { Card, CardContent, CardHeader, CardTitle } from "../../../ui/Card.js";
+import { Card } from "../../../ui/Card.js";
 import { cn } from "../../../util/cn.js";
 import { groupBy } from "../../../util/groupBy.js";
-import { SchemaLogicalGroup, SchemaPropertyItem } from "./SchemaComponents.js";
-import { hasLogicalGroupings } from "./utils.js";
-export const SchemaView = ({ schema, level = 0, defaultOpen = false, }) => {
+import { ConstValue } from "../components/ConstValue.js";
+import { EnumValues } from "../components/EnumValues.js";
+import { ParamInfos } from "../ParamInfos.js";
+import { SchemaExampleAndDefault } from "./SchemaExampleAndDefault.js";
+import { SchemaLogicalGroup, SchemaPropertyItem, } from "./SchemaPropertyItem.js";
+import { hasLogicalGroupings, isBasicType } from "./utils.js";
+const renderMarkdown = (content) => content && (_jsx(Markdown, { className: cn(ProseClasses, "text-sm leading-normal line-clamp-4"), content: content }));
+const renderBasicSchema = (schema) => (_jsxs(Card, { className: "p-4 space-y-2", children: [_jsx("span", { className: "text-sm text-muted-foreground", children: _jsx(ParamInfos, { schema: schema }) }), schema.enum && _jsx(EnumValues, { values: schema.enum }), renderMarkdown(schema.description), _jsx(SchemaExampleAndDefault, { schema: schema })] }));
+export const SchemaView = ({ schema, defaultOpen = false, cardHeader, }) => {
     if (!schema || Object.keys(schema).length === 0) {
-        return (_jsx(Card, { className: "p-4", children: _jsx("span", { className: "text-sm text-muted-foreground italic", children: "No response specified" }) }));
+        return (_jsxs(Card, { className: "overflow-hidden", children: [cardHeader, _jsx("div", { className: "text-sm text-muted-foreground italic p-4", children: "No schema specified" })] }));
     }
-    const renderSchema = (schema, level) => {
-        if (hasLogicalGroupings(schema)) {
-            return _jsx(SchemaLogicalGroup, { schema: schema, level: level });
-        }
-        // Sometimes items is not defined
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-        if (schema.type === "array" && schema.items) {
-            const itemsSchema = schema.items;
-            if (typeof itemsSchema.type === "string" &&
-                ["string", "number", "boolean", "integer"].includes(itemsSchema.type)) {
-                return (_jsxs(Card, { className: "p-4", children: [_jsxs("span", { className: "text-sm text-muted-foreground", children: [itemsSchema.type, "[]"] }), schema.description && (_jsx(Markdown, { className: cn(ProseClasses, "text-sm leading-normal line-clamp-4"), content: schema.description }))] }));
-            }
-            else if (itemsSchema.type === "object") {
-                return (_jsxs(Card, { className: "flex flex-col gap-2 bg-border/30 p-4", children: [_jsx("span", { className: "text-sm text-muted-foreground", children: "object[]" }), renderSchema(itemsSchema, level + 1)] }));
-            }
-            else {
-                return renderSchema(itemsSchema, level + 1);
-            }
-        }
-        if (schema.type === "object" &&
-            (!schema.properties || Object.keys(schema.properties).length === 0)) {
-            return (_jsxs(Card, { className: "p-4 flex gap-2 items-center", children: ["name" in schema && _jsx(_Fragment, { children: schema.name }), _jsx("span", { className: "text-sm text-muted-foreground", children: "object" }), schema.description && (_jsx(Markdown, { className: cn(ProseClasses, "text-sm leading-normal line-clamp-4"), content: schema.description }))] }));
-        }
-        if (schema.properties) {
-            const groupedProperties = groupBy(Object.entries(schema.properties), ([propertyName, property]) => {
-                return property.deprecated
-                    ? "deprecated"
-                    : schema.required?.includes(propertyName)
-                        ? "required"
-                        : "optional";
-            });
-            const groupNames = ["required", "optional", "deprecated"];
-            return (_jsx(Card, { className: "divide-y overflow-hidden", children: groupNames.map((group) => groupedProperties[group] && (_jsx("ul", { className: "divide-y", children: groupedProperties[group].map(([name, schema]) => (_jsx(SchemaPropertyItem, { name: name, schema: schema, group: group, level: level, defaultOpen: defaultOpen }, name))) }, group))) }));
-        }
-        if (typeof schema.type === "string" &&
-            ["string", "number", "boolean", "integer", "null"].includes(schema.type)) {
-            return (_jsxs(Card, { className: "p-4", children: [_jsx("span", { className: "text-sm text-muted-foreground", children: schema.type }), schema.description && (_jsx(Markdown, { className: cn(ProseClasses, "text-sm leading-normal line-clamp-4"), content: schema.description }))] }));
-        }
-        if (schema.additionalProperties) {
-            return (_jsxs(Card, { className: "my-2", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Additional Properties:" }) }), _jsx(CardContent, { children: renderSchema(schema.additionalProperties, level + 1) })] }));
-        }
-        return null;
-    };
-    return renderSchema(schema, level);
+    if (schema.const) {
+        return _jsx(ConstValue, { schema: schema });
+    }
+    if (hasLogicalGroupings(schema)) {
+        return _jsx(SchemaLogicalGroup, { schema: schema });
+    }
+    if (isBasicType(schema.type)) {
+        return renderBasicSchema(schema);
+    }
+    if (schema.type === "array" && typeof schema.items === "object") {
+        return _jsx(SchemaView, { schema: schema.items });
+    }
+    if (schema.type === "object") {
+        const groupedProperties = groupBy(Object.entries(schema.properties ?? {}), ([propertyName, property]) => {
+            return property.deprecated
+                ? "deprecated"
+                : schema.required?.includes(propertyName)
+                    ? "required"
+                    : "optional";
+        });
+        const groupNames = ["required", "optional", "deprecated"];
+        const additionalProperties = typeof schema.additionalProperties === "object" ? (_jsx(SchemaView, { schema: schema.additionalProperties })) : schema.additionalProperties === true ? (_jsxs("div", { className: cn(ProseClasses, "text-sm p-4 bg-border/20 hover:bg-border/30 flex items-center gap-1"), children: [_jsx("span", { children: "Additional properties are allowed" }), _jsx("a", { className: "p-0.5 -m-0.5", href: "https://swagger.io/docs/specification/v3_0/data-models/dictionaries/", rel: "noopener noreferrer", target: "_blank", children: _jsx(InfoIcon, { size: 14 }) })] })) : null;
+        return (_jsxs(Card, { className: "divide-y overflow-hidden", children: [cardHeader, groupNames.map((group) => groupedProperties[group] && (_jsx("ul", { className: "divide-y", children: groupedProperties[group].map(([name, schema]) => (_jsx(SchemaPropertyItem, { name: name, schema: schema, group: group, defaultOpen: defaultOpen }, name))) }, group))), additionalProperties] }));
+    }
+    return null;
 };
 //# sourceMappingURL=SchemaView.js.map

package/dist/lib/plugins/openapi/schema/SchemaView.js.map

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

package/dist/lib/plugins/openapi/schema/utils.d.ts

@@ -1,5 +1,7 @@
 import type { SchemaObject } from "../../../oas/parser/index.js";
-export declare const isComplexType: (value: SchemaObject) => boolean;
+export declare const isBasicType: (type: unknown) => type is "string" | "number" | "boolean" | "integer" | "null";
+export declare const isArrayType: (value: SchemaObject) => boolean;
+export declare const isComplexType: (value?: SchemaObject) => boolean | undefined;
 export declare const hasLogicalGroupings: (value: SchemaObject) => boolean;
 export declare const LogicalSchemaTypeMap: {
     readonly allOf: "AND";
@@ -7,3 +9,8 @@ export declare const LogicalSchemaTypeMap: {
     readonly oneOf: "ONE";
 };
 export type LogicalGroupType = "AND" | "OR" | "ONE";
+export declare const isCircularRef: (schema: unknown) => schema is string;
+export declare const isArrayCircularRef: (schema: SchemaObject) => schema is SchemaObject & {
+    items: SchemaObject;
+};
+export declare const extractCircularRefInfo: (ref?: string | SchemaObject) => string | undefined;

package/dist/lib/plugins/openapi/schema/utils.js

@@ -1,11 +1,22 @@
-export const isComplexType = (value) => value.type === "object" ||
-    (value.type === "array" &&
-        typeof value.items === "object" &&
-        (!value.items.type || value.items.type === "object"));
+import { CIRCULAR_REF } from "../../../oas/graphql/circular.js";
+export const isBasicType = (type) => typeof type === "string" &&
+    ["string", "number", "boolean", "integer", "null"].includes(type);
+export const isArrayType = (value) => value.type === "array" ||
+    // schema.type might be an array of types, so we need to check if "array" is one of them
+    (Array.isArray(value.type) && value.type.includes("array"));
+export const isComplexType = (value) => value &&
+    ((value.type === "object" &&
+        Object.keys(value.properties ?? {}).length > 0) ||
+        (value.type === "array" &&
+            typeof value.items === "object" &&
+            (!value.items.type || value.items.type === "object")));
 export const hasLogicalGroupings = (value) => Boolean(value.oneOf ?? value.allOf ?? value.anyOf);
 export const LogicalSchemaTypeMap = {
     allOf: "AND",
     anyOf: "OR",
     oneOf: "ONE",
 };
+export const isCircularRef = (schema) => typeof schema === "string" && schema.startsWith(CIRCULAR_REF);
+export const isArrayCircularRef = (schema) => isArrayType(schema) && "items" in schema && isCircularRef(schema.items);
+export const extractCircularRefInfo = (ref) => typeof ref === "string" ? ref.split(":")[1] : undefined;
 //# sourceMappingURL=utils.js.map

package/dist/lib/plugins/openapi/schema/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/schema/utils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE,CACnD,KAAK,CAAC,IAAI,KAAK,QAAQ;IACvB,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;QACrB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAmB,EAAE,EAAE,CACzD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,KAAK;CACJ,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/schema/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAa,EACiD,EAAE,CAChE,OAAO,IAAI,KAAK,QAAQ;IACxB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAE,EAAE,CACjD,KAAK,CAAC,IAAI,KAAK,OAAO;IACtB,wFAAwF;IACxF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAE,EAAE,CACpD,KAAK;IACL,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/C,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;YACrB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAmB,EAAE,EAAE,CACzD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,KAAK;CACJ,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAe,EAAoB,EAAE,CACjE,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAoB,EAC8B,EAAE,CACpD,WAAW,CAAC,MAAM,CAAC,IAAI,OAAO,IAAI,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAA2B,EACP,EAAE,CACtB,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC"}

package/dist/lib/plugins/openapi/state.d.ts

@@ -0,0 +1,25 @@
+interface SelectedServerState {
+    selectedServer?: string;
+    setSelectedServer: (newServer: string) => void;
+}
+export declare const useSelectedServerStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SelectedServerState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<SelectedServerState, SelectedServerState>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SelectedServerState) => void) => () => void;
+        onFinishHydration: (fn: (state: SelectedServerState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<SelectedServerState, SelectedServerState>>;
+    };
+}>;
+/**
+ * Simple wrapper for `useSelectedServerStore` to fall back to first of the provided servers
+ */
+export declare const useSelectedServer: (servers: Array<{
+    url: string;
+}>) => {
+    selectedServer: string;
+    setSelectedServer: (newServer: string) => void;
+};
+export {};

package/dist/lib/plugins/openapi/state.js

@@ -0,0 +1,18 @@
+import { useMemo } from "react";
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+export const useSelectedServerStore = create()(persist((set) => ({
+    selectedServer: undefined,
+    setSelectedServer: (newServer) => set({ selectedServer: newServer }),
+}), { name: "zudoku-selected-server" }));
+/**
+ * Simple wrapper for `useSelectedServerStore` to fall back to first of the provided servers
+ */
+export const useSelectedServer = (servers) => {
+    const { selectedServer, setSelectedServer } = useSelectedServerStore();
+    const finalSelectedServer = useMemo(() => selectedServer && servers.some((s) => s.url === selectedServer)
+        ? selectedServer
+        : (servers.at(0)?.url ?? ""), [selectedServer, servers]);
+    return { selectedServer: finalSelectedServer, setSelectedServer };
+};
+//# sourceMappingURL=state.js.map

package/dist/lib/plugins/openapi/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../src/lib/plugins/openapi/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,EAAuB,CACjE,OAAO,CACL,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACR,cAAc,EAAE,SAAS;IACzB,iBAAiB,EAAE,CAAC,SAAiB,EAAE,EAAE,CACvC,GAAG,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;CACrC,CAAC,EACF,EAAE,IAAI,EAAE,wBAAwB,EAAE,CACnC,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAA+B,EAAE,EAAE;IACnE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAEvE,MAAM,mBAAmB,GAAG,OAAO,CACjC,GAAG,EAAE,CACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,CAAC;QAC7D,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAChC,CAAC,cAAc,EAAE,OAAO,CAAC,CAC1B,CAAC;IAEF,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;AACpE,CAAC,CAAC"}

package/dist/lib/plugins/openapi/util/createSidebarCategory.d.ts

@@ -0,0 +1,9 @@
+import type { SidebarItem } from "../../../../config/validators/SidebarSchema.js";
+import type { OperationResult } from "../index.js";
+export declare const createSidebarCategory: ({ label, path, operations, collapsible, collapsed, }: {
+    label: string;
+    path: string;
+    operations: OperationResult[];
+    collapsible?: boolean;
+    collapsed?: boolean;
+}) => SidebarItem;

package/dist/lib/plugins/openapi/util/createSidebarCategory.js

@@ -0,0 +1,23 @@
+import { MethodColorMap } from "./methodColorMap.js";
+export const createSidebarCategory = ({ label, path, operations, collapsible, collapsed, }) => ({
+    type: "category",
+    label,
+    link: {
+        type: "doc",
+        id: path,
+        label,
+    },
+    collapsible,
+    collapsed,
+    items: operations.map((operation) => ({
+        type: "link",
+        label: operation.summary ?? operation.path,
+        href: `${path}#${operation.slug}`,
+        badge: {
+            label: operation.method,
+            color: MethodColorMap[operation.method.toLowerCase()],
+            invert: true,
+        },
+    })),
+});
+//# sourceMappingURL=createSidebarCategory.js.map

package/dist/lib/plugins/openapi/util/createSidebarCategory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSidebarCategory.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/util/createSidebarCategory.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,KAAK,EACL,IAAI,EACJ,UAAU,EACV,WAAW,EACX,SAAS,GAOV,EAAe,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,UAAU;IAChB,KAAK;IACL,IAAI,EAAE;QACJ,IAAI,EAAE,KAAc;QACpB,EAAE,EAAE,IAAI;QACR,KAAK;KACN;IACD,WAAW;IACX,SAAS;IACT,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,MAAe;QACrB,KAAK,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI;QAC1C,IAAI,EAAE,GAAG,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE;QACjC,KAAK,EAAE;YACL,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,KAAK,EAAE,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,CAAE;YACtD,MAAM,EAAE,IAAI;SACb;KACF,CAAC,CAAC;CACJ,CAAC,CAAC"}

package/dist/lib/plugins/openapi/util/generateSchemaExample.d.ts

@@ -1,2 +1,2 @@
 import { type SchemaObject } from "../../../oas/graphql/index.js";
-export declare const generateSchemaExample: (schema: SchemaObject, name?: string) => any;
+export declare const generateSchemaExample: (schema?: SchemaObject, name?: string) => any;

package/dist/lib/plugins/openapi/util/generateSchemaExample.js

@@ -1,19 +1,32 @@
+import { isCircularRef } from "../schema/utils.js";
 export const generateSchemaExample = (schema, name) => {
-    // Directly return the example or default if they exist
+    if (!schema || isCircularRef(schema)) {
+        return null;
+    }
+    // Check for schema-level example first
     if (schema.example !== undefined) {
         return schema.example;
     }
-    else if (schema.examples) {
-        return Object.values(schema.examples)[0];
+    // Then check for schema-level examples
+    if (schema.examples &&
+        typeof schema.examples === "object" &&
+        "default" in schema.examples) {
+        const defaultExample = schema.examples.default;
+        if (defaultExample !== null) {
+            return typeof defaultExample === "object" && "value" in defaultExample
+                ? defaultExample.value
+                : defaultExample;
+        }
     }
-    else if (schema.default !== undefined) {
-        return schema.default;
+    // No example needed for const values
+    if (schema.const !== undefined) {
+        return schema.const;
     }
-    if (schema.properties || schema.type === "object") {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    // For object schemas with properties
+    if (schema.type === "object" && schema.properties) {
         const example = {};
-        if (schema.properties) {
-            for (const [key, propSchema] of Object.entries(schema.properties)) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (typeof propSchema === "object") {
                 example[key] = generateSchemaExample(propSchema, key);
             }
         }
@@ -23,14 +36,51 @@ export const generateSchemaExample = (schema, name) => {
         if (Array.isArray(schema.items)) {
             return schema.items.map((itemSchema) => generateSchemaExample(itemSchema));
         }
-        else if (schema.items) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- OpenAPI schemas don't always adhere to spec
+        if (schema.items) {
             return [generateSchemaExample(schema.items)];
         }
         return [];
     }
+    if (schema.format !== undefined) {
+        // Partial implementation of JSON Schema format examples
+        // https://json-schema.org/draft/2020-12/draft-bhutton-json-schema-validation-00#rfc.section.7.3
+        switch (schema.format) {
+            case "date-time":
+                return "2024-08-25T15:00:00Z";
+            case "date":
+                return "2024-08-25";
+            case "time":
+                return "15:00:00";
+            case "email":
+                return "test@example.com";
+            case "uri":
+                return "https://www.example.com/path/to/resource";
+            case "uri-reference":
+                return "/path/to/resource";
+            case "uuid":
+                return "00000000-0000-0000-0000-000000000000";
+        }
+    }
     if (schema.enum) {
         return schema.enum[0];
     }
+    if (schema.oneOf) {
+        const randomIndex = Math.floor(Math.random() * schema.oneOf.length);
+        return generateSchemaExample(schema.oneOf[randomIndex]);
+    }
+    if (schema.anyOf) {
+        // Should likely be expanded to return a partial set of values, but it would require
+        // detection if being used within an array or a string type.
+        const randomIndex = Math.floor(Math.random() * schema.anyOf.length);
+        return generateSchemaExample(schema.anyOf[randomIndex]);
+    }
+    if (schema.allOf) {
+        // https://swagger.io/docs/specification/v3_0/data-models/oneof-anyof-allof-not/#allof
+        return schema.allOf.reduce((acc, allOfSchema) => {
+            return { ...acc, ...generateSchemaExample(allOfSchema) };
+        }, {});
+    }
     switch (schema.type) {
         case "string":
             return name || "string";
@@ -41,6 +91,8 @@ export const generateSchemaExample = (schema, name) => {
             return true;
         case "null":
             return null;
+        case "object":
+            return {};
         case undefined:
         default:
             return {};

package/dist/lib/plugins/openapi/util/generateSchemaExample.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateSchemaExample.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/util/generateSchemaExample.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAoB,EACpB,IAAa,EAER,EAAE;IACP,uDAAuD;IACvD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClD,8DAA8D;QAC9D,MAAM,OAAO,GAAQ,EAAE,CAAC;QAExB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClE,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,UAA0B,EAAE,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACrC,qBAAqB,CAAC,UAA0B,CAAC,CAClD,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,KAAqB,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,IAAI,QAAQ,CAAC;QAC1B,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,SAAS,CAAC;QACf;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"generateSchemaExample.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/util/generateSchemaExample.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAqB,EACrB,IAAa,EAER,EAAE;IACP,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,uCAAuC;IACvC,IACE,MAAM,CAAC,QAAQ;QACf,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAC5B,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC/C,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,OAAO,cAAc,KAAK,QAAQ,IAAI,OAAO,IAAI,cAAc;gBACpE,CAAC,CAAC,cAAc,CAAC,KAAK;gBACtB,CAAC,CAAC,cAAc,CAAC;QACrB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAClD,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAClE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,UAA0B,EAAE,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACrC,qBAAqB,CAAC,UAA0B,CAAC,CAClD,CAAC;QACJ,CAAC;QACD,sHAAsH;QACtH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,KAAqB,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,wDAAwD;QACxD,gGAAgG;QAChG,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,WAAW;gBACd,OAAO,sBAAsB,CAAC;YAChC,KAAK,MAAM;gBACT,OAAO,YAAY,CAAC;YACtB,KAAK,MAAM;gBACT,OAAO,UAAU,CAAC;YACpB,KAAK,OAAO;gBACV,OAAO,kBAAkB,CAAC;YAC5B,KAAK,KAAK;gBACR,OAAO,0CAA0C,CAAC;YACpD,KAAK,eAAe;gBAClB,OAAO,mBAAmB,CAAC;YAC7B,KAAK,MAAM;gBACT,OAAO,sCAAsC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpE,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAiB,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,oFAAoF;QACpF,4DAA4D;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpE,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAiB,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,sFAAsF;QACtF,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE;YAC9C,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,qBAAqB,CAAC,WAA2B,CAAC,EAAE,CAAC;QAC3E,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;IAED,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,IAAI,QAAQ,CAAC;QAC1B,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC;QACf;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/lib/plugins/openapi/util/getRoutes.d.ts

@@ -0,0 +1,10 @@
+import { type RouteObject } from "react-router";
+import type { GraphQLClient } from "../client/GraphQLClient.js";
+import { type OpenApiPluginOptions } from "../index.js";
+import type { OasPluginConfig } from "../interfaces.js";
+export declare const getVersions: (config: OasPluginConfig) => string[];
+export declare const getRoutes: ({ basePath, config, client, }: {
+    client: GraphQLClient;
+    config: OpenApiPluginOptions;
+    basePath: string;
+}) => RouteObject[];

package/dist/lib/plugins/openapi/util/getRoutes.js

@@ -0,0 +1,117 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useSuspenseQuery } from "@tanstack/react-query";
+import { generatePath, Navigate, redirect, useLocation, useParams, } from "react-router";
+import { joinUrl } from "../../../util/joinUrl.js";
+import { useCreateQuery } from "../client/useCreateQuery.js";
+import { useOasConfig } from "../context.js";
+import { GetSidebarOperationsQuery, UNTAGGED_PATH, } from "../index.js";
+// Creates the main provider route that wraps operation routes.
+const createOasProvider = (opts) => ({
+    path: opts.routePath,
+    async lazy() {
+        const { OasProvider } = await import("../OasProvider.js");
+        return {
+            element: (_jsx(OasProvider, { basePath: opts.basePath, version: opts.version, client: opts.client, config: opts.config })),
+        };
+    },
+    children: opts.routes,
+});
+// Creates a route for displaying the operation list used for both tagged and untagged operations.
+const createRoute = ({ path, tag, untagged, }) => ({
+    path,
+    async lazy() {
+        const { OperationList } = await import("../OperationList.js");
+        return { element: _jsx(OperationList, { tag: tag, untagged: untagged }) };
+    },
+});
+const NonTagPagesOperationList = ({ render, path, }) => {
+    const { type, input } = useOasConfig();
+    const { tag: currentTag } = useParams();
+    const location = useLocation();
+    const query = useCreateQuery(GetSidebarOperationsQuery, { type, input });
+    const { data: { schema }, } = useSuspenseQuery(query);
+    const firstTag = schema.tags.at(0);
+    if (!currentTag && firstTag?.slug) {
+        return (_jsx(Navigate, { to: {
+                pathname: generatePath(path, { tag: firstTag.slug }),
+                search: location.search,
+            } }));
+    }
+    if (currentTag && schema.tags.some((t) => t.slug === currentTag)) {
+        return render(currentTag);
+    }
+    return null;
+};
+const createNonTagPagesRoute = ({ path }) => ({
+    path,
+    async lazy() {
+        const { OperationList } = await import("../OperationList.js");
+        return {
+            element: (_jsx(NonTagPagesOperationList, { path: path, render: (tag) => _jsx(OperationList, { tag: tag }) })),
+        };
+    },
+});
+const createAdditionalRoutes = (basePath) => [
+    // Category without tagged operations
+    createRoute({
+        path: joinUrl(basePath, UNTAGGED_PATH),
+        untagged: true,
+    }),
+    // Schema list route
+    {
+        path: joinUrl(basePath, "~schemas"),
+        lazy: async () => {
+            const { SchemaList } = await import("../SchemaList.js");
+            return { element: _jsx(SchemaList, {}) };
+        },
+    },
+];
+// Creates routes for a specific version, including tag-based routes and the untagged operations route.
+const createVersionRoutes = (versionPath, tagPages) => {
+    const firstTagRoute = joinUrl(versionPath, tagPages.at(0) ?? UNTAGGED_PATH);
+    return [
+        // Redirect to first tag on the index route
+        { index: true, loader: () => redirect(firstTagRoute) },
+        // Create routes for each tag
+        ...tagPages.map((tag) => createRoute({
+            path: joinUrl(versionPath, tag),
+            tag,
+        })),
+        ...createAdditionalRoutes(versionPath),
+    ];
+};
+export const getVersions = (config) => config.type === "file" ? Object.keys(config.input) : [];
+export const getRoutes = ({ basePath, config, client, }) => {
+    const tagPages = config.tagPages;
+    // If the config does not provide tag pages the catch-all
+    // route handles all operations on a single page
+    if (!tagPages) {
+        return [
+            createOasProvider({
+                basePath,
+                routePath: basePath,
+                routes: [
+                    createNonTagPagesRoute({ path: basePath + "/:tag?" }),
+                    ...createAdditionalRoutes(basePath),
+                ],
+                client,
+                config,
+            }),
+        ];
+    }
+    const versions = getVersions(config);
+    // The latest version always is added as index path
+    const versionsInPath = versions.length > 1 ? [undefined, ...versions] : [undefined];
+    return versionsInPath.map((version) => {
+        const versionPath = joinUrl(basePath, version);
+        return createOasProvider({
+            basePath,
+            version,
+            routePath: versionPath,
+            routes: createVersionRoutes(versionPath, tagPages),
+            client,
+            config,
+        });
+    });
+};
+//# sourceMappingURL=getRoutes.js.map

package/dist/lib/plugins/openapi/util/getRoutes.js.map

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

package/dist/lib/plugins/openapi/util/methodColorMap.d.ts

@@ -0,0 +1,2 @@
+import { ColorMap } from "../../../components/navigation/SidebarBadge.js";
+export declare const MethodColorMap: Record<string, keyof typeof ColorMap>;

package/dist/lib/plugins/openapi/util/methodColorMap.js

@@ -0,0 +1,10 @@
+export const MethodColorMap = {
+    get: "green",
+    post: "blue",
+    put: "yellow",
+    delete: "red",
+    patch: "purple",
+    options: "gray",
+    head: "gray",
+};
+//# sourceMappingURL=methodColorMap.js.map

package/dist/lib/plugins/openapi/util/methodColorMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodColorMap.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/util/methodColorMap.tsx"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,GAAG,EAAE,OAAO;IACZ,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;CACb,CAAC"}

package/dist/lib/plugins/openapi/util/methodToColor.d.ts

@@ -0,0 +1,20 @@
+export declare const TextColorMap: {
+    green: string;
+    blue: string;
+    yellow: string;
+    red: string;
+    purple: string;
+    indigo: string;
+    gray: string;
+};
+export declare const methodToColor: {
+    get: string;
+    post: string;
+    put: string;
+    delete: string;
+    patch: string;
+    options: string;
+    head: string;
+    trace: string;
+};
+export declare const methodForColor: (method: string) => string;

package/dist/lib/plugins/openapi/util/methodToColor.js

@@ -0,0 +1,24 @@
+export const TextColorMap = {
+    green: "text-green-600",
+    blue: "text-sky-600",
+    yellow: "text-yellow-600",
+    red: "text-red-600",
+    purple: "text-purple-600",
+    indigo: "text-indigo-600",
+    gray: "text-gray-600",
+};
+export const methodToColor = {
+    get: TextColorMap.green,
+    post: TextColorMap.blue,
+    put: TextColorMap.yellow,
+    delete: TextColorMap.red,
+    patch: TextColorMap.purple,
+    options: TextColorMap.indigo,
+    head: TextColorMap.gray,
+    trace: TextColorMap.gray,
+};
+export const methodForColor = (method) => {
+    return (methodToColor[method.toLocaleLowerCase()] ??
+        TextColorMap.gray);
+};
+//# sourceMappingURL=methodToColor.js.map

package/dist/lib/plugins/openapi/util/methodToColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodToColor.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/util/methodToColor.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,iBAAiB;IACzB,GAAG,EAAE,cAAc;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,YAAY,CAAC,KAAK;IACvB,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,GAAG,EAAE,YAAY,CAAC,MAAM;IACxB,MAAM,EAAE,YAAY,CAAC,GAAG;IACxB,KAAK,EAAE,YAAY,CAAC,MAAM;IAC1B,OAAO,EAAE,YAAY,CAAC,MAAM;IAC5B,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,KAAK,EAAE,YAAY,CAAC,IAAI;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;IAC/C,OAAO,CACL,aAAa,CAAC,MAAM,CAAC,iBAAiB,EAAgC,CAAC;QACvE,YAAY,CAAC,IAAI,CAClB,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/plugins/openapi/util/sanitizeMarkdownForMetatag.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeMarkdownForMetatag(description: string, maxLength?: number): string;