@scalar/workspace-store 0.65.0 → 0.67.0

package/dist/mutators/operation/parameters.js

@@ -1,5 +1,7 @@
 import { getPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
+import { getParameterExample } from '../../helpers/get-parameter-example.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
+import { getQuerystringParameter, serializeQuerystringParameter } from '../../helpers/querystring-parameter.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
 import { isOpenApiDocument } from '../../schemas/type-guards.js';
 import { isContentTypeParameterObject } from '../../schemas/v3.2/strict/type-guards.js';
@@ -41,8 +43,13 @@ const getPathItemsForParameterMutation = (pathItemRef) => {
 export const upsertOperationParameter = (document, { meta, type, payload, originalParameter }) => {
     // We are editing an existing parameter
     if (originalParameter) {
+        const querystring = getQuerystringParameter(originalParameter, meta.exampleKey, { includeDisabled: true });
+        const preserveQuerystringValue = querystring && payload.value === serializeQuerystringParameter(querystring);
         const param = originalParameter;
-        const target = isContentTypeParameterObject(param) ? Object.values(param.content ?? {})[0] : param;
+        const selected = getParameterExample(param, meta.exampleKey);
+        const target = param.in !== 'querystring' && !selected.serialized && isContentTypeParameterObject(param)
+            ? Object.values(param.content ?? {})[0]
+            : param;
         if (!target) {
             return;
         }
@@ -77,7 +84,39 @@ export const upsertOperationParameter = (document, { meta, type, payload, origin
             return;
         }
         // Update the example value and disabled state
-        example.value = payload.value;
+        if (param.in === 'querystring') {
+            // The whole-query editor displays the URI-ready value, including percent encoding.
+            delete example.value;
+            delete example.dataValue;
+            // Inline edits replace the external example source as well as its cached representation.
+            delete example.externalValue;
+            delete example.serializedValue;
+            // Toggling an unchanged preview must preserve data and environment placeholders
+            // so future environment changes still happen before serialization.
+            if (preserveQuerystringValue && querystring.kind !== 'uri-ready') {
+                if (querystring.kind === 'serialized') {
+                    example.value = querystring.value;
+                }
+                else {
+                    example.dataValue = querystring.value;
+                }
+            }
+            else {
+                example.serializedValue = String(payload.value);
+            }
+        }
+        else {
+            delete example.dataValue;
+            delete example.serializedValue;
+            delete example.externalValue;
+            if (selected.serialized || selected.mediaSerialized) {
+                delete example.value;
+                example.serializedValue = String(payload.value);
+            }
+            else {
+                example.value = payload.value;
+            }
+        }
         example['x-disabled'] = payload.isDisabled;
         return;
     }
@@ -212,5 +251,6 @@ 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 && !(type === 'query' && getResolvedRef(it)?.in === 'querystring')) ?? [];
 };

package/dist/navigation/get-navigation-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,4BAA4B,EAAgC,MAAM,6BAA6B,CAAA;AAE7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAG7D,MAAM,MAAM,iBAAiB,GACzB,OAAO,CACL,IAAI,CACF,4BAA4B,EAC1B,qBAAqB,GACrB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GACD,SAAS,CAAA;AAEb;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,UAAU,iBAAiB,KAAG,mBAmJxF,CAAA"}
+{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,4BAA4B,EAAgC,MAAM,6BAA6B,CAAA;AAE7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAe7D,MAAM,MAAM,iBAAiB,GACzB,OAAO,CACL,IAAI,CACF,4BAA4B,EAC1B,qBAAqB,GACrB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GACD,SAAS,CAAA;AAEb;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,UAAU,iBAAiB,KAAG,mBAyJxF,CAAA"}

package/dist/navigation/get-navigation-options.js

@@ -1,5 +1,16 @@
+import { isHttpMethod } from '@scalar/helpers/http/is-http-method';
 import { slugify } from '@scalar/helpers/string/slugify';
 import { DEFAULT_MODELS_SECTION_LABEL } from '@scalar/types/api-reference';
+/**
+ * Fixed fields retain their existing links; authored variants need a distinct namespace.
+ * Extension methods retain exact case because HTTP method tokens are case-sensitive.
+ * Normalizing COPY and copy would collapse distinct operations onto the same anchor.
+ */
+const getMethodId = (method) => isHttpMethod(method)
+    ? method === method.toLowerCase()
+        ? method.toUpperCase()
+        : `additionalOperations/${method}`
+    : method;
 /**
  * Returns options for traversing an OpenAPI document, allowing customization of
  * how IDs and slugs are generated for tags, headings, models, operations, and webhooks.
@@ -65,11 +76,13 @@ export const getNavigationOptions = (documentName, options) => {
                 return `${prefixTag}${options.generateOperationSlug({
                     path: props.path,
                     operationId: props.operation.operationId,
-                    method: props.method.toUpperCase(),
+                    method: isHttpMethod(props.method) && props.method === props.method.toLowerCase()
+                        ? props.method.toUpperCase()
+                        : props.method,
                     summary: props.operation.summary,
                 })}`;
             }
-            return `${prefixTag}${props.method.toUpperCase()}${props.path}`;
+            return `${prefixTag}${getMethodId(props.method)}${props.path}`;
         }
         // -------- Default webhook id generation logic --------
         if (props.type === 'webhook') {
@@ -83,13 +96,15 @@ export const getNavigationOptions = (documentName, options) => {
             if (options?.generateWebhookSlug) {
                 return `${prefixTag}webhook/${options.generateWebhookSlug({
                     name: props.name,
-                    method: props.method?.toUpperCase(),
+                    method: isHttpMethod(props.method) && props.method === props.method.toLowerCase()
+                        ? props.method.toUpperCase()
+                        : props.method,
                 })}`;
             }
             // Webhook events are commonly named with dots (e.g. "account_holder.created").
             // Keep the dot so the deep link stays close to the event name, instead of
             // dropping it and joining adjacent words ("account-holdercreated").
-            return `${prefixTag}webhook/${props.method?.toUpperCase()}/${slugify(props.name, { allowedSpecialChars: '.' })}`;
+            return `${prefixTag}webhook/${getMethodId(props.method)}/${slugify(props.name, { allowedSpecialChars: '.' })}`;
         }
         // -------- Default model id generation logic --------
         if (props.type === 'model') {

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":"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"}
+{"version":3,"file":"traverse-paths.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-paths.ts"],"names":[],"mappings":"AAMA,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,5 +1,5 @@
 import { escapeJsonPointer } from '@scalar/json-magic/helpers/escape-json-pointer';
-import { forEachPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
+import { forEachPathItemOperation, getPathItemOperationKey } 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';
@@ -83,7 +83,7 @@ export const traversePaths = ({ document, tagsMap, generateId, documentId, opera
             if (isHidden(operation)) {
                 return;
             }
-            const ref = `#/paths/${escapeJsonPointer(path)}/${method}`;
+            const ref = `#/paths/${escapeJsonPointer(path)}/${getPathItemOperationKey(method)}`;
             // Traverse tags
             if (operation.tags?.length) {
                 operation.tags.forEach((tagName) => {

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":"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"}
+{"version":3,"file":"traverse-webhooks.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-webhooks.ts"],"names":[],"mappings":"AAIA,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,4 +1,4 @@
-import { forEachPathItemOperation } from '../../helpers/for-each-path-item-operation.js';
+import { forEachPathItemOperation, getPathItemOperationKey } 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';
@@ -62,7 +62,7 @@ export const traverseWebhooks = ({ document, tagsMap, generateId, untaggedWebhoo
             if (isHidden(operation)) {
                 return;
             }
-            const ref = `#/webhooks/${name}/${method}`;
+            const ref = `#/webhooks/${name}/${getPathItemOperationKey(method)}`;
             if (operation.tags?.length) {
                 operation.tags.forEach((tagName) => {
                     const { tag, id: tagId } = getTag({ tagsMap, name: tagName, documentId, generateId });

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

@@ -1,4 +1,3 @@
-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.2/strict/openapi-document.js';
@@ -10,7 +9,7 @@ type UpdateOrderIdParams = {
     /** Operation or webhook entries to update the order ID for */
     entries: (WithParent<TraversedOperation> | WithParent<TraversedWebhook>)[];
     operation: OperationObject;
-    method: HttpMethod;
+    method: string;
     path: string;
 } | {
     /** Tag entries to update the order ID for */

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

@@ -1 +1 @@
-{"version":3,"file":"update-order-ids.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/update-order-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,KAAK,mBAAmB,GAAG;IACzB,KAAK,EAAE,cAAc,CAAA;IACrB,UAAU,EAAE,WAAW,CAAA;CACxB,GAAG,CACA;IACE,8DAA8D;IAC9D,OAAO,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAA;IAC1E,SAAS,EAAE,eAAe,CAAA;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,6CAA6C;IAC7C,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAA;IACnC,GAAG,EAAE,SAAS,CAAA;CACf,CACJ,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,gCAAgC,mBAAmB,SAiEjF,CAAA"}
+{"version":3,"file":"update-order-ids.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/update-order-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,KAAK,mBAAmB,GAAG;IACzB,KAAK,EAAE,cAAc,CAAA;IACrB,UAAU,EAAE,WAAW,CAAA;CACxB,GAAG,CACA;IACE,8DAA8D;IAC9D,OAAO,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAA;IAC1E,SAAS,EAAE,eAAe,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,6CAA6C;IAC7C,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAA;IACnC,GAAG,EAAE,SAAS,CAAA;CACf,CACJ,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,gCAAgC,mBAAmB,SAiEjF,CAAA"}

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;AAKH,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,2BAA2B,CAAA;AAStF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,eAahC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,eA2CpE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QAAO,eAwCjC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAO,eA6BtC,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;AAED,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,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;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,eA2CpE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QAAO,eAwCjC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAO,eA6BtC,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,eAmFrC,CAAA;AAKD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,eAaxC,CAAA;AAED,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/plugins/bundler/index.js

@@ -273,8 +273,9 @@ export const syncPathParameters = () => {
             }
             const pathString = path[1];
             // Sync parameters for each operation method
-            for (const method of HTTP_METHODS) {
-                const operation = getResolvedRef(node[method], context);
+            const additionalOperations = isObject(node.additionalOperations) ? Object.values(node.additionalOperations) : [];
+            for (const operationNode of [...HTTP_METHODS.map((method) => node[method]), ...additionalOperations]) {
+                const operation = getResolvedRef(operationNode, context);
                 if (!isObject(operation)) {
                     continue;
                 }

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

@@ -43,6 +43,6 @@ export declare const buildRequestBody: (requestBody: RequestBodyObject | undefin
 /** The key of the current example */
 exampleName?: string, 
 /** Selected anyOf/oneOf request-body variants keyed by schema path */
-requestBodyCompositionSelection?: Record<string, number>) => RequestBody | null;
+requestBodyCompositionSelection?: Record<string, number>, openapiVersion?: string) => RequestBody | null;
 export {};
 //# sourceMappingURL=build-request-body.d.ts.map

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":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAA;AAKjG,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,mBAAmB,CAAA;AAO1B,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;QACb,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,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;AAwBD,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,GACnB,QAAQ,GACR,UAAU,GACV,GAAG,GACH;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AA2CtE;;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,IA8WhB,CAAA"}
+{"version":3,"file":"build-request-body.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/build-request-body.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAA;AAKjG,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,mBAAmB,CAAA;AAO1B,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;QACb,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,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;AAwBD,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,GACnB,QAAQ,GACR,UAAU,GACV,GAAG,GACH;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AA2CtE;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,iBAAiB,GAAG,SAAS;AAC1C,qCAAqC;AACrC,oBAAuB;AACvB,sEAAsE;AACtE,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxD,iBAAiB,MAAM,KACtB,WAAW,GAAG,IAoXhB,CAAA"}

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

@@ -67,7 +67,7 @@ export const buildRequestBody = (requestBody,
 /** The key of the current example */
 exampleName = 'default', 
 /** Selected anyOf/oneOf request-body variants keyed by schema path */
-requestBodyCompositionSelection) => {
+requestBodyCompositionSelection, openapiVersion) => {
     if (!requestBody) {
         return null;
     }
@@ -77,7 +77,7 @@ requestBodyCompositionSelection) => {
         return null;
     }
     /** An example value */
-    const example = getExampleFromBody(requestBody, bodyContentType, exampleName, requestBodyCompositionSelection);
+    const example = getExampleFromBody(requestBody, bodyContentType, exampleName, requestBodyCompositionSelection, openapiVersion);
     if (!example) {
         return null;
     }

package/dist/request-example/builder/body/get-request-body-example.d.ts

@@ -5,14 +5,14 @@ import type { ExampleObject, RequestBodyObject } from '@scalar/workspace-store/s
  * This is the schema-generation half of {@link getExampleFromBody}. It is exposed on its own so
  * callers that need to regenerate a body for a freshly selected composition branch (rather than the
  * edited example that would otherwise shadow it) produce the exact same value the initial example
- * does. The schema is deep-resolved first so nested `$ref` members (common for composition branches)
- * are materialized instead of emitting `null` for referenced sub-objects.
+ * does. Data generation deep-resolves nested `$ref` members. XML retains reference sites so node
+ * naming and version-specific wrappers survive serialization.
  *
  * Returns `undefined` when there is no schema for the content type.
  */
-export declare const getSchemaExampleFromBody: (requestBody: RequestBodyObject, contentType: string, requestBodyCompositionSelection?: Record<string, number>) => unknown;
+export declare const getSchemaExampleFromBody: (requestBody: RequestBodyObject, contentType: string, requestBodyCompositionSelection?: Record<string, number>, openapiVersion?: string) => unknown;
 /**
  * Basically getExample + we generate an example from the schema if no example is found
  */
-export declare const getExampleFromBody: (requestBody: RequestBodyObject, contentType: string, exampleName: string, requestBodyCompositionSelection?: Record<string, number>) => ExampleObject | null;
+export declare const getExampleFromBody: (requestBody: RequestBodyObject, contentType: string, exampleName: string, requestBodyCompositionSelection?: Record<string, number>, openapiVersion?: string) => ExampleObject | null;
 //# sourceMappingURL=get-request-body-example.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-request-body-example.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/get-request-body-example.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AAQrE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,iBAAiB,EAC9B,aAAa,MAAM,EACnB,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvD,OAwBF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,iBAAiB,EAC9B,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvD,aAAa,GAAG,IAwBlB,CAAA"}
+{"version":3,"file":"get-request-body-example.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/get-request-body-example.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AASrE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,iBAAiB,EAC9B,aAAa,MAAM,EACnB,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxD,iBAAiB,MAAM,KACtB,OAgCF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,iBAAiB,EAC9B,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxD,iBAAiB,MAAM,KACtB,aAAa,GAAG,IA0ClB,CAAA"}

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

@@ -1,26 +1,36 @@
+import { isXmlMediaType } from '@scalar/helpers/http/is-xml-media-type';
 import { parseMimeType } from '@scalar/helpers/http/mime-type';
 import { getExampleValue } from '../../../helpers/get-example-value.js';
 import { getResolvedRefDeep } from '../../../helpers/get-resolved-ref-deep.js';
 import { serializeStreamExample } from '../../../helpers/serialize-stream-example.js';
 import { getExample } from '../../../request-example/builder/helpers/get-example.js';
 import { getExampleFromSchema } from '../../../request-example/builder/helpers/get-example-from-schema.js';
+import { getXmlBodyExample } from '../../../request-example/xml/get-xml-body-example.js';
 /**
  * Generate a write-mode example directly from a request body's schema, ignoring any stored example.
  *
  * This is the schema-generation half of {@link getExampleFromBody}. It is exposed on its own so
  * callers that need to regenerate a body for a freshly selected composition branch (rather than the
  * edited example that would otherwise shadow it) produce the exact same value the initial example
- * does. The schema is deep-resolved first so nested `$ref` members (common for composition branches)
- * are materialized instead of emitting `null` for referenced sub-objects.
+ * does. Data generation deep-resolves nested `$ref` members. XML retains reference sites so node
+ * naming and version-specific wrappers survive serialization.
  *
  * Returns `undefined` when there is no schema for the content type.
  */
-export const getSchemaExampleFromBody = (requestBody, contentType, requestBodyCompositionSelection) => {
+export const getSchemaExampleFromBody = (requestBody, contentType, requestBodyCompositionSelection, openapiVersion) => {
     const mediaType = requestBody.content?.[contentType];
     const schema = mediaType?.schema ??
         (mediaType?.itemSchema && parseMimeType(contentType).type === 'multipart'
             ? { type: 'array', items: mediaType.itemSchema }
             : mediaType?.itemSchema);
+    if (isXmlMediaType(contentType)) {
+        return getXmlBodyExample(mediaType?.schema, undefined, {
+            openapiVersion,
+            mode: 'write',
+            compositionSelection: requestBodyCompositionSelection,
+            schemaPath: ['requestBody'],
+        }).xml;
+    }
     if (!schema) {
         return undefined;
     }
@@ -36,11 +46,25 @@ export const getSchemaExampleFromBody = (requestBody, contentType, requestBodyCo
 /**
  * Basically getExample + we generate an example from the schema if no example is found
  */
-export const getExampleFromBody = (requestBody, contentType, exampleName, requestBodyCompositionSelection) => {
+export const getExampleFromBody = (requestBody, contentType, exampleName, requestBodyCompositionSelection, openapiVersion) => {
     // Return the existing example when it carries a usable value. An example that only has an
     // `externalValue` (not yet resolved to a `value`) is treated as missing, so we fall back to a
     // schema-generated example instead of building an empty request body.
     const example = getExample(requestBody, exampleName, contentType);
+    if (isXmlMediaType(contentType)) {
+        const result = getXmlBodyExample(requestBody.content?.[contentType]?.schema, example, {
+            openapiVersion,
+            mode: 'write',
+            compositionSelection: requestBodyCompositionSelection,
+            schemaPath: ['requestBody'],
+        });
+        if (result.xml === undefined)
+            return null;
+        // Consumers select dataValue before value, so retain the serialized result for editor and wire output.
+        return example?.dataValue !== undefined
+            ? { ...example, value: result.xml, serializedValue: result.xml }
+            : { ...example, value: result.xml };
+    }
     const selected = getExampleValue(example);
     if (example && selected) {
         const stream = typeof selected.value === 'string' ? undefined : serializeStreamExample(selected.value, contentType, false);
@@ -52,7 +76,7 @@ export const getExampleFromBody = (requestBody, contentType, exampleName, reques
         return selected.source === 'value' ? example : { ...example, value: selected.value };
     }
     // Generate an example from the schema
-    const schemaExample = getSchemaExampleFromBody(requestBody, contentType, requestBodyCompositionSelection);
+    const schemaExample = getSchemaExampleFromBody(requestBody, contentType, requestBodyCompositionSelection, openapiVersion);
     if (schemaExample === undefined || schemaExample === null) {
         return null;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"build-request.d.ts","sourceRoot":"","sources":["../../../src/request-example/builder/build-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,8BAA8B,CAAA;AAQnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,uDAAuD,CAAA;AAK9D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;AAwClD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,cAAc,EACvB,cAAc,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB;IAAE,6BAA6B,CAAC,EAAE,OAAO,CAAA;CAAE,KAC3D,MAyBF,CAAA;AAED;;;;;KAKK;AACL,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kGAAkG;IAClG,cAAc,EAAE,cAAc,CAAA;IAC9B,2BAA2B;IAC3B,UAAU,EAAE,eAAe,CAAA;IAC3B,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAA;AAEnE,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,OAAO,oBAAoB,CAAA;AAEjG,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAA;AAElF,eAAO,MAAM,YAAY,GACvB,SAAS,cAAc,EACvB,SAAS;IACP,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;OAGG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAA;CACxC,KACA,kBAMF,CAAA"}
+{"version":3,"file":"build-request.d.ts","sourceRoot":"","sources":["../../../src/request-example/builder/build-request.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,8BAA8B,CAAA;AAQnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,uDAAuD,CAAA;AAK9D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;AAwClD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,cAAc,EACvB,cAAc,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB;IAAE,6BAA6B,CAAC,EAAE,OAAO,CAAA;CAAE,KAC3D,MAyBF,CAAA;AAED;;;;;KAKK;AACL,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kGAAkG;IAClG,cAAc,EAAE,cAAc,CAAA;IAC9B,2BAA2B;IAC3B,UAAU,EAAE,eAAe,CAAA;IAC3B,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAA;AAEnE,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,OAAO,oBAAoB,CAAA;AAEjG,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAA;AAElF,eAAO,MAAM,YAAY,GACvB,SAAS,cAAc,EACvB,SAAS;IACP,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;OAGG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAA;CACxC,KACA,kBAMF,CAAA"}

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

@@ -1,3 +1,4 @@
+import { isHttpMethod } from '@scalar/helpers/http/is-http-method';
 import { X_SCALAR_DATE, X_SCALAR_DNT, X_SCALAR_REFERER, X_SCALAR_USER_AGENT } from '@scalar/helpers/http/scalar-headers';
 import { replaceEnvVariables } from '@scalar/helpers/regex/replace-variables';
 import { err, ok } from '@scalar/helpers/types/result';
@@ -206,7 +207,7 @@ const buildRequestInner = (request, options) => {
                  *
                  * @see https://github.com/whatwg/fetch/issues/50
                  */
-                method: request.method.toUpperCase(),
+                method: isHttpMethod(request.method) ? request.method.toUpperCase() : request.method,
                 headers,
                 body,
                 cache: request.cache,

package/dist/request-example/builder/header/build-request-parameters.d.ts

@@ -20,5 +20,7 @@ exampleName?: string) => {
     pathVariables: Record<string, string>;
     allowReservedQueryParameters: Set<string>;
     urlParams: URLSearchParams;
+    serializedQuery?: string[];
+    serializedPathParameters?: Set<string>;
 };
 //# sourceMappingURL=build-request-parameters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build-request-parameters.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/build-request-parameters.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,qEAAqE,CAAA;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAA;AAqBlH;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;AACjC,qBAAqB;AACrB,aAAY,aAAa,CAAC,eAAe,CAAC,EAAO;AACjD,qCAAqC;AACrC,cAAa,MAAkB,KAC9B;IACD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,4BAA4B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,SAAS,EAAE,eAAe,CAAA;CAqG3B,CAAA"}
+{"version":3,"file":"build-request-parameters.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/build-request-parameters.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,qEAAqE,CAAA;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAA;AAqBlH;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;AACjC,qBAAqB;AACrB,aAAY,aAAa,CAAC,eAAe,CAAC,EAAO;AACjD,qCAAqC;AACrC,cAAa,MAAkB,KAC9B;IACD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,4BAA4B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,SAAS,EAAE,eAAe,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,wBAAwB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CA8IvC,CAAA"}

package/dist/request-example/builder/header/build-request-parameters.js

@@ -3,8 +3,8 @@ import { isObject } from '@scalar/helpers/object/is-object';
 import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref';
 import { xScalarCookieSchema, } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies';
 import { coerceValue } from '@scalar/workspace-store/schemas/typebox-coerce';
+import { getParameterExample } from '../../../helpers/get-parameter-example.js';
 import { deSerializeParameter } from '../../../request-example/builder/header/de-serialize-parameter.js';
-import { getExample } from '../helpers/get-example.js';
 import { isParamDisabled } from './is-param-disabled.js';
 import { serializeContentValue, serializeCookieStyle, serializeDeepObjectStyle, serializeFormStyle, serializeFormStyleForCookies, serializePipeDelimitedStyle, serializeSimpleStyle, serializeSpaceDelimitedStyle, } from './serialize-parameter.js';
 /** Helper to get explode value with default */
@@ -38,15 +38,58 @@ exampleName = 'default') => {
     // Second pass: process all parameters
     for (const referencedParam of parameters) {
         const param = getResolvedRef(referencedParam);
-        if (!param)
+        if (!param) {
             continue;
-        const example = getExample(param, exampleName, undefined);
+        }
+        const selected = getParameterExample(param, exampleName);
+        const { example, value } = selected;
         // Skip disabled examples
         if (!example || isParamDisabled(param, example)) {
             continue;
         }
-        /** Replace environment variables in the key and value */
-        const value = example.value;
+        /** Parameter-level wire text already contains its name, delimiters, and encoding. */
+        if (selected.serialized) {
+            const wireValue = String(value);
+            switch (param.in) {
+                case 'query':
+                    ;
+                    (result.serializedQuery ??= []).push(wireValue);
+                    break;
+                case 'path':
+                    result.pathVariables[param.name] = wireValue;
+                    (result.serializedPathParameters ??= new Set()).add(param.name);
+                    break;
+                case 'header':
+                    result.headers[param.name] = wireValue;
+                    break;
+                case 'cookie':
+                    result.headers.Cookie = [result.headers.Cookie, wireValue].filter(Boolean).join('; ');
+                    break;
+            }
+            continue;
+        }
+        if (selected.mediaSerialized) {
+            const text = String(value);
+            switch (param.in) {
+                case 'query':
+                    result.urlParams.set(param.name, text);
+                    break;
+                case 'header':
+                    result.headers[param.name] = text;
+                    break;
+                case 'path':
+                    result.pathVariables[param.name] = text;
+                    break;
+                case 'cookie':
+                    result.cookies.push(coerceValue(xScalarCookieSchema, {
+                        name: encodeURIComponent(param.name),
+                        value: encodeURIComponent(text),
+                        path: '/',
+                    }));
+                    break;
+            }
+            continue;
+        }
         /** De-serialize the example value if it is a string and matches the schema type */
         const deSerializedValue = deSerializeParameter(value, param);
         const paramName = param.name;
@@ -82,11 +125,7 @@ exampleName = 'default') => {
                 result.pathVariables[paramName] = String(serialized);
                 break;
             }
-            // The 3.2 `querystring` location represents the whole query string. Handle it like a
-            // regular query parameter so schema-based values still expand into the query string
-            // instead of being silently dropped.
-            case 'query':
-            case 'querystring': {
+            case 'query': {
                 processQueryParameter(param, paramName, deSerializedValue, result.urlParams, result.allowReservedQueryParameters);
                 break;
             }

package/dist/request-example/builder/header/is-param-disabled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-param-disabled.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/is-param-disabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AAElH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,eAAe,EACtB,SAAS,aAAa,GAAG,SAAS,EAClC,kBAAiB,OAAc,KAC9B,OAgBF,CAAA"}
+{"version":3,"file":"is-param-disabled.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/is-param-disabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AAIlH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,eAAe,EACtB,SAAS,aAAa,GAAG,SAAS,EAClC,kBAAiB,OAAc,KAC9B,OAiBF,CAAA"}

package/dist/request-example/builder/header/is-param-disabled.js

@@ -1,3 +1,4 @@
+import { getExampleValue } from '../../../helpers/get-example-value.js';
 /**
  * Determines if a parameter is disabled
  *
@@ -16,7 +17,8 @@ export const isParamDisabled = (param, example, defaultDisabled = true) => {
         return xDisabled;
     }
     // Keep the editor, generated snippets, and outgoing requests aligned for pre-populated values.
-    const hasValue = example?.value !== undefined && example.value !== '' && example.value !== null;
+    const value = getExampleValue(example)?.value;
+    const hasValue = value !== undefined && value !== '' && value !== null;
     if (!defaultDisabled || hasValue) {
         return false;
     }

package/dist/request-example/builder/helpers/example-evaluation.d.ts

@@ -0,0 +1,19 @@
+import type { DynamicScope } from '../../../helpers/dynamic-ref.js';
+import type { SchemaObject } from '../../../schemas/v3.1/strict/openapi-document.js';
+/** Schema provenance collected only when a format needs more than the generated data. */
+export type ExampleEvaluation = {
+    schema: SchemaObject;
+    value: unknown;
+    path: string[];
+    name?: string;
+    dynamicScope: DynamicScope;
+    children: ExampleEvaluation[];
+};
+/** Per-call capture state; never shared with the JSON result cache. */
+export type ExampleEvaluationState = {
+    stack: ExampleEvaluation[];
+    root?: ExampleEvaluation;
+};
+/** Internal option: keep the default JSON generation path free of provenance allocations. */
+export declare const EXAMPLE_EVALUATION: unique symbol;
+//# sourceMappingURL=example-evaluation.d.ts.map

package/dist/request-example/builder/helpers/example-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-evaluation.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/example-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B,CAAA;AAED,uEAAuE;AACvE,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,iBAAiB,CAAA;CACzB,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,eAA+B,CAAA"}

package/dist/request-example/builder/helpers/example-evaluation.js

@@ -0,0 +1,2 @@
+/** Internal option: keep the default JSON generation path free of provenance allocations. */
+export const EXAMPLE_EVALUATION = Symbol('example-evaluation');

package/dist/request-example/builder/helpers/get-example-from-schema.d.ts

@@ -1,9 +1,15 @@
 import { type DynamicScope } from '../../../helpers/dynamic-ref.js';
 import type { SchemaObject } from '../../../schemas/v3.2/strict/openapi-document.js';
-type GetExampleFromSchemaOptions = {
+import { EXAMPLE_EVALUATION, type ExampleEvaluationState } from './example-evaluation.js';
+/** Select a composition branch once for both generated values and supplied example metadata. */
+export declare const selectExampleComposition: (schema: SchemaObject, schemaPath: string[], options?: GetExampleFromSchemaOptions, arrayItem?: boolean, value?: Record<string, unknown>) => SchemaObject | undefined;
+/** Options shared by data generation and schema-aware serializers. */
+export type GetExampleFromSchemaOptions = {
+    /** Internal provenance capture, excluded from persistent result caches. */
+    [EXAMPLE_EVALUATION]?: ExampleEvaluationState;
     /** Fallback string for empty string values. */
     emptyString?: string;
-    /** Whether to use XML tag names as keys. */
+    /** @deprecated Use getXmlExampleFromSchema for schema-aware XML serialization. */
     xml?: boolean;
     /** Whether to show read-only/write-only properties. */
     mode?: 'read' | 'write';
@@ -37,7 +43,7 @@ type GetExampleFromSchemaOptions = {
  * @param name - The name of the property being processed.
  * @returns An example value for the given schema.
  */
-export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, { level, parentSchema, name, seen, schemaPath, dynamicScope, }?: Partial<{
+declare const generateExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, { level, parentSchema, name, seen, schemaPath, dynamicScope, }?: Partial<{
     level: number;
     parentSchema: SchemaObject;
     name: string;
@@ -47,5 +53,7 @@ export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetE
     /** Chain of schema resources entered so far, used to resolve `$dynamicRef` (JSON Schema 2020-12). */
     dynamicScope: DynamicScope;
 }>) => unknown;
+/** Generate data, optionally retaining the exact schema decisions for another output format. */
+export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, context?: Parameters<typeof generateExampleFromSchema>[2]) => unknown;
 export {};
 //# sourceMappingURL=get-example-from-schema.d.ts.map

package/dist/request-example/builder/helpers/get-example-from-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-example-from-schema.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example-from-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAqD,MAAM,uBAAuB,CAAA;AAG5G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAiyB1E,KAAK,2BAA2B,GAAG;IACjC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,8BAA8B,CAAC,EAAE,OAAO,CAAA;IACxC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C,CAAA;AAuPD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,iEAOG,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qGAAqG;IACrG,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAM,KACN,OAuPF,CAAA"}
+{"version":3,"file":"get-example-from-schema.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example-from-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAqD,MAAM,uBAAuB,CAAA;AAG5G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E,OAAO,EAAE,kBAAkB,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAoZ9G,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,GACnC,QAAQ,YAAY,EACpB,YAAY,MAAM,EAAE,EACpB,UAAU,2BAA2B,EACrC,mBAAiB,EACjB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,YAAY,GAAG,SAmBjB,CAAA;AAuZD,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,2EAA2E;IAC3E,CAAC,kBAAkB,CAAC,CAAC,EAAE,sBAAsB,CAAA;IAC7C,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,8BAA8B,CAAC,EAAE,OAAO,CAAA;IACxC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C,CAAA;AAuPD;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,yBAAyB,GAC7B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,iEAOG,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qGAAqG;IACrG,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAM,KACN,OA8OF,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,UAAS,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAM,KAC5D,OA0BF,CAAA"}