@scalar/workspace-store 0.59.0 → 0.61.0

package/dist/mutators/operation/helpers/fetch-request-to-har.js

@@ -45,7 +45,7 @@ export const fetchRequestToHar = async ({ requestPayload, includeBody = true, ht
     // Read the request body if requested
     const bodyDetails = await (async () => {
         if (includeBody && requestInit.body != null) {
-            const details = await processRequestBody(requestInit.body, mimeType);
+            const details = await processRequestBody(requestInit.body, _headers.get('content-type') ?? mimeType, bodySizeLimit);
             if (details.size <= bodySizeLimit) {
                 return details;
             }
@@ -80,7 +80,17 @@ export const fetchRequestToHar = async ({ requestPayload, includeBody = true, ht
  * Because we own the RequestInit tuple we can inspect the body by type directly —
  * no stream cloning or header sniffing required.
  */
-const processRequestBody = async (body, contentType) => {
+const processRequestBody = async (body, contentType, bodySizeLimit) => {
+    if (body instanceof Blob && contentType.toLowerCase().startsWith('multipart/form-data;')) {
+        if (body.size > bodySizeLimit) {
+            return { text: '', size: -1 };
+        }
+        // Raw uploads can contain malformed multipart data. History must still record the response.
+        const form = await new Response(body, { headers: { 'content-type': contentType } })
+            .formData()
+            .catch(() => undefined);
+        return form ? { ...extractFormDataParams(form), size: body.size } : { text: '', size: -1 };
+    }
     // Structured form payloads become a params array so HAR viewers can render them as key/value tables
     if (body instanceof FormData) {
         return extractFormDataParams(body);

package/dist/mutators/operation/helpers/har-to-operation.d.ts

@@ -1,5 +1,5 @@
 import type { HarRequest } from '@scalar/snippetz';
-import type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { OperationObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
 type HarToOperationProps = {
     /** HAR request to convert */
     harRequest: HarRequest;

package/dist/mutators/operation/helpers/har-to-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"har-to-operation.d.ts","sourceRoot":"","sources":["../../../../src/mutators/operation/helpers/har-to-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AAKpH,KAAK,mBAAmB,GAAG;IACzB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,2DAK5B,mBAAmB,KAAG,eAyHxB,CAAA"}
+{"version":3,"file":"har-to-operation.d.ts","sourceRoot":"","sources":["../../../../src/mutators/operation/helpers/har-to-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AAKpH,KAAK,mBAAmB,GAAG;IACzB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,2DAK5B,mBAAmB,KAAG,eA0HxB,CAAA"}

package/dist/mutators/operation/helpers/har-to-operation.js

@@ -1,12 +1,12 @@
 import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref';
-import { isContentTypeParameterObject } from '../../../schemas/v3.1/strict/type-guards.js';
+import { isContentTypeParameterObject } from '../../../schemas/v3.2/strict/type-guards.js';
 const preprocessParameters = (parameters, pathVariables, exampleKey) => {
     parameters.forEach((param) => {
         const resolvedParam = getResolvedRef(param);
-        if (isContentTypeParameterObject(resolvedParam)) {
+        if (!resolvedParam || isContentTypeParameterObject(resolvedParam)) {
             return;
         }
-        setParameterDisabled(getResolvedRef(param), exampleKey, true);
+        setParameterDisabled(resolvedParam, exampleKey, true);
         if (resolvedParam.in === 'path') {
             resolvedParam.examples ||= {};
             resolvedParam.examples[exampleKey] = {
@@ -98,6 +98,8 @@ export const harToOperation = ({ harRequest, exampleKey, baseOperation = {}, pat
         }
         // Resolve the request body in case it is a reference
         const requestBody = getResolvedRef(baseOperation.requestBody);
+        if (!requestBody)
+            return baseOperation;
         // Ensure the content type exists in the requestBody
         if (!requestBody.content[mimeType]) {
             requestBody.content[mimeType] = {
@@ -147,7 +149,9 @@ const setParameterDisabled = (param, exampleKey, disabled) => {
     if (!param.examples?.[exampleKey]) {
         return;
     }
-    getResolvedRef(param.examples[exampleKey])['x-disabled'] = disabled;
+    const example = getResolvedRef(param.examples[exampleKey]);
+    if (example)
+        example['x-disabled'] = disabled;
 };
 /**
  * Finds an existing parameter in the parameters array or creates a new one.
@@ -157,7 +161,7 @@ const findOrCreateParameter = (parameters, name, inValue) => {
     // Try to find existing parameter using getResolvedRef to handle references
     for (const param of parameters) {
         const resolved = getResolvedRef(param);
-        if (isContentTypeParameterObject(resolved)) {
+        if (!resolved || isContentTypeParameterObject(resolved)) {
             continue;
         }
         // Check if parameter location matches

package/dist/mutators/operation/helpers/sync-path-parameters.d.ts

@@ -1,5 +1,5 @@
-import type { ParameterObject } from '../../../schemas/v3.1/strict/parameter.js';
-import type { ReferenceType } from '../../../schemas/v3.1/strict/reference.js';
+import type { ParameterObject } from '../../../schemas/v3.2/strict/parameter.js';
+import type { ReferenceType } from '../../../schemas/v3.2/strict/reference.js';
 export type MinimalParameterObject = Pick<ParameterObject, 'name' | 'in'>;
 /**
  * Synchronizes path parameters when a path string changes.

package/dist/mutators/operation/history.js

@@ -1,7 +1,7 @@
 import { getPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
 import { isOpenApiDocument } from '../../schemas/type-guards.js';
-import { isContentTypeParameterObject } from '../../schemas/v3.1/strict/type-guards.js';
+import { isContentTypeParameterObject } from '../../schemas/v3.2/strict/type-guards.js';
 import { fetchRequestToHar } from './helpers/fetch-request-to-har.js';
 import { fetchResponseToHar } from './helpers/fetch-response-to-har.js';
 import { harToOperation } from './helpers/har-to-operation.js';
@@ -21,7 +21,7 @@ export const addResponseToHistory = async (store, document, { payload, meta }) =
     // Get all the variables from the operation parameters
     const variables = operationParameters.reduce((acc, param) => {
         const resolvedParam = getResolvedRef(param);
-        if (isContentTypeParameterObject(resolvedParam)) {
+        if (!resolvedParam || isContentTypeParameterObject(resolvedParam)) {
             return acc;
         }
         if (resolvedParam.in === 'path') {

package/dist/mutators/operation/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAarE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SA0DX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,uBAAuB,CAAC,SAsB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,mEAAmE,eAAe,CAAC,6BAA6B,CAAC,KAChH,IAoGF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAiDlG,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,+DAA+D,eAAe,CAAC,0BAA0B,CAAC,SAuE3G,CAAA"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAarE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SA0DX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,uBAAuB,CAAC,SAsB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,mEAAmE,eAAe,CAAC,6BAA6B,CAAC,KAChH,IAoGF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAkDlG,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,+DAA+D,eAAe,CAAC,0BAA0B,CAAC,SAwE3G,CAAA"}

package/dist/mutators/operation/operation.js

@@ -277,6 +277,8 @@ export const deleteOperationExample = (workspace, { meta: { path, method, exampl
     // Remove the example from all operation parameters
     operation.parameters?.forEach((parameter) => {
         const resolvedParameter = getResolvedRef(parameter);
+        if (!resolvedParameter)
+            return;
         // Remove from content-level examples (if parameter uses content)
         if ('content' in resolvedParameter && resolvedParameter.content) {
             Object.values(resolvedParameter.content).forEach((mediaType) => {
@@ -326,6 +328,8 @@ export const renameOperationExample = (workspace, { meta: { path, method, exampl
     const records = [];
     operation.parameters?.forEach((parameter) => {
         const resolvedParameter = getResolvedRef(parameter);
+        if (!resolvedParameter)
+            return;
         if ('examples' in resolvedParameter && resolvedParameter.examples) {
             records.push(resolvedParameter.examples);
         }

package/dist/mutators/operation/parameters.js

@@ -193,5 +193,5 @@ export const deleteAllOperationParameters = (document, { meta, type }) => {
         return;
     }
     // Filter out parameters of the specified type
-    operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== type) ?? [];
+    operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it)?.in !== type) ?? [];
 };

package/dist/mutators/server.d.ts

@@ -1,6 +1,6 @@
 import type { AsyncApiServerVariableObject } from '@scalar/types/asyncapi/3.1';
 import type { ServerEvents } from '../events/definitions/server.js';
-import { type ServerObject } from '../schemas/v3.1/strict/openapi-document.js';
+import { type ServerObject } from '../schemas/v3.2/strict/openapi-document.js';
 import type { WorkspaceDocument } from '../schemas/workspace.js';
 /**
  * Initializes the servers for the document or operation based on meta.
@@ -53,7 +53,7 @@ export declare const clearServers: (document: WorkspaceDocument | null, { meta }
  * @param meta - Target context (document or operation)
  * @returns the updated variable or undefined if the variable is not found
  */
-export declare const updateServerVariables: (document: WorkspaceDocument | null, { index, key, value, meta }: ServerEvents["server:update:variables"]) => import("../schemas/v3.1/strict/openapi-document.js").ServerVariableObject | undefined;
+export declare const updateServerVariables: (document: WorkspaceDocument | null, { index, key, value, meta }: ServerEvents["server:update:variables"]) => import("../schemas/v3.2/strict/openapi-document.js").ServerVariableObject | undefined;
 /**
  * Updates the selected server for the document or operation based on meta.
  *
@@ -94,7 +94,7 @@ export declare const serverMutatorsFactory: ({ document }: {
     updateServer: (payload: ServerEvents["server:update:server"]) => ServerObject | undefined;
     deleteServer: (payload: ServerEvents["server:delete:server"]) => void;
     clearServers: (payload: ServerEvents["server:clear:servers"]) => void;
-    updateServerVariables: (payload: ServerEvents["server:update:variables"]) => import("../schemas/v3.1/strict/openapi-document.js").ServerVariableObject | undefined;
+    updateServerVariables: (payload: ServerEvents["server:update:variables"]) => import("../schemas/v3.2/strict/openapi-document.js").ServerVariableObject | undefined;
     updateSelectedServer: (payload: ServerEvents["server:update:selected"]) => string | undefined;
     updateSelectedAsyncApiServer: (payload: ServerEvents["asyncapi-server:update:selected"]) => string | undefined;
     updateAsyncApiServerVariables: (payload: ServerEvents["asyncapi-server:update:variables"]) => AsyncApiServerVariableObject | undefined;

package/dist/mutators/server.js

@@ -4,7 +4,7 @@ import { getResolvedRef } from '../helpers/get-resolved-ref.js';
 import { unpackProxyObject } from '../helpers/unpack-proxy.js';
 import { isAsyncApiDocument, isOpenApiDocument } from '../schemas/type-guards.js';
 import { coerceValue } from '../schemas/typebox-coerce.js';
-import { ServerObjectSchema } from '../schemas/v3.1/strict/openapi-document.js';
+import { ServerObjectSchema } from '../schemas/v3.2/strict/openapi-document.js';
 /**
  * Resolves the server target (document or operation) from meta.
  * Document-level servers live on the document; operation-level servers on the operation object.

package/dist/mutators/tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/mutators/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AASzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAe3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,cAAc,CAAC,SAqEvF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SA+B/F,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE;yBAErD,SAAS,CAAC,gBAAgB,CAAC;uBAC7B,SAAS,CAAC,cAAc,CAAC;yBACvB,SAAS,CAAC,gBAAgB,CAAC;CAEnD,CAAA"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/mutators/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AASzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAe3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,cAAc,CAAC,SAqEvF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAiC/F,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE;yBAErD,SAAS,CAAC,gBAAgB,CAAC;uBAC7B,SAAS,CAAC,cAAc,CAAC;yBACvB,SAAS,CAAC,gBAAgB,CAAC;CAEnD,CAAA"}

package/dist/mutators/tag.js

@@ -112,6 +112,8 @@ export const deleteTag = (workspace, payload) => {
     Object.values(document.paths ?? {}).forEach((pathItemRef) => {
         forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
             const resolvedOperation = getResolvedRef(operationRef);
+            if (!resolvedOperation)
+                return;
             if ('tags' in resolvedOperation) {
                 const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
                 resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
@@ -122,6 +124,8 @@ export const deleteTag = (workspace, payload) => {
     Object.values(document.webhooks ?? {}).forEach((pathItemRef) => {
         forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
             const resolvedOperation = getResolvedRef(operationRef);
+            if (!resolvedOperation)
+                return;
             const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
             resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
         });

package/dist/navigation/helpers/get-openapi-object.d.ts

@@ -1,7 +1,7 @@
 import type { WorkspaceStore } from '../../client.js';
 import type { WorkspaceDocument } from '../../schemas.js';
 import type { TraversedDocument, TraversedEntry, TraversedOperation, TraversedTag } from '../../schemas/navigation.js';
-import type { OperationObject, TagObject } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OperationObject, TagObject } from '../../schemas/v3.2/strict/openapi-document.js';
 type TraversedOrderable = TraversedDocument | TraversedTag | TraversedOperation;
 type GetOpenapiObject<Entry extends TraversedOrderable> = Entry extends TraversedDocument ? WorkspaceDocument : Entry extends TraversedTag ? TagObject : Entry extends TraversedOperation ? OperationObject : never;
 /** Type guard which checks if the entry has an x-scalar-order property */

package/dist/navigation/helpers/traverse-asyncapi-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-asyncapi-document.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-asyncapi-document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,gBAAgB,EAA2B,MAAM,4BAA4B,CAAA;AAKlH,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,qCAAqC,CAAA;AAOlG,OAAO,KAAK,EAKV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAM7B,oFAAoF;AACpF,KAAK,wCAAwC,GAAG,gBAAgB,GAAG;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAkiBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,EACpB,UAAU,wCAAwC,EAClD,UAAU,iBAAiB,KAC1B,iBA+HF,CAAA"}
+{"version":3,"file":"traverse-asyncapi-document.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-asyncapi-document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,gBAAgB,EAA2B,MAAM,4BAA4B,CAAA;AAKlH,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,qCAAqC,CAAA;AAOlG,OAAO,KAAK,EAKV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAM7B,oFAAoF;AACpF,KAAK,wCAAwC,GAAG,gBAAgB,GAAG;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAiiBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,EACpB,UAAU,wCAAwC,EAClD,UAAU,iBAAiB,KAC1B,iBA+HF,CAAA"}

package/dist/navigation/helpers/traverse-asyncapi-document.js

@@ -236,8 +236,8 @@ const createChannelEntry = ({ bucket, operationEntries, generateId, parentId, pa
     // We skip channels that are stored as references, since the order should live on the target.
     const channelNode = document.channels?.[bucket.channelName];
     if (channelNode && !('$ref' in channelNode)) {
-        ;
-        channelNode['x-scalar-order'] = operations.map((child) => child.id);
+        const orderedChannel = channelNode;
+        orderedChannel['x-scalar-order'] = operations.map((child) => child.id);
     }
     return {
         type: 'asyncapi-channel',

package/dist/navigation/helpers/traverse-description.d.ts

@@ -1,7 +1,7 @@
 import type { AsyncApiInfoObject } from '@scalar/types/asyncapi/3.1';
 import type { TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedDescription } from '../../schemas/navigation.js';
-import type { InfoObject } from '../../schemas/v3.1/strict/info.js';
+import type { InfoObject } from '../../schemas/v3.2/strict/info.js';
 /**
  * Creates a hierarchical navigation structure from markdown headings in an OpenAPI or AsyncAPI description.
  *

package/dist/navigation/helpers/traverse-document.d.ts

@@ -1,6 +1,6 @@
 import { type NavigationOptions } from '../../navigation/get-navigation-options.js';
 import type { TraversedEntry } from '../../schemas/navigation.js';
-import type { OpenApiDocument } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OpenApiDocument } from '../../schemas/v3.2/strict/openapi-document.js';
 /**
  * Traverses an OpenAPI Document to generate navigation structure and metadata.
  *

package/dist/navigation/helpers/traverse-examples.d.ts

@@ -1,8 +1,19 @@
-import type { OperationObject } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OperationObject } from '../../schemas/v3.2/strict/openapi-document.js';
 /**
  * Traverse the OpenAPI operation object and extract all example values.
  *
  * @param operation - The OpenAPI operation object to extract examples from
  */
 export declare const traverseOperationExamples: (operation: OperationObject) => string[];
+/**
+ * Build an example key that does not collide with any example the operation already has.
+ *
+ * Draft examples are stored in a `Set`, so reusing an existing key silently no-ops instead of
+ * creating a new entry. Callers that generate examples on the user's behalf (rather than asking
+ * for a name) use this to keep every click producing a fresh example.
+ *
+ * The base name is returned untouched when it is still free, otherwise a numeric suffix is added:
+ * `Generated`, `Generated (2)`, `Generated (3)`, ...
+ */
+export declare const getUniqueExampleName: (operation: OperationObject, baseName: string) => string;
 //# sourceMappingURL=traverse-examples.d.ts.map

package/dist/navigation/helpers/traverse-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-examples.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-examples.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,eAAe,aAqCnE,CAAA"}
+{"version":3,"file":"traverse-examples.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-examples.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,eAAe,aAqCnE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,eAAe,EAAE,UAAU,MAAM,KAAG,MAanF,CAAA"}

package/dist/navigation/helpers/traverse-examples.js

@@ -10,7 +10,7 @@ export const traverseOperationExamples = (operation) => {
     // Add all examples from request bodies
     if (operation.requestBody) {
         const requestBody = getResolvedRef(operation.requestBody);
-        Object.values(requestBody.content ?? {}).forEach((mediaType) => {
+        Object.values(requestBody?.content ?? {}).forEach((mediaType) => {
             Object.keys(mediaType.examples ?? {}).forEach((key) => {
                 examples.add(key);
             });
@@ -36,3 +36,24 @@ export const traverseOperationExamples = (operation) => {
     }
     return Array.from(examples);
 };
+/**
+ * Build an example key that does not collide with any example the operation already has.
+ *
+ * Draft examples are stored in a `Set`, so reusing an existing key silently no-ops instead of
+ * creating a new entry. Callers that generate examples on the user's behalf (rather than asking
+ * for a name) use this to keep every click producing a fresh example.
+ *
+ * The base name is returned untouched when it is still free, otherwise a numeric suffix is added:
+ * `Generated`, `Generated (2)`, `Generated (3)`, ...
+ */
+export const getUniqueExampleName = (operation, baseName) => {
+    const taken = new Set(traverseOperationExamples(operation));
+    if (!taken.has(baseName)) {
+        return baseName;
+    }
+    let suffix = 2;
+    while (taken.has(`${baseName} (${suffix})`)) {
+        suffix++;
+    }
+    return `${baseName} (${suffix})`;
+};

package/dist/navigation/helpers/traverse-paths.d.ts

@@ -1,6 +1,6 @@
 import type { OperationTitleSource, TagsMap, TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedOperation } from '../../schemas/navigation.js';
-import type { OpenApiDocument, OperationObject } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OpenApiDocument, OperationObject } from '../../schemas/v3.2/strict/openapi-document.js';
 export declare const isDeprecatedOperation: (operation: OperationObject) => boolean;
 /**
  * Traverses the paths in an OpenAPI document to build a map of operations organized by tags.

package/dist/navigation/helpers/traverse-schemas.d.ts

@@ -1,6 +1,6 @@
 import type { TagsMap, TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedSchema } from '../../schemas/navigation.js';
-import type { OpenApiDocument } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OpenApiDocument } from '../../schemas/v3.2/strict/openapi-document.js';
 /** Traverses the schemas in an OpenAPI document to build an array of model entries.
  *
  * This function processes each schema in components.schemas to:

package/dist/navigation/helpers/traverse-tags.d.ts

@@ -1,6 +1,6 @@
 import type { TagsMap, TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedEntry } from '../../schemas/navigation.js';
-import type { OpenApiDocument } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OpenApiDocument } from '../../schemas/v3.2/strict/openapi-document.js';
 type Options = Pick<TraverseSpecOptions, 'tagsSorter' | 'operationsSorter' | 'generateId'>;
 /**
  * Traverses the tags map to create navigation entries, handling nested, grouped and ungrouped tags.

package/dist/navigation/helpers/traverse-webhooks.d.ts

@@ -1,6 +1,6 @@
 import type { TagsMap, TraverseSpecOptions } from '../../navigation/types.js';
 import type { TraversedWebhook } from '../../schemas/navigation.js';
-import type { OpenApiDocument } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { OpenApiDocument } from '../../schemas/v3.2/strict/openapi-document.js';
 /** Traverses the webhooks in an OpenAPI document to build an array of webhook entries.
  *
  * This function processes each webhook in the document to:

package/dist/navigation/helpers/update-order-ids.d.ts

@@ -1,8 +1,8 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { WorkspaceStore } from '../../client.js';
 import type { IdGenerator, TraversedOperation, TraversedTag, TraversedWebhook, WithParent } from '../../schemas/navigation.js';
-import type { TagObject } from '../../schemas/v3.1/strict/openapi-document.js';
-import type { OperationObject } from '../../schemas/v3.1/strict/operation.js';
+import type { TagObject } from '../../schemas/v3.2/strict/openapi-document.js';
+import type { OperationObject } from '../../schemas/v3.2/strict/operation.js';
 type UpdateOrderIdParams = {
     store: WorkspaceStore;
     generateId: IdGenerator;

package/dist/navigation/index.d.ts

@@ -4,5 +4,6 @@ export { getParentEntry } from './helpers/get-parent-entry.js';
 export { type TagEntriesMap, getTagEntries } from './helpers/get-tag-entries.js';
 export { traverseAsyncApiDocument } from './helpers/traverse-asyncapi-document.js';
 export { traverseDocument as createNavigation } from './helpers/traverse-document.js';
+export { getUniqueExampleName } from './helpers/traverse-examples.js';
 export type { TraverseSpecOptions as createNavigationOptions } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClF,YAAY,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,YAAY,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,SAAS,CAAA"}

package/dist/navigation/index.js

@@ -4,3 +4,4 @@ export { getParentEntry } from './helpers/get-parent-entry.js';
 export { getTagEntries } from './helpers/get-tag-entries.js';
 export { traverseAsyncApiDocument } from './helpers/traverse-asyncapi-document.js';
 export { traverseDocument as createNavigation } from './helpers/traverse-document.js';
+export { getUniqueExampleName } from './helpers/traverse-examples.js';

package/dist/navigation/types.d.ts

@@ -1,6 +1,6 @@
 import type { ModelsSectionLabel } from '@scalar/types/api-reference';
 import type { IdGenerator, TraversedEntry } from '../schemas/navigation.js';
-import type { TagObject } from '../schemas/v3.1/strict/openapi-document.js';
+import type { TagObject } from '../schemas/v3.2/strict/openapi-document.js';
 /** Map of tagNames and their entries */
 export type TagsMap = Map<string, {
     id: string;

package/dist/persistence/index.d.ts.map

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

package/dist/persistence/index.js

@@ -194,7 +194,7 @@ export const createWorkspaceStorePersistence = async () => {
              * making it safe to cache and reference across slug renames.
              */
             getItem: async (workspaceUid) => {
-                const workspace = (await workspaceTable.getItem({ workspaceUid }));
+                const workspace = await workspaceTable.getItem({ workspaceUid });
                 if (!workspace) {
                     return undefined;
                 }
@@ -223,7 +223,7 @@ export const createWorkspaceStorePersistence = async () => {
              * including documents and metadata, use `getItem(workspaceUid)`.
              */
             getAll: async () => {
-                return (await workspaceTable.getAll());
+                return await workspaceTable.getAll();
             },
             /**
              * Retrieves all workspaces for a given team UID. Uses the `teamUid`
@@ -233,7 +233,7 @@ export const createWorkspaceStorePersistence = async () => {
              * canonical identifier and survives team-slug renames.
              */
             getAllByTeamUid: async (teamUid) => {
-                return (await workspaceTable.getRange([teamUid], 'teamUid'));
+                return await workspaceTable.getRange([teamUid], 'teamUid');
             },
             /**
              * Retrieves all workspaces for a given team slug. Uses the
@@ -242,7 +242,7 @@ export const createWorkspaceStorePersistence = async () => {
              * `getAllByTeamUid`.
              */
             getAllByTeamSlug: async (teamSlug) => {
-                return (await workspaceTable.getRange([teamSlug], 'teamSlug_slug'));
+                return await workspaceTable.getRange([teamSlug], 'teamSlug_slug');
             },
             /**
              * Saves a workspace and all of its chunks. The caller is responsible
@@ -253,7 +253,7 @@ export const createWorkspaceStorePersistence = async () => {
              * attempting to persist a duplicate pair will reject the transaction.
              */
             setItem: async ({ workspaceUid, teamUid = 'local', teamSlug = 'local', slug, }, value) => {
-                const workspace = (await workspaceTable.addItem({ workspaceUid }, { teamUid, teamSlug, slug, name: value.name }));
+                const workspace = await workspaceTable.addItem({ workspaceUid }, { teamUid, teamSlug, slug, name: value.name });
                 await metaTable.addItem({ workspaceUid }, { data: value.workspace.meta });
                 await Promise.all([
                     ...Object.entries(value.workspace.documents ?? {}).map(([name, data]) => documentsTable.addItem({ workspaceUid, documentName: name }, { data })),
@@ -301,11 +301,11 @@ export const createWorkspaceStorePersistence = async () => {
              * record, or `undefined` when the workspace does not exist.
              */
             updateName: async (workspaceUid, name) => {
-                const workspace = (await workspaceTable.getItem({ workspaceUid }));
+                const workspace = await workspaceTable.getItem({ workspaceUid });
                 if (!workspace) {
                     return undefined;
                 }
-                return (await workspaceTable.addItem({ workspaceUid }, { ...workspace, name }));
+                return await workspaceTable.addItem({ workspaceUid }, { ...workspace, name });
             },
             /**
              * Updates the mutable slug metadata for an existing workspace.
@@ -318,7 +318,7 @@ export const createWorkspaceStorePersistence = async () => {
              * references continue to resolve.
              */
             updateSlugs: async (workspaceUid, slugs) => {
-                const workspace = (await workspaceTable.getItem({ workspaceUid }));
+                const workspace = await workspaceTable.getItem({ workspaceUid });
                 if (!workspace) {
                     return undefined;
                 }
@@ -330,11 +330,11 @@ export const createWorkspaceStorePersistence = async () => {
                         return undefined;
                     }
                 }
-                return (await workspaceTable.addItem({ workspaceUid }, {
+                return await workspaceTable.addItem({ workspaceUid }, {
                     ...workspace,
                     teamSlug: nextTeamSlug,
                     slug: nextSlug,
-                }));
+                });
             },
             /** Checks if a workspace with the given UID exists. */
             has: async (workspaceUid) => {

package/dist/persistence/indexdb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexdb.d.ts","sourceRoot":"","sources":["../../src/persistence/indexdb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAA;AAE/D;;;;;;;;;GASG;AACH,KAAK,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,SAAS,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI;IAC3E,MAAM,EAAE,CAAC,CAAA;IACT,OAAO,EAAE,CAAC,CAAA;CACX,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,WAAW,CAAA;IACf,WAAW,EAAE,cAAc,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,EAAE,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,uBAAuB,GAAU,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,+BAI9G;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;IACT,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CACjC;UAuFS,IAAI,SAAS,MAAM,CAAC,aAAa,IAAI;;;;;;;;;+BAiEf,WAAW,EAAE,cAAc,MAAM;;;8EA6BP,OAAO,CAAC,IAAI,CAAC;kCAWpC,WAAW,EAAE,KAAG,OAAO,CAAC,MAAM,CAAC;;;;yBA4BpC,OAAO,CAAC,IAAI,CAAC;;;EAxH1C,CAAA"}
+{"version":3,"file":"indexdb.d.ts","sourceRoot":"","sources":["../../src/persistence/indexdb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAA;AAE/D;;;;;;;;;GASG;AACH,KAAK,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,SAAS,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI;IAC3E,MAAM,EAAE,CAAC,CAAA;IACT,OAAO,EAAE,CAAC,CAAA;CACX,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,WAAW,CAAA;IACf,WAAW,EAAE,cAAc,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,EAAE,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,uBAAuB,GAAU,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,+BAI9G;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;IACT,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CACjC;UAyFS,IAAI,SAAS,MAAM,CAAC,aAAa,IAAI;;;;;;;;;+BAiEf,WAAW,EAAE,cAAc,MAAM;;;8EA6BP,OAAO,CAAC,IAAI,CAAC;kCAWpC,WAAW,EAAE,KAAG,OAAO,CAAC,MAAM,CAAC;;;;yBA4BpC,OAAO,CAAC,IAAI,CAAC;;;EAxH1C,CAAA"}

package/dist/persistence/indexdb.js

@@ -72,7 +72,9 @@ export const createIndexDbConnection = async ({ name = 'scalar-workspace-store',
                 }
                 catch (error) {
                     const label = migration.description ? `v${version} (${migration.description})` : `v${version}`;
-                    throw new Error(`Migration ${label} failed: ${error?.message ?? error}`, { cause: error });
+                    throw new Error(`Migration ${label} failed: ${error instanceof Error ? error.message : error}`, {
+                        cause: error,
+                    });
                 }
             }
         };
@@ -167,8 +169,8 @@ function createTableWrapper(name, db) {
         return new Promise((resolve, reject) => {
             const req = objectStoreOrIndex.openCursor(range);
             req.onerror = () => reject(req.error);
-            req.onsuccess = (event) => {
-                const cursor = event.target.result;
+            req.onsuccess = () => {
+                const cursor = req.result;
                 if (cursor) {
                     results.push(cursor.value);
                     cursor.continue();
@@ -202,8 +204,8 @@ function createTableWrapper(name, db) {
         return new Promise((resolve, reject) => {
             const req = store.openCursor(range);
             req.onerror = () => reject(req.error);
-            req.onsuccess = (event) => {
-                const cursor = event.target.result;
+            req.onsuccess = () => {
+                const cursor = req.result;
                 if (cursor) {
                     cursor.delete();
                     deletedCount++;

package/dist/persistence/migrations/v2-team-to-local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-team-to-local.d.ts","sourceRoot":"","sources":["../../../src/persistence/migrations/v2-team-to-local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoEtD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAG,MAU5E,CAAA;AAcD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,SAAS,iBAAiB,EAAE,KACvC,KAAK,CAAC;IAAE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAkCjF,CAAA;AAiDD,eAAO,MAAM,sBAAsB,EAAE,SA8GpC,CAAA"}
+{"version":3,"file":"v2-team-to-local.d.ts","sourceRoot":"","sources":["../../../src/persistence/migrations/v2-team-to-local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoEtD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAG,MAU5E,CAAA;AAcD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,SAAS,iBAAiB,EAAE,KACvC,KAAK,CAAC;IAAE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAkCjF,CAAA;AAiDD,eAAO,MAAM,sBAAsB,EAAE,SA2GpC,CAAA"}

package/dist/persistence/migrations/v2-team-to-local.js

@@ -1,3 +1,4 @@
+import { isObjectLike } from '@scalar/helpers/object/is-object';
 /**
  * v2 — move to UID-based identity and collapse every workspace into the
  * local team.
@@ -145,7 +146,7 @@ const STALE_META_KEYS = ['x-scalar-tabs', 'x-scalar-active-tab'];
  * survive.
  */
 const stripStaleMetaFields = (meta) => {
-    if (!meta || typeof meta !== 'object') {
+    if (!isObjectLike(meta)) {
         return meta;
     }
     const copy = { ...meta };
@@ -250,9 +251,7 @@ export const v2TeamToLocalMigration = {
                 // longer routable after collapsing into the local team (and slugs
                 // may have been suffixed on collision), so drop them here and
                 // let the client rebuild tabs from the live route.
-                const nextData = tableName === 'meta'
-                    ? stripStaleMetaFields(rest.data)
-                    : rest.data;
+                const nextData = tableName === 'meta' ? stripStaleMetaFields(rest.data) : rest.data;
                 store.put({ ...rest, data: nextData, workspaceUid });
             }
         }

package/dist/plugins/bundler/index.d.ts

@@ -3,7 +3,7 @@
  * Plugins defined here can extend or modify the behavior of the bundling process,
  * such as adding lifecycle hooks or custom processing logic.
  */
-import type { LifecyclePlugin } from '@scalar/json-magic/bundle';
+import { type LifecyclePlugin } from '@scalar/json-magic/bundle';
 /**
  * A lifecycle plugin that adds a `$status` property to nodes during resolution.
  * - Sets `$status` to 'loading' when resolution starts.
@@ -86,9 +86,12 @@ export declare const restoreOriginalRefs: () => LifecyclePlugin;
 export declare const normalizeAuthSchemes: () => LifecyclePlugin;
 /**
  * Lifecycle plugin to normalize $ref nodes:
- * Ensures that for any non-schema object containing a $ref, only $ref,
+ * Ensures that for any OpenAPI Reference Object containing a $ref, only $ref,
  * summary, description, and $status properties are preserved.
  * This keeps $ref references clean and predictable for downstream consumers.
+ *
+ * Schema Objects are deliberately skipped: in JSON Schema 2020-12 a $ref may
+ * carry sibling keywords, so their siblings must not be stripped.
  */
 export declare const normalizeRefs: () => LifecyclePlugin;
 /**

package/dist/plugins/bundler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/bundler/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAShE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,eAahC,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,QAAO,eA+BxC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QAAO,eAwCjC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAO,eAuBtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,oBAAoB,QAAO,eAuBvC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,eAmChC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAO,eAkFrC,CAAA;AAKD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,eAaxC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/bundler/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,2BAA2B,CAAA;AAStF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,eAahC,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,QAAO,eAmCxC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QAAO,eAwCjC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAO,eAuBtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,oBAAoB,QAAO,eAuBvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAAO,eAyBhC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAO,eAkFrC,CAAA;AAKD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,eAaxC,CAAA"}