oas 31.1.2 → 32.1.0

package/dist/{chunk-BRYRBTD7.cjs → chunk-4OCSFLJO.cjs}

@@ -1,6 +1,5 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
 
-var _chunkO3GIPZLCcjs = require('./chunk-O3GIPZLC.cjs');
 
 
 
@@ -11,125 +10,27 @@ var _chunkO3GIPZLCcjs = require('./chunk-O3GIPZLC.cjs');
 
 
 
-var _chunkB5WP4BJMcjs = require('./chunk-B5WP4BJM.cjs');
+
+
+
+var _chunk7RDMAMMIcjs = require('./chunk-7RDMAMMI.cjs');
 
 
 var _chunkAYA3UT4Lcjs = require('./chunk-AYA3UT4L.cjs');
 
 
-var _chunkVQBEI5WIcjs = require('./chunk-VQBEI5WI.cjs');
+var _chunkYPR7YTHMcjs = require('./chunk-YPR7YTHM.cjs');
 
 // src/operation/index.ts
 var _jsonschemarefparser = require('@apidevtools/json-schema-ref-parser');
 
-// src/lib/build-discriminator-one-of.ts
-function hasDiscriminatorWithoutPolymorphism(schema) {
-  if (!schema || typeof schema !== "object") return false;
-  if (!("discriminator" in schema)) return false;
-  if ("oneOf" in schema || "anyOf" in schema) return false;
-  return true;
-}
-function allOfReferencesSchema(schema, targetSchemaName) {
-  if (!schema || typeof schema !== "object") return false;
-  if (!("allOf" in schema) || !Array.isArray(schema.allOf)) return false;
-  return schema.allOf.some((item) => {
-    if (_chunkVQBEI5WIcjs.isRef.call(void 0, item)) {
-      const refParts = item.$ref.split("/");
-      const refSchemaName = refParts[refParts.length - 1];
-      return refSchemaName === targetSchemaName;
-    }
-    return false;
-  });
-}
-function findDiscriminatorChildren(api) {
-  const childrenMap = /* @__PURE__ */ new Map();
-  const invertedChildrenMap = /* @__PURE__ */ new Map();
-  if (!_optionalChain([api, 'optionalAccess', _2 => _2.components, 'optionalAccess', _3 => _3.schemas]) || typeof api.components.schemas !== "object") {
-    return { children: childrenMap, inverted: invertedChildrenMap };
-  }
-  const schemas = api.components.schemas;
-  const schemaNames = Object.keys(schemas);
-  const discriminatorSchemas = schemaNames.filter((name) => {
-    return hasDiscriminatorWithoutPolymorphism(schemas[name]);
-  });
-  for (const baseName of discriminatorSchemas) {
-    const baseSchema = schemas[baseName];
-    const discriminator = baseSchema.discriminator;
-    let childSchemaNames;
-    if (discriminator.mapping && typeof discriminator.mapping === "object") {
-      const mappingRefs = Object.values(discriminator.mapping);
-      if (mappingRefs.length > 0) {
-        childSchemaNames = mappingRefs.map((ref) => {
-          const parts = ref.split("/");
-          return parts[parts.length - 1];
-        });
-      }
-    }
-    if (!childSchemaNames || childSchemaNames.length === 0) {
-      childSchemaNames = schemaNames.filter((name) => {
-        if (name === baseName) return false;
-        return allOfReferencesSchema(schemas[name], baseName);
-      });
-    }
-    if (childSchemaNames.length > 0) {
-      childrenMap.set(baseName, childSchemaNames);
-    }
-  }
-  for (const [key, values] of childrenMap) {
-    for (const value of values) {
-      if (invertedChildrenMap.has(value)) {
-        _optionalChain([invertedChildrenMap, 'access', _4 => _4.get, 'call', _5 => _5(value), 'optionalAccess', _6 => _6.push, 'call', _7 => _7(key)]);
-      } else {
-        invertedChildrenMap.set(value, [key]);
-      }
-    }
-  }
-  return { children: childrenMap, inverted: invertedChildrenMap };
-}
-function buildDiscriminatorOneOf(api, childrenMap) {
-  if (!_optionalChain([api, 'optionalAccess', _8 => _8.components, 'optionalAccess', _9 => _9.schemas]) || typeof api.components.schemas !== "object") {
-    return;
-  } else if (childrenMap.size === 0) {
-    return;
-  }
-  for (const [schemaName, childNames] of childrenMap) {
-    const schema = api.components.schemas[schemaName];
-    if (!schema) continue;
-    const oneOf = [];
-    for (const childName of childNames) {
-      if (api.components.schemas[childName]) {
-        oneOf.push(_chunkB5WP4BJMcjs.cloneObject.call(void 0, api.components.schemas[childName]));
-      }
-    }
-    if (oneOf.length > 0) {
-      schema.oneOf = oneOf;
-    }
-  }
-  for (const [parentSchemaName, childNames] of childrenMap) {
-    for (const childName of childNames) {
-      const childSchema = api.components.schemas[childName];
-      if (!childSchema || !("allOf" in childSchema) || !Array.isArray(childSchema.allOf)) {
-        continue;
-      }
-      for (let i = 0; i < childSchema.allOf.length; i++) {
-        const item = childSchema.allOf[i];
-        if (item && typeof item === "object" && "x-readme-ref-name" in item && item["x-readme-ref-name"] === parentSchemaName && "oneOf" in item) {
-          const clonedItem = _chunkB5WP4BJMcjs.cloneObject.call(void 0, item);
-          delete clonedItem.oneOf;
-          childSchema.allOf[i] = clonedItem;
-        }
-      }
-    }
-  }
-}
-
 // src/operation/lib/dedupe-common-parameters.ts
 function dedupeCommonParameters(parameters, commonParameters) {
   return commonParameters.filter((param) => {
     return !parameters.find((param2) => {
       if (param.name && param2.name) {
         return param.name === param2.name && param.in === param2.in;
-      } else if (_chunkVQBEI5WIcjs.isRef.call(void 0, param) && _chunkVQBEI5WIcjs.isRef.call(void 0, param2)) {
+      } else if (_chunkYPR7YTHMcjs.isRef.call(void 0, param) && _chunkYPR7YTHMcjs.isRef.call(void 0, param2)) {
         return param.$ref === param2.$ref;
       }
       return false;
@@ -153,7 +54,7 @@ function usesPolymorphism(schema) {
   return false;
 }
 function objectify(thing) {
-  if (!_chunkB5WP4BJMcjs.isObject.call(void 0, thing)) {
+  if (!_chunk7RDMAMMIcjs.isObject.call(void 0, thing)) {
     return {};
   }
   return thing;
@@ -224,27 +125,51 @@ var primitive = (schema) => {
   return `Unknown Type: ${objectifiedSchema.type}`;
 };
 function sampleFromSchema(schema, opts = {}) {
-  const objectifySchema = objectify(schema);
-  let { type } = objectifySchema;
-  const hasPolymorphism = usesPolymorphism(objectifySchema);
+  const seenRefs = opts.seenRefs || /* @__PURE__ */ new Set();
+  let objectifySchema = objectify(schema);
+  let refToRelease;
+  if (opts.definition && _chunkYPR7YTHMcjs.isRef.call(void 0, objectifySchema)) {
+    refToRelease = objectifySchema.$ref;
+    if (seenRefs.has(refToRelease)) {
+      return void 0;
+    }
+    objectifySchema = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, objectifySchema, opts.definition, seenRefs);
+    if (!objectifySchema || _chunkYPR7YTHMcjs.isRef.call(void 0, objectifySchema)) {
+      return void 0;
+    }
+  }
+  try {
+    return sampleFromResolvedSchema(objectifySchema, opts, seenRefs);
+  } finally {
+    if (refToRelease) {
+      seenRefs.delete(refToRelease);
+    }
+  }
+}
+function sampleFromResolvedSchema(schema, opts, seenRefs) {
+  let { type } = schema;
+  const hasPolymorphism = usesPolymorphism(schema);
   if (hasPolymorphism === "allOf") {
     try {
       return sampleFromSchema(
-        _jsonschemamergeallof2.default.call(void 0, objectifySchema, {
+        _jsonschemamergeallof2.default.call(void 0, schema, {
           resolvers: {
             // Ignore any unrecognized OAS-specific keywords that might be present on the schema
             // (like `xml`).
             defaultResolver: _jsonschemamergeallof2.default.options.resolvers.title
           }
         }),
-        opts
+        {
+          ...opts,
+          seenRefs
+        }
       );
     } catch (e) {
       return void 0;
     }
   } else if (hasPolymorphism) {
-    const samples = objectifySchema[hasPolymorphism].map((s) => {
-      return sampleFromSchema(s, opts);
+    const samples = schema[hasPolymorphism].map((s) => {
+      return sampleFromSchema(s, { ...opts, seenRefs });
     });
     if (samples.length === 1) {
       return samples[0];
@@ -253,7 +178,7 @@ function sampleFromSchema(schema, opts = {}) {
     }
     return samples[0];
   }
-  const { example, additionalProperties, properties, items } = objectifySchema;
+  const { example, additionalProperties, properties, items } = schema;
   const { includeReadOnly, includeWriteOnly } = opts;
   if (example !== void 0) {
     return deeplyStripKey(example, "$$ref", (val) => {
@@ -273,26 +198,26 @@ function sampleFromSchema(schema, opts = {}) {
     const props = objectify(properties);
     const obj = {};
     for (const name in props) {
-      if (_optionalChain([props, 'optionalAccess', _10 => _10[name], 'access', _11 => _11.deprecated])) {
+      if (_optionalChain([props, 'optionalAccess', _2 => _2[name], 'access', _3 => _3.deprecated])) {
         continue;
       }
-      if (_optionalChain([props, 'optionalAccess', _12 => _12[name], 'access', _13 => _13.readOnly]) && !includeReadOnly) {
+      if (_optionalChain([props, 'optionalAccess', _4 => _4[name], 'access', _5 => _5.readOnly]) && !includeReadOnly) {
         continue;
       }
-      if (_optionalChain([props, 'optionalAccess', _14 => _14[name], 'access', _15 => _15.writeOnly]) && !includeWriteOnly) {
+      if (_optionalChain([props, 'optionalAccess', _6 => _6[name], 'access', _7 => _7.writeOnly]) && !includeWriteOnly) {
         continue;
       }
-      if (_optionalChain([props, 'access', _16 => _16[name], 'access', _17 => _17.examples, 'optionalAccess', _18 => _18.length])) {
+      if (_optionalChain([props, 'access', _8 => _8[name], 'access', _9 => _9.examples, 'optionalAccess', _10 => _10.length])) {
         obj[name] = props[name].examples[0];
         continue;
       }
-      obj[name] = sampleFromSchema(props[name], opts);
+      obj[name] = sampleFromSchema(props[name], { ...opts, seenRefs });
     }
     if (additionalProperties === true) {
       obj.additionalProp = {};
     } else if (additionalProperties) {
       const additionalProps = objectify(additionalProperties);
-      const additionalPropVal = sampleFromSchema(additionalProps, opts);
+      const additionalPropVal = sampleFromSchema(additionalProps, { ...opts, seenRefs });
       obj.additionalProp = additionalPropVal;
     }
     return obj;
@@ -302,12 +227,22 @@ function sampleFromSchema(schema, opts = {}) {
       return [];
     }
     if (Array.isArray(items.anyOf)) {
-      return items.anyOf.map((i) => sampleFromSchema(i, opts));
+      return items.anyOf.map(
+        (i) => sampleFromSchema(i, {
+          ...opts,
+          seenRefs
+        })
+      );
     }
     if (Array.isArray(items.oneOf)) {
-      return items.oneOf.map((i) => sampleFromSchema(i, opts));
+      return items.oneOf.map(
+        (i) => sampleFromSchema(i, {
+          ...opts,
+          seenRefs
+        })
+      );
     }
-    return [sampleFromSchema(items, opts)];
+    return [sampleFromSchema(items, { ...opts, seenRefs })];
   }
   if (schema.enum) {
     if (schema.default) {
@@ -324,7 +259,7 @@ var memo = _memoizee2.default.call(void 0, sampleFromSchema);
 var samples_default = memo;
 
 // src/operation/lib/get-mediatype-examples.ts
-function getMediaTypeExamples(mediaType, mediaTypeObject, opts = {}) {
+function getMediaTypeExamples(mediaType, mediaTypeObject, definition, opts = {}) {
   if (mediaTypeObject.example) {
     return [
       {
@@ -362,10 +297,13 @@ function getMediaTypeExamples(mediaType, mediaTypeObject, opts = {}) {
     }
   }
   if (mediaTypeObject.schema) {
-    if (!_chunkB5WP4BJMcjs.matches_mimetype_default.xml(mediaType)) {
+    if (!_chunk7RDMAMMIcjs.matches_mimetype_default.xml(mediaType)) {
       return [
         {
-          value: samples_default(JSON.parse(JSON.stringify(mediaTypeObject.schema)), opts)
+          value: samples_default(structuredClone(mediaTypeObject.schema), {
+            ...opts,
+            definition
+          })
         }
       ];
     }
@@ -374,19 +312,21 @@ function getMediaTypeExamples(mediaType, mediaTypeObject, opts = {}) {
 }
 
 // src/operation/lib/get-response-examples.ts
-function getResponseExamples(operation) {
+function getResponseExamples(operation, definition) {
   return Object.keys(operation.responses || {}).map((status) => {
-    const response = _optionalChain([operation, 'access', _19 => _19.responses, 'optionalAccess', _20 => _20[status]]);
+    let response = _optionalChain([operation, 'access', _11 => _11.responses, 'optionalAccess', _12 => _12[status]]);
     let onlyHeaders = false;
-    if (!response || _chunkVQBEI5WIcjs.isRef.call(void 0, response)) {
-      return false;
+    if (!response) return false;
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+      response = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, response, definition);
+      if (!response || _chunkYPR7YTHMcjs.isRef.call(void 0, response)) return false;
     }
     const mediaTypes = {};
-    (_optionalChain([response, 'optionalAccess', _21 => _21.content]) ? Object.keys(response.content) : []).forEach((mediaType) => {
+    (_optionalChain([response, 'optionalAccess', _13 => _13.content]) ? Object.keys(response.content) : []).forEach((mediaType) => {
       if (!mediaType) return;
-      const mediaTypeObject = _optionalChain([response, 'access', _22 => _22.content, 'optionalAccess', _23 => _23[mediaType]]);
+      const mediaTypeObject = _optionalChain([response, 'access', _14 => _14.content, 'optionalAccess', _15 => _15[mediaType]]);
       if (!mediaTypeObject) return;
-      const examples = getMediaTypeExamples(mediaType, mediaTypeObject, {
+      const examples = getMediaTypeExamples(mediaType, mediaTypeObject, definition, {
         includeReadOnly: true,
         includeWriteOnly: false
       });
@@ -410,20 +350,31 @@ function getResponseExamples(operation) {
 }
 
 // src/operation/lib/get-callback-examples.ts
-function getCallbackExamples(operation) {
+function getCallbackExamples(operation, definition) {
   if (!operation.callbacks) {
     return [];
   }
   const examples = Object.keys(operation.callbacks).map((identifier) => {
-    const callback = _optionalChain([operation, 'access', _24 => _24.callbacks, 'optionalAccess', _25 => _25[identifier]]);
-    if (!callback || _chunkVQBEI5WIcjs.isRef.call(void 0, callback)) {
-      return [];
+    let callback = _optionalChain([operation, 'access', _16 => _16.callbacks, 'optionalAccess', _17 => _17[identifier]]);
+    if (!callback) return [];
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, callback)) {
+      callback = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, callback, definition);
+      if (!callback || _chunkYPR7YTHMcjs.isRef.call(void 0, callback)) return [];
     }
     const items = Object.keys(callback).map((expression) => {
-      return Object.keys(callback[expression]).map((method) => {
-        const pathItem = callback[expression];
-        const example = getResponseExamples(pathItem[method]);
-        if (example.length === 0) return false;
+      let callbackPath = callback[expression];
+      if (!callbackPath) return [];
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, callbackPath)) {
+        callbackPath = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, callbackPath, definition);
+        if (!callbackPath || _chunkYPR7YTHMcjs.isRef.call(void 0, callbackPath)) return [];
+      }
+      return Object.keys(callbackPath).map((method) => {
+        if (["servers", "parameters", "summary", "description"].includes(method)) {
+          return false;
+        }
+        const pathItem = callbackPath;
+        const example = getResponseExamples(pathItem[method], definition);
+        if (!example.length) return false;
         return {
           identifier,
           expression,
@@ -464,7 +415,7 @@ function getExampleGroups(operation) {
   const namelessCodeSampleCounts = {};
   const groups = {};
   const codeSamples = _chunkAYA3UT4Lcjs.getExtension.call(void 0, "code-samples", operation.api, operation);
-  _optionalChain([codeSamples, 'optionalAccess', _26 => _26.forEach, 'call', _27 => _27((sample, i) => {
+  _optionalChain([codeSamples, 'optionalAccess', _18 => _18.forEach, 'call', _19 => _19((sample, i) => {
     if (namelessCodeSampleCounts[sample.language]) {
       namelessCodeSampleCounts[sample.language] += 1;
     } else {
@@ -472,7 +423,7 @@ function getExampleGroups(operation) {
     }
     const name = getDefaultName(sample, namelessCodeSampleCounts);
     if (sample.correspondingExample) {
-      if (_optionalChain([groups, 'access', _28 => _28[sample.correspondingExample], 'optionalAccess', _29 => _29.customCodeSamples, 'optionalAccess', _30 => _30.length])) {
+      if (_optionalChain([groups, 'access', _20 => _20[sample.correspondingExample], 'optionalAccess', _21 => _21.customCodeSamples, 'optionalAccess', _22 => _22.length])) {
         groups[sample.correspondingExample].customCodeSamples.push({ ...sample, name, originalIndex: i });
       } else if (sample.correspondingExample) {
         groups[sample.correspondingExample] = {
@@ -480,7 +431,7 @@ function getExampleGroups(operation) {
           customCodeSamples: [{ ...sample, name, originalIndex: i }]
         };
       }
-    } else if (_optionalChain([groups, 'access', _31 => _31[noCorrespondingResponseKey], 'optionalAccess', _32 => _32.customCodeSamples, 'optionalAccess', _33 => _33.length])) {
+    } else if (_optionalChain([groups, 'access', _23 => _23[noCorrespondingResponseKey], 'optionalAccess', _24 => _24.customCodeSamples, 'optionalAccess', _25 => _25.length])) {
       groups[noCorrespondingResponseKey].customCodeSamples.push({ ...sample, name, originalIndex: i });
     } else {
       groups[noCorrespondingResponseKey] = {
@@ -495,17 +446,19 @@ function getExampleGroups(operation) {
   }
   operation.getParameters().forEach((param) => {
     Object.entries(param.examples || {}).forEach(([exampleKey, paramExample]) => {
-      if (_chunkVQBEI5WIcjs.isRef.call(void 0, paramExample)) {
-        return;
+      let example = paramExample;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, example)) {
+        example = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, example, operation.api);
+        if (!example || _chunkYPR7YTHMcjs.isRef.call(void 0, example)) return;
       }
       groups[exampleKey] = {
         ...groups[exampleKey],
-        name: _optionalChain([groups, 'access', _34 => _34[exampleKey], 'optionalAccess', _35 => _35.name]) || paramExample.summary || exampleKey,
+        name: _optionalChain([groups, 'access', _26 => _26[exampleKey], 'optionalAccess', _27 => _27.name]) || example.summary || exampleKey,
         request: {
-          ..._optionalChain([groups, 'access', _36 => _36[exampleKey], 'optionalAccess', _37 => _37.request]),
+          ..._optionalChain([groups, 'access', _28 => _28[exampleKey], 'optionalAccess', _29 => _29.request]),
           [param.in]: {
-            ..._optionalChain([groups, 'access', _38 => _38[exampleKey], 'optionalAccess', _39 => _39.request, 'optionalAccess', _40 => _40[param.in]]),
-            [param.name]: paramExample.value
+            ..._optionalChain([groups, 'access', _30 => _30[exampleKey], 'optionalAccess', _31 => _31.request, 'optionalAccess', _32 => _32[param.in]]),
+            [param.name]: example.value
           }
         }
       };
@@ -517,9 +470,9 @@ function getExampleGroups(operation) {
         const mediaType = requestExample.mediaType === "application/x-www-form-urlencoded" ? "formData" : "body";
         groups[mediaTypeExample.title] = {
           ...groups[mediaTypeExample.title],
-          name: _optionalChain([groups, 'access', _41 => _41[mediaTypeExample.title], 'optionalAccess', _42 => _42.name]) || mediaTypeExample.summary || mediaTypeExample.title,
+          name: _optionalChain([groups, 'access', _33 => _33[mediaTypeExample.title], 'optionalAccess', _34 => _34.name]) || mediaTypeExample.summary || mediaTypeExample.title,
           request: {
-            ..._optionalChain([groups, 'access', _43 => _43[mediaTypeExample.title], 'optionalAccess', _44 => _44.request]),
+            ..._optionalChain([groups, 'access', _35 => _35[mediaTypeExample.title], 'optionalAccess', _36 => _36.request]),
             [mediaType]: mediaTypeExample.value
           }
         };
@@ -538,14 +491,19 @@ function getExampleGroups(operation) {
 }
 
 // src/operation/lib/get-requestbody-examples.ts
-function getRequestBodyExamples(operation) {
-  const requestBody = operation.requestBody;
-  if (!requestBody || _chunkVQBEI5WIcjs.isRef.call(void 0, requestBody) || !requestBody.content) {
+function getRequestBodyExamples(operation, definition) {
+  let requestBody = operation.requestBody;
+  if (!requestBody) {
+    return [];
+  } else if (_chunkYPR7YTHMcjs.isRef.call(void 0, requestBody)) {
+    requestBody = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, requestBody, definition);
+  }
+  if (!requestBody || _chunkYPR7YTHMcjs.isRef.call(void 0, requestBody) || !requestBody.content) {
     return [];
   }
   return Object.keys(requestBody.content || {}).map((mediaType) => {
     const mediaTypeObject = requestBody.content[mediaType];
-    const examples = getMediaTypeExamples(mediaType, mediaTypeObject, {
+    const examples = getMediaTypeExamples(mediaType, mediaTypeObject, definition, {
       includeReadOnly: false,
       includeWriteOnly: true
     });
@@ -559,26 +517,69 @@ function getRequestBodyExamples(operation) {
   }).filter((item) => item !== false);
 }
 
-// src/operation/lib/get-response-as-json-schema.ts
-var isJSON = _chunkB5WP4BJMcjs.matches_mimetype_default.json;
-function buildHeadersSchema(response, opts) {
+// src/operation/lib/operationId.ts
+function hasOperationId(operation) {
+  return Boolean("operationId" in operation && _optionalChain([operation, 'access', _37 => _37.operationId, 'optionalAccess', _38 => _38.length]));
+}
+function getOperationId(path, method, operation, opts = {}) {
+  function sanitize(id) {
+    return id.replace(_optionalChain([opts, 'optionalAccess', _39 => _39.camelCase]) || _optionalChain([opts, 'optionalAccess', _40 => _40.friendlyCase]) ? /[^a-zA-Z0-9_]/g : /[^a-zA-Z0-9]/g, "-").replace(/--+/g, "-").replace(/^-|-$/g, "");
+  }
+  const operationIdExists = hasOperationId(operation);
+  let operationId;
+  if (operationIdExists) {
+    operationId = operation.operationId;
+  } else {
+    operationId = sanitize(path).toLowerCase();
+  }
+  const currMethod = method.toLowerCase();
+  if (_optionalChain([opts, 'optionalAccess', _41 => _41.camelCase]) || _optionalChain([opts, 'optionalAccess', _42 => _42.friendlyCase])) {
+    if (_optionalChain([opts, 'optionalAccess', _43 => _43.friendlyCase])) {
+      operationId = operationId.replaceAll("_", " ");
+      if (!operationIdExists) {
+        operationId = operationId.replace(/[^a-zA-Z0-9_]+(.)/g, (_, chr) => ` ${chr}`).split(" ").filter((word, i, arr) => word !== arr[i - 1]).join(" ");
+      }
+    }
+    operationId = operationId.replace(/[^a-zA-Z0-9_]+(.)/g, (_, chr) => chr.toUpperCase());
+    if (operationIdExists) {
+      operationId = sanitize(operationId);
+    }
+    operationId = operationId.replace(/^[0-9]/g, (match) => `_${match}`);
+    operationId = operationId.charAt(0).toLowerCase() + operationId.slice(1);
+    if (operationId.startsWith(currMethod)) {
+      return operationId;
+    }
+    if (operationIdExists) {
+      return operationId;
+    }
+    operationId = operationId.charAt(0).toUpperCase() + operationId.slice(1);
+    return `${currMethod}${operationId}`;
+  } else if (operationIdExists) {
+    return operationId;
+  }
+  return `${currMethod}_${operationId}`;
+}
+
+// src/operation/transformers/get-response-as-json-schema.ts
+var isJSON = _chunk7RDMAMMIcjs.matches_mimetype_default.json;
+function buildHeadersSchema(response, schemaOptions) {
   const headersSchema = {
     type: "object",
     properties: {}
   };
   if (response.headers) {
     Object.keys(response.headers).forEach((key) => {
-      if (!_optionalChain([response, 'access', _45 => _45.headers, 'optionalAccess', _46 => _46[key]]) || _chunkVQBEI5WIcjs.isRef.call(void 0, _optionalChain([response, 'access', _47 => _47.headers, 'optionalAccess', _48 => _48[key]]))) {
+      if (!_optionalChain([response, 'access', _44 => _44.headers, 'optionalAccess', _45 => _45[key]]) || _chunkYPR7YTHMcjs.isRef.call(void 0, _optionalChain([response, 'access', _46 => _46.headers, 'optionalAccess', _47 => _47[key]]))) {
         return;
       }
       if (response.headers[key].schema) {
         const header = response.headers[key];
-        if (!header.schema || _chunkVQBEI5WIcjs.isRef.call(void 0, header.schema)) {
+        if (!header.schema || _chunkYPR7YTHMcjs.isRef.call(void 0, header.schema)) {
           return;
         }
-        headersSchema.properties[key] = _chunkB5WP4BJMcjs.toJSONSchema.call(void 0, header.schema, {
+        headersSchema.properties[key] = _chunk7RDMAMMIcjs.toJSONSchema.call(void 0, header.schema, {
           addEnumsToDescriptions: true,
-          transformer: _optionalChain([opts, 'optionalAccess', _49 => _49.transformer])
+          ...schemaOptions
         });
         if (header.description) {
           headersSchema.properties[key].description = header.description;
@@ -602,15 +603,24 @@ function getResponseAsJSONSchema(operation, api, statusCode, opts) {
   if (!response) {
     return null;
   }
-  let hasCircularRefs = false;
-  let hasDiscriminatorMappingRefs = false;
-  function refLogger(ref, type) {
-    if (type === "ref") {
-      hasCircularRefs = true;
-    } else {
-      hasDiscriminatorMappingRefs = true;
-    }
-  }
+  const usedSchemas = /* @__PURE__ */ new Map();
+  const seenRefs = /* @__PURE__ */ new Set();
+  const refsByGroup = /* @__PURE__ */ new Map();
+  function refLoggerForSchemaGroup(group) {
+    let set = refsByGroup.get(group);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      refsByGroup.set(group, set);
+    }
+    return set;
+  }
+  const baseSchemaOptions = {
+    addEnumsToDescriptions: true,
+    definition: api,
+    seenRefs,
+    usedSchemas,
+    refLogger: (ref) => refLoggerForSchemaGroup("body").add(ref)
+  };
   function getPreferredSchema(content, preferredContentType) {
     if (!content) {
       return null;
@@ -621,125 +631,108 @@ function getResponseAsJSONSchema(operation, api, statusCode, opts) {
     }
     if (preferredContentType) {
       if (contentTypes.includes(preferredContentType)) {
-        const schema2 = _chunkB5WP4BJMcjs.cloneObject.call(void 0, content[preferredContentType].schema);
+        const schema2 = _chunk7RDMAMMIcjs.cloneObject.call(void 0, content[preferredContentType].schema);
         if (!schema2) {
           return null;
         }
-        return _chunkB5WP4BJMcjs.toJSONSchema.call(void 0, schema2, {
-          addEnumsToDescriptions: true,
-          refLogger,
-          transformer: _optionalChain([opts, 'optionalAccess', _50 => _50.transformer])
-        });
+        return _chunk7RDMAMMIcjs.toJSONSchema.call(void 0, schema2, baseSchemaOptions);
       }
       return null;
     }
     for (let i = 0; i < contentTypes.length; i++) {
       if (isJSON(contentTypes[i])) {
-        const schema2 = _chunkB5WP4BJMcjs.cloneObject.call(void 0, content[contentTypes[i]].schema);
+        const schema2 = _chunk7RDMAMMIcjs.cloneObject.call(void 0, content[contentTypes[i]].schema);
         if (!schema2) {
           return {};
         }
-        return _chunkB5WP4BJMcjs.toJSONSchema.call(void 0, schema2, {
-          addEnumsToDescriptions: true,
-          refLogger,
-          transformer: _optionalChain([opts, 'optionalAccess', _51 => _51.transformer])
-        });
+        return _chunk7RDMAMMIcjs.toJSONSchema.call(void 0, schema2, baseSchemaOptions);
       }
     }
     const contentType = contentTypes.shift();
     if (!contentType) {
       return {};
     }
-    const schema = _chunkB5WP4BJMcjs.cloneObject.call(void 0, content[contentType].schema);
+    const schema = _chunk7RDMAMMIcjs.cloneObject.call(void 0, content[contentType].schema);
     if (!schema) {
       return {};
     }
-    return _chunkB5WP4BJMcjs.toJSONSchema.call(void 0, schema, {
-      addEnumsToDescriptions: true,
-      refLogger,
-      transformer: _optionalChain([opts, 'optionalAccess', _52 => _52.transformer])
-    });
+    return _chunk7RDMAMMIcjs.toJSONSchema.call(void 0, schema, baseSchemaOptions);
   }
-  const foundSchema = getPreferredSchema(response.content, _optionalChain([opts, 'optionalAccess', _53 => _53.contentType]));
-  if (_optionalChain([opts, 'optionalAccess', _54 => _54.contentType]) && !foundSchema) {
+  const foundSchema = getPreferredSchema(response.content, _optionalChain([opts, 'optionalAccess', _48 => _48.contentType]));
+  if (_optionalChain([opts, 'optionalAccess', _49 => _49.contentType]) && !foundSchema) {
     return null;
   }
   if (foundSchema) {
-    const schema = _chunkB5WP4BJMcjs.cloneObject.call(void 0, foundSchema);
+    const schema = structuredClone(foundSchema);
+    let schemaType = foundSchema.type;
+    if (schemaType === void 0 && _chunkYPR7YTHMcjs.isRef.call(void 0, foundSchema) && usedSchemas.size > 0) {
+      const resolvedSchema = usedSchemas.get(foundSchema.$ref);
+      const resolvedType = resolvedSchema && typeof resolvedSchema === "object" && "type" in resolvedSchema ? resolvedSchema.type : void 0;
+      schemaType = Array.isArray(resolvedType) ? resolvedType[0] : resolvedType;
+    }
     const schemaWrapper = {
       // If there's no `type` then the root schema is a circular `$ref` that we likely won't be
       // able to render so instead of generating a JSON Schema with an `undefined` type we should
       // default to `string` so there's at least *something* the end-user can interact with.
-      type: foundSchema.type || "string",
-      schema: _chunkB5WP4BJMcjs.isPrimitive.call(void 0, schema) ? schema : {
+      type: _nullishCoalesce(schemaType, () => ( "string")),
+      schema: _chunk7RDMAMMIcjs.isPrimitive.call(void 0, schema) ? schema : {
         ...schema,
-        $schema: _chunkB5WP4BJMcjs.getSchemaVersionString.call(void 0, schema, api)
+        $schema: _chunk7RDMAMMIcjs.getSchemaVersionString.call(void 0, schema, api)
       },
       label: "Response body"
     };
     if (response.description && schemaWrapper.schema) {
       schemaWrapper.description = response.description;
     }
-    if (api.components && schemaWrapper.schema) {
-      if (hasCircularRefs || hasDiscriminatorMappingRefs && _optionalChain([opts, 'optionalAccess', _55 => _55.includeDiscriminatorMappingRefs])) {
-        schemaWrapper.schema.components = _chunkB5WP4BJMcjs.cloneObject.call(void 0, 
-          api.components
-        );
+    _chunk7RDMAMMIcjs.applyDiscriminatorOneOfToUsedSchemas.call(void 0, api, usedSchemas, (ref) => {
+      if (usedSchemas.has(ref)) {
+        return usedSchemas.get(ref);
+      }
+      try {
+        const resolved = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, { $ref: ref }, api, seenRefs);
+        if (_chunkYPR7YTHMcjs.isRef.call(void 0, resolved)) return void 0;
+        const converted = _chunk7RDMAMMIcjs.toJSONSchema.call(void 0, structuredClone(resolved), {
+          ...baseSchemaOptions,
+          seenRefs
+        });
+        usedSchemas.set(ref, converted);
+        return converted;
+      } catch (e2) {
+        return void 0;
+      }
+    });
+    if (schemaWrapper.schema && usedSchemas.size > 0) {
+      const refsInGroup = _nullishCoalesce(refsByGroup.get("body"), () => ( /* @__PURE__ */ new Set()));
+      const referencedSchemas = _chunk7RDMAMMIcjs.filterRequiredRefsToReferenced.call(void 0, refsInGroup, usedSchemas);
+      if (referencedSchemas.size > 0) {
+        _chunk7RDMAMMIcjs.mergeReferencedSchemasIntoRoot.call(void 0, schemaWrapper.schema, referencedSchemas);
       }
     }
     jsonSchema.push(schemaWrapper);
   }
   if (response.headers) {
-    jsonSchema.push(buildHeadersSchema(response, opts));
-  }
-  return jsonSchema.length ? jsonSchema : null;
-}
-
-// src/operation/lib/operationId.ts
-function hasOperationId(operation) {
-  return Boolean("operationId" in operation && _optionalChain([operation, 'access', _56 => _56.operationId, 'optionalAccess', _57 => _57.length]));
-}
-function getOperationId(path, method, operation, opts = {}) {
-  function sanitize(id) {
-    return id.replace(_optionalChain([opts, 'optionalAccess', _58 => _58.camelCase]) || _optionalChain([opts, 'optionalAccess', _59 => _59.friendlyCase]) ? /[^a-zA-Z0-9_]/g : /[^a-zA-Z0-9]/g, "-").replace(/--+/g, "-").replace(/^-|-$/g, "");
-  }
-  const operationIdExists = hasOperationId(operation);
-  let operationId;
-  if (operationIdExists) {
-    operationId = operation.operationId;
-  } else {
-    operationId = sanitize(path).toLowerCase();
-  }
-  const currMethod = method.toLowerCase();
-  if (_optionalChain([opts, 'optionalAccess', _60 => _60.camelCase]) || _optionalChain([opts, 'optionalAccess', _61 => _61.friendlyCase])) {
-    if (_optionalChain([opts, 'optionalAccess', _62 => _62.friendlyCase])) {
-      operationId = operationId.replaceAll("_", " ");
-      if (!operationIdExists) {
-        operationId = operationId.replace(/[^a-zA-Z0-9_]+(.)/g, (_, chr) => ` ${chr}`).split(" ").filter((word, i, arr) => word !== arr[i - 1]).join(" ");
+    const headersWrapper = buildHeadersSchema(response, {
+      ...baseSchemaOptions,
+      refLogger: (ref) => refLoggerForSchemaGroup("headers").add(ref)
+    });
+    if (headersWrapper.schema && usedSchemas.size > 0) {
+      const refsInGroup = _nullishCoalesce(refsByGroup.get("headers"), () => ( /* @__PURE__ */ new Set()));
+      const referencedSchemas = _chunk7RDMAMMIcjs.filterRequiredRefsToReferenced.call(void 0, refsInGroup, usedSchemas);
+      if (referencedSchemas.size > 0) {
+        _chunk7RDMAMMIcjs.mergeReferencedSchemasIntoRoot.call(void 0, headersWrapper.schema, referencedSchemas);
       }
     }
-    operationId = operationId.replace(/[^a-zA-Z0-9_]+(.)/g, (_, chr) => chr.toUpperCase());
-    if (operationIdExists) {
-      operationId = sanitize(operationId);
-    }
-    operationId = operationId.replace(/^[0-9]/g, (match) => `_${match}`);
-    operationId = operationId.charAt(0).toLowerCase() + operationId.slice(1);
-    if (operationId.startsWith(currMethod)) {
-      return operationId;
-    }
-    if (operationIdExists) {
-      return operationId;
-    }
-    operationId = operationId.charAt(0).toUpperCase() + operationId.slice(1);
-    return `${currMethod}${operationId}`;
-  } else if (operationIdExists) {
-    return operationId;
+    jsonSchema.push(headersWrapper);
   }
-  return `${currMethod}_${operationId}`;
+  return jsonSchema.length ? jsonSchema : null;
 }
 
 // src/operation/index.ts
-var Operation = class {
+var Operation = (_class = class {
+  /**
+   * The `Oas` instance that this operation belongs to.
+   */
+  
   /**
    * Schema of the operation from the API Definition.
    */
@@ -791,9 +784,17 @@ var Operation = class {
    * it doesn't initiate multiple dereferencing processes.
    */
   
-  constructor(api, path, method, operation) {
+  /**
+   * Have the component schemas within this API definition been decorated with our
+   * `x-readme-ref-name` extension?
+   *
+   * @see {@link decorateComponentSchemas}
+   */
+  __init() {this.schemasDecorated = false}
+  constructor(oas, path, method, operation) {;_class.prototype.__init.call(this);
+    this.oas = oas;
     this.schema = operation;
-    this.api = api;
+    this.api = oas.api;
     this.path = path;
     this.method = method;
     this.contentType = void 0;
@@ -819,11 +820,11 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-summary}
    */
   getSummary() {
-    if (_optionalChain([this, 'access', _63 => _63.schema, 'optionalAccess', _64 => _64.summary]) && typeof this.schema.summary === "string") {
+    if (_optionalChain([this, 'access', _50 => _50.schema, 'optionalAccess', _51 => _51.summary]) && typeof this.schema.summary === "string") {
       return this.schema.summary;
     }
-    const pathItem = _optionalChain([this, 'access', _65 => _65.api, 'access', _66 => _66.paths, 'optionalAccess', _67 => _67[this.path]]);
-    if (_optionalChain([pathItem, 'optionalAccess', _68 => _68.summary]) && typeof pathItem.summary === "string") {
+    const pathItem = _optionalChain([this, 'access', _52 => _52.api, 'access', _53 => _53.paths, 'optionalAccess', _54 => _54[this.path]]);
+    if (_optionalChain([pathItem, 'optionalAccess', _55 => _55.summary]) && typeof pathItem.summary === "string") {
       return pathItem.summary;
     }
     return void 0;
@@ -835,11 +836,11 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-description}
    */
   getDescription() {
-    if (_optionalChain([this, 'access', _69 => _69.schema, 'optionalAccess', _70 => _70.description]) && typeof this.schema.description === "string") {
+    if (_optionalChain([this, 'access', _56 => _56.schema, 'optionalAccess', _57 => _57.description]) && typeof this.schema.description === "string") {
       return this.schema.description;
     }
-    const pathItem = _optionalChain([this, 'access', _71 => _71.api, 'access', _72 => _72.paths, 'optionalAccess', _73 => _73[this.path]]);
-    if (_optionalChain([pathItem, 'optionalAccess', _74 => _74.description]) && typeof pathItem.description === "string") {
+    const pathItem = _optionalChain([this, 'access', _58 => _58.api, 'access', _59 => _59.paths, 'optionalAccess', _60 => _60[this.path]]);
+    if (_optionalChain([pathItem, 'optionalAccess', _61 => _61.description]) && typeof pathItem.description === "string") {
       return pathItem.description;
     }
     return void 0;
@@ -857,19 +858,19 @@ var Operation = class {
     }
     let types = [];
     if (this.schema.requestBody) {
-      if (_chunkVQBEI5WIcjs.isRef.call(void 0, this.schema.requestBody)) {
-        this.schema.requestBody = _chunkB5WP4BJMcjs.dereferenceRef.call(void 0, this.schema.requestBody, this.api);
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, this.schema.requestBody)) {
+        this.schema.requestBody = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, this.schema.requestBody, this.api);
       }
       if (this.schema.requestBody && "content" in this.schema.requestBody) {
         types = Object.keys(this.schema.requestBody.content);
       }
     }
     this.contentType = "application/json";
-    if (_optionalChain([types, 'optionalAccess', _75 => _75.length])) {
+    if (_optionalChain([types, 'optionalAccess', _62 => _62.length])) {
       this.contentType = types[0];
     }
     types.forEach((t) => {
-      if (_chunkB5WP4BJMcjs.matches_mimetype_default.json(t)) {
+      if (_chunk7RDMAMMIcjs.matches_mimetype_default.json(t)) {
         this.contentType = t;
       }
     });
@@ -882,7 +883,7 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-request-body-content}
    */
   isFormUrlEncoded() {
-    return _chunkB5WP4BJMcjs.matches_mimetype_default.formUrlEncoded(this.getContentType());
+    return _chunk7RDMAMMIcjs.matches_mimetype_default.formUrlEncoded(this.getContentType());
   }
   /**
    * Checks if the current operation has a mutipart content type payload.
@@ -891,7 +892,7 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-request-body-content}
    */
   isMultipart() {
-    return _chunkB5WP4BJMcjs.matches_mimetype_default.multipart(this.getContentType());
+    return _chunk7RDMAMMIcjs.matches_mimetype_default.multipart(this.getContentType());
   }
   /**
    * Checks if the current operation has a JSON-like content type payload.
@@ -900,7 +901,7 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-request-body-content}
    */
   isJson() {
-    return _chunkB5WP4BJMcjs.matches_mimetype_default.json(this.getContentType());
+    return _chunk7RDMAMMIcjs.matches_mimetype_default.json(this.getContentType());
   }
   /**
    * Checks if the current operation has an XML content type payload.
@@ -909,7 +910,7 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-request-body-content}
    */
   isXml() {
-    return _chunkB5WP4BJMcjs.matches_mimetype_default.xml(this.getContentType());
+    return _chunk7RDMAMMIcjs.matches_mimetype_default.xml(this.getContentType());
   }
   /**
    * Checks if the current operation is a webhook or not.
@@ -928,7 +929,7 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#security-requirement-object}
    */
   getSecurity() {
-    if (!_optionalChain([this, 'access', _76 => _76.api, 'optionalAccess', _77 => _77.components, 'optionalAccess', _78 => _78.securitySchemes]) || !Object.keys(this.api.components.securitySchemes).length) {
+    if (!_optionalChain([this, 'access', _63 => _63.api, 'optionalAccess', _64 => _64.components, 'optionalAccess', _65 => _65.securitySchemes]) || !Object.keys(this.api.components.securitySchemes).length) {
       return [];
     }
     return this.schema.security || this.api.security || [];
@@ -948,20 +949,22 @@ var Operation = class {
       let keys;
       try {
         keys = Object.keys(requirement);
-      } catch (e2) {
+      } catch (e3) {
         return false;
       }
       const keysWithTypes = keys.map((key) => {
         let security;
         try {
-          if (!_optionalChain([this, 'access', _79 => _79.api, 'access', _80 => _80.components, 'optionalAccess', _81 => _81.securitySchemes, 'optionalAccess', _82 => _82[key]]) || _chunkVQBEI5WIcjs.isRef.call(void 0, this.api.components.securitySchemes[key])) {
-            return false;
+          security = _optionalChain([this, 'access', _66 => _66.api, 'optionalAccess', _67 => _67.components, 'optionalAccess', _68 => _68.securitySchemes, 'optionalAccess', _69 => _69[key]]);
+          if (!security) return false;
+          if (_chunkYPR7YTHMcjs.isRef.call(void 0, security)) {
+            security = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, security, this.api);
+            if (!security || _chunkYPR7YTHMcjs.isRef.call(void 0, security)) return false;
           }
-          security = this.api.components.securitySchemes[key];
-        } catch (e3) {
+        } catch (e4) {
           return false;
         }
-        if (!security) return false;
+        if (!security || _chunkYPR7YTHMcjs.isRef.call(void 0, security)) return false;
         let type = null;
         if (security.type === "http") {
           if (security.scheme === "basic") type = "Basic";
@@ -1004,7 +1007,7 @@ var Operation = class {
           if (!prev[security.type]) prev[security.type] = [];
           const exists = prev[security.type].some((sec) => sec._key === security.security._key);
           if (!exists) {
-            if (_optionalChain([security, 'access', _83 => _83.security, 'optionalAccess', _84 => _84._requirements])) delete security.security._requirements;
+            if (_optionalChain([security, 'access', _70 => _70.security, 'optionalAccess', _71 => _71._requirements])) delete security.security._requirements;
             prev[security.type].push(security.security);
           }
         });
@@ -1034,37 +1037,56 @@ var Operation = class {
     if (this.schema.parameters) {
       this.headers.request = this.headers.request.concat(
         this.schema.parameters.map((p) => {
-          if (_chunkVQBEI5WIcjs.isRef.call(void 0, p)) {
-            return void 0;
+          let param = p;
+          if (_chunkYPR7YTHMcjs.isRef.call(void 0, param)) {
+            param = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, param, this.api);
+            if (!param || _chunkYPR7YTHMcjs.isRef.call(void 0, param)) return void 0;
           }
-          if (p.in && p.in === "header") return p.name;
+          if (param.in && param.in === "header") return param.name;
           return void 0;
         }).filter((item) => item !== void 0)
       );
     }
     if (this.schema.responses) {
       this.headers.response = Object.keys(this.schema.responses).map((r) => {
-        const response = _optionalChain([this, 'access', _85 => _85.schema, 'access', _86 => _86.responses, 'optionalAccess', _87 => _87[r]]);
-        if (!response || _chunkVQBEI5WIcjs.isRef.call(void 0, response)) {
-          return [];
+        let response = this.schema.responses[r];
+        if (!response) return [];
+        if (_chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+          this.schema.responses[r] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, response, this.api);
+          response = this.schema.responses[r];
+          if (!response || _chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+            return [];
+          }
         }
-        return _optionalChain([response, 'optionalAccess', _88 => _88.headers]) ? Object.keys(response.headers) : [];
+        return _optionalChain([response, 'optionalAccess', _72 => _72.headers]) ? Object.keys(response.headers) : [];
       }).reduce((a, b) => a.concat(b), []);
     }
     if (!this.headers.request.includes("Content-Type") && this.schema.requestBody) {
-      const requestBody = this.schema.requestBody;
-      if (requestBody && !_chunkVQBEI5WIcjs.isRef.call(void 0, requestBody) && "content" in requestBody && Object.keys(requestBody.content)) {
-        this.headers.request.push("Content-Type");
+      let requestBody = this.schema.requestBody;
+      if (requestBody) {
+        if (_chunkYPR7YTHMcjs.isRef.call(void 0, requestBody)) {
+          this.schema.requestBody = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, requestBody, this.api);
+          requestBody = this.schema.requestBody;
+        }
+        if (requestBody && !_chunkYPR7YTHMcjs.isRef.call(void 0, requestBody) && "content" in requestBody && Object.keys(requestBody.content)) {
+          this.headers.request.push("Content-Type");
+        }
       }
     }
     if (this.schema.responses) {
-      if (Object.keys(this.schema.responses).some((r) => {
-        const response = _optionalChain([this, 'access', _89 => _89.schema, 'access', _90 => _90.responses, 'optionalAccess', _91 => _91[r]]);
-        if (!response || _chunkVQBEI5WIcjs.isRef.call(void 0, response)) {
-          return false;
+      const hasResponseContent = Object.keys(this.schema.responses).some((r) => {
+        let response = _optionalChain([this, 'access', _73 => _73.schema, 'access', _74 => _74.responses, 'optionalAccess', _75 => _75[r]]);
+        if (!response) return false;
+        if (_chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+          this.schema.responses[r] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, response, this.api);
+          response = this.schema.responses[r];
+          if (!response || _chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+            return false;
+          }
         }
-        return _optionalChain([response, 'optionalAccess', _92 => _92.content]) && Object.keys(response.content).length > 0;
-      })) {
+        return response.content && Object.keys(response.content).length > 0;
+      });
+      if (hasResponseContent) {
         if (!this.headers.request.includes("Accept")) this.headers.request.push("Accept");
         if (!this.headers.response.includes("Content-Type")) this.headers.response.push("Content-Type");
       }
@@ -1120,7 +1142,7 @@ var Operation = class {
       return [];
     }
     const oasTagMap = /* @__PURE__ */ new Map();
-    if (Array.isArray(_optionalChain([this, 'access', _93 => _93.api, 'optionalAccess', _94 => _94.tags]))) {
+    if (Array.isArray(_optionalChain([this, 'access', _76 => _76.api, 'optionalAccess', _77 => _77.tags]))) {
       this.api.tags.forEach((tag) => {
         oasTagMap.set(tag.name, tag);
       });
@@ -1159,17 +1181,26 @@ var Operation = class {
   /**
    * Return the parameters (non-request body) on the operation.
    *
-   * @todo Add support for `ReferenceObject`
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationparameters}
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-parameters}
    */
   getParameters() {
-    let parameters = (_optionalChain([this, 'access', _95 => _95.schema, 'optionalAccess', _96 => _96.parameters]) || []).filter(
-      (param) => param && !_chunkVQBEI5WIcjs.isRef.call(void 0, param)
-    );
-    const commonParams = (_optionalChain([this, 'access', _97 => _97.api, 'optionalAccess', _98 => _98.paths, 'optionalAccess', _99 => _99[this.path], 'optionalAccess', _100 => _100.parameters]) || []).filter(
-      (param) => param && !_chunkVQBEI5WIcjs.isRef.call(void 0, param)
-    );
+    let parameters = (_optionalChain([this, 'access', _78 => _78.schema, 'optionalAccess', _79 => _79.parameters]) || []).map((p) => {
+      let param = p;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, param)) {
+        param = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, param, this.api);
+        if (!param || _chunkYPR7YTHMcjs.isRef.call(void 0, param)) return void 0;
+      }
+      return param;
+    }).filter((param) => param !== void 0);
+    const commonParams = (_optionalChain([this, 'access', _80 => _80.api, 'optionalAccess', _81 => _81.paths, 'optionalAccess', _82 => _82[this.path], 'optionalAccess', _83 => _83.parameters]) || []).map((p) => {
+      let param = p;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, param)) {
+        param = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, param, this.api);
+        if (!param || _chunkYPR7YTHMcjs.isRef.call(void 0, param)) return void 0;
+      }
+      return param;
+    }).filter((param) => param !== void 0);
     if (commonParams.length) {
       parameters = parameters.concat(dedupeCommonParameters(parameters, commonParams) || []);
     }
@@ -1188,26 +1219,54 @@ var Operation = class {
    * Convert the operation into an array of JSON Schema schemas for each available type of
    * parameter available on the operation.
    *
+   * Note that this method is not compatible with an operation or OpenAPI definition that has been
+   * processed with `.dereference()`. This method can only be called with the _original_ API
+   * definition that was used to initialize the `Operation` and `Oas` instance. If a dereferenced
+   * schema is present when this is called a `TypeError` will be thrown.
+   *
+   * @throws {TypeError} If the operation or OpenAPI definition has been run through `.dereference().`
+   *
    */
   getParametersAsJSONSchema(opts = {}) {
-    return _chunkB5WP4BJMcjs.getParametersAsJSONSchema.call(void 0, this, this.api, {
+    if (this.isDereferenced()) {
+      throw new Error(
+        "`.getParametersAsJSONSchema()` is not compatible with an operation or OpenAPI definition that has been run through `.dereference().`"
+      );
+    }
+    if (!this.schemasDecorated) {
+      _chunk7RDMAMMIcjs.decorateComponentSchemasWithRefName.call(void 0, this.api);
+      this.schemasDecorated = true;
+    }
+    return _chunk7RDMAMMIcjs.getParametersAsJSONSchema.call(void 0, this, this.api, {
       includeDiscriminatorMappingRefs: true,
-      transformer: (s) => s,
       ...opts
     });
   }
   /**
    * Get a single response for this status code, formatted as JSON schema.
    *
+   * Note that this method is not compatible with an operation or OpenAPI definition that has been
+   * processed with `.dereference()`. This method can only be called with the _original_ API
+   * definition that was used to initialize the `Operation` and `Oas` instance. If a dereferenced
+   * schema is present when this is called a `TypeError` will be thrown.
+   *
    * @param statusCode Status code to pull a JSON Schema response for.
    * @param opts Options for schema generation.
    * @param opts.contentType Optional content-type to use. If specified and the response doesn't have
    *   this content-type, the function will return null.
    */
   getResponseAsJSONSchema(statusCode, opts = {}) {
+    if (this.isDereferenced()) {
+      throw new Error(
+        "`.getResponseAsJSONSchema()` is not compatible with an operation or OpenAPI definition that has been run through `.dereference().`"
+      );
+    }
+    if (!this.schemasDecorated) {
+      _chunk7RDMAMMIcjs.decorateComponentSchemasWithRefName.call(void 0, this.api);
+      this.schemasDecorated = true;
+    }
     return getResponseAsJSONSchema(this, this.api, statusCode, {
       includeDiscriminatorMappingRefs: true,
-      transformer: (s) => s,
       ...opts
     });
   }
@@ -1218,6 +1277,30 @@ var Operation = class {
   getResponseStatusCodes() {
     return this.schema.responses ? Object.keys(this.schema.responses) : [];
   }
+  /**
+   * Retrieve an array of all content types that this operation can return.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#response-object}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#response-object}
+   */
+  getResponseContentTypes() {
+    if (!this.schema.responses) return [];
+    const contentTypes = /* @__PURE__ */ new Set();
+    Object.values(this.schema.responses).forEach((response) => {
+      let resp = response;
+      if (!resp) return;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, resp)) {
+        resp = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, resp, this.api);
+        if (!resp || _chunkYPR7YTHMcjs.isRef.call(void 0, resp)) {
+          return;
+        }
+      }
+      Object.keys(resp.content || {}).forEach((mimeType) => {
+        contentTypes.add(mimeType);
+      });
+    });
+    return Array.from(contentTypes);
+  }
   /**
    * Determine if the operation has any request bodies.
    *
@@ -1227,6 +1310,23 @@ var Operation = class {
   hasRequestBody() {
     return !!this.schema.requestBody;
   }
+  /**
+   * Return the current `requestBody` object, dereferencing it in the process if it's a `$ref`
+   * pointer.
+   *
+   */
+  getResolvedRequestBody() {
+    let requestBody = this.schema.requestBody;
+    if (!requestBody) return false;
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, requestBody)) {
+      this.schema.requestBody = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, requestBody, this.api);
+      requestBody = this.schema.requestBody;
+      if (!requestBody || _chunkYPR7YTHMcjs.isRef.call(void 0, requestBody)) {
+        return false;
+      }
+    }
+    return requestBody;
+  }
   /**
    * Retrieve the list of all available media types that the operations request body can accept.
    *
@@ -1237,10 +1337,8 @@ var Operation = class {
     if (!this.hasRequestBody()) {
       return [];
     }
-    const requestBody = this.schema.requestBody;
-    if (!requestBody || _chunkVQBEI5WIcjs.isRef.call(void 0, requestBody)) {
-      return [];
-    }
+    const requestBody = this.getResolvedRequestBody();
+    if (!requestBody) return [];
     return Object.keys(requestBody.content);
   }
   /**
@@ -1253,10 +1351,8 @@ var Operation = class {
     if (!this.hasRequestBody()) {
       return false;
     }
-    const requestBody = this.schema.requestBody;
-    if (!requestBody || _chunkVQBEI5WIcjs.isRef.call(void 0, requestBody)) {
-      return false;
-    }
+    const requestBody = this.getResolvedRequestBody();
+    if (!requestBody) return false;
     if (requestBody.required) {
       return true;
     }
@@ -1282,10 +1378,8 @@ var Operation = class {
     if (!this.hasRequestBody()) {
       return false;
     }
-    const requestBody = this.schema.requestBody;
-    if (!requestBody || _chunkVQBEI5WIcjs.isRef.call(void 0, requestBody)) {
-      return false;
-    }
+    const requestBody = this.getResolvedRequestBody();
+    if (!requestBody) return false;
     if (mediaType) {
       if (!(mediaType in requestBody.content)) {
         return false;
@@ -1295,7 +1389,7 @@ var Operation = class {
     let availableMediaType;
     const mediaTypes = this.getRequestBodyMediaTypes();
     mediaTypes.forEach((mt) => {
-      if (!availableMediaType && _chunkB5WP4BJMcjs.matches_mimetype_default.json(mt)) {
+      if (!availableMediaType && _chunk7RDMAMMIcjs.matches_mimetype_default.json(mt)) {
         availableMediaType = mt;
       }
     });
@@ -1322,11 +1416,11 @@ var Operation = class {
    * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#request-body-examples}
    */
   getRequestBodyExamples() {
-    const isRequestExampleValueDefined = typeof _optionalChain([this, 'access', _101 => _101.requestBodyExamples, 'optionalAccess', _102 => _102[0], 'optionalAccess', _103 => _103.examples, 'optionalAccess', _104 => _104[0], 'access', _105 => _105.value]) !== "undefined";
+    const isRequestExampleValueDefined = typeof _optionalChain([this, 'access', _84 => _84.requestBodyExamples, 'optionalAccess', _85 => _85[0], 'optionalAccess', _86 => _86.examples, 'optionalAccess', _87 => _87[0], 'access', _88 => _88.value]) !== "undefined";
     if (this.requestBodyExamples && isRequestExampleValueDefined) {
       return this.requestBodyExamples;
     }
-    this.requestBodyExamples = getRequestBodyExamples(this.schema);
+    this.requestBodyExamples = getRequestBodyExamples(this.schema, this.api);
     return this.requestBodyExamples;
   }
   /**
@@ -1340,9 +1434,14 @@ var Operation = class {
     if (!this.schema.responses) {
       return false;
     }
-    const response = this.schema.responses[statusCode];
-    if (!response || _chunkVQBEI5WIcjs.isRef.call(void 0, response)) {
-      return false;
+    let response = this.schema.responses[statusCode];
+    if (!response) return false;
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+      this.schema.responses[statusCode] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, response, this.api);
+      response = this.schema.responses[statusCode];
+      if (!response || _chunkYPR7YTHMcjs.isRef.call(void 0, response)) {
+        return false;
+      }
     }
     return response;
   }
@@ -1356,7 +1455,7 @@ var Operation = class {
     if (this.responseExamples) {
       return this.responseExamples;
     }
-    this.responseExamples = getResponseExamples(this.schema);
+    this.responseExamples = getResponseExamples(this.schema, this.api);
     return this.responseExamples;
   }
   /**
@@ -1379,15 +1478,28 @@ var Operation = class {
    */
   getCallback(identifier, expression, method) {
     if (!this.schema.callbacks) return false;
-    const callbackObj = this.schema.callbacks[identifier];
-    if (!callbackObj || _chunkVQBEI5WIcjs.isRef.call(void 0, callbackObj)) {
-      return false;
+    let callbackObj = this.schema.callbacks[identifier];
+    if (!callbackObj) return false;
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, callbackObj)) {
+      this.schema.callbacks[identifier] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, callbackObj, this.api);
+      callbackObj = this.schema.callbacks[identifier];
+      if (!callbackObj || _chunkYPR7YTHMcjs.isRef.call(void 0, callbackObj)) {
+        return false;
+      }
     }
-    const callback = callbackObj[expression];
-    if (!callback || _chunkVQBEI5WIcjs.isRef.call(void 0, callback) || !callback[method]) {
+    let callback = callbackObj[expression];
+    if (!callback) return false;
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, callback)) {
+      callbackObj[expression] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, callback, this.api);
+      callback = callbackObj[expression];
+      if (!callback || _chunkYPR7YTHMcjs.isRef.call(void 0, callback)) {
+        return false;
+      }
+    }
+    if (!callback[method]) {
       return false;
     }
-    return new Callback(this.api, expression, method, callback[method], identifier, callback);
+    return new Callback(this.oas, expression, method, callback[method], identifier, callback);
   }
   /**
    * Retrieve an array of operations created from each callback.
@@ -1398,18 +1510,28 @@ var Operation = class {
   getCallbacks() {
     if (!this.hasCallbacks()) return [];
     const callbacks = [];
-    Object.keys(this.schema.callbacks || {}).forEach((callback) => {
-      const cb = _optionalChain([this, 'access', _106 => _106.schema, 'access', _107 => _107.callbacks, 'optionalAccess', _108 => _108[callback]]);
-      if (!cb || _chunkVQBEI5WIcjs.isRef.call(void 0, cb)) {
-        return;
+    Object.keys(this.schema.callbacks).forEach((callback) => {
+      let cb = _optionalChain([this, 'access', _89 => _89.schema, 'access', _90 => _90.callbacks, 'optionalAccess', _91 => _91[callback]]);
+      if (!cb) return;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, cb)) {
+        this.schema.callbacks[callback] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, cb, this.api);
+        cb = this.schema.callbacks[callback];
+        if (!cb || _chunkYPR7YTHMcjs.isRef.call(void 0, cb)) {
+          return;
+        }
       }
       Object.keys(cb).forEach((expression) => {
-        const exp = cb[expression];
-        if (!exp || _chunkVQBEI5WIcjs.isRef.call(void 0, exp)) {
-          return;
+        let callbackPath = cb[expression];
+        if (!callbackPath) return;
+        if (_chunkYPR7YTHMcjs.isRef.call(void 0, callbackPath)) {
+          cb[expression] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, callbackPath, this.api);
+          callbackPath = cb[expression];
+          if (!callbackPath || _chunkYPR7YTHMcjs.isRef.call(void 0, callbackPath)) {
+            return;
+          }
         }
-        Object.keys(exp).forEach((method) => {
-          if (!_chunkO3GIPZLCcjs.supportedMethods.includes(method)) return;
+        Object.keys(callbackPath).forEach((method) => {
+          if (!_chunk7RDMAMMIcjs.supportedMethods.includes(method)) return;
           const found = this.getCallback(callback, expression, method);
           if (found) {
             callbacks.push(found);
@@ -1429,7 +1551,7 @@ var Operation = class {
     if (this.callbackExamples) {
       return this.callbackExamples;
     }
-    this.callbackExamples = getCallbackExamples(this.schema);
+    this.callbackExamples = getCallbackExamples(this.schema, this.api);
     return this.callbackExamples;
   }
   /**
@@ -1452,7 +1574,7 @@ var Operation = class {
    * @deprecated Use `oas.getExtension(extension, operation)` instead.
    */
   getExtension(extension) {
-    return _optionalChain([this, 'access', _109 => _109.schema, 'optionalAccess', _110 => _110[extension]]);
+    return _optionalChain([this, 'access', _92 => _92.schema, 'optionalAccess', _93 => _93[extension]]);
   }
   /**
    * Returns an object with groups of all example definitions (body/header/query/path/response/etc.).
@@ -1486,18 +1608,13 @@ var Operation = class {
       });
     }
     this.dereferencing.processing = true;
-    const { children: discriminatorChildrenMap, inverted: discriminatorChildrenMapInverted } = findDiscriminatorChildren(this.api);
-    const { api, schema, promises } = this;
-    if (_optionalChain([api, 'optionalAccess', _111 => _111.components, 'optionalAccess', _112 => _112.schemas]) && typeof api.components.schemas === "object") {
-      Object.keys(api.components.schemas).forEach((schemaName) => {
-        if (_chunkB5WP4BJMcjs.isPrimitive.call(void 0, _optionalChain([api, 'access', _113 => _113.components, 'optionalAccess', _114 => _114.schemas, 'optionalAccess', _115 => _115[schemaName]])) || Array.isArray(_optionalChain([api, 'access', _116 => _116.components, 'optionalAccess', _117 => _117.schemas, 'optionalAccess', _118 => _118[schemaName]])) || _optionalChain([api, 'access', _119 => _119.components, 'optionalAccess', _120 => _120.schemas, 'optionalAccess', _121 => _121[schemaName]]) === null) {
-          return;
-        }
-        (_optionalChain([api, 'access', _122 => _122.components, 'optionalAccess', _123 => _123.schemas, 'optionalAccess', _124 => _124[schemaName]]))["x-readme-ref-name"] = schemaName;
-      });
+    if (!this.schemasDecorated) {
+      _chunk7RDMAMMIcjs.decorateComponentSchemasWithRefName.call(void 0, this.api);
+      this.schemasDecorated = true;
     }
+    const { api, schema, promises } = this;
     const circularRefs = /* @__PURE__ */ new Set();
-    const dereferencingOptions = _chunkB5WP4BJMcjs.getDereferencingOptions.call(void 0, circularRefs);
+    const dereferencingOptions = _chunk7RDMAMMIcjs.getDereferencingOptions.call(void 0, circularRefs);
     const parser = new (0, _jsonschemarefparser.$RefParser)();
     return parser.dereference(
       "#/__INTERNAL__",
@@ -1530,30 +1647,12 @@ var Operation = class {
             if (path === "#/paths" || path.startsWith("#/paths/")) {
               return true;
             }
-            if (discriminatorChildrenMap.size > 0 || discriminatorChildrenMapInverted.size > 0) {
-              if (path.startsWith("#/components/") && path !== "#/components/schemas" && !path.startsWith("#/components/schemas/")) {
-                return true;
-              }
-              if (path.startsWith("#/components/schemas/")) {
-                const schemaName = path.split("/").pop();
-                if (schemaName && (discriminatorChildrenMap.has(schemaName) || discriminatorChildrenMapInverted.has(schemaName))) {
-                  if (path === `#/components/schemas/${schemaName}` || path.startsWith(`#/components/schemas/${schemaName}/`)) {
-                    return false;
-                  }
-                  return true;
-                }
-              }
-              return false;
-            }
             return path === "#/components" || path.startsWith("#/components/");
           }
         }
       }
     ).then((res) => {
       const dereferenced = res;
-      if (_optionalChain([dereferenced, 'optionalAccess', _125 => _125.components, 'optionalAccess', _126 => _126.schemas]) && discriminatorChildrenMap.size > 0) {
-        buildDiscriminatorOneOf({ components: dereferenced.components }, discriminatorChildrenMap);
-      }
       this.schema = dereferenced.__INTERNAL__;
       this.promises = promises;
       this.dereferencing = {
@@ -1562,7 +1661,7 @@ var Operation = class {
         // We need to convert our `Set` to an array in order to match the typings.
         circularRefs: [...circularRefs]
       };
-      if (_optionalChain([opts, 'optionalAccess', _127 => _127.cb])) {
+      if (_optionalChain([opts, 'optionalAccess', _94 => _94.cb])) {
         opts.cb();
       }
     }).then(() => {
@@ -1573,6 +1672,15 @@ var Operation = class {
       throw err;
     });
   }
+  /**
+   * Determine if the current operation schema, or the OpenAPI definition it's part of, has been
+   * dereferenced or not with `.dereference()`.
+   *
+   * @see Operation.dereference
+   */
+  isDereferenced() {
+    return this.oas.isDereferenced() || this.dereferencing.processing || this.dereferencing.complete;
+  }
   /**
    * Retrieve any circular `$ref` pointers that maybe present within operation schema.
    *
@@ -1586,7 +1694,7 @@ var Operation = class {
     }
     return this.dereferencing.circularRefs;
   }
-};
+}, _class);
 var Callback = class extends Operation {
   /**
    * The identifier that this callback is set to.
@@ -1610,25 +1718,57 @@ var Callback = class extends Operation {
   getIdentifier() {
     return this.identifier;
   }
+  /**
+   * Retrieve the `summary` for this callback.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationsummary}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-summary}
+   */
   getSummary() {
-    if (_optionalChain([this, 'access', _128 => _128.schema, 'optionalAccess', _129 => _129.summary]) && typeof this.schema.summary === "string") {
+    if (_optionalChain([this, 'access', _95 => _95.schema, 'optionalAccess', _96 => _96.summary]) && typeof this.schema.summary === "string") {
       return this.schema.summary;
     } else if (this.parentSchema.summary && typeof this.parentSchema.summary === "string") {
       return this.parentSchema.summary;
     }
     return void 0;
   }
+  /**
+   * Retrieve the `description` for this operation.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationdescription}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-description}
+   */
   getDescription() {
-    if (_optionalChain([this, 'access', _130 => _130.schema, 'optionalAccess', _131 => _131.description]) && typeof this.schema.description === "string") {
+    if (_optionalChain([this, 'access', _97 => _97.schema, 'optionalAccess', _98 => _98.description]) && typeof this.schema.description === "string") {
       return this.schema.description;
     } else if (this.parentSchema.description && typeof this.parentSchema.description === "string") {
       return this.parentSchema.description;
     }
     return void 0;
   }
+  /**
+   * Return the parameters (non-request body) on the operation.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationparameters}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-parameters}
+   */
   getParameters() {
-    let parameters = _optionalChain([this, 'access', _132 => _132.schema, 'optionalAccess', _133 => _133.parameters]) || [];
-    const commonParams = this.parentSchema.parameters || [];
+    let parameters = (_optionalChain([this, 'access', _99 => _99.schema, 'optionalAccess', _100 => _100.parameters]) || []).map((p) => {
+      let param = p;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, param)) {
+        param = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, param, this.api);
+        if (!param || _chunkYPR7YTHMcjs.isRef.call(void 0, param)) return void 0;
+      }
+      return param;
+    }).filter((param) => param !== void 0);
+    const commonParams = (this.parentSchema.parameters || []).map((p) => {
+      let param = p;
+      if (_chunkYPR7YTHMcjs.isRef.call(void 0, param)) {
+        param = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, param, this.api);
+        if (!param || _chunkYPR7YTHMcjs.isRef.call(void 0, param)) return void 0;
+      }
+      return param;
+    }).filter((param) => param !== void 0);
     if (commonParams.length) {
       parameters = parameters.concat(dedupeCommonParameters(parameters, commonParams) || []);
     }
@@ -1636,29 +1776,43 @@ var Callback = class extends Operation {
   }
 };
 var Webhook = class extends Operation {
+  /**
+   * Retrieve the `summary` for this callback.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationsummary}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-summary}
+   */
   getSummary() {
-    if (_optionalChain([this, 'access', _134 => _134.schema, 'optionalAccess', _135 => _135.summary]) && typeof this.schema.summary === "string") {
+    if (_optionalChain([this, 'access', _101 => _101.schema, 'optionalAccess', _102 => _102.summary]) && typeof this.schema.summary === "string") {
       return this.schema.summary;
+    } else if (!this.api.webhooks) {
+      return void 0;
     }
-    const webhookPath = _optionalChain([this, 'access', _136 => _136.api, 'access', _137 => _137.webhooks, 'optionalAccess', _138 => _138[this.path]]);
-    if (webhookPath && !_chunkVQBEI5WIcjs.isRef.call(void 0, webhookPath)) {
-      if (_optionalChain([webhookPath, 'optionalAccess', _139 => _139.summary]) && typeof webhookPath.summary === "string") {
-        return webhookPath.summary;
-      }
+    let webhookPath = this.api.webhooks[this.path];
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, webhookPath)) {
+      this.api.webhooks[this.path] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, webhookPath, this.api);
+      webhookPath = this.api.webhooks[this.path];
     }
-    return void 0;
+    return _optionalChain([webhookPath, 'optionalAccess', _103 => _103.summary]);
   }
+  /**
+   * Retrieve the `description` for this operation.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#user-content-operationdescription}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.2.md#user-content-operation-description}
+   */
   getDescription() {
-    if (_optionalChain([this, 'access', _140 => _140.schema, 'optionalAccess', _141 => _141.description]) && typeof this.schema.description === "string") {
+    if (_optionalChain([this, 'access', _104 => _104.schema, 'optionalAccess', _105 => _105.description]) && typeof this.schema.description === "string") {
       return this.schema.description;
+    } else if (!this.api.webhooks) {
+      return void 0;
     }
-    const webhookPath = _optionalChain([this, 'access', _142 => _142.api, 'access', _143 => _143.webhooks, 'optionalAccess', _144 => _144[this.path]]);
-    if (webhookPath && !_chunkVQBEI5WIcjs.isRef.call(void 0, webhookPath)) {
-      if (_optionalChain([webhookPath, 'optionalAccess', _145 => _145.description]) && typeof webhookPath.description === "string") {
-        return webhookPath.description;
-      }
+    let webhookPath = this.api.webhooks[this.path];
+    if (_chunkYPR7YTHMcjs.isRef.call(void 0, webhookPath)) {
+      this.api.webhooks[this.path] = _chunk7RDMAMMIcjs.dereferenceRef.call(void 0, webhookPath, this.api);
+      webhookPath = this.api.webhooks[this.path];
     }
-    return void 0;
+    return _optionalChain([webhookPath, 'optionalAccess', _106 => _106.description]);
   }
 };
 
@@ -1666,9 +1820,7 @@ var Webhook = class extends Operation {
 
 
 
-
-
-exports.findDiscriminatorChildren = findDiscriminatorChildren; exports.buildDiscriminatorOneOf = buildDiscriminatorOneOf; exports.Operation = Operation; exports.Callback = Callback; exports.Webhook = Webhook;
+exports.Operation = Operation; exports.Callback = Callback; exports.Webhook = Webhook;
 /**
  * Portions of this file have been extracted and modified from Swagger UI.
  *
@@ -1681,4 +1833,4 @@ exports.findDiscriminatorChildren = findDiscriminatorChildren; exports.buildDisc
  * @license Apache-2.0
  * @see {@link https://github.com/swagger-api/swagger-ui/blob/master/src/core/plugins/samples/fn.js}
  */
-//# sourceMappingURL=chunk-BRYRBTD7.cjs.map
+//# sourceMappingURL=chunk-4OCSFLJO.cjs.map