@scalar/workspace-store 0.68.2 → 0.68.4

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

@@ -1,3 +1,4 @@
+import { isObject } from '@scalar/helpers/object/is-object';
 import { getResolvedRef, mergeSiblingReferences } from '../../helpers/get-resolved-ref.js';
 import { isHidden } from '../../helpers/is-hidden.js';
 import { getNavigationTagNames } from '../../navigation/helpers/get-navigation-tag-names.js';
@@ -15,7 +16,7 @@ const createSchemaEntry = ({ ref, name, generateId, parentTag, _schema, parentId
     const schema = getResolvedRef(_schema);
     // Use schema.title if available, otherwise fall back to name
     // @see https://json-schema.org/draft/2020-12/json-schema-core#section-4.3.5
-    const title = (schema && 'title' in schema && schema.title) || name;
+    const title = (isObject(schema) && 'title' in schema && schema.title) || name;
     const entry = {
         id,
         title,

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

@@ -1 +1 @@
-{"version":3,"file":"traverse-tags.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-tags.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,wCAAwC,CAAA;AAIxF,KAAK,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC,CAAA;AAmS1F;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,2FAK1B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB,KAAG,cAAc,EAuEjB,CAAA"}
+{"version":3,"file":"traverse-tags.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-tags.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,wCAAwC,CAAA;AAIxF,KAAK,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC,CAAA;AAqS1F;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,2FAK1B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB,KAAG,cAAc,EAuEjB,CAAA"}

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

@@ -2,6 +2,7 @@ import { sortByOrder } from '@scalar/helpers/array/sort-by-order';
 import { getTagKind } from '../../helpers/get-tag-kind.js';
 import { isHidden } from '../../helpers/is-hidden.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
+import { getTagExternalDocs } from '../../navigation/helpers/get-tag-external-docs.js';
 import { getXKeysFromObject } from '../../navigation/helpers/get-x-keys.js';
 import { getTag } from './get-tag.js';
 /** Creates a traversed tag entry from an OpenAPI tag object.
@@ -22,6 +23,7 @@ const createTagEntry = ({ tag, generateId, children, isGroup = false, isTagGroup
         isTagGroup,
     });
     // `summary` is the OpenAPI 3.2 display label; `x-displayName` keeps precedence for backwards compatibility.
+    const externalDocs = getTagExternalDocs(tag);
     const title = tag['x-displayName'] ?? tag.summary ?? tag.name ?? 'Untitled Tag';
     // Update the order of the children based on the items
     // This will ensure that the sort order is always in sync with the items
@@ -31,6 +33,7 @@ const createTagEntry = ({ tag, generateId, children, isGroup = false, isTagGroup
         title,
         name: tag.name || title,
         description: tag.description,
+        ...(externalDocs ? { externalDocs } : {}),
         children,
         isGroup,
         // Only tag on legacy `x-tagGroups` wrappers so the renderer can flatten them without a header.

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,eAmFrC,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,eA6CpE,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

@@ -57,8 +57,9 @@ export const externalValueResolver = (options) => {
             const resolvedValue = resolveReferencePath(context.origin, externalValue);
             if (options?.lazy) {
                 const path = context.path.at(-2) === 'examples' ? context.path : (context.referencedFromPath ?? context.path);
-                if (path.at(-2) !== 'examples' || isSchemaPath(path))
+                if (path.at(-2) !== 'examples' || isSchemaPath(path)) {
                     return;
+                }
                 // Preserve the referenced document origin before bundling loses that context.
                 node['externalValue'] = resolvedValue;
                 return;

package/dist/plugins/bundler/openapi-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-document.d.ts","sourceRoot":"","sources":["../../../src/plugins/bundler/openapi-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAwB,MAAM,2BAA2B,CAAA;AAE7G,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,gBAcpC,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,eAAe,QAAO,eAsClC,CAAA"}
+{"version":3,"file":"openapi-document.d.ts","sourceRoot":"","sources":["../../../src/plugins/bundler/openapi-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAwB,MAAM,2BAA2B,CAAA;AAE7G,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,gBAcpC,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,eAAe,QAAO,eAwClC,CAAA"}

package/dist/plugins/bundler/openapi-document.js

@@ -19,8 +19,9 @@ export const openApiDocument = () => {
     const authoredRefs = new WeakMap();
     const paths = new WeakMap();
     const indexPaths = (value, path) => {
-        if (value === null || typeof value !== 'object' || paths.has(value))
+        if (value === null || typeof value !== 'object' || paths.has(value)) {
             return;
+        }
         paths.set(value, path);
         for (const [key, child] of Object.entries(value)) {
             indexPaths(child, [...path, key]);

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

@@ -1 +1 @@
-{"version":3,"file":"build-multipart.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/build-multipart.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,eAAe,EACf,YAAY,EACb,MAAM,8DAA8D,CAAA;AAQrE,sGAAsG;AACtG,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,GAAG,CACA;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CACrE,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAAI,aAAa,MAAM,EAAE,OAAO,eAAe,KAAG,OASnF,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,GAAI,aAAa,MAAM,EAAE,OAAO,eAAe,KAAG,OASpF,CAAA;AA4CD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,YAAY,GAAG,SAAS,EAChC,OAAO,MAAM,EACb,aAAa,eAAe,CAAC,YAAY,CAAC,KACzC,YAAY,GAAG,SAMa,CAAA;AAc/B,6FAA6F;AAC7F,eAAO,MAAM,cAAc,GACzB,OAAO,OAAO,EACd,aAAa,MAAM,EACnB,WAAU,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAM,EACnG,SAAS,YAAY,EACrB,gBAAW,KACV,aAAa,EAkIf,CAAA"}
+{"version":3,"file":"build-multipart.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/build-multipart.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,eAAe,EACf,YAAY,EACb,MAAM,8DAA8D,CAAA;AAQrE,sGAAsG;AACtG,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,GAAG,CACA;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CACrE,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAAI,aAAa,MAAM,EAAE,OAAO,eAAe,KAAG,OASnF,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,GAAI,aAAa,MAAM,EAAE,OAAO,eAAe,KAAG,OASpF,CAAA;AA4CD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,YAAY,GAAG,SAAS,EAChC,OAAO,MAAM,EACb,aAAa,eAAe,CAAC,YAAY,CAAC,KACzC,YAAY,GAAG,SAMa,CAAA;AAc/B,6FAA6F;AAC7F,eAAO,MAAM,cAAc,GACzB,OAAO,OAAO,EACd,aAAa,MAAM,EACnB,WAAU,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAM,EACnG,SAAS,YAAY,EACrB,gBAAW,KACV,aAAa,EAmIf,CAAA"}

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

@@ -83,8 +83,9 @@ export const buildMultipart = (value, contentType, encoding = {}, schema, nestin
     }
     const named = parseMimeType(contentType).essence === 'multipart/form-data';
     const positional = Array.isArray(value);
-    const entries = positional
-        ? value.map((item, index) => {
+    let entries = [];
+    if (positional) {
+        entries = value.map((item, index) => {
             const itemEncoding = index < (encoding.prefixEncoding?.length ?? 0) ? encoding.prefixEncoding?.[index] : encoding.itemEncoding;
             const itemSchema = getMultipartItemSchema(schema, index, encoding.itemSchema);
             if (named && item !== null && typeof item === 'object' && !Array.isArray(item)) {
@@ -97,20 +98,21 @@ export const buildMultipart = (value, contentType, encoding = {}, schema, nestin
                 return [entry[0], entry[1], itemEncoding, resolveLeafSchema(itemSchema, [entry[0]])];
             }
             return [undefined, item, itemEncoding, itemSchema];
-        })
-        : value !== null && typeof value === 'object'
-            ? Object.entries(value).flatMap(([key, item]) => {
-                const propertySchema = resolveLeafSchema(schema, [key]);
-                return (Array.isArray(item) ? item : [item]).map((part) => [
-                    key,
-                    part,
-                    encoding.encoding?.[key],
-                    Array.isArray(item)
-                        ? getResolvedRef(propertySchema && isArraySchema(propertySchema) ? propertySchema.items : undefined, mergeSiblingReferences)
-                        : propertySchema,
-                ]);
-            })
-            : [];
+        });
+    }
+    else if (value !== null && typeof value === 'object') {
+        entries = Object.entries(value).flatMap(([key, item]) => {
+            const propertySchema = resolveLeafSchema(schema, [key]);
+            return (Array.isArray(item) ? item : [item]).map((part) => [
+                key,
+                part,
+                encoding.encoding?.[key],
+                Array.isArray(item)
+                    ? getResolvedRef(propertySchema && isArraySchema(propertySchema) ? propertySchema.items : undefined, mergeSiblingReferences)
+                    : propertySchema,
+            ]);
+        });
+    }
     return entries.flatMap(([key, item, partEncoding, partSchema]) => {
         const style = named && hasEncodingStyle(partEncoding);
         const styleParts = style ? serializeFormPropertyWithEncoding(key ?? '', item, partEncoding) : null;

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

@@ -1 +1 @@
-{"version":3,"file":"encode-multipart-body.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/encode-multipart-body.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AA0BtD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,GACjC,OAAO,aAAa,EAAE,EACtB,oBAAmC,EACnC,UAAS,CAAC,KAAK,EAAE,MAAM,KAAK,MAAyB,EACrD,gBAAW,KACV;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CA6C3C,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,EAAE,EACtB,oBAAmC,EACnC,UAAU,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,KAClC,IAGF,CAAA"}
+{"version":3,"file":"encode-multipart-body.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/encode-multipart-body.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AA0BtD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,GACjC,OAAO,aAAa,EAAE,EACtB,oBAAmC,EACnC,UAAS,CAAC,KAAK,EAAE,MAAM,KAAK,MAAyB,EACrD,gBAAW,KACV;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CA8C3C,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,EAAE,EACtB,oBAAmC,EACnC,UAAU,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,KAClC,IAGF,CAAA"}

package/dist/request-example/builder/body/encode-multipart-body.js

@@ -33,7 +33,8 @@ export const serializeMultipartBody = (parts, contentType = 'multipart/form-data
         const encoded = part.type === 'multipart'
             ? serializeMultipartBody(part.value, part.contentType, replace, nesting + 1)
             : { chunks: [part.type === 'text' ? replace(part.value) : part.value], contentType: part.contentType };
-        const filename = part.type === 'file' ? part.value.name : part.type === 'blob' ? 'blob' : undefined;
+        const blobFilename = part.type === 'blob' ? 'blob' : undefined;
+        const filename = part.type === 'file' ? part.value.name : blobFilename;
         const partContentType = encoded.contentType ??
             (part.type === 'file' || part.type === 'blob' ? part.value.type || 'application/octet-stream' : undefined);
         if (partContentType && /[\r\n\0]/.test(partContentType)) {

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

@@ -5,8 +5,8 @@ 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. Data generation deep-resolves nested `$ref` members. XML retains reference sites so node
- * naming and version-specific wrappers survive serialization.
+ * does. Keep reference sites intact so the generator can detect cycles without losing the schema
+ * at the recursion point. XML also needs them for node naming and version-specific wrappers.
  *
  * Returns `undefined` when there is no schema for the content type.
  */

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":"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"}
+{"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;AAUrE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,iBAAiB,EAC9B,aAAa,MAAM,EACnB,kCAAkC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxD,iBAAiB,MAAM,KACtB,OA8BF,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,IA4ClB,CAAA"}

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

@@ -1,8 +1,9 @@
 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 { getResolvedRef } from '../../../helpers/get-resolved-ref.js';
 import { serializeStreamExample } from '../../../helpers/serialize-stream-example.js';
+import { snapshotSchema } from '../../../helpers/snapshot-schema.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';
@@ -12,8 +13,8 @@ import { getXmlBodyExample } from '../../../request-example/xml/get-xml-body-exa
  * 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. Data generation deep-resolves nested `$ref` members. XML retains reference sites so node
- * naming and version-specific wrappers survive serialization.
+ * does. Keep reference sites intact so the generator can detect cycles without losing the schema
+ * at the recursion point. XML also needs them for node naming and version-specific wrappers.
  *
  * Returns `undefined` when there is no schema for the content type.
  */
@@ -31,11 +32,10 @@ export const getSchemaExampleFromBody = (requestBody, contentType, requestBodyCo
             schemaPath: ['requestBody'],
         }).xml;
     }
-    if (!schema) {
+    if (!schema || getResolvedRef(schema) === undefined) {
         return undefined;
     }
-    const resolvedSchema = getResolvedRefDeep(schema);
-    const value = getExampleFromSchema(resolvedSchema, {
+    const value = getExampleFromSchema(snapshotSchema(schema), {
         mode: 'write',
         compositionSelection: requestBodyCompositionSelection,
     }, {
@@ -58,8 +58,9 @@ export const getExampleFromBody = (requestBody, contentType, exampleName, reques
             compositionSelection: requestBodyCompositionSelection,
             schemaPath: ['requestBody'],
         });
-        if (result.xml === undefined)
+        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 }

package/dist/request-example/builder/body/schema-value-coercion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-value-coercion.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/schema-value-coercion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAShG;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,GAAG,SAAS,EAAE,UAAU,MAAM,EAAE,KAAG,YAAY,GAAG,SASvG,CAAA;AA2BD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,GAAG,SAAS,KAAG,OAe9F,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAUnD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,OAAO,aAG1C,MAAM,UAAU,OAAO,YAgBzC,CAAA"}
+{"version":3,"file":"schema-value-coercion.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/body/schema-value-coercion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAYhG;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,GAAG,SAAS,EAAE,UAAU,MAAM,EAAE,KAAG,YAAY,GAAG,SASvG,CAAA;AA2BD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,GAAG,SAAS,KAAG,OAe9F,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAUnD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,OAAO,aAG1C,MAAM,UAAU,OAAO,YAgBzC,CAAA"}

package/dist/request-example/builder/body/schema-value-coercion.js

@@ -3,7 +3,10 @@ import { isObjectSchema } from '@scalar/workspace-store/schemas/v3.2/strict/type
 /** 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];
+    if (Array.isArray(type)) {
+        return [...type];
+    }
+    return type == null ? [] : [type];
 };
 /**
  * Walk an object schema along a dotted-row path and return the resolved leaf schema,

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":"AAIA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,qEAAqE,CAAA;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAA;AAElH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAoB5E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;AACjC,qBAAqB;AACrB,aAAY,aAAa,CAAC,eAAe,CAAC,EAAO;AACjD,qCAAqC;AACrC,cAAa,MAAkB;AAC/B,6DAA6D;AAC7D,iBAAiB,MAAM,KACtB;IACD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC9D,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;CA+JvC,CAAA"}
+{"version":3,"file":"build-request-parameters.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/build-request-parameters.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,qEAAqE,CAAA;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAA;AAElH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAqB5E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;AACjC,qBAAqB;AACrB,aAAY,aAAa,CAAC,eAAe,CAAC,EAAO;AACjD,qCAAqC;AACrC,cAAa,MAAkB;AAC/B,6DAA6D;AAC7D,iBAAiB,MAAM,KACtB;IACD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC9D,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;CAyKvC,CAAA"}

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

@@ -6,6 +6,7 @@ import { xScalarCookieSchema, } from '@scalar/workspace-store/schemas/extensions
 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 { filterDisabledProperties } from './filter-disabled-properties.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 */
@@ -47,7 +48,10 @@ openapiVersion) => {
         const selected = getParameterExample(param, exampleName);
         const { example, value } = selected;
         // Skip disabled examples
-        if (!example || isParamDisabled(param, example)) {
+        const propertyStates = param.in === 'query' && !selected.serialized && !selected.mediaSerialized
+            ? example?.['x-scalar-disabled-properties']
+            : undefined;
+        if (!example || (!propertyStates && isParamDisabled(param, example))) {
             continue;
         }
         /** Parameter-level wire text already contains its name, delimiters, and encoding. */
@@ -94,7 +98,13 @@ openapiVersion) => {
             continue;
         }
         /** De-serialize the example value if it is a string and matches the schema type */
-        const deSerializedValue = deSerializeParameter(value, param);
+        const fullValue = deSerializeParameter(value, param);
+        const deSerializedValue = propertyStates
+            ? filterDisabledProperties(fullValue, propertyStates, isParamDisabled(param, example))
+            : fullValue;
+        if (propertyStates && deSerializedValue === undefined) {
+            continue;
+        }
         const paramName = param.name;
         // Handle by parameter location
         switch (param.in) {

package/dist/request-example/builder/header/filter-disabled-properties.d.ts

@@ -0,0 +1,3 @@
+/** Build the enabled portion of a query object without discarding stored disabled values. */
+export declare const filterDisabledProperties: (value: unknown, states: Record<string, boolean>, inheritedDisabled: boolean, path?: string[]) => unknown;
+//# sourceMappingURL=filter-disabled-properties.d.ts.map

package/dist/request-example/builder/header/filter-disabled-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-disabled-properties.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/filter-disabled-properties.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,EACd,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,mBAAmB,OAAO,EAC1B,OAAM,MAAM,EAAO,KAClB,OAgBF,CAAA"}

package/dist/request-example/builder/header/filter-disabled-properties.js

@@ -0,0 +1,18 @@
+import { isObject } from '@scalar/helpers/object/is-object';
+/** Build the enabled portion of a query object without discarding stored disabled values. */
+export const filterDisabledProperties = (value, states, inheritedDisabled, path = []) => {
+    const disabled = states[JSON.stringify(path)] ?? inheritedDisabled;
+    if (!isObject(value) || Array.isArray(value)) {
+        return disabled ? undefined : value;
+    }
+    const entries = Object.entries(value);
+    const enabled = entries.flatMap(([key, child]) => {
+        const filtered = filterDisabledProperties(child, states, disabled, [...path, key]);
+        return filtered === undefined ? [] : [[key, filtered]];
+    });
+    // Do not serialize parents whose children were all excluded.
+    if (enabled.length === 0 && (disabled || entries.length > 0)) {
+        return undefined;
+    }
+    return Object.fromEntries(enabled);
+};

package/dist/request-example/builder/header/filter-global-cookies.d.ts

@@ -3,7 +3,7 @@ import type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/g
  * Filter a global cookie to determine if it should be included with a request to the given URL.
  * - Returns false if the cookie is disabled, in the disabledGlobalCookies map, or missing a name.
  * - Returns false if the domain does not match.
- * - Returns false if the path is specified and does not match the URL pathname.
+ * - Returns false if the path is specified and the request pathname does not path-match it.
  * - Returns true otherwise.
  */
 export declare const filterGlobalCookie: ({ cookie, url, disabledGlobalCookies, }: {

package/dist/request-example/builder/header/filter-global-cookies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-global-cookies.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/filter-global-cookies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AAIxG;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,yCAIhC;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/C,KAAG,OAqBH,CAAA"}
+{"version":3,"file":"filter-global-cookies.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/header/filter-global-cookies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AAiBxG;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,yCAIhC;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/C,KAAG,OAsBH,CAAA"}

package/dist/request-example/builder/header/filter-global-cookies.js

@@ -1,9 +1,20 @@
 import { matchesDomain } from './matches-domain.js';
+/**
+ * RFC 6265 path-match: cookie-path C matches request-path R when they are the same,
+ * or C is a prefix of R and the next character is a slash. A trailing slash on C
+ * already supplies that boundary, so `/api` matches `/api/users` but not `/apiv2`.
+ */
+const pathMatches = (requestPath, cookiePath) => {
+    if (requestPath === cookiePath || cookiePath.endsWith('/')) {
+        return requestPath.startsWith(cookiePath);
+    }
+    return requestPath.startsWith(`${cookiePath}/`);
+};
 /**
  * Filter a global cookie to determine if it should be included with a request to the given URL.
  * - Returns false if the cookie is disabled, in the disabledGlobalCookies map, or missing a name.
  * - Returns false if the domain does not match.
- * - Returns false if the path is specified and does not match the URL pathname.
+ * - Returns false if the path is specified and the request pathname does not path-match it.
  * - Returns true otherwise.
  */
 export const filterGlobalCookie = ({ cookie, url, disabledGlobalCookies, }) => {
@@ -17,8 +28,9 @@ export const filterGlobalCookie = ({ cookie, url, disabledGlobalCookies, }) => {
     if (cookie.domain && !matchesDomain(url, cookie.domain)) {
         return false;
     }
-    // If a path restriction exists, ensure the cookie is only sent for URLs with a matching prefix.
-    if (cookie.path && !urlObject.pathname.startsWith(cookie.path)) {
+    // An empty path means no path restriction. Otherwise require an RFC 6265 path-match,
+    // so a cookie for `/api` is not sent to `/apiv2`.
+    if (cookie.path && !pathMatches(urlObject.pathname, cookie.path)) {
         return false;
     }
     // Cookie passed all checks; include it in the request.

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

@@ -3,7 +3,7 @@ import type { ExampleObject, ParameterObject } from '@scalar/workspace-store/sch
  * Determines if a parameter is disabled
  *
  * First we explicitly check if its been disabled via the `x-disabled` extension.
- * Populated examples are enabled unless explicitly disabled. Empty optional parameters stay disabled.
+ * Authored populated examples are enabled unless explicitly disabled. Empty optional parameters stay disabled.
  *
  * @param param - The parameter to check.
  * @param example - The example to check.

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;AAIlH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,eAAe,EACtB,SAAS,aAAa,GAAG,SAAS,EAClC,kBAAiB,OAAc,KAC9B,OAiBF,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;AAKlH;;;;;;;;;;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,9 +1,10 @@
 import { getExampleValue } from '../../../helpers/get-example-value.js';
+import { isGeneratedExample } from '../../../request-example/builder/helpers/get-example.js';
 /**
  * Determines if a parameter is disabled
  *
  * First we explicitly check if its been disabled via the `x-disabled` extension.
- * Populated examples are enabled unless explicitly disabled. Empty optional parameters stay disabled.
+ * Authored populated examples are enabled unless explicitly disabled. Empty optional parameters stay disabled.
  *
  * @param param - The parameter to check.
  * @param example - The example to check.
@@ -18,7 +19,7 @@ export const isParamDisabled = (param, example, defaultDisabled = true) => {
     }
     // Keep the editor, generated snippets, and outgoing requests aligned for pre-populated values.
     const value = getExampleValue(example)?.value;
-    const hasValue = value !== undefined && value !== '' && value !== null;
+    const hasValue = value !== undefined && value !== '' && value !== null && !isGeneratedExample(example);
     if (!defaultDisabled || hasValue) {
         return false;
     }

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;AAE1E,OAAO,EAAE,kBAAkB,EAA0B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAwZ9G,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,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+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;AAwPD;;;;;;;;;;;;;;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;AAoBD,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,UAAS,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAM,KAC5D,OA2BF,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;AAwZ9G,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,SAoBjB,CAAA;AAiaD,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,2EAA2E;IAC3E,CAAC,kBAAkB,CAAC,CAAC,EAAE,sBAAsB,CAAA;IAC7C,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+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;AAyPD;;;;;;;;;;;;;;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,OAgPF,CAAA;AAoBD,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,UAAS,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAM,KAC5D,OA2BF,CAAA"}

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

@@ -324,7 +324,8 @@ const consumeCompositionSelection = (options, schemaPath, composition) => {
 };
 /** Select a composition branch once for both generated values and supplied example metadata. */
 export const selectExampleComposition = (schema, schemaPath, options, arrayItem = false, value) => {
-    const keyword = schema.oneOf ? 'oneOf' : schema.anyOf ? 'anyOf' : undefined;
+    const anyOfKeyword = schema.anyOf ? 'anyOf' : undefined;
+    const keyword = schema.oneOf ? 'oneOf' : anyOfKeyword;
     const members = keyword ? schema[keyword] : undefined;
     if (!keyword || !members?.length) {
         return undefined;
@@ -472,16 +473,14 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath,
         // Use propertyNames enum values as example keys when no custom name is set
         const propertyNamesEnum = hasCustomName ? undefined : getPropertyNamesEnumValues(schema);
         const additionalName = hasCustomName ? customName.trim() : DEFAULT_ADDITIONAL_PROPERTIES_NAME;
-        const additionalValue = isAnyType
-            ? 'anything'
-            : typeof additional === 'object'
-                ? getExampleFromSchema(additional, options, {
-                    level: level + 1,
-                    schemaPath: [...schemaPath, additionalName],
-                    seen,
-                    dynamicScope: childScope,
-                })
-                : 'anything';
+        const additionalValue = !isAnyType && typeof additional === 'object'
+            ? getExampleFromSchema(additional, options, {
+                level: level + 1,
+                schemaPath: [...schemaPath, additionalName],
+                seen,
+                dynamicScope: childScope,
+            })
+            : 'anything';
         if (propertyNamesEnum && propertyNamesEnum.length > 0) {
             // Use the first enum value as a realistic example key
             response[String(propertyNamesEnum[0])] = additionalValue;
@@ -490,7 +489,8 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath,
             response[additionalName] = additionalValue;
         }
     }
-    const compositionKeyword = schema.oneOf ? 'oneOf' : schema.anyOf ? 'anyOf' : undefined;
+    const anyOfKeyword = schema.anyOf ? 'anyOf' : undefined;
+    const compositionKeyword = schema.oneOf ? 'oneOf' : anyOfKeyword;
     const oneOfAnyOf = compositionKeyword ? schema[compositionKeyword] : undefined;
     if (compositionKeyword && oneOfAnyOf?.length) {
         const chosen = selectExampleComposition(schema, schemaPath, options, false, response);
@@ -593,7 +593,8 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath, d
                 .filter(isDefined);
             return cache(schema, wrapItems ? examples.map((e) => ({ [itemsXmlTagName]: e })) : examples, cacheKey, skipCache);
         }
-        const compositionKeyword = items.oneOf ? 'oneOf' : items.anyOf ? 'anyOf' : undefined;
+        const anyOfKeyword = items.anyOf ? 'anyOf' : undefined;
+        const compositionKeyword = items.oneOf ? 'oneOf' : anyOfKeyword;
         const union = compositionKeyword ? items[compositionKeyword] : undefined;
         if (compositionKeyword && union && union.length > 0) {
             const selectedIndex = getCompositionSelectionIndex(itemsSchemaPath, compositionKeyword, options, union.length) ??
@@ -607,6 +608,9 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath, d
                 seen: itemsSeen,
                 dynamicScope: childScope,
             });
+            if (ex === undefined) {
+                return undefined;
+            }
             return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey, skipCache);
         }
     }
@@ -619,6 +623,10 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath, d
             seen: itemsSeen,
             dynamicScope: childScope,
         });
+        // Propagate an omitted recursive item so optional arrays do not serialize it as null.
+        if (ex === undefined) {
+            return undefined;
+        }
         return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey, skipCache);
     }
     return cache(schema, [], cacheKey, skipCache);
@@ -730,7 +738,8 @@ const getEmptyContainer = (schema) => {
 };
 /** Pick the `oneOf`/`anyOf` variant the walk itself would have rendered, honoring an explicit selection. */
 const getSelectedVariant = (schema, options, schemaPath) => {
-    const compositionKeyword = schema.oneOf ? 'oneOf' : schema.anyOf ? 'anyOf' : undefined;
+    const anyOfKeyword = schema.anyOf ? 'anyOf' : undefined;
+    const compositionKeyword = schema.oneOf ? 'oneOf' : anyOfKeyword;
     const variants = compositionKeyword ? schema[compositionKeyword] : undefined;
     if (!compositionKeyword || !Array.isArray(variants) || variants.length === 0) {
         return undefined;
@@ -990,7 +999,8 @@ const generateExampleFromSchema = (schema, options, { level = 0, parentSchema, n
     }
     // Resolve non-object unions before type dispatch so shared root keywords do not
     // hide the selected member. Use the same selection and discriminator rules as other unions.
-    const selectedComposition = _schema.oneOf ? 'oneOf' : _schema.anyOf ? 'anyOf' : undefined;
+    const selectedAnyOf = _schema.anyOf ? 'anyOf' : undefined;
+    const selectedComposition = _schema.oneOf ? 'oneOf' : selectedAnyOf;
     const selectedVariant = getSelectedVariant(_schema, options, schemaPath);
     if (selectedComposition && selectedVariant) {
         const rootType = 'type' in _schema ? _schema.type : undefined;
@@ -1037,7 +1047,8 @@ const generateExampleFromSchema = (schema, options, { level = 0, parentSchema, n
         return cache(_schema, primitive, cacheKey, skipCache);
     }
     // Handle composition schemas (oneOf, anyOf)
-    const compositionKeyword = _schema.oneOf ? 'oneOf' : _schema.anyOf ? 'anyOf' : undefined;
+    const anyOfKeyword = _schema.anyOf ? 'anyOf' : undefined;
+    const compositionKeyword = _schema.oneOf ? 'oneOf' : anyOfKeyword;
     const discriminate = compositionKeyword ? _schema[compositionKeyword] : undefined;
     if (compositionKeyword && Array.isArray(discriminate) && discriminate.length > 0) {
         const candidate = selectExampleComposition(_schema, schemaPath, options);

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

@@ -1,4 +1,6 @@
 import type { ExampleObject, MediaTypeObject, ParameterObject, RequestBodyObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
+/** Whether an example contains only enum suggestions rather than authored values. */
+export declare const isGeneratedExample: (example: ExampleObject | undefined) => boolean;
 /**
  * Resolve an example value for a parameter or requestBody from either `examples` or `content.*.examples`.
  * Or the [deprecated] `example` field.

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

@@ -1 +1 @@
-{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EAGlB,MAAM,8DAA8D,CAAA;AAoHrE;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,eAAe,GAAG,iBAAiB,GAAG,eAAe,EAC5D,aAAa,MAAM,GAAG,SAAS,EAC/B,aAAa,MAAM,GAAG,SAAS,KAC9B,aAAa,GAAG,SAyBlB,CAAA"}
+{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EAGlB,MAAM,8DAA8D,CAAA;AAQrE,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,GAAG,SAAS,KAAG,OACf,CAAA;AAuHzD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,eAAe,GAAG,iBAAiB,GAAG,eAAe,EAC5D,aAAa,MAAM,GAAG,SAAS,EAC/B,aAAa,MAAM,GAAG,SAAS,KAC9B,aAAa,GAAG,SAyBlB,CAAA"}

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

@@ -1,5 +1,9 @@
 import { getResolvedRef } from '../../../helpers/get-resolved-ref.js';
 import { resolve } from '../../../resolve.js';
+// Keep suggestion provenance out of API descriptions and persisted user examples.
+const generatedExamples = new WeakSet();
+/** Whether an example contains only enum suggestions rather than authored values. */
+export const isGeneratedExample = (example) => example !== undefined && generatedExamples.has(example);
 /** Helper to get example from examples object with fallback to example field */
 const getExampleFromExamples = (examples, exampleField, exampleName) => {
     if (!examples && exampleField === undefined) {
@@ -34,15 +38,17 @@ const getSchemaExample = (input, walk = { ancestors: new Set(), withoutValues: n
     if ('default' in schema && schema.default !== undefined) {
         return { value: schema.default };
     }
-    if ('enum' in schema && schema.enum?.[0] !== undefined) {
-        return { value: schema.enum[0] };
-    }
     if ('examples' in schema && schema.examples?.[0] !== undefined) {
         return { value: schema.examples[0] };
     }
     if ('example' in schema && schema.example !== undefined) {
         return { value: schema.example };
     }
+    if ('enum' in schema && schema.enum?.[0] !== undefined) {
+        const example = { value: schema.enum[0] };
+        generatedExamples.add(example);
+        return example;
+    }
     // Reference siblings create a fresh merged object, so track the underlying schema for cycles.
     const target = getResolvedRef(input) ?? input;
     if (!('properties' in schema) || !schema.properties) {
@@ -62,7 +68,7 @@ const getSchemaExample = (input, walk = { ancestors: new Set(), withoutValues: n
     walk.ancestors.add(target);
     const properties = Object.entries(schema.properties).flatMap(([name, property]) => {
         const example = getSchemaExample(property, walk);
-        return example === undefined ? [] : [[name, example.value]];
+        return example === undefined ? [] : [{ name, example }];
     });
     walk.ancestors.delete(target);
     // Stops at schemas inside this walk have left the path, so the rest point above it.
@@ -70,7 +76,11 @@ const getSchemaExample = (input, walk = { ancestors: new Set(), withoutValues: n
     walk.stops = outerStops;
     stops.forEach((stop) => outerStops.add(stop));
     if (properties.length > 0) {
-        return { value: Object.fromEntries(properties) };
+        const example = { value: Object.fromEntries(properties.map(({ name, example }) => [name, example.value])) };
+        if (properties.every(({ example }) => isGeneratedExample(example))) {
+            generatedExamples.add(example);
+        }
+        return example;
     }
     walk.withoutValues.set(target, { properties: schema.properties, stops });
     return undefined;

package/dist/request-example/builder/index.d.ts

@@ -5,6 +5,7 @@ export { type SerializedFormProperty, serializeFormPropertyWithEncoding } from '
 export { serializeMultipartArray } from './body/serialize-multipart-array.js';
 export { BUILD_REQUEST_FAILED, type BuildRequestData, type BuildRequestFailureCode, type BuildRequestResult, type RequestPayload, buildRequest, resolveExecutableRequestUrl, } from './build-request.js';
 export { deSerializeParameter, deSerializeSchemaValue } from './header/de-serialize-parameter.js';
+export { filterDisabledProperties } from './header/filter-disabled-properties.js';
 export { filterGlobalCookie } from './header/filter-global-cookies.js';
 export { isParamDisabled } from './header/is-param-disabled.js';
 export { serializeContentValue, serializeCookieStyle, serializeDeepObjectStyle, serializeFormStyle, serializeFormStyleForCookies, serializePipeDelimitedStyle, serializeSimpleStyle, serializeSpaceDelimitedStyle, } from './header/serialize-parameter.js';