zudoku 0.77.0 → 0.78.0

package/dist/cli/cli.js

@@ -2963,7 +2963,10 @@ var init_ZudokuConfig = __esm({
       showVersionSelect: z7.enum(["always", "if-available", "hide"]),
       expandAllTags: z7.boolean(),
       showInfoPage: z7.boolean(),
-      schemaDownload: z7.object({ enabled: z7.boolean() }).partial(),
+      schemaDownload: z7.object({
+        enabled: z7.boolean(),
+        fileName: z7.string().regex(/^[A-Za-z0-9_-]+$/).optional()
+      }).partial(),
       transformExamples: z7.custom(
         (val) => typeof val === "function"
       ),
@@ -3112,7 +3115,7 @@ var init_ZudokuConfig = __esm({
     }).partial();
     DocsConfigSchema = z7.object({
       files: z7.union([z7.string(), z7.array(z7.string())]).transform((val) => typeof val === "string" ? [val] : val).default([DEFAULT_DOCS_FILES]),
-      publishMarkdown: z7.boolean().default(false).describe(
+      publishMarkdown: z7.boolean().default(true).describe(
         "When enabled, generates .md files for each document during build. Access documents at their URL path with .md extension (e.g., /foo/hello.md). Markdown files are generated without frontmatter."
       ),
       defaultOptions: z7.object({
@@ -3214,6 +3217,7 @@ var init_ZudokuConfig = __esm({
         issuer: z7.string(),
         audience: z7.string().optional(),
         scopes: z7.array(z7.string()).optional(),
+        allowInsecureRequests: z7.boolean().optional(),
         redirectToAfterSignUp: z7.string().optional(),
         redirectToAfterSignIn: z7.string().optional(),
         redirectToAfterSignOut: z7.string().optional(),
@@ -3350,6 +3354,9 @@ var init_ZudokuConfig = __esm({
     PlacementPosition = z7.enum(["start", "center", "end"]);
     HeaderConfigSchema = z7.object({
       navigation: HeaderNavigationSchema,
+      themeSwitcher: z7.object({
+        enabled: z7.boolean()
+      }).partial().optional(),
       placements: z7.object({
         navigation: PlacementPosition,
         search: PlacementPosition,
@@ -3818,7 +3825,7 @@ import {
 // package.json
 var package_default = {
   name: "zudoku",
-  version: "0.76.0",
+  version: "0.77.0",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -3896,10 +3903,10 @@ var package_default = {
   },
   dependencies: {
     "@apidevtools/json-schema-ref-parser": "15.3.5",
-    "@base-ui/react": "^1.4.0",
+    "@base-ui/react": "^1.4.1",
     "@envelop/core": "5.5.1",
     "@graphql-typed-document-node/core": "3.2.0",
-    "@hono/node-server": "1.19.13",
+    "@hono/node-server": "2.0.2",
     "@lekoarts/rehype-meta-as-attributes": "3.0.3",
     "@mdx-js/react": "3.1.1",
     "@mdx-js/rollup": "3.1.1",
@@ -3929,7 +3936,8 @@ var package_default = {
     "@radix-ui/react-tooltip": "1.2.8",
     "@radix-ui/react-visually-hidden": "1.2.4",
     "@scalar/openapi-parser": "0.23.13",
-    "@sentry/node": "10.49.0",
+    "@scalar/snippetz": "0.9.6",
+    "@sentry/node": "10.52.0",
     "@shikijs/langs": "4.0.2",
     "@shikijs/rehype": "4.0.2",
     "@shikijs/themes": "4.0.2",
@@ -3942,7 +3950,6 @@ var package_default = {
     "@types/react-dom": "catalog:",
     "@vitejs/plugin-react": "6.0.1",
     "@x0k/json-schema-merge": "1.0.2",
-    "@zudoku/httpsnippet": "10.0.9",
     "@zudoku/react-helmet-async": "2.0.5",
     "@zuplo/mcp": "0.0.32",
     bs58: "6.0.0",
@@ -3957,14 +3964,14 @@ var package_default = {
     "fast-equals": "6.0.0",
     glob: "13.0.6",
     "glob-parent": "6.0.2",
-    graphql: "16.13.2",
+    graphql: "16.14.0",
     "graphql-type-json": "0.3.2",
     "graphql-yoga": "5.18.0",
     "gray-matter": "4.0.3",
     "hast-util-heading-rank": "3.0.0",
     "hast-util-to-jsx-runtime": "2.3.6",
     "hast-util-to-string": "3.0.1",
-    hono: "4.12.14",
+    hono: "4.12.18",
     "http-terminator": "3.2.0",
     "javascript-stringify": "2.1.0",
     "json-schema-to-typescript-lite": "15.0.0",
@@ -3974,7 +3981,7 @@ var package_default = {
     "mdast-util-mdx": "3.0.0",
     "mdast-util-mdx-jsx": "3.2.0",
     "micromark-extension-mdxjs": "3.0.0",
-    motion: "12.35.1",
+    motion: "12.38.0",
     nanoevents: "9.1.0",
     "next-themes": "0.4.6",
     oauth4webapi: "3.8.5",
@@ -3982,13 +3989,13 @@ var package_default = {
     pagefind: "1.5.2",
     picocolors: "1.1.1",
     piscina: "5.1.4",
-    "posthog-node": "5.26.0",
+    "posthog-node": "5.33.4",
     "react-error-boundary": "6.1.1",
-    "react-hook-form": "7.71.2",
+    "react-hook-form": "7.75.0",
     "react-is": "catalog:",
     "react-markdown": "10.1.0",
     "react-router": "7.14.1",
-    "rehype-mdx-import-media": "1.2.0",
+    "rehype-mdx-import-media": "1.4.0",
     "rehype-raw": "7.0.0",
     "rehype-slug": "6.0.0",
     "remark-comment": "1.0.0",
@@ -3997,11 +4004,11 @@ var package_default = {
     "remark-frontmatter": "5.0.0",
     "remark-gfm": "4.0.1",
     "remark-mdx-frontmatter": "5.2.0",
-    semver: "7.7.4",
+    semver: "7.8.0",
     shiki: "4.0.2",
     sitemap: "9.0.1",
     "strip-ansi": "7.2.0",
-    "tailwind-merge": "3.5.0",
+    "tailwind-merge": "3.6.0",
     tailwindcss: "4.2.1",
     "tw-animate-css": "1.4.0",
     unified: "11.0.5",
@@ -4009,21 +4016,21 @@ var package_default = {
     vaul: "1.1.2",
     vfile: "6.0.3",
     vite: "8.0.9",
-    yaml: "2.8.3",
+    yaml: "2.8.4",
     yargs: "18.0.0",
     zod: "4.3.6",
-    zustand: "5.0.12"
+    zustand: "5.0.13"
   },
   devDependencies: {
-    "@clerk/clerk-js": "^6.7.4",
-    "@graphql-codegen/cli": "6.3.0",
+    "@graphql-codegen/cli": "7.0.0",
     "@inkeep/cxkit-types": "0.5.117",
     "@testing-library/dom": "catalog:",
     "@testing-library/jest-dom": "catalog:",
     "@testing-library/react": "catalog:",
     "@testing-library/user-event": "catalog:",
-    "@types/estree": "1.0.8",
+    "@types/estree": "1.0.9",
     "@types/glob-parent": "5.1.3",
+    "@types/har-format": "^1.2.16",
     "@types/hast": "3.0.4",
     "@types/json-schema": "7.0.15",
     "@types/mdast": "4.0.4",
@@ -4362,7 +4369,20 @@ import {
 var { compareSchemaDefinitions, compareSchemaValues } = createComparator();
 var { mergeArrayOfSchemaDefinitions } = createMerger({
   intersectJson: createIntersector(compareSchemaValues),
-  deduplicateJsonSchemaDef: createDeduplicator(compareSchemaDefinitions)
+  deduplicateJsonSchemaDef: createDeduplicator(compareSchemaDefinitions),
+  // Default mergers throw on incompatible type/enum pairs, which aborts the
+  // whole flatten even when the bad pair is one branch of a pairwise `anyOf`
+  // combination. Union instead.
+  mergers: {
+    type: (a, b) => {
+      if (a === b) return a;
+      const aArr = Array.isArray(a) ? a : [a];
+      const bArr = Array.isArray(b) ? b : [b];
+      const set = /* @__PURE__ */ new Set([...aArr, ...bArr]);
+      return set.size === 1 ? [...set][0] : [...set];
+    },
+    enum: (a, b) => Array.from(/* @__PURE__ */ new Set([...a, ...b]))
+  }
 });
 var shallowAllOfMerge = createShallowAllOfMerge(
   mergeArrayOfSchemaDefinitions
@@ -5705,6 +5725,9 @@ var SchemaManager = class {
     const existingSchema = schemas[index];
     const schemaVersion = processedSchema.info.version ?? FALLBACK_VERSION;
     const versionPath = existingSchema?.path && existingSchema.path.length > 0 ? existingSchema.path : paramsPath(params) || schemaVersion;
+    const config2 = ensureArray(this.config.apis ?? []).find(
+      (c) => c.path === configuredPath
+    );
     const processed = {
       schema: processedSchema,
       version: schemaVersion,
@@ -5717,7 +5740,8 @@ var SchemaManager = class {
         filePath,
         versionPath,
         configuredPath,
-        params
+        params,
+        config2?.options
       ),
       processedJsonPath,
       processedTime
@@ -5803,14 +5827,15 @@ var SchemaManager = class {
     }
     return map;
   };
-  createSchemaPath = (inputPath, versionPath, apiPath, params) => {
+  createSchemaPath = (inputPath, versionPath, apiPath, params, config2) => {
     const suffix = paramsSuffix(params);
     const extension = suffix ? ".json" : path7.extname(inputPath);
+    const fileName = config2?.schemaDownload?.fileName ?? this.config.defaults?.apis?.schemaDownload?.fileName ?? "schema";
     return joinUrl(
       this.config.basePath,
       apiPath,
       versionPath,
-      `schema${suffix}${extension}`
+      `${fileName}${suffix}${extension}`
     );
   };
   validateSchema = async (schema2, filePath) => {

package/dist/declarations/config/validators/ZudokuConfig.d.ts

@@ -42,6 +42,29 @@ declare const AiAssistantsSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodLitera
     }) => string>]>;
 }, z.core.$strip>]>>]>>;
 export type AiAssistantsConfig = z.infer<typeof AiAssistantsSchema>;
+declare const ApiOptionsSchema: z.ZodObject<{
+    examplesLanguage: z.ZodOptional<z.ZodString>;
+    supportedLanguages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    disablePlayground: z.ZodOptional<z.ZodBoolean>;
+    disableSidecar: z.ZodOptional<z.ZodBoolean>;
+    showVersionSelect: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        hide: "hide";
+        "if-available": "if-available";
+    }>>;
+    expandAllTags: z.ZodOptional<z.ZodBoolean>;
+    showInfoPage: z.ZodOptional<z.ZodBoolean>;
+    schemaDownload: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
+    generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
+}, z.core.$strip>;
+export type ApiOptionsConfig = z.infer<typeof ApiOptionsSchema>;
 declare const VersionConfigSchema: z.ZodObject<{
     path: z.ZodString;
     input: z.ZodString;
@@ -71,6 +94,7 @@ declare const ApiSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         showInfoPage: z.ZodOptional<z.ZodBoolean>;
         schemaDownload: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
+            fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
         generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -105,6 +129,7 @@ declare const ApiSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         showInfoPage: z.ZodOptional<z.ZodBoolean>;
         schemaDownload: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
+            fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
         generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -139,6 +164,7 @@ declare const ApiSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         showInfoPage: z.ZodOptional<z.ZodBoolean>;
         schemaDownload: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
+            fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
         generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -336,6 +362,7 @@ declare const AuthenticationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     issuer: z.ZodString;
     audience: z.ZodOptional<z.ZodString>;
     scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowInsecureRequests: z.ZodOptional<z.ZodBoolean>;
     redirectToAfterSignUp: z.ZodOptional<z.ZodString>;
     redirectToAfterSignIn: z.ZodOptional<z.ZodString>;
     redirectToAfterSignOut: z.ZodOptional<z.ZodString>;
@@ -6420,6 +6447,9 @@ export declare const ZudokuConfig: z.ZodObject<{
                 }, z.core.$strip>>;
             }, z.core.$strip>]>>;
         }, z.core.$strip>]>>>;
+        themeSwitcher: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
         placements: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             navigation: z.ZodOptional<z.ZodEnum<{
                 end: "end";
@@ -6708,6 +6738,7 @@ export declare const ZudokuConfig: z.ZodObject<{
         issuer: z.ZodString;
         audience: z.ZodOptional<z.ZodString>;
         scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowInsecureRequests: z.ZodOptional<z.ZodBoolean>;
         redirectToAfterSignUp: z.ZodOptional<z.ZodString>;
         redirectToAfterSignIn: z.ZodOptional<z.ZodString>;
         redirectToAfterSignOut: z.ZodOptional<z.ZodString>;
@@ -6842,6 +6873,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -6876,6 +6908,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -6910,6 +6943,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -6940,6 +6974,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -6974,6 +7009,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -7008,6 +7044,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -7107,6 +7144,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             showInfoPage: z.ZodOptional<z.ZodBoolean>;
             schemaDownload: z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodOptional<z.ZodBoolean>;
+                fileName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             }, z.core.$strip>>;
             transformExamples: z.ZodOptional<z.ZodCustom<TransformExamplesFn, TransformExamplesFn>>;
             generateCodeSnippet: z.ZodOptional<z.ZodCustom<GenerateCodeSnippetFn, GenerateCodeSnippetFn>>;
@@ -7126,6 +7164,9 @@ type BaseZudokuConfig = z.input<typeof ZudokuConfig>;
 export type ZudokuConfig = Omit<BaseZudokuConfig, "header" | "navigation" | "navigationRules"> & {
     header?: {
         navigation?: z.infer<typeof HeaderNavigationSchema>;
+        themeSwitcher?: {
+            enabled?: boolean;
+        };
         placements?: {
             navigation?: "start" | "center" | "end";
             search?: "start" | "center" | "end";

package/dist/declarations/lib/authentication/providers/clerk.d.ts

@@ -1,9 +1,22 @@
-import type { Clerk } from "@clerk/clerk-js";
 import type { ClerkAuthenticationConfig } from "../../../config/config.js";
 import type { AuthenticationProviderInitializer } from "../authentication.js";
+type ClerkEmailAddress = {
+    emailAddress: string;
+    verification: {
+        status: string;
+    };
+};
+export type ClerkUser = {
+    id: string;
+    fullName: string | null;
+    imageUrl: string;
+    emailAddresses: ClerkEmailAddress[];
+    reload: () => Promise<unknown>;
+    [key: string]: unknown;
+};
 export type ClerkProviderData = {
     type: "clerk";
-    user: NonNullable<Clerk["session"]>["user"] | undefined;
+    user: ClerkUser | undefined;
 };
 declare module "../state.js" {
     interface ProviderDataRegistry {

package/dist/declarations/lib/authentication/providers/openid.d.ts

@@ -38,7 +38,13 @@ export declare class OpenIDAuthenticationProvider extends CoreAuthenticationPlug
     protected readonly authorizationParams?: Record<string, string>;
     protected readonly forwardAuthorizationParams: string[];
     protected static readonly DEFAULT_FORWARD_AUTHORIZATION_PARAMS: string[];
-    constructor({ issuer, audience, clientId, redirectToAfterSignUp, redirectToAfterSignIn, redirectToAfterSignOut, basePath, scopes, signUp, disableSignUp, authorizationParams, forwardAuthorizationParams, }: OpenIDAuthenticationConfig);
+    private readonly allowInsecureRequests;
+    constructor({ issuer, audience, clientId, redirectToAfterSignUp, redirectToAfterSignIn, redirectToAfterSignOut, basePath, scopes, signUp, disableSignUp, authorizationParams, forwardAuthorizationParams, allowInsecureRequests, }: OpenIDAuthenticationConfig);
+    protected get oauthOptions(): {
+        [oauth.allowInsecureRequests]: boolean;
+    } | {
+        [oauth.allowInsecureRequests]?: undefined;
+    };
     protected getAuthServer(): Promise<oauth.AuthorizationServer>;
     protected setTokensFromResponse(response: oauth.TokenEndpointResponse): void;
     signUp({ navigate }: {

package/dist/declarations/lib/core/ZudokuContext.d.ts

@@ -71,6 +71,9 @@ type Site = Partial<{
 }>;
 type HeaderConfig = {
     navigation?: HeaderNavigation;
+    themeSwitcher?: {
+        enabled?: boolean;
+    };
     placements?: {
         navigation?: "start" | "center" | "end";
         search?: "start" | "center" | "end";

package/dist/declarations/lib/plugins/openapi/GeneratedExampleSidecarBox.d.ts

@@ -1,5 +1,6 @@
-export declare const GeneratedExampleSidecarBox: ({ code, isOnScreen, shouldLazyHighlight, }: {
+export declare const GeneratedExampleSidecarBox: ({ code, language, isOnScreen, shouldLazyHighlight, }: {
     code: string;
+    language?: string;
     isOnScreen: boolean;
     shouldLazyHighlight?: boolean;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/declarations/lib/plugins/openapi/playground/Playground.d.ts

@@ -26,13 +26,18 @@ export type PathParam = {
 };
 export type PlaygroundForm = {
     body: string;
-    bodyMode?: "text" | "file" | "multipart";
+    bodyMode?: "text" | "file" | "multipart" | "urlencoded";
     file?: File | null;
     multipartFormFields: Array<{
         name: string;
         value: File | string;
         active: boolean;
     }>;
+    urlencodedFormFields: Array<{
+        name: string;
+        value: string;
+        active: boolean;
+    }>;
     queryParams: Array<{
         name: string;
         value: string;

package/dist/declarations/lib/plugins/openapi/playground/buildRequestBody.d.ts

@@ -0,0 +1,14 @@
+import type { PlaygroundForm } from "./Playground.js";
+export type ContentTypeAction = {
+    kind: "preserve";
+} | {
+    kind: "remove";
+} | {
+    kind: "override";
+    value: string;
+};
+export type BuiltRequestBody = {
+    body: string | FormData | File | undefined;
+    contentType: ContentTypeAction;
+};
+export declare const buildRequestBody: (form: PlaygroundForm) => BuiltRequestBody;

package/dist/declarations/lib/plugins/openapi/playground/request-panel/UrlEncodedField.d.ts

@@ -0,0 +1,8 @@
+import type { PlaygroundForm } from "../Playground.js";
+import type { useKeyValueFieldManager } from "./useKeyValueFieldManager.js";
+type UrlEncodedFieldProps = {
+    index: number;
+    manager: ReturnType<typeof useKeyValueFieldManager<PlaygroundForm, "urlencodedFormFields">>;
+};
+export declare const UrlEncodedField: ({ index, manager }: UrlEncodedFieldProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/declarations/lib/plugins/openapi/util/createHttpSnippet.d.ts

@@ -1,4 +1,4 @@
-import { HTTPSnippet } from "@zudoku/httpsnippet";
+import type { HarRequest } from "@scalar/snippetz";
 import type { OperationsFragmentFragment } from "../graphql/graphql.js";
 export type ResolvedAuth = {
     headers: Array<{
@@ -19,5 +19,5 @@ export declare const createHttpSnippet: ({ operation, selectedServer, exampleBod
         text?: string;
     };
     resolvedAuth?: ResolvedAuth;
-}) => HTTPSnippet;
-export declare const getConverted: (snippet: HTTPSnippet, option: string) => any;
+}) => Partial<HarRequest>;
+export declare const getConverted: (request: Partial<HarRequest>, language: string) => string;

package/dist/declarations/lib/plugins/openapi/util/formatRequestBody.d.ts

@@ -0,0 +1,11 @@
+export type UrlEncodedRow = {
+    name: string;
+    value: string;
+};
+export declare const isUrlEncodedMediaType: (mediaType?: string) => boolean;
+export declare const toUrlEncoded: (value: unknown) => string;
+export declare const formatRequestBodyForDisplay: (mediaType: string | undefined, value: unknown) => string | undefined;
+export declare const getLanguageForMediaType: (mediaType?: string) => string;
+export declare const rowsToUrlEncoded: (rows: UrlEncodedRow[]) => string;
+export declare const fromUrlEncoded: (text: string) => UrlEncodedRow[];
+export declare const exampleToUrlEncodedRows: (value: unknown) => UrlEncodedRow[];

package/dist/flat-config.d.ts

@@ -168,6 +168,9 @@ export interface FlatZudokuConfig {
         items: _Schema2[]
       })[]
     })[]
+    themeSwitcher?: {
+      enabled?: boolean
+    }
     placements?: {
       navigation?: _Schema3
       search?: _Schema3
@@ -278,6 +281,7 @@ export interface FlatZudokuConfig {
     issuer: string
     audience?: string
     scopes?: string[]
+    allowInsecureRequests?: boolean
     redirectToAfterSignUp?: string
     redirectToAfterSignIn?: string
     redirectToAfterSignOut?: string
@@ -485,6 +489,7 @@ export interface _Schema22 {
   showInfoPage?: boolean
   schemaDownload?: {
     enabled?: boolean
+    fileName?: string
   }
   transformExamples?: unknown
   generateCodeSnippet?: unknown

package/docs/configuration/api-reference.md

@@ -212,6 +212,7 @@ const config = {
       showInfoPage: true, // Show API information page as the index route
       schemaDownload: {
         enabled: true, // Enable schema download button
+        fileName: "schema", // Set name of the schema file when downloaded
       },
     },
   },
@@ -238,6 +239,8 @@ Available options:
 - `schemaDownload`: Enable schema download functionality. When enabled, displays a button allowing
   users to download the OpenAPI schema, copy it to clipboard, or open in a new tab.
   - `enabled`: Enable or disable the schema download button
+  - `fileName`: Set name of the schema file when downloaded (default: `schema`). Note: Do not
+    include a file extension, as that is added automatically based on the input file type.
 - `transformExamples`: Function to transform request/response examples before rendering. See
   [Transforming Examples](../guides/transforming-examples.md) for detailed usage
 - `generateCodeSnippet`: Function to generate custom code snippets for the API playground. See
@@ -261,6 +264,7 @@ const config = {
       showInfoPage: true, // Show API information page as the index route
       schemaDownload: {
         enabled: true, // Enable schema download button
+        fileName: "schema", // Set name of the schema file when downloaded
       },
     },
   },

package/docs/configuration/docs.md

@@ -228,7 +228,7 @@ The copy button provides:
 
 ### `publishMarkdown`
 
-**Type:** `boolean` **Default:** `false`
+**Type:** `boolean` **Default:** `true`
 
 When enabled, generates `.md` files for each documentation page during build. Pages can then be
 accessed at their URL path with the `.md` extension appended (e.g., `/docs/quickstart.md`).

package/docs/configuration/overview.md

@@ -195,10 +195,16 @@ Configures the header navigation and placement of header elements (navigation, s
       search: "end",          // "start" | "center" | "end"
       auth: "end",            // "start" | "center" | "end" | "navigation"
     },
+    themeSwitcher: {
+      enabled: false, // optional, defaults to true
+    },
   }
 }
 ```
 
+Use `header.themeSwitcher.enabled: false` to hide the light/dark theme switch from the desktop
+header and mobile navigation drawer.
+
 ### `defaults`
 
 Sets global default options for APIs that apply to all API configurations. Individual API options

package/docs/guides/mcp-servers.md

@@ -186,4 +186,4 @@ since they use a different interaction model.
 
 If you are using [Zuplo](https://zuplo.com) to host your API, the `x-mcp-server` extension is
 automatically added to POST operations that use the `mcpServerHandler`. No manual schema changes are
-needed. See the [Zuplo MCP documentation](https://zuplo.com/docs/handlers/mcp-handler) for details.
+needed. See the [Zuplo MCP documentation](https://zuplo.com/docs/handlers/mcp-server) for details.