@scalar/oas-utils 0.2.110 → 0.2.113

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @scalar/oas-utils
 
+## 0.2.113
+
+### Patch Changes
+
+- a31973c: feat: add ScalarStabilitySchema
+- Updated dependencies [bab7990]
+- Updated dependencies [2c621d4]
+  - @scalar/types@0.0.39
+  - @scalar/themes@0.9.74
+
+## 0.2.112
+
+### Patch Changes
+
+- Updated dependencies [7f1a40e]
+  - @scalar/types@0.0.38
+  - @scalar/themes@0.9.73
+
+## 0.2.111
+
+### Patch Changes
+
+- 89d8b75: feat: new ApiReferenceConfiguration type
+- 8a04b8d: fix: mime type transformation issue
+- 1459ce7: fix: adds parameter examples array support
+- 8a04b8d: fix: adds vendor specific mime type support
+- Updated dependencies [89d8b75]
+- Updated dependencies [8a04b8d]
+  - @scalar/themes@0.9.72
+  - @scalar/types@0.0.37
+  - @scalar/object-utils@1.1.13
+  - @scalar/openapi-types@0.1.9
+
 ## 0.2.110
 
 ### Patch Changes

package/dist/entities/spec/operation.d.ts

@@ -5,7 +5,7 @@
 import { type RequestPayload, type Request as RequestType } from './requests.js';
 export type Operation = RequestType;
 export type OperationPayload = RequestPayload;
-export declare const operationSchema: import("zod").ZodObject<import("zod").objectUtil.extendShape<Omit<{
+export declare const operationSchema: import("zod").ZodObject<import("zod").objectUtil.extendShape<import("zod").objectUtil.extendShape<Omit<{
     tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
     summary: import("zod").ZodOptional<import("zod").ZodString>;
     description: import("zod").ZodOptional<import("zod").ZodString>;
@@ -22,7 +22,7 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         content: import("zod").ZodOptional<import("zod").ZodUnknown>;
         style: import("zod").ZodOptional<import("zod").ZodEnum<["matrix", "simple", "form", "label", "spaceDelimited", "pipeDelimited", "deepObject"]>>;
         example: import("zod").ZodOptional<import("zod").ZodUnknown>;
-        examples: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+        examples: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
             value: import("zod").ZodUnknown;
             summary: import("zod").ZodOptional<import("zod").ZodString>;
         }, "strip", import("zod").ZodTypeAny, {
@@ -31,7 +31,7 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         }, {
             value?: unknown;
             summary?: string | undefined;
-        }>>>;
+        }>>, import("zod").ZodArray<import("zod").ZodUnknown, "many">]>>;
     }, "strip", import("zod").ZodTypeAny, {
         required: boolean;
         name: string;
@@ -42,7 +42,7 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -56,7 +56,7 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -161,6 +161,8 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
     'x-internal': import("zod").ZodOptional<import("zod").ZodBoolean>;
     'x-scalar-ignore': import("zod").ZodOptional<import("zod").ZodBoolean>;
 }, "x-scalar-examples">, {
+    'x-scalar-stability': import("zod").ZodCatch<import("zod").ZodOptional<import("zod").ZodEnum<[import("@scalar/types").XScalarStability.Deprecated, import("@scalar/types").XScalarStability.Experimental, import("@scalar/types").XScalarStability.Stable]>>>;
+}>, {
     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodLiteral<"request">>>;
     uid: import("zod").ZodBranded<import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>, "operation">;
     path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
@@ -200,13 +202,14 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
     }[] | undefined;
     requestBody?: any;
     responses?: Record<string, any> | undefined;
+    'x-scalar-stability'?: import("@scalar/types").XScalarStability | undefined;
 }, {
     path?: string | undefined;
     type?: "request" | undefined;
@@ -237,13 +240,14 @@ export declare const operationSchema: import("zod").ZodObject<import("zod").obje
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
     }[] | undefined;
     requestBody?: any;
     responses?: Record<string, any> | undefined;
+    'x-scalar-stability'?: unknown;
     method?: "options" | "connect" | "delete" | "get" | "head" | "patch" | "post" | "put" | "trace" | undefined;
 }>;
 //# sourceMappingURL=operation.d.ts.map

package/dist/entities/spec/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/operation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,IAAI,WAAW,EAAiB,MAAM,YAAY,CAAA;AAE5F,MAAM,MAAM,SAAS,GAAG,WAAW,CAAA;AACnC,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AAC7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgB,CAAA"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/operation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,IAAI,WAAW,EAAiB,MAAM,YAAY,CAAA;AAE5F,MAAM,MAAM,SAAS,GAAG,WAAW,CAAA;AACnC,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AAC7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgB,CAAA"}

package/dist/entities/spec/parameters.d.ts

@@ -19,7 +19,7 @@ export declare const oasParameterSchema: z.ZodObject<{
     /** Defaulted according to @url https://spec.openapis.org/oas/v3.1.0#parameter-object */
     style: z.ZodOptional<z.ZodEnum<["matrix", "simple", "form", "label", "spaceDelimited", "pipeDelimited", "deepObject"]>>;
     example: z.ZodOptional<z.ZodUnknown>;
-    examples: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    examples: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodObject<{
         value: z.ZodUnknown;
         summary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -28,7 +28,7 @@ export declare const oasParameterSchema: z.ZodObject<{
     }, {
         value?: unknown;
         summary?: string | undefined;
-    }>>>;
+    }>>, z.ZodArray<z.ZodUnknown, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     required: boolean;
     name: string;
@@ -39,7 +39,7 @@ export declare const oasParameterSchema: z.ZodObject<{
     schema?: unknown;
     content?: unknown;
     style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-    examples?: Record<string, {
+    examples?: unknown[] | Record<string, {
         value?: unknown;
         summary?: string | undefined;
     }> | undefined;
@@ -53,7 +53,7 @@ export declare const oasParameterSchema: z.ZodObject<{
     schema?: unknown;
     content?: unknown;
     style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-    examples?: Record<string, {
+    examples?: unknown[] | Record<string, {
         value?: unknown;
         summary?: string | undefined;
     }> | undefined;

package/dist/entities/spec/parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvC,eAAO,MAAM,mBAAmB,kDAAgD,CAAA;AAChF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE3D,eAAO,MAAM,oBAAoB,mGAQ/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;IAI7B,yBAAyB;;IAEzB,yBAAyB;;;;IAIzB,wFAAwF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYjD,CAAA;AAEzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACjE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvC,eAAO,MAAM,mBAAmB,kDAAgD,CAAA;AAChF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE3D,eAAO,MAAM,oBAAoB,mGAQ/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;IAI7B,yBAAyB;;IAEzB,yBAAyB;;;;IAIzB,wFAAwF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAejD,CAAA;AAEzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACjE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/entities/spec/parameters.js

@@ -27,10 +27,13 @@ const oasParameterSchema = z.object({
     style: parameterStyleSchema.optional(),
     example: z.unknown().optional(),
     examples: z
-        .record(z.string(), z.object({
-        value: z.unknown(),
-        summary: z.string().optional(),
-    }))
+        .union([
+        z.record(z.string(), z.object({
+            value: z.unknown(),
+            summary: z.string().optional(),
+        })),
+        z.array(z.unknown()),
+    ])
         .optional(),
 });
 

package/dist/entities/spec/request-examples.d.ts

@@ -161,12 +161,15 @@ export declare const exampleRequestBodySchema: z.ZodObject<{
     raw: z.ZodOptional<z.ZodObject<{
         encoding: z.ZodEnum<["json", "text", "html", "javascript", "xml", "yaml", "edn"]>;
         value: z.ZodDefault<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         value: string;
-        encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+        encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
+        mimeType?: string | undefined;
     }, {
-        encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+        encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
         value?: string | undefined;
+        mimeType?: string | undefined;
     }>>;
     formData: z.ZodOptional<z.ZodObject<{
         encoding: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"form-data">, z.ZodLiteral<"urlencoded">]>>;
@@ -309,7 +312,8 @@ export declare const exampleRequestBodySchema: z.ZodObject<{
     } | undefined;
     raw?: {
         value: string;
-        encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+        encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
+        mimeType?: string | undefined;
     } | undefined;
 }, {
     binary?: Blob | undefined;
@@ -333,8 +337,9 @@ export declare const exampleRequestBodySchema: z.ZodObject<{
         encoding?: "form-data" | "urlencoded" | undefined;
     } | undefined;
     raw?: {
-        encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+        encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
         value?: string | undefined;
+        mimeType?: string | undefined;
     } | undefined;
     activeBody?: "binary" | "formData" | "raw" | undefined;
 }>;
@@ -384,12 +389,15 @@ export declare const requestExampleSchema: z.ZodObject<{
         raw: z.ZodOptional<z.ZodObject<{
             encoding: z.ZodEnum<["json", "text", "html", "javascript", "xml", "yaml", "edn"]>;
             value: z.ZodDefault<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             value: string;
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
+            mimeType?: string | undefined;
         }, {
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
             value?: string | undefined;
+            mimeType?: string | undefined;
         }>>;
         formData: z.ZodOptional<z.ZodObject<{
             encoding: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"form-data">, z.ZodLiteral<"urlencoded">]>>;
@@ -532,7 +540,8 @@ export declare const requestExampleSchema: z.ZodObject<{
         } | undefined;
         raw?: {
             value: string;
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
+            mimeType?: string | undefined;
         } | undefined;
     }, {
         binary?: Blob | undefined;
@@ -556,8 +565,9 @@ export declare const requestExampleSchema: z.ZodObject<{
             encoding?: "form-data" | "urlencoded" | undefined;
         } | undefined;
         raw?: {
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
             value?: string | undefined;
+            mimeType?: string | undefined;
         } | undefined;
         activeBody?: "binary" | "formData" | "raw" | undefined;
     }>>>;
@@ -1093,7 +1103,8 @@ export declare const requestExampleSchema: z.ZodObject<{
         } | undefined;
         raw?: {
             value: string;
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
+            mimeType?: string | undefined;
         } | undefined;
     };
     requestUid?: (string & z.BRAND<"operation">) | undefined;
@@ -1190,8 +1201,9 @@ export declare const requestExampleSchema: z.ZodObject<{
             encoding?: "form-data" | "urlencoded" | undefined;
         } | undefined;
         raw?: {
-            encoding: "xml" | "text" | "json" | "html" | "javascript" | "yaml" | "edn";
+            encoding: "xml" | "json" | "text" | "html" | "javascript" | "yaml" | "edn";
             value?: string | undefined;
+            mimeType?: string | undefined;
         } | undefined;
         activeBody?: "binary" | "formData" | "raw" | undefined;
     } | undefined;

package/dist/entities/spec/request-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-examples.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/request-examples.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request-examples.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/request-examples.ts"],"names":[],"mappings":"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"}

package/dist/entities/spec/request-examples.js

@@ -117,6 +117,7 @@ const exampleRequestBodySchema = z.object({
         .object({
         encoding: z.enum(exampleRequestBodyEncoding),
         value: z.string().default(''),
+        mimeType: z.string().optional(),
     })
         .optional(),
     formData: z
@@ -230,7 +231,15 @@ function convertExampleToXScalar(example) {
 function createParamInstance(param) {
     const schema = param.schema;
     const keys = Object.keys(param?.examples ?? {});
-    const firstExample = keys.length ? param.examples?.[keys[0]] : null;
+    const firstExample = (() => {
+        if (keys.length && !Array.isArray(param.examples)) {
+            return param.examples?.[keys[0]];
+        }
+        if (Array.isArray(param.examples) && param.examples.length > 0) {
+            return { value: param.examples[0] };
+        }
+        return null;
+    })();
     /**
      * TODO:
      * - Need better value defaulting here
@@ -239,11 +248,15 @@ function createParamInstance(param) {
      */
     const value = String(schema?.default ?? schema?.examples?.[0] ?? schema?.example ?? firstExample?.value ?? param.example ?? '');
     // Handle non-string enums and enums within items for array types
-    const parseEnum = schema?.enum && schema?.type !== 'string'
-        ? schema.enum?.map(String)
-        : schema?.items?.enum && schema?.type === 'array'
-            ? schema.items.enum.map(String)
-            : schema?.enum;
+    const parseEnum = (() => {
+        if (schema?.enum && schema?.type !== 'string') {
+            return schema.enum?.map(String);
+        }
+        if (schema?.items?.enum && schema?.type === 'array') {
+            return schema.items.enum.map(String);
+        }
+        return schema?.enum;
+    })();
     // Handle non-string examples
     const parseExamples = schema?.examples && schema?.type !== 'string' ? schema.examples?.map(String) : schema?.examples;
     // safe parse the example
@@ -302,10 +315,12 @@ function createExampleFromRequest(request, name, server) {
             },
         });
         const contentType = request.requestBody ? requestBody?.mimeType : contentTypeHeader?.value;
-        if (contentType === 'application/json') {
+        // Handle JSON and JSON-like mimetypes
+        if (contentType?.includes('/json') || contentType?.endsWith('+json')) {
             body.activeBody = 'raw';
             body.raw = {
                 encoding: 'json',
+                mimeType: contentType,
                 value: requestBody?.text ?? JSON.stringify({}),
             };
         }

package/dist/entities/spec/requests.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { XScalarStability } from '@scalar/types';
 import { type RequestExample } from './request-examples.js';
 export declare const requestMethods: readonly ["connect", "delete", "get", "head", "options", "patch", "post", "put", "trace"];
 export type RequestMethod = (typeof requestMethods)[number];
@@ -74,7 +75,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         content: z.ZodOptional<z.ZodUnknown>;
         style: z.ZodOptional<z.ZodEnum<["matrix", "simple", "form", "label", "spaceDelimited", "pipeDelimited", "deepObject"]>>;
         example: z.ZodOptional<z.ZodUnknown>;
-        examples: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        examples: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodObject<{
             value: z.ZodUnknown;
             summary: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -83,7 +84,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         }, {
             value?: unknown;
             summary?: string | undefined;
-        }>>>;
+        }>>, z.ZodArray<z.ZodUnknown, "many">]>>;
     }, "strip", z.ZodTypeAny, {
         required: boolean;
         name: string;
@@ -94,7 +95,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -108,7 +109,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -241,7 +242,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -288,7 +289,7 @@ export declare const oasRequestSchema: z.ZodObject<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -314,7 +315,7 @@ export declare const oasRequestSchema: z.ZodObject<{
     }> | undefined;
 }>;
 /** Unified request schema for client usage */
-export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
+export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<Omit<{
     /**
      * A list of tags for API documentation control. Tags can be used for logical
      * grouping of operations by resources or any other qualifier.
@@ -360,7 +361,7 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         content: z.ZodOptional<z.ZodUnknown>;
         style: z.ZodOptional<z.ZodEnum<["matrix", "simple", "form", "label", "spaceDelimited", "pipeDelimited", "deepObject"]>>;
         example: z.ZodOptional<z.ZodUnknown>;
-        examples: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        examples: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodObject<{
             value: z.ZodUnknown;
             summary: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -369,7 +370,7 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         }, {
             value?: unknown;
             summary?: string | undefined;
-        }>>>;
+        }>>, z.ZodArray<z.ZodUnknown, "many">]>>;
     }, "strip", z.ZodTypeAny, {
         required: boolean;
         name: string;
@@ -380,7 +381,7 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -394,7 +395,7 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
@@ -505,6 +506,8 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
     'x-internal': z.ZodOptional<z.ZodBoolean>;
     'x-scalar-ignore': z.ZodOptional<z.ZodBoolean>;
 }, "x-scalar-examples">, {
+    'x-scalar-stability': z.ZodCatch<z.ZodOptional<z.ZodEnum<[XScalarStability.Deprecated, XScalarStability.Experimental, XScalarStability.Stable]>>>;
+}>, {
     type: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"request">>>;
     uid: z.ZodBranded<z.ZodDefault<z.ZodOptional<z.ZodString>>, "operation">;
     /** Path Key */
@@ -550,13 +553,14 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
     }[] | undefined;
     requestBody?: any;
     responses?: Record<string, any> | undefined;
+    'x-scalar-stability'?: XScalarStability | undefined;
 }, {
     path?: string | undefined;
     type?: "request" | undefined;
@@ -587,13 +591,14 @@ export declare const requestSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
         schema?: unknown;
         content?: unknown;
         style?: "matrix" | "simple" | "form" | "label" | "spaceDelimited" | "pipeDelimited" | "deepObject" | undefined;
-        examples?: Record<string, {
+        examples?: unknown[] | Record<string, {
             value?: unknown;
             summary?: string | undefined;
         }> | undefined;
     }[] | undefined;
     requestBody?: any;
     responses?: Record<string, any> | undefined;
+    'x-scalar-stability'?: unknown;
     method?: "options" | "connect" | "delete" | "get" | "head" | "patch" | "post" | "put" | "trace" | undefined;
 }>;
 export type Request = z.infer<typeof requestSchema>;

package/dist/entities/spec/requests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/requests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvC,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,oBAAoB,CAAA;AAI9E,eAAO,MAAM,cAAc,2FAA4F,CAAA;AAEvH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IACzD,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,MAAM,EAAE,aAAa,CAAA;IACrB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAMD,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;IAC3B;;;;;OAKG;;IAEH,kDAAkD;;IAElD,mHAAmH;;IAEnH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;IAGH,uBAAuB;;IAEvB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEvB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG2B,CAAA;AA0BnD,8CAA8C;AAC9C,eAAO,MAAM,aAAa;IA3ExB;;;;;OAKG;;IAEH,kDAAkD;;IAElD,mHAAmH;;IAEnH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;IAGH,uBAAuB;;IAEvB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEvB,sBAAsB;;;;;;IAetB,eAAe;;IAEf,qBAAqB;;IAErB,kDAAkD;;IAElD,oCAAoC;;IAEpC,uDAAuD;;IAEvD,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK6C,CAAA;AAE9G,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA"}
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../src/entities/spec/requests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,oBAAoB,CAAA;AAI9E,eAAO,MAAM,cAAc,2FAA4F,CAAA;AAEvH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IACzD,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,MAAM,EAAE,aAAa,CAAA;IACrB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAMD,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;IAC3B;;;;;OAKG;;IAEH,kDAAkD;;IAElD,mHAAmH;;IAEnH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;IAGH,uBAAuB;;IAEvB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEvB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG2B,CAAA;AAyCnD,8CAA8C;AAC9C,eAAO,MAAM,aAAa;IA1FxB;;;;;OAKG;;IAEH,kDAAkD;;IAElD,mHAAmH;;IAEnH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;IAGH,uBAAuB;;IAEvB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEvB,sBAAsB;;;;;;;;IA8BtB,eAAe;;IAEf,qBAAqB;;IAErB,kDAAkD;;IAElD,oCAAoC;;IAEpC,uDAAuD;;IAEvD,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQlC,CAAA;AAE/B,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA"}

package/dist/entities/spec/requests.js

@@ -1,5 +1,6 @@
 import { nanoidSchema, selectedSecuritySchemeUidSchema } from '../shared/utility.js';
 import { z } from 'zod';
+import { XScalarStability } from '@scalar/types';
 import { oasParameterSchema } from './parameters.js';
 import { xScalarExampleSchema } from './request-examples.js';
 import { oasSecurityRequirementSchema } from './security.js';
@@ -58,6 +59,20 @@ const oasRequestSchema = z.object({
     'x-internal': z.boolean().optional(),
     'x-scalar-ignore': z.boolean().optional(),
 });
+/**
+ * An OpenAPI extension to indicate the stability of the operation
+ *
+ * @example
+ * ```yaml
+ * x-scalar-stability: deprecated
+ * ```
+ */
+const ScalarStabilitySchema = z.object({
+    'x-scalar-stability': z
+        .enum([XScalarStability.Deprecated, XScalarStability.Experimental, XScalarStability.Stable])
+        .optional()
+        .catch(undefined),
+});
 /**
  * Extended properties added to the spec definition for client usage
  *
@@ -82,6 +97,9 @@ const extendedRequestSchema = z.object({
     selectedSecuritySchemeUids: selectedSecuritySchemeUidSchema,
 });
 /** Unified request schema for client usage */
-const requestSchema = oasRequestSchema.omit({ 'x-scalar-examples': true }).merge(extendedRequestSchema);
+const requestSchema = oasRequestSchema
+    .omit({ 'x-scalar-examples': true })
+    .merge(ScalarStabilitySchema)
+    .merge(extendedRequestSchema);
 
 export { oasRequestSchema, requestMethods, requestSchema };

package/dist/entities/workspace/workspace.d.ts

@@ -36,13 +36,13 @@ export declare const workspaceSchema: z.ZodObject<{
         }>>>;
     }, "strip", z.ZodTypeAny, {
         modifiers: ("Meta" | "Control" | "Shift" | "Alt" | "default")[];
-        hotKeys?: Partial<Record<"" | "/" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
+        hotKeys?: Partial<Record<"" | "/" | "0" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
             event: "addTopNav" | "closeModal" | "closeTopNav" | "createNew" | "executeRequest" | "focusAddressBar" | "focusRequestSearch" | "jumpToLastTab" | "jumpToTab" | "navigateSearchResultsDown" | "navigateSearchResultsUp" | "navigateTopNavLeft" | "navigateTopNavRight" | "openCommandPalette" | "selectSearchResult" | "toggleSidebar";
             modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default")[] | undefined;
         }>> | undefined;
     }, {
         modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default" | undefined)[] | undefined;
-        hotKeys?: Partial<Record<"" | "/" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
+        hotKeys?: Partial<Record<"" | "/" | "0" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
             event: "addTopNav" | "closeModal" | "closeTopNav" | "createNew" | "executeRequest" | "focusAddressBar" | "focusRequestSearch" | "jumpToLastTab" | "jumpToTab" | "navigateSearchResultsDown" | "navigateSearchResultsUp" | "navigateTopNavLeft" | "navigateTopNavRight" | "openCommandPalette" | "selectSearchResult" | "toggleSidebar";
             modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default" | undefined)[] | undefined;
         }>> | undefined;
@@ -54,7 +54,7 @@ export declare const workspaceSchema: z.ZodObject<{
     /** Workspace level proxy for all requests to be sent through */
     proxyUrl: z.ZodOptional<z.ZodString>;
     /** Workspace level theme, we might move this to user level later */
-    themeId: z.ZodDefault<z.ZodOptional<z.ZodEnum<["alternate", "default", "moon", "purple", "solarized", "bluePlanet", "deepSpace", "saturn", "kepler", "elysiajs", "fastify", "mars", "none"]>>>;
+    themeId: z.ZodCatch<z.ZodDefault<z.ZodOptional<z.ZodEnum<["alternate", "default", "moon", "purple", "solarized", "bluePlanet", "deepSpace", "saturn", "kepler", "elysiajs", "fastify", "mars", "none"]>>>>;
     /** Currently selected snippet client */
     selectedHttpClient: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         targetKey: z.ZodString;
@@ -81,7 +81,7 @@ export declare const workspaceSchema: z.ZodObject<{
     };
     hotKeyConfig?: {
         modifiers: ("Meta" | "Control" | "Shift" | "Alt" | "default")[];
-        hotKeys?: Partial<Record<"" | "/" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
+        hotKeys?: Partial<Record<"" | "/" | "0" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
             event: "addTopNav" | "closeModal" | "closeTopNav" | "createNew" | "executeRequest" | "focusAddressBar" | "focusRequestSearch" | "jumpToLastTab" | "jumpToTab" | "navigateSearchResultsDown" | "navigateSearchResultsUp" | "navigateTopNavLeft" | "navigateTopNavRight" | "openCommandPalette" | "selectSearchResult" | "toggleSidebar";
             modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default")[] | undefined;
         }>> | undefined;
@@ -95,7 +95,7 @@ export declare const workspaceSchema: z.ZodObject<{
     environments?: Record<string, string> | undefined;
     hotKeyConfig?: {
         modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default" | undefined)[] | undefined;
-        hotKeys?: Partial<Record<"" | "/" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
+        hotKeys?: Partial<Record<"" | "/" | "0" | "Space" | "Backspace" | "Tab" | "Enter" | "Escape" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "End" | "Home" | "PageDown" | "PageUp" | "Delete" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "*" | "+" | "-" | "." | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12" | ";" | "=" | "," | "`" | "[" | "\\" | "]", {
             event: "addTopNav" | "closeModal" | "closeTopNav" | "createNew" | "executeRequest" | "focusAddressBar" | "focusRequestSearch" | "jumpToLastTab" | "jumpToTab" | "navigateSearchResultsDown" | "navigateSearchResultsUp" | "navigateTopNavLeft" | "navigateTopNavRight" | "openCommandPalette" | "selectSearchResult" | "toggleSidebar";
             modifiers?: ("Meta" | "Control" | "Shift" | "Alt" | "default" | undefined)[] | undefined;
         }>> | undefined;
@@ -103,7 +103,7 @@ export declare const workspaceSchema: z.ZodObject<{
     activeEnvironmentId?: string | undefined;
     cookies?: string[] | undefined;
     proxyUrl?: string | undefined;
-    themeId?: "default" | "alternate" | "moon" | "purple" | "solarized" | "bluePlanet" | "deepSpace" | "saturn" | "kepler" | "elysiajs" | "fastify" | "mars" | "none" | undefined;
+    themeId?: unknown;
     selectedHttpClient?: {
         targetKey: string;
         clientKey: string;

package/dist/entities/workspace/workspace.js

@@ -36,7 +36,7 @@ const workspaceSchema = z.object({
     /** Workspace level proxy for all requests to be sent through */
     proxyUrl: z.string().optional(),
     /** Workspace level theme, we might move this to user level later */
-    themeId: z.enum(themeIds).optional().default('default'),
+    themeId: z.enum(themeIds).optional().default('default').catch('default'),
     /** Currently selected snippet client */
     selectedHttpClient: z
         .object({

package/dist/helpers/normalizeMimeType.d.ts

@@ -1,9 +1,8 @@
-import type { ContentType } from '@scalar/types/legacy';
 /**
  * Normalizes a MIME type to a standard format.
  *
  * Input: application/problem+json; charset=utf-8
  * Output: application/json
  */
-export declare function normalizeMimeType(contentType?: string): ContentType | undefined;
+export declare function normalizeMimeType(contentType?: string): `application/json${string}` | `application/xml${string}` | `text/plain${string}` | `text/html${string}` | `application/octet-stream${string}` | `application/x-www-form-urlencoded${string}` | `multipart/form-data${string}` | `*/*${string}` | `application/vnd.${string}+json${string}` | undefined;
 //# sourceMappingURL=normalizeMimeType.d.ts.map

package/dist/helpers/normalizeMimeType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeMimeType.d.ts","sourceRoot":"","sources":["../../src/helpers/normalizeMimeType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,2BAcrD"}
+{"version":3,"file":"normalizeMimeType.d.ts","sourceRoot":"","sources":["../../src/helpers/normalizeMimeType.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,0SAcrD"}

package/dist/helpers/normalizeMimeType.js

@@ -11,8 +11,8 @@ function normalizeMimeType(contentType) {
     return contentType
         // Remove '; charset=utf-8'
         .replace(/;.*$/, '')
-        // Remove 'problem+'
-        .replace(/\/.+\+/, '/')
+        // Remove 'problem+' but keep vendor-specific vnd and fhir mime types
+        .replace(/\/(?!.*vnd\.|fhir\+).*\+/, '/')
         // Remove whitespace
         .trim();
 }

package/dist/helpers/normalizeMimeTypeObject.d.ts

@@ -13,5 +13,7 @@ export declare function normalizeMimeTypeObject(content?: Record<ContentType, an
     [x: `application/x-www-form-urlencoded${string}`]: any;
     [x: `multipart/form-data${string}`]: any;
     [x: `*/*${string}`]: any;
+    [x: `application/vnd.${string}+jsonnull`]: any;
+    [x: `application/vnd.${string}+json${string}`]: any;
 } | undefined;
 //# sourceMappingURL=normalizeMimeTypeObject.d.ts.map

package/dist/helpers/normalizeMimeTypeObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeMimeTypeObject.d.ts","sourceRoot":"","sources":["../../src/helpers/normalizeMimeTypeObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;;;;;;;;;cA8BzE"}
+{"version":3,"file":"normalizeMimeTypeObject.d.ts","sourceRoot":"","sources":["../../src/helpers/normalizeMimeTypeObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;;;;;;;;;;;cA8BzE"}

package/dist/spec-getters/getRequestBodyFromOperation.d.ts

@@ -1,15 +1,13 @@
-import type { TransformedOperation } from '@scalar/types/legacy';
-declare const mimeTypes: readonly ["application/json", "application/octet-stream", "application/x-www-form-urlencoded", "application/xml", "multipart/form-data", "text/plain"];
+import type { ContentType, TransformedOperation } from '@scalar/types/legacy';
 /**
  * Get the request body from the operation.
  */
 export declare function getRequestBodyFromOperation(operation: Omit<TransformedOperation, 'httpVerb'>, selectedExampleKey?: string | number, omitEmptyAndOptionalProperties?: boolean): {
-    mimeType: (typeof mimeTypes)[number];
+    mimeType: ContentType;
     text?: string;
     params?: {
         name: string;
         value?: string;
     }[];
 } | null;
-export {};
 //# sourceMappingURL=getRequestBodyFromOperation.d.ts.map

package/dist/spec-getters/getRequestBodyFromOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRequestBodyFromOperation.d.ts","sourceRoot":"","sources":["../../src/spec-getters/getRequestBodyFromOperation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAgC7E,QAAA,MAAM,SAAS,wJAOL,CAAA;AAEV;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,EACjD,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,EACpC,8BAA8B,CAAC,EAAE,OAAO,GACvC;IACD,QAAQ,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;CACJ,GAAG,IAAI,CAgKP"}
+{"version":3,"file":"getRequestBodyFromOperation.d.ts","sourceRoot":"","sources":["../../src/spec-getters/getRequestBodyFromOperation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAyC7E;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,EACjD,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,EACpC,8BAA8B,CAAC,EAAE,OAAO,GACvC;IACD,QAAQ,EAAE,WAAW,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;CACJ,GAAG,IAAI,CA+JP"}

package/dist/spec-getters/getRequestBodyFromOperation.js

@@ -17,8 +17,8 @@ function getParamsFromObject(obj, prefix = '') {
         return [{ name: newKey, value }];
     });
 }
-// Define all supported mime types
-const mimeTypes = [
+// Define preferred standard mime types (order indicates preference)
+const standardMimeTypes = [
     'application/json',
     'application/octet-stream',
     'application/x-www-form-urlencoded',
@@ -30,20 +30,17 @@ const mimeTypes = [
  * Get the request body from the operation.
  */
 function getRequestBodyFromOperation(operation, selectedExampleKey, omitEmptyAndOptionalProperties) {
-    // Get the content object from the operation
     const originalContent = operation.information?.requestBody?.content;
     const content = normalizeMimeTypeObject(originalContent);
-    /**
-     *  Find the first mime type that is supported
-     *
-     * TODO: This is very fragile. There needs to be significantly more support for
-     * vendor specific content types (like application/vnd.github+json)
-     */
-    const mimeType = mimeTypes.find((currentMimeType) => !!content?.[currentMimeType]) ?? 'application/json';
+    // First try to find a standard mime type
+    const mimeType = standardMimeTypes.find((currentMimeType) => !!content?.[currentMimeType]) ??
+        (Object.keys(content ?? {})[0] || 'application/json');
+    // Handle JSON-like content types (e.g., application/vnd.github+json)
+    const isJsonLike = mimeType.includes('json') || mimeType.endsWith('+json');
     /** Examples */
     const examples = content?.[mimeType]?.examples ?? content?.['application/json']?.examples;
     // Let’s use the first example
-    const selectedExample = (examples ?? {})?.[selectedExampleKey ?? Object.keys(examples ?? {})[0]];
+    const selectedExample = examples?.[selectedExampleKey ?? Object.keys(examples ?? {})[0]];
     if (selectedExample) {
         return {
             mimeType,
@@ -68,7 +65,7 @@ function getRequestBodyFromOperation(operation, selectedExampleKey, omitEmptyAnd
     /**
      * FormData Parameters (Swagger 2.0)
      *
-     * “Form - Used to describe the payload of an HTTP request when either application/x-www-form-urlencoded,
+     * ”Form - Used to describe the payload of an HTTP request when either application/x-www-form-urlencoded,
      * multipart/form-data or both are used as the content type of the request (in Swagger's definition, the
      * consumes property of an operation). This is the only parameter type that can be used to send files,
      * thus supporting the file type. Since form parameters are sent in the payload, they cannot be declared
@@ -105,8 +102,8 @@ function getRequestBodyFromOperation(operation, selectedExampleKey, omitEmptyAnd
     const requestBodyObject = content?.[mimeType];
     // Get example from operation
     const example = requestBodyObject?.example ? requestBodyObject?.example : undefined;
-    // JSON
-    if (mimeType === 'application/json') {
+    // Update the JSON handling section
+    if (isJsonLike) {
         const exampleFromSchema = requestBodyObject?.schema
             ? getExampleFromSchema(requestBodyObject?.schema, {
                 mode: 'write',

package/dist/transforms/import-spec.d.ts

@@ -2,7 +2,7 @@ import type { SelectedSecuritySchemeUids } from '../entities/shared/utility.js';
 import { type Collection, type CollectionPayload, type Request, type RequestExample, type Server, type Tag } from '../entities/spec/index.js';
 import { type SecurityScheme } from '../entities/spec/security.js';
 import type { OpenAPIV3_1 } from '@scalar/openapi-types';
-import type { ReferenceConfiguration } from '@scalar/types/legacy';
+import type { ApiReferenceConfiguration } from '@scalar/types/api-reference';
 import type { UnknownObject } from '@scalar/types/utils';
 /** Takes a string or object and parses it into an openapi spec compliant schema */
 export declare const parseSchema: (spec: string | UnknownObject, { shouldLoad }?: {
@@ -17,7 +17,7 @@ export declare const parseSchema: (spec: string | UnknownObject, { shouldLoad }?
 }>;
 /** Converts selected security requirements to uids */
 export declare const getSelectedSecuritySchemeUids: (securityRequirements: (string | string[])[], preferredSecurityNames: (string | string[])[] | undefined, securitySchemeMap: Record<string, SecurityScheme["uid"]>) => SelectedSecuritySchemeUids;
-export type ImportSpecToWorkspaceArgs = Pick<CollectionPayload, 'documentUrl' | 'watchMode'> & Pick<ReferenceConfiguration, 'authentication' | 'baseServerURL' | 'servers'> & {
+export type ImportSpecToWorkspaceArgs = Pick<CollectionPayload, 'documentUrl' | 'watchMode'> & Pick<ApiReferenceConfiguration, 'authentication' | 'baseServerURL' | 'servers'> & {
     /** Sets the preferred security scheme on the collection instead of the requests */
     setCollectionSecurity?: boolean;
     /** Call the load step from the parser */
@@ -53,5 +53,5 @@ export declare function importSpecToWorkspace(spec: string | UnknownObject, { au
 /**
  * Retrieves a list of servers from an OpenAPI document and converts them to a list of Server entities.
  */
-export declare function getServersFromOpenApiDocument(servers: OpenAPIV3_1.ServerObject[] | undefined, { baseServerURL }?: Pick<ReferenceConfiguration, 'baseServerURL'>): Server[];
+export declare function getServersFromOpenApiDocument(servers: OpenAPIV3_1.ServerObject[] | undefined, { baseServerURL }?: Pick<ApiReferenceConfiguration, 'baseServerURL'>): Server[];
 //# sourceMappingURL=import-spec.d.ts.map

package/dist/transforms/import-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-spec.d.ts","sourceRoot":"","sources":["../../src/transforms/import-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,cAAc,EAGnB,KAAK,MAAM,EACX,KAAK,GAAG,EAMT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,0BAA0B,CAAA;AAMjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,mFAAmF;AACnF,eAAO,MAAM,WAAW,SAAgB,MAAM,GAAG,aAAa;;;IAkC1D;;;OAGG;YAC8C,WAAW,CAAC,QAAQ;;EAGxE,CAAA;AAED,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,yBAClB,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,0BACnB,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,iCAC1B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,KACvD,0BAWF,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,WAAW,CAAC,GAC1F,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAAC,GAAG;IAC7E,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,GAAG,aAAa,EAC5B,EACE,cAAc,EACd,aAAa,EACb,WAAW,EACX,OAAO,EAAE,iBAAiB,EAC1B,qBAA6B,EAC7B,UAAU,EACV,SAAiB,GAClB,GAAE,yBAA8B,GAChC,OAAO,CACN;IACE,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAA;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC,GACD;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,SAAS,CAAA;CAAE,CACnE,CA8TA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,GAAG,SAAS,EAC/C,EAAE,aAAa,EAAE,GAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,CAAM,GACpE,MAAM,EAAE,CAwCV"}
+{"version":3,"file":"import-spec.d.ts","sourceRoot":"","sources":["../../src/transforms/import-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,cAAc,EAGnB,KAAK,MAAM,EACX,KAAK,GAAG,EAMT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,0BAA0B,CAAA;AAMjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,mFAAmF;AACnF,eAAO,MAAM,WAAW,SAAgB,MAAM,GAAG,aAAa;;;IAkC1D;;;OAGG;YAC8C,WAAW,CAAC,QAAQ;;EAGxE,CAAA;AAED,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,yBAClB,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,0BACnB,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,iCAC1B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,KACvD,0BAWF,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,WAAW,CAAC,GAC1F,IAAI,CAAC,yBAAyB,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAAC,GAAG;IAChF,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,GAAG,aAAa,EAC5B,EACE,cAAc,EACd,aAAa,EACb,WAAW,EACX,OAAO,EAAE,iBAAiB,EAC1B,qBAA6B,EAC7B,UAAU,EACV,SAAiB,GAClB,GAAE,yBAA8B,GAChC,OAAO,CACN;IACE,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAA;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC,GACD;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,SAAS,CAAA;CAAE,CACnE,CA8TA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,GAAG,SAAS,EAC/C,EAAE,aAAa,EAAE,GAAE,IAAI,CAAC,yBAAyB,EAAE,eAAe,CAAM,GACvE,MAAM,EAAE,CAwCV"}

package/package.json

@@ -16,7 +16,7 @@
     "specification",
     "yaml"
   ],
-  "version": "0.2.110",
+  "version": "0.2.113",
   "engines": {
     "node": ">=18"
   },
@@ -127,18 +127,18 @@
     "yaml": "^2.4.5",
     "zod": "^3.23.8",
     "@scalar/object-utils": "1.1.13",
-    "@scalar/themes": "0.9.71",
+    "@scalar/themes": "0.9.74",
     "@scalar/openapi-types": "0.1.9",
-    "@scalar/types": "0.0.36"
+    "@scalar/types": "0.0.39"
   },
   "devDependencies": {
     "type-fest": "^4.20.0",
     "vite": "^5.4.10",
     "vitest": "^1.6.0",
     "zod-to-ts": "github:amritk/zod-to-ts#build",
-    "@scalar/build-tooling": "0.1.15",
-    "@scalar/openapi-types": "0.1.9",
-    "@scalar/openapi-parser": "0.10.9"
+    "@scalar/build-tooling": "0.1.16",
+    "@scalar/openapi-parser": "0.10.9",
+    "@scalar/openapi-types": "0.1.9"
   },
   "scripts": {
     "build": "scalar-build-rollup",