@scalar/workspace-store 0.54.2 → 0.54.3

package/dist/mutators/operation/operation.js

@@ -1,6 +1,7 @@
 import { isHttpMethod } from '@scalar/helpers/http/is-http-method';
 import { preventPollution } from '@scalar/helpers/object/prevent-pollution';
 import { findVariables } from '@scalar/helpers/regex/find-variables';
+import { deletePathItemOperation, getPathItemOperation, pathItemIsEmpty, setPathItemOperation, } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
 import { syncParametersForPathChange } from '../../mutators/operation/helpers/sync-path-parameters.js';
@@ -44,7 +45,7 @@ export const createOperation = (workspaceStore, payload) => {
     preventPollution(normalizedPath);
     preventPollution(method);
     /** Create the operation in the document */
-    document.paths[normalizedPath][method] = operation;
+    setPathItemOperation(document.paths[normalizedPath], method, operation);
     // Make sure that we are selecting the new operation server
     const { servers } = operation;
     const firstServer = unpackProxyObject(servers?.[0]);
@@ -91,7 +92,7 @@ export const updateOperationMeta = (store, document, { meta, payload }) => {
     if (documentName === undefined) {
         return;
     }
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     if (!operation) {
         console.error('Operation not found', { meta, document });
         return;
@@ -136,7 +137,7 @@ export const updateOperationPathMethod = (document, store, { meta, payload: { me
         return;
     }
     // Check for conflicts at the target location
-    if (document.paths?.[finalPath]?.[finalMethod]) {
+    if (getPathItemOperation(document.paths?.[finalPath], finalMethod)) {
         callback('conflict', blurTargetSelector);
         return;
     }
@@ -145,7 +146,7 @@ export const updateOperationPathMethod = (document, store, { meta, payload: { me
         console.error('Document navigation missing', { document });
         return;
     }
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     if (!operation) {
         console.error('Operation not found', { meta, document });
         return;
@@ -185,13 +186,12 @@ export const updateOperationPathMethod = (document, store, { meta, payload: { me
     preventPollution(meta.path);
     preventPollution(finalMethod);
     // Move the operation to the new location
-    document.paths[finalPath][finalMethod] = unpackProxyObject(operation);
+    setPathItemOperation(document.paths[finalPath], finalMethod, unpackProxyObject(operation));
     // Remove the operation from the old location
-    const oldPathItems = document.paths[meta.path];
-    if (oldPathItems && isHttpMethod(meta.method)) {
-        delete oldPathItems[meta.method];
-        // If the old path has no more operations, remove the path entry
-        if (Object.keys(oldPathItems).length === 0) {
+    if (isHttpMethod(meta.method)) {
+        deletePathItemOperation(document.paths[meta.path], meta.method);
+        // If the old path is now empty, remove the path entry (path-level metadata is kept otherwise)
+        if (pathItemIsEmpty(document.paths[meta.path])) {
             delete document.paths[meta.path];
         }
     }
@@ -217,9 +217,9 @@ export const deleteOperation = (workspace, { meta, documentName }) => {
     }
     preventPollution(meta.path);
     preventPollution(meta.method);
-    delete document.paths?.[meta.path]?.[meta.method];
-    // If the path has no more operations, remove the path entry
-    if (Object.keys(document.paths?.[meta.path] ?? {}).length === 0) {
+    deletePathItemOperation(document.paths?.[meta.path], meta.method);
+    // If the path is now empty, remove the path entry (path-level metadata is kept otherwise)
+    if (pathItemIsEmpty(document.paths?.[meta.path])) {
         delete document.paths?.[meta.path];
     }
 };
@@ -236,7 +236,7 @@ export const createOperationDraftExample = (workspace, { meta: { path, method },
         console.error('Document not found', { documentName });
         return;
     }
-    const operation = getResolvedRef(document.paths?.[path]?.[method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[path], method));
     if (!operation) {
         console.error('Operation not found', { path, method });
         return;
@@ -264,7 +264,7 @@ export const deleteOperationExample = (workspace, { meta: { path, method, exampl
         return;
     }
     // Get the operation object for the given path and method
-    const operation = getResolvedRef(document.paths?.[path]?.[method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[path], method));
     if (!operation) {
         return;
     }
@@ -314,7 +314,7 @@ export const renameOperationExample = (workspace, { meta: { path, method, exampl
     if (!isOpenApiDocument(document)) {
         return;
     }
-    const operation = getResolvedRef(document.paths?.[path]?.[method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[path], method));
     if (!operation) {
         return;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAMlD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,eAAe,CAAC,4BAA4B,CAAC,SAkD1F,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,GACzC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uCAAuC,eAAe,CAAC,mCAAmC,CAAC,SA8C5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,eAAe,CAAC,4BAA4B,CAAC,SA6B3E,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gBAAgB,eAAe,CAAC,iCAAiC,CAAC,SAanE,CAAA"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAIrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAmClD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,eAAe,CAAC,4BAA4B,CAAC,SAkD1F,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,GACzC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uCAAuC,eAAe,CAAC,mCAAmC,CAAC,SA8C5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,eAAe,CAAC,4BAA4B,CAAC,SAkC3E,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gBAAgB,eAAe,CAAC,iCAAiC,CAAC,SAanE,CAAA"}

package/dist/mutators/operation/parameters.js

@@ -1,6 +1,25 @@
+import { getPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
 import { isOpenApiDocument } from '../../schemas/type-guards.js';
+const getPathItemsForParameterMutation = (pathItemRef) => {
+    if (!pathItemRef || typeof pathItemRef !== 'object') {
+        return [];
+    }
+    if ('$ref' in pathItemRef) {
+        const targets = [];
+        const refWrapper = pathItemRef;
+        if (refWrapper.parameters !== undefined) {
+            targets.push(refWrapper);
+        }
+        const resolved = getResolvedRef(pathItemRef);
+        if (resolved) {
+            targets.push(resolved);
+        }
+        return targets;
+    }
+    return [pathItemRef];
+};
 /**
  * Updates an existing parameter of a given `type` by its index within that
  * type subset (e.g. the N-th query parameter). Supports updating name, value,
@@ -42,7 +61,7 @@ export const upsertOperationParameter = (document, { meta, type, payload, origin
     if (!isOpenApiDocument(document)) {
         return;
     }
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     if (!operation) {
         console.error('Operation not found', { meta, document });
         return;
@@ -84,7 +103,7 @@ export const updateOperationExtraParameters = (document, { type, meta, payload,
         return;
     }
     // Resolve the referenced operation from the document using the path and method
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     if (!operation) {
         return;
     }
@@ -130,7 +149,7 @@ export const deleteOperationParameter = (document, { meta, originalParameter })
     if (!isOpenApiDocument(document)) {
         return;
     }
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     // Lets check if its on the operation first as its more likely
     const operationIndex = operation?.parameters?.findIndex((it) => getResolvedRef(it) === originalParameter) ?? -1;
     // We cannot call splice on a proxy object, so we unwrap the array and filter it
@@ -138,11 +157,13 @@ export const deleteOperationParameter = (document, { meta, originalParameter })
         operation.parameters = unpackProxyObject(operation.parameters?.filter((_, i) => i !== operationIndex), { depth: 1 });
         return;
     }
-    // If it wasn't on the operation it might be on the path
-    const path = getResolvedRef(document.paths?.[meta.path]);
-    const pathIndex = path?.parameters?.findIndex((it) => getResolvedRef(it) === originalParameter) ?? -1;
-    if (path && pathIndex >= 0) {
-        path.parameters = unpackProxyObject(path.parameters?.filter((_, i) => i !== pathIndex), { depth: 1 });
+    // If it wasn't on the operation it might be on the path (wrapper siblings or $ref-value)
+    for (const path of getPathItemsForParameterMutation(document.paths?.[meta.path])) {
+        const pathIndex = path.parameters?.findIndex((parameter) => getResolvedRef(parameter) === originalParameter) ?? -1;
+        if (pathIndex >= 0) {
+            path.parameters = unpackProxyObject(path.parameters?.filter((_, i) => i !== pathIndex), { depth: 1 });
+            return;
+        }
     }
 };
 /**
@@ -162,7 +183,7 @@ export const deleteAllOperationParameters = (document, { meta, type }) => {
     if (!isOpenApiDocument(document)) {
         return;
     }
-    const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
+    const operation = getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method));
     if (!operation) {
         return;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mutators/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,6BAA6B,CAAA;AAK3E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,wCAAwC,CAAA;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAyB5D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,UAAU,YAAY,CAAC,2BAA2B,CAAC,+BAUpD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,iBAAiB,GAAG,IAAI,EAClC,uBAAuB,YAAY,CAAC,mBAAmB,CAAC,KACvD,YAAY,GAAG,SAmBjB,CAAA;AAgFD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,iBAAiB,GAAG,IAAI,EAClC,yBAAyB,YAAY,CAAC,sBAAsB,CAAC,KAC5D,YAAY,GAAG,SAgCjB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,iBAAiB,GAAG,IAAI,EAClC,iBAAiB,YAAY,CAAC,sBAAsB,CAAC,SAatD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,UAAU,YAAY,CAAC,sBAAsB,CAAC,SAS9G,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,YAAY,CAAC,yBAAyB,CAAC,sFAWrE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,iBAAiB,GAAG,IAAI,EAClC,eAAe,YAAY,CAAC,wBAAwB,CAAC,KACpD,MAAM,GAAG,SAaX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,UAAU,YAAY,CAAC,iCAAiC,CAAC,KACxD,MAAM,GAAG,SAOX,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GACxC,UAAU,iBAAiB,GAAG,IAAI,EAClC,sBAAsB,YAAY,CAAC,kCAAkC,CAAC,KACrE,4BAA4B,GAAG,SAcjC,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,cAAc;IAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE;iCAEzD,YAAY,CAAC,2BAA2B,CAAC;yBACjD,YAAY,CAAC,mBAAmB,CAAC;4BAC9B,YAAY,CAAC,sBAAsB,CAAC;4BACpC,YAAY,CAAC,sBAAsB,CAAC;4BACpC,YAAY,CAAC,sBAAsB,CAAC;qCAC3B,YAAY,CAAC,yBAAyB,CAAC;oCAExC,YAAY,CAAC,wBAAwB,CAAC;4CAC9B,YAAY,CAAC,iCAAiC,CAAC;6CAE9C,YAAY,CAAC,kCAAkC,CAAC;CAG5F,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mutators/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,6BAA6B,CAAA;AAM3E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,wCAAwC,CAAA;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAyB5D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,UAAU,YAAY,CAAC,2BAA2B,CAAC,+BAUpD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,iBAAiB,GAAG,IAAI,EAClC,uBAAuB,YAAY,CAAC,mBAAmB,CAAC,KACvD,YAAY,GAAG,SAmBjB,CAAA;AAgFD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,iBAAiB,GAAG,IAAI,EAClC,yBAAyB,YAAY,CAAC,sBAAsB,CAAC,KAC5D,YAAY,GAAG,SAgCjB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,iBAAiB,GAAG,IAAI,EAClC,iBAAiB,YAAY,CAAC,sBAAsB,CAAC,SAatD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,UAAU,YAAY,CAAC,sBAAsB,CAAC,SAS9G,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,YAAY,CAAC,yBAAyB,CAAC,sFAWrE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,iBAAiB,GAAG,IAAI,EAClC,eAAe,YAAY,CAAC,wBAAwB,CAAC,KACpD,MAAM,GAAG,SAaX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,UAAU,YAAY,CAAC,iCAAiC,CAAC,KACxD,MAAM,GAAG,SAOX,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GACxC,UAAU,iBAAiB,GAAG,IAAI,EAClC,sBAAsB,YAAY,CAAC,kCAAkC,CAAC,KACrE,4BAA4B,GAAG,SAcjC,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,cAAc;IAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE;iCAEzD,YAAY,CAAC,2BAA2B,CAAC;yBACjD,YAAY,CAAC,mBAAmB,CAAC;4BAC9B,YAAY,CAAC,sBAAsB,CAAC;4BACpC,YAAY,CAAC,sBAAsB,CAAC;4BACpC,YAAY,CAAC,sBAAsB,CAAC;qCAC3B,YAAY,CAAC,yBAAyB,CAAC;oCAExC,YAAY,CAAC,wBAAwB,CAAC;4CAC9B,YAAY,CAAC,iCAAiC,CAAC;6CAE9C,YAAY,CAAC,kCAAkC,CAAC;CAG5F,CAAA"}

package/dist/mutators/server.js

@@ -1,4 +1,5 @@
 import { findVariables } from '@scalar/helpers/regex/find-variables';
+import { getPathItemOperation } from '../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../helpers/get-resolved-ref.js';
 import { unpackProxyObject } from '../helpers/unpack-proxy.js';
 import { isAsyncApiDocument, isOpenApiDocument } from '../schemas/type-guards.js';
@@ -15,7 +16,7 @@ const getServerTarget = (document, meta) => {
     if (meta.type === 'document') {
         return document;
     }
-    return getResolvedRef(document.paths?.[meta.path]?.[meta.method]) ?? null;
+    return getResolvedRef(getPathItemOperation(document.paths?.[meta.path], meta.method)) ?? null;
 };
 /**
  * Initializes the servers for the document or operation based on meta.

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;AAQzD;;;;;;;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,SAwC/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,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"}

package/dist/mutators/tag.js

@@ -1,3 +1,4 @@
+import { forEachPathItemOperation, getPathItemOperation } from '../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../helpers/get-resolved-ref.js';
 import { unpackProxyObject } from '../helpers/unpack-proxy.js';
 import { getNavigationOptions } from '../navigation/get-navigation-options.js';
@@ -55,7 +56,7 @@ export const editTag = (store, payload) => {
     payload.tag.children?.forEach((child) => {
         // Operation
         if (child.type === 'operation') {
-            const operation = getResolvedRef(document.paths?.[child.path]?.[child.method]);
+            const operation = getResolvedRef(getPathItemOperation(document.paths?.[child.path], child.method));
             if (operation && 'tags' in operation) {
                 const plainTags = unpackProxyObject(operation.tags, { depth: null });
                 operation.tags = plainTags?.map((tag) => (tag === oldName ? newName : tag));
@@ -63,7 +64,7 @@ export const editTag = (store, payload) => {
         }
         // Webhook
         else if (child.type === 'webhook') {
-            const webhook = getResolvedRef(document.webhooks?.[child.name]?.[child.method]);
+            const webhook = getResolvedRef(getPathItemOperation(document.webhooks?.[child.name], child.method));
             if (webhook && 'tags' in webhook) {
                 const plainTags = unpackProxyObject(webhook.tags, { depth: null });
                 webhook.tags = plainTags?.map((tag) => (tag === oldName ? newName : tag));
@@ -108,13 +109,9 @@ export const deleteTag = (workspace, payload) => {
         return;
     }
     // Clear tags from all operations that have this tag
-    Object.values(document.paths ?? {}).forEach((path) => {
-        Object.values(path).forEach((operation) => {
-            // Only process operations that are objects
-            if (typeof operation !== 'object' || Array.isArray(operation)) {
-                return;
-            }
-            const resolvedOperation = getResolvedRef(operation);
+    Object.values(document.paths ?? {}).forEach((pathItemRef) => {
+        forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
+            const resolvedOperation = getResolvedRef(operationRef);
             if ('tags' in resolvedOperation) {
                 const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
                 resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
@@ -122,12 +119,9 @@ export const deleteTag = (workspace, payload) => {
         });
     });
     // Remove the tag from all webhooks that have this tag
-    Object.values(document.webhooks ?? {}).forEach((webhook) => {
-        Object.values(webhook).forEach((operation) => {
-            if (typeof operation !== 'object' || Array.isArray(operation)) {
-                return;
-            }
-            const resolvedOperation = getResolvedRef(operation);
+    Object.values(document.webhooks ?? {}).forEach((pathItemRef) => {
+        forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
+            const resolvedOperation = getResolvedRef(operationRef);
             const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
             resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
         });

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

@@ -1 +1 @@
-{"version":3,"file":"get-openapi-object.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-openapi-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE/G,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAIxF,KAAK,kBAAkB,GAAG,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAE/E,KAAK,gBAAgB,CAAC,KAAK,SAAS,kBAAkB,IAAI,KAAK,SAAS,iBAAiB,GACrF,iBAAiB,GACjB,KAAK,SAAS,YAAY,GACxB,SAAS,GACT,KAAK,SAAS,kBAAkB,GAC9B,eAAe,GACf,KAAK,CAAA;AAEb,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,OAAO,cAAc,KAAG,KAAK,IAAI,kBACmB,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,SAAS,kBAAkB,EAAE,mBAGhE;IACD,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;CACb,KAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAgC7B,CAAA"}
+{"version":3,"file":"get-openapi-object.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-openapi-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE/G,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAIxF,KAAK,kBAAkB,GAAG,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAE/E,KAAK,gBAAgB,CAAC,KAAK,SAAS,kBAAkB,IAAI,KAAK,SAAS,iBAAiB,GACrF,iBAAiB,GACjB,KAAK,SAAS,YAAY,GACxB,SAAS,GACT,KAAK,SAAS,kBAAkB,GAC9B,eAAe,GACf,KAAK,CAAA;AAEb,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,OAAO,cAAc,KAAG,KAAK,IAAI,kBACmB,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,SAAS,kBAAkB,EAAE,mBAGhE;IACD,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;CACb,KAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAoC7B,CAAA"}

package/dist/navigation/helpers/get-openapi-object.js

@@ -1,3 +1,4 @@
+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 { getParentEntry } from './get-parent-entry.js';
@@ -46,7 +47,7 @@ export const getOpenapiObject = ({ store, entry, }) => {
     }
     if (entry.type === 'operation') {
         // Fetch and resolve the referenced operation object at the given path/method
-        return getResolvedRef(document.paths?.[entry.path]?.[entry.method]) ?? null;
+        return (getResolvedRef(getPathItemOperation(document.paths?.[entry.path], entry.method)) ?? null);
     }
     // If entry type is unknown, return null
     return null;

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

@@ -1 +1 @@
-{"version":3,"file":"traverse-paths.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-paths.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE5F,OAAO,KAAK,EAA+B,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAI9F,eAAO,MAAM,qBAAqB,GAAI,WAAW,eAAe,YAE/D,CAAA;AAsED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,GAAI,sEAM3B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAC5C,KAAG;IAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAA;CA6D7C,CAAA"}
+{"version":3,"file":"traverse-paths.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-paths.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE5F,OAAO,KAAK,EAA+B,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAI9F,eAAO,MAAM,qBAAqB,GAAI,WAAW,eAAe,YAE/D,CAAA;AAsED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,GAAI,sEAM3B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAC5C,KAAG;IAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAA;CA0D7C,CAAA"}

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

@@ -1,6 +1,5 @@
-import { isHttpMethod } from '@scalar/helpers/http/is-http-method';
-import { objectKeys } from '@scalar/helpers/object/object-keys';
 import { escapeJsonPointer } from '@scalar/json-magic/helpers/escape-json-pointer';
+import { forEachPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef, mergeSiblingReferences } from '../../helpers/get-resolved-ref.js';
 import { isHidden } from '../../helpers/is-hidden.js';
 import { traverseOperationExamples } from '../../navigation/helpers/traverse-examples.js';
@@ -74,16 +73,14 @@ const createOperationEntry = ({ ref, operation, method, path, generateId, parent
 export const traversePaths = ({ document, tagsMap, generateId, documentId, operationTitleSource, }) => {
     const untaggedOperations = [];
     // Traverse paths
-    Object.entries(document.paths ?? {}).forEach(([path, pathItemObject]) => {
-        const pathKeys = objectKeys(pathItemObject ?? {}).filter((key) => isHttpMethod(key));
-        pathKeys.forEach((method) => {
-            const _operation = pathItemObject?.[method];
-            const operation = getResolvedRef(_operation, mergeSiblingReferences);
+    Object.entries(document.paths ?? {}).forEach(([path, pathItemRef]) => {
+        forEachPathItemOperation(pathItemRef, (method, operationRef) => {
+            const operation = getResolvedRef(operationRef, mergeSiblingReferences);
             if (!operation) {
                 return;
             }
             // Skip if the operation is internal or scalar-ignore
-            if (isHidden(operation) || !isHttpMethod(method)) {
+            if (isHidden(operation)) {
                 return;
             }
             const ref = `#/paths/${escapeJsonPointer(path)}/${method}`;

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

@@ -1 +1 @@
-{"version":3,"file":"traverse-webhooks.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-webhooks.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,wCAAwC,CAAA;AA2DzG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,0EAM9B;IACD,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAA;IACzB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,wBAAwB,EAAE,MAAM,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,gBAAgB,EA0DnB,CAAA"}
+{"version":3,"file":"traverse-webhooks.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-webhooks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,wCAAwC,CAAA;AA2DzG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,0EAM9B;IACD,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAA;IACzB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,wBAAwB,EAAE,MAAM,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,gBAAgB,EAuDnB,CAAA"}

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

@@ -1,5 +1,4 @@
-import { isHttpMethod } from '@scalar/helpers/http/is-http-method';
-import { objectKeys } from '@scalar/helpers/object/object-keys';
+import { forEachPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef, mergeSiblingReferences } from '../../helpers/get-resolved-ref.js';
 import { isHidden } from '../../helpers/is-hidden.js';
 import { isDeprecatedOperation } from '../../navigation/helpers/traverse-paths.js';
@@ -53,11 +52,9 @@ const createWebhookEntry = ({ ref, method, name, title, generateId, parentTag, w
 export const traverseWebhooks = ({ document, tagsMap, generateId, untaggedWebhooksParentId, documentId, }) => {
     const untagged = [];
     // Traverse webhooks
-    Object.entries(document.webhooks ?? {}).forEach(([name, pathItemObject]) => {
-        const pathKeys = objectKeys(pathItemObject ?? {}).filter((key) => isHttpMethod(key));
-        pathKeys.forEach((method) => {
-            const _operation = pathItemObject?.[method];
-            const operation = getResolvedRef(_operation, mergeSiblingReferences);
+    Object.entries(document.webhooks ?? {}).forEach(([name, pathItemRef]) => {
+        forEachPathItemOperation(pathItemRef, (method, operationRef) => {
+            const operation = getResolvedRef(operationRef, mergeSiblingReferences);
             if (!operation) {
                 return;
             }

package/dist/request-example/builder/body/build-request-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-body.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/build-request-body.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAA;AAOjG,KAAK,QAAQ,GAAG;IACd,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,CACH;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,GACD;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,IAAI,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,GACD;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,IAAI,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CACJ,EAAE,CAAA;CACJ,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,EAAE,CAAA;CACJ,CAAA;AAED,KAAK,GAAG,GAAG;IACT,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,GAAG,CAAA;AAiCrD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,iBAAiB,GAAG,SAAS;AAC1C,qCAAqC;AACrC,oBAAuB;AACvB,sEAAsE;AACtE,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvD,WAAW,GAAG,IAkRhB,CAAA"}
+{"version":3,"file":"build-request-body.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/build-request-body.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAA;AAOjG,KAAK,QAAQ,GAAG;IACd,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,CACH;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,GACD;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,IAAI,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,GACD;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,IAAI,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CACJ,EAAE,CAAA;CACJ,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,EAAE,CAAA;CACJ,CAAA;AAED,KAAK,GAAG,GAAG;IACT,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,GAAG,CAAA;AA2GrD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,iBAAiB,GAAG,SAAS;AAC1C,qCAAqC;AACrC,oBAAuB;AACvB,sEAAsE;AACtE,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvD,WAAW,GAAG,IA2RhB,CAAA"}

package/dist/request-example/builder/body/build-request-body.js

@@ -1,7 +1,7 @@
 // import { replaceEnvVariables } from '@scalar/helpers/regex/replace-variables'
 import { isObject } from '@scalar/helpers/object/is-object';
 import { setValueAtPath } from '@scalar/helpers/object/set-value-at-path';
-import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref';
+import { getResolvedRef, mergeSiblingReferences } from '@scalar/workspace-store/helpers/get-resolved-ref';
 import { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy';
 import { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards';
 import { getExampleFromBody } from './get-request-body-example.js';
@@ -16,13 +16,15 @@ const getMultipartEncodingContentType = (requestBody, bodyContentType, fieldName
  * by `get-form-body-rows.ts` are folded back via `foldDottedRowsToObject`.
  */
 const buildDottedNestedRowPredicate = (schema) => {
-    const resolved = schema ? getResolvedRef(schema) : undefined;
+    const resolved = schema ? getResolvedRef(schema, mergeSiblingReferences) : undefined;
     if (!resolved || !isObjectSchema(resolved) || !resolved.properties) {
         return (_name, _value) => false;
     }
     const nestedTopKeys = new Set();
     for (const [key, child] of Object.entries(resolved.properties)) {
-        const childResolved = child ? getResolvedRef(child) : undefined;
+        const childResolved = child
+            ? getResolvedRef(child, mergeSiblingReferences)
+            : undefined;
         if (childResolved && isObjectSchema(childResolved) && childResolved.properties) {
             nestedTopKeys.add(key);
         }
@@ -35,6 +37,75 @@ const buildDottedNestedRowPredicate = (schema) => {
         return !!head && nestedTopKeys.has(head);
     };
 };
+/** Normalize a schema's `type` (string | string[] | absent) into a plain string array. */
+const normalizeSchemaTypes = (schema) => {
+    const type = 'type' in schema ? schema.type : undefined;
+    return Array.isArray(type) ? [...type] : type == null ? [] : [type];
+};
+/**
+ * Walk an object schema along a dotted-row path and return the resolved leaf schema,
+ * or undefined when any segment is not a declared object property.
+ */
+const resolveLeafSchema = (schema, segments) => {
+    let current = schema;
+    for (const segment of segments) {
+        if (!current || !isObjectSchema(current) || !current.properties) {
+            return undefined;
+        }
+        current = getResolvedRef(current.properties[segment], mergeSiblingReferences);
+    }
+    return current;
+};
+/** True when a JSON-parsed value's runtime type is allowed by the schema's declared types. */
+const parsedValueMatchesSchemaType = (value, types) => {
+    if (value === null) {
+        return types.includes('null');
+    }
+    if (Array.isArray(value)) {
+        return types.includes('array');
+    }
+    if (typeof value === 'object') {
+        return types.includes('object');
+    }
+    if (typeof value === 'boolean') {
+        return types.includes('boolean');
+    }
+    if (typeof value === 'number') {
+        // A fractional value only satisfies `number`; `integer` requires a whole number so a
+        // string like "3.14" against an integer-only leaf stays untouched instead of being coerced.
+        return types.includes('number') || (types.includes('integer') && Number.isInteger(value));
+    }
+    if (typeof value === 'string') {
+        return types.includes('string');
+    }
+    return false;
+};
+/**
+ * The form table stringifies every value for display, so an edited nested field comes back
+ * as a string (`false` -> "false", `[]` -> "[]"). When the leaf schema declares a non-string
+ * type, parse the string back to that type so the regrouped JSON part keeps its original
+ * shape instead of becoming string-typed (issue #9416).
+ *
+ * Coercion is deliberately conservative: schemas that allow `string` keep the raw text, and a
+ * value that does not parse as its declared type is left untouched so user input is never lost.
+ */
+const coerceLeafValueToSchemaType = (value, schema) => {
+    if (typeof value !== 'string' || !schema) {
+        return value;
+    }
+    const types = normalizeSchemaTypes(schema);
+    // No declared type, or a string is allowed: keep the user's text as-is.
+    if (types.length === 0 || types.includes('string')) {
+        return value;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        return parsedValueMatchesSchemaType(parsed, types) ? parsed : value;
+    }
+    catch {
+        return value;
+    }
+};
 /**
  * Create the fetch request body
  */
@@ -81,9 +152,10 @@ requestBodyCompositionSelection) => {
         // lazily allocate the regrouped object for its top-level key and push it into
         // `entries` at the position of the *first* matching row, then keep folding leaves
         // into the same live object reference so interleaved flat rows keep their order.
-        const isDottedNestedRow = result.mode === 'formdata'
-            ? buildDottedNestedRowPredicate(requestBody.content[bodyContentType]?.schema)
-            : () => false;
+        const multipartSchema = result.mode === 'formdata'
+            ? getResolvedRef(requestBody.content[bodyContentType]?.schema, mergeSiblingReferences)
+            : undefined;
+        const isDottedNestedRow = result.mode === 'formdata' ? buildDottedNestedRowPredicate(multipartSchema) : () => false;
         const entries = [];
         const regroupedByTopKey = new Map();
         for (const row of exampleValue) {
@@ -102,7 +174,9 @@ requestBodyCompositionSelection) => {
                 regroupedByTopKey.set(topKey, target);
                 entries.push({ name: topKey, value: target });
             }
-            setValueAtPath(target, segments.slice(1), row.value);
+            // The form table stringifies leaf values; restore the schema-declared type so the
+            // regrouped JSON part keeps booleans/numbers/arrays instead of string-typing them.
+            setValueAtPath(target, segments.slice(1), coerceLeafValueToSchemaType(row.value, resolveLeafSchema(multipartSchema, segments)));
         }
         // Loop over all entries and add them to the form
         entries.forEach(({ name, value }) => {

package/dist/request-example/builder/header/de-serialize-parameter.js

@@ -29,6 +29,40 @@ const deSerializeContentExample = (example, contentType) => {
 };
 /** Schema types that must become arrays/objects — serializers branch on `Array.isArray` / objects. */
 const structuredSchemaTypes = new Set(['array', 'object']);
+/**
+ * Find the structured (`array` or `object`) type a schema represents, looking through
+ * `anyOf`/`oneOf`/`allOf` composition.
+ *
+ * Optional array/object parameters are commonly described as `anyOf: [{ type: 'array' }, { type: 'null' }]`
+ * (e.g. FastAPI/Pydantic `Optional[List[str]]`). Without unwrapping these we would treat the value as a
+ * plain string and send a single `id=a,b` query parameter instead of repeating `id=a&id=b`.
+ */
+const getStructuredType = (schema) => {
+    const resolved = getResolvedRef(schema);
+    if (!resolved || typeof resolved !== 'object') {
+        return undefined;
+    }
+    if ('type' in resolved && resolved.type) {
+        const type = Array.isArray(resolved.type)
+            ? resolved.type.find((t) => structuredSchemaTypes.has(t))
+            : resolved.type;
+        if (type === 'array' || type === 'object') {
+            return type;
+        }
+    }
+    for (const key of ['anyOf', 'oneOf', 'allOf']) {
+        const subSchemas = resolved[key];
+        if (Array.isArray(subSchemas)) {
+            for (const subSchema of subSchemas) {
+                const type = getStructuredType(subSchema);
+                if (type) {
+                    return type;
+                }
+            }
+        }
+    }
+    return undefined;
+};
 /**
  * Schema-based parameters from the request editor.
  *
@@ -36,10 +70,9 @@ const structuredSchemaTypes = new Set(['array', 'object']);
  * Only `array` and `object` values are parsed so OpenAPI style serialization can expand them.
  */
 const deSerializeSchemaExample = (example, schema) => {
-    const resolvedSchema = getResolvedRef(schema);
-    if (typeof example === 'string' && resolvedSchema && 'type' in resolvedSchema) {
-        const type = Array.isArray(resolvedSchema.type) ? resolvedSchema.type[0] : resolvedSchema.type;
-        if (type && structuredSchemaTypes.has(type)) {
+    if (typeof example === 'string') {
+        const type = getStructuredType(schema);
+        if (type) {
             try {
                 return JSON.parse(example);
             }

package/dist/request-example/builder/security/build-request-security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-security.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/security/build-request-security.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAA;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,8DAA8D;IAC9D,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IACjC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;AAC/B,4DAA4D;AAC5D,yBAAyB,0BAA0B,EAAE;AACrD,qEAAqE;AACrE,8BAA0B,KACzB,0BAA0B,EAuF5B,CAAA"}
+{"version":3,"file":"build-request-security.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/security/build-request-security.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAA;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,8DAA8D;IAC9D,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IACjC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;AAC/B,4DAA4D;AAC5D,yBAAyB,0BAA0B,EAAE;AACrD,qEAAqE;AACrE,8BAA0B,KACzB,0BAA0B,EA6F5B,CAAA"}

package/dist/request-example/builder/security/build-request-security.js

@@ -39,14 +39,19 @@ emptyTokenPlaceholder = '') => {
         // HTTP
         if (scheme.type === 'http') {
             if (scheme.scheme === 'basic') {
-                const username = scheme['x-scalar-secret-username'];
-                const password = scheme['x-scalar-secret-password'];
-                const value = `${username}:${password}`;
+                const username = scheme['x-scalar-secret-username'] || '';
+                const password = scheme['x-scalar-secret-password'] || '';
+                // When the user has cleared both fields we must not send any credentials.
+                // Falling back to placeholder values here would emit `Basic username:password`,
+                // which some servers accept as a valid (but bogus) credential instead of returning 401.
+                if (username === '' && password === '') {
+                    return null;
+                }
                 return result.push({
                     in: 'header',
                     name: 'Authorization',
                     // We encode the value when we build the request since we want to be able to replace the variables in the value
-                    value: value === ':' ? 'username:password' : value,
+                    value: `${username}:${password}`,
                     format: 'basic',
                 });
             }

package/dist/request-example/context/get-request-example-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-request-example-context.d.ts","sourceRoot":"","sources":["../../../src/request-example/context/get-request-example-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAEpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAA;AAIjG,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,iCAAiC,CAAA;AAIhF,OAAO,EAAE,KAAK,qBAAqB,EAAiB,MAAM,mDAAmD,CAAA;AAE7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAA;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,eAAe,CAAA;IAC1B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,WAAW,EAAE,kBAAkB,CAAA;KAChC,CAAA;IACD,OAAO,EAAE;QACP,SAAS,EAAE,aAAa,EAAE,CAAA;QAC1B,QAAQ,EAAE,aAAa,EAAE,CAAA;KAC1B,CAAA;IACD,OAAO,EAAE;QACP,IAAI,EAAE,YAAY,EAAE,CAAA;QACpB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;QAC7B,IAAI,EAAE,UAAU,CAAA;KACjB,CAAA;IACD,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KACnB,CAAA;IACD,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAChC,CAAA;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qBAAqB,CAAA;QAC9B,YAAY,EAAE,yBAAyB,EAAE,CAAA;QACzC,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,eAAe,EAAE,0BAA0B,EAAE,CAAA;QAC7C,IAAI,EAAE,QAAQ,CAAA;KACf,CAAA;CACF,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,gBAAgB,cAAc,EAC9B,cAAc,MAAM,EACpB,oBAAoB,kBAAkB,EACtC,UAAS,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,+CAA+C;IAC/C,cAAc,EAAE,2BAA2B,CAAA;IAC3C;;;;OAIG;IACH,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC3C,CAAM,KACN,MAAM,CAAC,0BAA0B,CA6InC,CAAA"}
+{"version":3,"file":"get-request-example-context.d.ts","sourceRoot":"","sources":["../../../src/request-example/context/get-request-example-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAA;AAIjG,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,iCAAiC,CAAA;AAIhF,OAAO,EAAE,KAAK,qBAAqB,EAAiB,MAAM,mDAAmD,CAAA;AAE7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAA;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,eAAe,CAAA;IAC1B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,WAAW,EAAE,kBAAkB,CAAA;KAChC,CAAA;IACD,OAAO,EAAE;QACP,SAAS,EAAE,aAAa,EAAE,CAAA;QAC1B,QAAQ,EAAE,aAAa,EAAE,CAAA;KAC1B,CAAA;IACD,OAAO,EAAE;QACP,IAAI,EAAE,YAAY,EAAE,CAAA;QACpB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;QAC7B,IAAI,EAAE,UAAU,CAAA;KACjB,CAAA;IACD,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KACnB,CAAA;IACD,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAChC,CAAA;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qBAAqB,CAAA;QAC9B,YAAY,EAAE,yBAAyB,EAAE,CAAA;QACzC,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,eAAe,EAAE,0BAA0B,EAAE,CAAA;QAC7C,IAAI,EAAE,QAAQ,CAAA;KACf,CAAA;CACF,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,gBAAgB,cAAc,EAC9B,cAAc,MAAM,EACpB,oBAAoB,kBAAkB,EACtC,UAAS,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,+CAA+C;IAC/C,cAAc,EAAE,2BAA2B,CAAA;IAC3C;;;;OAIG;IACH,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC3C,CAAM,KACN,MAAM,CAAC,0BAA0B,CA6InC,CAAA"}

package/dist/request-example/context/get-request-example-context.js

@@ -1,3 +1,4 @@
+import { getPathItemOperation, getResolvedPathItem } from '../../helpers/for-each-path-item-operation.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
 import { getActiveEnvironment } from '../../request-example/context/environment.js';
 import { getDefaultHeaders } from '../../request-example/context/headers.js';
@@ -24,14 +25,14 @@ export const getRequestExampleContext = (workspaceStore, documentName, requestEx
             error: `Document ${documentName} is not an OpenAPI document`,
         };
     }
-    const pathItem = getResolvedRef(document.paths?.[path]);
+    const pathItem = getResolvedPathItem(document.paths?.[path]);
     if (!pathItem) {
         return {
             ok: false,
             error: `Path ${path} not found`,
         };
     }
-    const resolvedOperation = getResolvedRef(pathItem[method]);
+    const resolvedOperation = getResolvedRef(getPathItemOperation(document.paths?.[path], method));
     if (!resolvedOperation) {
         return {
             ok: false,