swagger-client 3.36.0 → 3.36.1

package/dist/swagger-client.browser.js

@@ -15567,6 +15567,45 @@ class OpenAPI3_1DereferenceVisitor {
     this.refractCache = refractCache;
     this.allOfDiscriminatorMapping = allOfDiscriminatorMapping;
   }
+  handleDereferenceError(error, refEl, directAncestors) {
+    var _this$options$derefer;
+    if ((_this$options$derefer = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer !== void 0 && _this$options$derefer.continueOnError) {
+      var _this$options$derefer3;
+      if (directAncestors) {
+        const ancestorWithRef = [...directAncestors].find(ancestor => (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isObjectElement)(ancestor) && ancestor.getMetaProperty('ref-referencing-element'));
+        if (ancestorWithRef) {
+          var _this$options$derefer2;
+          (_this$options$derefer2 = this.options.dereference.dereferenceOpts) === null || _this$options$derefer2 === void 0 || _this$options$derefer2.errors.push({
+            error,
+            refEl: ancestorWithRef.getMetaProperty('ref-referencing-element')
+          });
+        }
+      }
+      (_this$options$derefer3 = this.options.dereference.dereferenceOpts) === null || _this$options$derefer3 === void 0 || _this$options$derefer3.errors.push({
+        error,
+        refEl
+      });
+      return undefined;
+    }
+    throw error;
+  }
+  getNestedVisitorOptions(referencingElement) {
+    var _this$options$derefer4, _this$options$derefer5;
+    return {
+      ...this.options,
+      resolve: {
+        ...this.options.resolve,
+        external: (_this$options$derefer4 = this.options.dereference) !== null && _this$options$derefer4 !== void 0 && (_this$options$derefer4 = _this$options$derefer4.dereferenceOpts) !== null && _this$options$derefer4 !== void 0 && _this$options$derefer4.skipNestedExternal && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.get('$ref')).startsWith('#') ? false : this.options.resolve.external
+      },
+      dereference: {
+        ...this.options.dereference,
+        dereferenceOpts: {
+          ...((_this$options$derefer5 = this.options.dereference) === null || _this$options$derefer5 === void 0 ? void 0 : _this$options$derefer5.dereferenceOpts),
+          continueOnError: false
+        }
+      }
+    };
+  }
   toBaseURI(uri) {
     return _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.resolve(this.reference.uri, _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.sanitize(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.stripHash(uri)));
   }
@@ -15621,8 +15660,8 @@ class OpenAPI3_1DereferenceVisitor {
   }
   OpenApi3_1Element = {
     leave: (openApi3_1Element, key, parent, path, ancestors, link) => {
-      var _this$options$derefer;
-      if (!((_this$options$derefer = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer !== void 0 && _this$options$derefer.dereferenceDiscriminatorMapping)) {
+      var _this$options$derefer6;
+      if (!((_this$options$derefer6 = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer6 !== void 0 && _this$options$derefer6.dereferenceDiscriminatorMapping)) {
         return undefined;
       }
       const openApi3_1ElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneShallow)(openApi3_1Element);
@@ -15632,6 +15671,7 @@ class OpenAPI3_1DereferenceVisitor {
     }
   };
   async ReferenceElement(referencingElement, key, parent, path, ancestors, link) {
+    var _this$options$derefer9, _this$options$derefer0;
     // skip current referencing element as it's already been access
     if (this.indirections.includes(referencingElement)) {
       return false;
@@ -15651,13 +15691,23 @@ class OpenAPI3_1DereferenceVisitor {
       // skip traversing this reference element and all it's child elements
       return false;
     }
-    const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
+    let reference;
+    try {
+      reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
+    } catch (error) {
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
+    }
     const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
     this.indirections.push(referencingElement);
     const jsonPointer = _swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-
-    // possibly non-semantic fragment
-    let referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+    let referencedElement;
+    try {
+      // possibly non-semantic fragment
+      referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+    } catch (error) {
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
+    }
     referencedElement.id = identityManager.identify(referencedElement);
 
     // applying semantics to a fragment
@@ -15681,27 +15731,34 @@ class OpenAPI3_1DereferenceVisitor {
 
     // detect direct or indirect reference
     if (referencingElement === referencedElement) {
-      throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Reference Object detected');
+      const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Reference Object detected');
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect maximum depth of dereferencing
     if (this.indirections.length > this.options.dereference.maxDepth) {
-      throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      const error = new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect second deep dive into the same fragment and avoid it
     if (ancestorsLineage.includes(referencedElement)) {
       reference.refSet.circular = true;
       if (this.options.dereference.circular === 'error') {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
-      } else if (this.options.dereference.circular === 'replace') {
-        var _this$options$derefer2, _this$options$derefer3;
+        const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
+      if (this.options.dereference.circular === 'replace') {
+        var _this$options$derefer7, _this$options$derefer8;
         const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__.RefElement(referencedElement.id, {
           type: 'reference',
           uri: reference.uri,
           $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref)
         });
-        const replacer = (_this$options$derefer2 = (_this$options$derefer3 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer3 === void 0 ? void 0 : _this$options$derefer3.circularReplacer) !== null && _this$options$derefer2 !== void 0 ? _this$options$derefer2 : this.options.dereference.circularReplacer;
+        const replacer = (_this$options$derefer7 = (_this$options$derefer8 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer8 === void 0 ? void 0 : _this$options$derefer8.circularReplacer) !== null && _this$options$derefer7 !== void 0 ? _this$options$derefer7 : this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
         link.replaceWith(replacement, mutationReplacer);
         return !parent ? replacement : false;
@@ -15719,22 +15776,27 @@ class OpenAPI3_1DereferenceVisitor {
      */
     const isNonRootDocument = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
     const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isReferenceElement)(referencedElement) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isReferenceElement)(referencedElement) || shouldDetectCircular || (_this$options$derefer9 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer9 !== void 0 && _this$options$derefer9.continueOnError) && !ancestorsLineage.includesCycle(referencedElement)) {
       // append referencing reference to ancestors lineage
       directAncestors.add(referencingElement);
       const visitor = new OpenAPI3_1DereferenceVisitor({
         reference,
         namespace: this.namespace,
         indirections: [...this.indirections],
-        options: this.options,
+        options: this.getNestedVisitorOptions(referencingElement),
         refractCache: this.refractCache,
         ancestors: ancestorsLineage,
         allOfDiscriminatorMapping: this.allOfDiscriminatorMapping
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
-        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
-      });
+      try {
+        referencedElement = await visitAsync(referencedElement, visitor, {
+          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
+          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+        });
+      } catch (error) {
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
 
       // remove referencing reference from ancestors lineage
       directAncestors.delete(referencingElement);
@@ -15759,6 +15821,9 @@ class OpenAPI3_1DereferenceVisitor {
     mergedElement.setMetaProperty('ref-origin', reference.uri);
     // annotate fragment with info about referencing element
     mergedElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(identityManager.identify(referencingElement)));
+    if ((_this$options$derefer0 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer0 !== void 0 && _this$options$derefer0.continueOnError) {
+      mergedElement.setMetaProperty('ref-referencing-element', referencingElement);
+    }
 
     // override description and summary (outer has higher priority then inner)
     if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isObjectElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isObjectElement)(mergedElement)) {
@@ -15783,6 +15848,7 @@ class OpenAPI3_1DereferenceVisitor {
     return !parent ? mergedElement : false;
   }
   async PathItemElement(referencingElement, key, parent, path, ancestors, link) {
+    var _this$options$derefer11;
     // ignore PathItemElement without $ref field
     if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencingElement.$ref)) {
       return undefined;
@@ -15807,13 +15873,23 @@ class OpenAPI3_1DereferenceVisitor {
       // skip traversing this Path Item element but traverse all it's child elements
       return undefined;
     }
-    const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
+    let reference;
+    try {
+      reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
+    } catch (error) {
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
+    }
     const $refBaseURI = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.resolve(retrievalURI, (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref));
     this.indirections.push(referencingElement);
     const jsonPointer = _swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference($refBaseURI);
-
-    // possibly non-semantic referenced element
-    let referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+    let referencedElement;
+    try {
+      // possibly non-semantic referenced element
+      referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+    } catch (error) {
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
+    }
     referencedElement.id = identityManager.identify(referencedElement);
 
     /**
@@ -15831,27 +15907,34 @@ class OpenAPI3_1DereferenceVisitor {
 
     // detect direct or indirect reference
     if (referencingElement === referencedElement) {
-      throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Path Item Object reference detected');
+      const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Path Item Object reference detected');
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect maximum depth of dereferencing
     if (this.indirections.length > this.options.dereference.maxDepth) {
-      throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      const error = new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect second deep dive into the same fragment and avoid it
     if (ancestorsLineage.includes(referencedElement)) {
       reference.refSet.circular = true;
       if (this.options.dereference.circular === 'error') {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
-      } else if (this.options.dereference.circular === 'replace') {
-        var _this$options$derefer4, _this$options$derefer5;
+        const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
+      if (this.options.dereference.circular === 'replace') {
+        var _this$options$derefer1, _this$options$derefer10;
         const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__.RefElement(referencedElement.id, {
           type: 'path-item',
           uri: reference.uri,
           $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref)
         });
-        const replacer = (_this$options$derefer4 = (_this$options$derefer5 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer5 === void 0 ? void 0 : _this$options$derefer5.circularReplacer) !== null && _this$options$derefer4 !== void 0 ? _this$options$derefer4 : this.options.dereference.circularReplacer;
+        const replacer = (_this$options$derefer1 = (_this$options$derefer10 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer10 === void 0 ? void 0 : _this$options$derefer10.circularReplacer) !== null && _this$options$derefer1 !== void 0 ? _this$options$derefer1 : this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
         link.replaceWith(replacement, mutationReplacer);
         return !parent ? replacement : false;
@@ -15869,22 +15952,27 @@ class OpenAPI3_1DereferenceVisitor {
      */
     const isNonRootDocument = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
     const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isPathItemElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isPathItemElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencedElement.$ref) || shouldDetectCircular || (_this$options$derefer11 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer11 !== void 0 && _this$options$derefer11.continueOnError) && !ancestorsLineage.includesCycle(referencedElement)) {
       // append referencing reference to ancestors lineage
       directAncestors.add(referencingElement);
       const visitor = new OpenAPI3_1DereferenceVisitor({
         reference,
         namespace: this.namespace,
         indirections: [...this.indirections],
-        options: this.options,
+        options: this.getNestedVisitorOptions(referencingElement),
         refractCache: this.refractCache,
         ancestors: ancestorsLineage,
         allOfDiscriminatorMapping: this.allOfDiscriminatorMapping
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
-        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
-      });
+      try {
+        referencedElement = await visitAsync(referencedElement, visitor, {
+          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
+          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+        });
+      } catch (error) {
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
 
       // remove referencing reference from ancestors lineage
       directAncestors.delete(referencingElement);
@@ -15895,6 +15983,7 @@ class OpenAPI3_1DereferenceVisitor {
      * Creating a new version of Path Item by merging fields from referenced Path Item with referencing one.
      */
     if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isPathItemElement)(referencedElement)) {
+      var _this$options$derefer12;
       const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.PathItemElement([...referencedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(referencedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(referencedElement.attributes));
       // assign unique id to merged element
       mergedElement.setMetaProperty('id', identityManager.generateId());
@@ -15913,6 +16002,9 @@ class OpenAPI3_1DereferenceVisitor {
       mergedElement.setMetaProperty('ref-origin', reference.uri);
       // annotate fragment with info about referencing element
       mergedElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(identityManager.identify(referencingElement)));
+      if ((_this$options$derefer12 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer12 !== void 0 && _this$options$derefer12.continueOnError) {
+        mergedElement.setMetaProperty('ref-referencing-element', referencingElement);
+      }
       referencedElement = mergedElement;
     }
 
@@ -15934,7 +16026,8 @@ class OpenAPI3_1DereferenceVisitor {
 
     // operationRef and operationId fields are mutually exclusive
     if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(linkElement.operationRef) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(linkElement.operationId)) {
-      throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('LinkElement operationRef and operationId fields are mutually exclusive.');
+      const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('LinkElement operationRef and operationId fields are mutually exclusive.');
+      return this.handleDereferenceError(error, linkElement);
     }
     let operationElement;
     if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(linkElement.operationRef)) {
@@ -15955,8 +16048,14 @@ class OpenAPI3_1DereferenceVisitor {
         // skip traversing this Link element but traverse all it's child elements
         return undefined;
       }
-      const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(linkElement.operationRef));
-      operationElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+      let reference;
+      try {
+        reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(linkElement.operationRef));
+        operationElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(reference.value.result, jsonPointer);
+      } catch (error) {
+        return this.handleDereferenceError(error, linkElement);
+      }
+
       // applying semantics to a referenced element
       if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isPrimitiveElement)(operationElement)) {
         const cacheKey = `operation-${(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(identityManager.identify(operationElement))}`;
@@ -15987,11 +16086,17 @@ class OpenAPI3_1DereferenceVisitor {
     if ((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(linkElement.operationId)) {
       var _linkElementCopy$oper2;
       const operationId = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(linkElement.operationId);
-      const reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize(this.reference.uri));
+      let reference;
+      try {
+        reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize(this.reference.uri));
+      } catch (error) {
+        return this.handleDereferenceError(error, linkElement);
+      }
       operationElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(e => (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isOperationElement)(e) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isElement)(e.operationId) && e.operationId.equals(operationId), reference.value.result);
       // OperationElement not found by its operationId
       if ((0,ramda_adjunct__WEBPACK_IMPORTED_MODULE_2__["default"])(operationElement)) {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"](`OperationElement(operationId=${operationId}) not found.`);
+        const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"](`OperationElement(operationId=${operationId}) not found.`);
+        return this.handleDereferenceError(error, linkElement);
       }
       const linkElementCopy = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneShallow)(linkElement);
       (_linkElementCopy$oper2 = linkElementCopy.operationId) === null || _linkElementCopy$oper2 === void 0 || _linkElementCopy$oper2.meta.set('operation', operationElement);
@@ -16016,7 +16121,8 @@ class OpenAPI3_1DereferenceVisitor {
 
     // value and externalValue fields are mutually exclusive
     if (exampleElement.hasKey('value') && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(exampleElement.externalValue)) {
-      throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('ExampleElement value and externalValue fields are mutually exclusive.');
+      const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('ExampleElement value and externalValue fields are mutually exclusive.');
+      return this.handleDereferenceError(error, exampleElement);
     }
     const retrievalURI = this.toBaseURI((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(exampleElement.externalValue));
     const isInternalReference = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.stripHash(this.reference.uri) === retrievalURI;
@@ -16032,7 +16138,12 @@ class OpenAPI3_1DereferenceVisitor {
       // skip traversing this Example element but traverse all it's child elements
       return undefined;
     }
-    const reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(exampleElement.externalValue));
+    let reference;
+    try {
+      reference = await this.toReference((0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(exampleElement.externalValue));
+    } catch (error) {
+      return this.handleDereferenceError(error, exampleElement);
+    }
 
     // shallow clone of the referenced element
     const valueElement = (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneShallow)(reference.value.result);
@@ -16052,7 +16163,7 @@ class OpenAPI3_1DereferenceVisitor {
     return !parent ? exampleElementCopy : undefined;
   }
   async MemberElement(memberElement, key, parent, path, ancestors, link) {
-    var _this$options$derefer6;
+    var _this$options$derefer13;
     const parentElement = ancestors[ancestors.length - 1];
 
     // skip current MemberElement if its parent is not a DiscriminatorElement
@@ -16061,7 +16172,7 @@ class OpenAPI3_1DereferenceVisitor {
     }
 
     // skip current MemberElement if discriminator mapping dereferencing option is not enabled
-    if (!((_this$options$derefer6 = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer6 !== void 0 && _this$options$derefer6.dereferenceDiscriminatorMapping)) {
+    if (!((_this$options$derefer13 = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer13 !== void 0 && _this$options$derefer13.dereferenceDiscriminatorMapping)) {
       return false;
     }
 
@@ -16096,15 +16207,20 @@ class OpenAPI3_1DereferenceVisitor {
       reference: this.reference,
       namespace: this.namespace,
       indirections: [...this.indirections],
-      options: this.options,
+      options: this.getNestedVisitorOptions(schemaElement),
       refractCache: this.refractCache,
       ancestors: ancestorsLineage,
       allOfDiscriminatorMapping: this.allOfDiscriminatorMapping
     });
-    const referencedElement = await visitAsync(schemaElement, visitor, {
-      keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
-      nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
-    });
+    let referencedElement;
+    try {
+      referencedElement = await visitAsync(schemaElement, visitor, {
+        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
+        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+      });
+    } catch (error) {
+      return this.handleDereferenceError(error, schemaElement, directAncestors);
+    }
 
     // remove referencing reference from ancestors lineage
     directAncestors.delete(schemaElement);
@@ -16125,6 +16241,7 @@ class OpenAPI3_1DereferenceVisitor {
     return !parent ? memberElementCopy : undefined;
   }
   async SchemaElement(referencingElement, key, parent, path, ancestors, link) {
+    var _this$options$derefer16;
     // skip current referencing schema as $ref keyword was not defined
     if (!(0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencingElement.$ref)) {
       return undefined;
@@ -16137,7 +16254,12 @@ class OpenAPI3_1DereferenceVisitor {
     const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
     // compute baseURI using rules around $id and $ref keywords
-    let reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize(this.reference.uri));
+    let reference;
+    try {
+      reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize(this.reference.uri));
+    } catch (error) {
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
+    }
     let {
       uri: retrievalURI
     } = reference;
@@ -16218,10 +16340,20 @@ class OpenAPI3_1DereferenceVisitor {
             // skip traversing this schema element but traverse all it's child elements
             return undefined;
           }
-          reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize($refBaseURI));
+          try {
+            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize($refBaseURI));
+          } catch (toReferenceError) {
+            this.indirections.pop();
+            return this.handleDereferenceError(toReferenceError, referencingElement, directAncestors);
+          }
           const selector = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_17__.uriToAnchor)($refBaseURI);
           const referenceAsSchema = (0,_util_mjs__WEBPACK_IMPORTED_MODULE_25__.maybeRefractToSchemaElement)(reference.value.result);
-          referencedElement = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_17__.evaluate)(selector, referenceAsSchema);
+          try {
+            referencedElement = (0,_selectors_$anchor_mjs__WEBPACK_IMPORTED_MODULE_17__.evaluate)(selector, referenceAsSchema);
+          } catch (evaluateError) {
+            this.indirections.pop();
+            return this.handleDereferenceError(evaluateError, referencingElement, directAncestors);
+          }
           referencedElement = (0,_util_mjs__WEBPACK_IMPORTED_MODULE_25__.maybeRefractToSchemaElement)(referencedElement);
           referencedElement.id = identityManager.identify(referencedElement);
         } else {
@@ -16240,41 +16372,59 @@ class OpenAPI3_1DereferenceVisitor {
             // skip traversing this schema element but traverse all it's child elements
             return undefined;
           }
-          reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize($refBaseURI));
+          try {
+            reference = await this.toReference(_util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.unsanitize($refBaseURI));
+          } catch (toReferenceError) {
+            this.indirections.pop();
+            return this.handleDereferenceError(toReferenceError, referencingElement, directAncestors);
+          }
           const selector = _swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_11__.URIFragmentIdentifier.fromURIReference($refBaseURI);
           const referenceAsSchema = (0,_util_mjs__WEBPACK_IMPORTED_MODULE_25__.maybeRefractToSchemaElement)(reference.value.result);
-          referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(referenceAsSchema, selector);
+          try {
+            referencedElement = (0,_swagger_api_apidom_json_pointer_modern__WEBPACK_IMPORTED_MODULE_12__.evaluate)(referenceAsSchema, selector);
+          } catch (evaluateError) {
+            this.indirections.pop();
+            return this.handleDereferenceError(evaluateError, referencingElement, directAncestors);
+          }
           referencedElement = (0,_util_mjs__WEBPACK_IMPORTED_MODULE_25__.maybeRefractToSchemaElement)(referencedElement);
           referencedElement.id = identityManager.identify(referencedElement);
         }
       } else {
-        throw error;
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
       }
     }
 
     // detect direct or indirect reference
     if (referencingElement === referencedElement) {
-      throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Schema Object reference detected');
+      const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Recursive Schema Object reference detected');
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect maximum depth of dereferencing
     if (this.indirections.length > this.options.dereference.maxDepth) {
-      throw new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      const error = new _errors_MaximumDereferenceDepthError_mjs__WEBPACK_IMPORTED_MODULE_19__["default"](`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
+      this.indirections.pop();
+      return this.handleDereferenceError(error, referencingElement, directAncestors);
     }
 
     // detect second deep dive into the same fragment and avoid it
     if (ancestorsLineage.includes(referencedElement)) {
       reference.refSet.circular = true;
       if (this.options.dereference.circular === 'error') {
-        throw new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
-      } else if (this.options.dereference.circular === 'replace') {
-        var _this$options$derefer7, _this$options$derefer8;
+        const error = new _swagger_api_apidom_error__WEBPACK_IMPORTED_MODULE_10__["default"]('Circular reference detected');
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
+      if (this.options.dereference.circular === 'replace') {
+        var _this$options$derefer14, _this$options$derefer15;
         const refElement = new _swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_4__.RefElement(referencedElement.id, {
           type: 'json-schema',
           uri: reference.uri,
           $ref: (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_9__["default"])(referencingElement.$ref)
         });
-        const replacer = (_this$options$derefer7 = (_this$options$derefer8 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer8 === void 0 ? void 0 : _this$options$derefer8.circularReplacer) !== null && _this$options$derefer7 !== void 0 ? _this$options$derefer7 : this.options.dereference.circularReplacer;
+        const replacer = (_this$options$derefer14 = (_this$options$derefer15 = this.options.dereference.strategyOpts['openapi-3-1']) === null || _this$options$derefer15 === void 0 ? void 0 : _this$options$derefer15.circularReplacer) !== null && _this$options$derefer14 !== void 0 ? _this$options$derefer14 : this.options.dereference.circularReplacer;
         const replacement = replacer(refElement);
         link.replaceWith(replacement, mutationReplacer);
         return !parent ? replacement : false;
@@ -16292,22 +16442,27 @@ class OpenAPI3_1DereferenceVisitor {
      */
     const isNonRootDocument = _util_url_mjs__WEBPACK_IMPORTED_MODULE_21__.stripHash(reference.refSet.rootRef.uri) !== reference.uri;
     const shouldDetectCircular = ['error', 'replace'].includes(this.options.dereference.circular);
-    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isSchemaElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencedElement.$ref) || shouldDetectCircular) && !ancestorsLineage.includesCycle(referencedElement)) {
+    if ((isExternalReference || isNonRootDocument || (0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isSchemaElement)(referencedElement) && (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_5__.isStringElement)(referencedElement.$ref) || shouldDetectCircular || (_this$options$derefer16 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer16 !== void 0 && _this$options$derefer16.continueOnError) && !ancestorsLineage.includesCycle(referencedElement)) {
       // append referencing reference to ancestors lineage
       directAncestors.add(referencingElement);
       const visitor = new OpenAPI3_1DereferenceVisitor({
         reference,
         namespace: this.namespace,
         indirections: [...this.indirections],
-        options: this.options,
+        options: this.getNestedVisitorOptions(referencingElement),
         refractCache: this.refractCache,
         ancestors: ancestorsLineage,
         allOfDiscriminatorMapping: this.allOfDiscriminatorMapping
       });
-      referencedElement = await visitAsync(referencedElement, visitor, {
-        keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
-        nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
-      });
+      try {
+        referencedElement = await visitAsync(referencedElement, visitor, {
+          keyMap: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.keyMap,
+          nodeTypeGetter: _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_15__.getNodeType
+        });
+      } catch (error) {
+        this.indirections.pop();
+        return this.handleDereferenceError(error, referencingElement, directAncestors);
+      }
 
       // remove referencing reference from ancestors lineage
       directAncestors.delete(referencingElement);
@@ -16336,7 +16491,7 @@ class OpenAPI3_1DereferenceVisitor {
      * Creating a new version of Schema Object by merging fields from referenced Schema Object with referencing one.
      */
     if ((0,_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isSchemaElement)(referencedElement)) {
-      var _this$options$derefer9;
+      var _this$options$derefer17, _this$options$derefer18;
       const mergedElement = new _swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_16__.SchemaElement([...referencedElement.content], (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(referencedElement.meta), (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(referencedElement.attributes));
       // assign unique id to merged element
       mergedElement.setMetaProperty('id', identityManager.generateId());
@@ -16355,9 +16510,12 @@ class OpenAPI3_1DereferenceVisitor {
       mergedElement.setMetaProperty('ref-origin', reference.uri);
       // annotate fragment with info about referencing element
       mergedElement.setMetaProperty('ref-referencing-element-id', (0,_swagger_api_apidom_core__WEBPACK_IMPORTED_MODULE_7__.cloneDeep)(identityManager.identify(referencingElement)));
+      if ((_this$options$derefer17 = this.options.dereference.dereferenceOpts) !== null && _this$options$derefer17 !== void 0 && _this$options$derefer17.continueOnError) {
+        mergedElement.setMetaProperty('ref-referencing-element', referencingElement);
+      }
 
       // creating mapping for allOf discriminator
-      if ((_this$options$derefer9 = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer9 !== void 0 && _this$options$derefer9.dereferenceDiscriminatorMapping) {
+      if ((_this$options$derefer18 = this.options.dereference.strategyOpts['openapi-3-1']) !== null && _this$options$derefer18 !== void 0 && _this$options$derefer18.dereferenceDiscriminatorMapping) {
         var _parentElement$classe;
         const parentElement = ancestors[ancestors.length - 1];
         const parentSchemaElement = [...directAncestors].findLast(_swagger_api_apidom_ns_openapi_3_1__WEBPACK_IMPORTED_MODULE_14__.isSchemaElement);
@@ -16549,7 +16707,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   Schema: () => (/* binding */ Schema),
 /* harmony export */   Type: () => (/* binding */ Type),
 /* harmony export */   YAMLException: () => (/* binding */ YAMLException),
-/* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__),
+/* harmony export */   "default": () => (/* binding */ jsYaml),
 /* harmony export */   dump: () => (/* binding */ dump),
 /* harmony export */   load: () => (/* binding */ load),
 /* harmony export */   loadAll: () => (/* binding */ loadAll),
@@ -16559,7 +16717,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   types: () => (/* binding */ types)
 /* harmony export */ });
 
-/*! js-yaml 4.1.0 https://github.com/nodeca/js-yaml @license MIT */
+/*! js-yaml 4.1.1 https://github.com/nodeca/js-yaml @license MIT */
 function isNothing(subject) {
   return (typeof subject === 'undefined') || (subject === null);
 }
@@ -17770,6 +17928,22 @@ function charFromCodepoint(c) {
   );
 }
 
+// set a property of a literal object, while protecting against prototype pollution,
+// see https://github.com/nodeca/js-yaml/issues/164 for more details
+function setProperty(object, key, value) {
+  // used for this specific key only because Object.defineProperty is slow
+  if (key === '__proto__') {
+    Object.defineProperty(object, key, {
+      configurable: true,
+      enumerable: true,
+      writable: true,
+      value: value
+    });
+  } else {
+    object[key] = value;
+  }
+}
+
 var simpleEscapeCheck = new Array(256); // integer, for fast access
 var simpleEscapeMap = new Array(256);
 for (var i = 0; i < 256; i++) {
@@ -17948,7 +18122,7 @@ function mergeMappings(state, destination, source, overridableKeys) {
     key = sourceKeys[index];
 
     if (!_hasOwnProperty$1.call(destination, key)) {
-      destination[key] = source[key];
+      setProperty(destination, key, source[key]);
       overridableKeys[key] = true;
     }
   }
@@ -18008,17 +18182,7 @@ function storeMappingPair(state, _result, overridableKeys, keyTag, keyNode, valu
       throwError(state, 'duplicated mapping key');
     }
 
-    // used for this specific key only because Object.defineProperty is slow
-    if (keyNode === '__proto__') {
-      Object.defineProperty(_result, keyNode, {
-        configurable: true,
-        enumerable: true,
-        writable: true,
-        value: valueNode
-      });
-    } else {
-      _result[keyNode] = valueNode;
-    }
+    setProperty(_result, keyNode, valueNode);
     delete overridableKeys[keyNode];
   }
 
@@ -20407,7 +20571,6 @@ var jsYaml = {
 	safeDump: safeDump
 };
 
-/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (jsYaml);
 
 
 
@@ -50695,35 +50858,145 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   readFile: () => (/* binding */ readFile)
 /* harmony export */ });
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(23557);
-/* harmony import */ var _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(17955);
-/* harmony import */ var _errors_ResolveError_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(35416);
-/* harmony import */ var _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12207);
+/* harmony import */ var _File_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(38396);
+/* harmony import */ var _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(17955);
+/* harmony import */ var _errors_ResolveError_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(35416);
+/* harmony import */ var _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(12207);
+
 
 
 
 
+const CACHE_NAME = 'apidom-file-cache';
+const getCacheFileResult = async ({
+  cacheKey,
+  cacheTTL
+}) => {
+  if (cacheTTL === 0) {
+    return {
+      cachedResult: null,
+      cachedError: null
+    };
+  }
+  try {
+    const cache = await caches.open(CACHE_NAME);
+    const response = await cache.match(cacheKey);
+    if (response) {
+      const {
+        cachedResult,
+        cachedError,
+        timestamp
+      } = await response.json();
+      const now = Date.now();
+
+      // Check if the cache is still valid
+      if (now - timestamp < cacheTTL) {
+        return {
+          cachedResult,
+          cachedError
+        };
+      }
+      await cache.delete(cacheKey);
+    }
+  } catch (error) {
+    // If parsing cache fails, continue with normal parsing
+    console.log('There was an error parsing the response');
+    return {
+      cachedResult: null,
+      cachedError: null
+    };
+  }
+  return {
+    cachedResult: null,
+    cachedError: null
+  };
+};
+const setCacheFileResult = async ({
+  cacheKey,
+  result,
+  error,
+  cacheTTL
+}) => {
+  if (cacheTTL === 0) {
+    return;
+  }
+  try {
+    const cacheData = {
+      cachedResult: result,
+      cachedError: error,
+      timestamp: Date.now()
+    };
+    const cache = await caches.open(CACHE_NAME);
+    const response = new Response(JSON.stringify(cacheData), {
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    });
+    await cache.put(cacheKey, response);
+  } catch (err) {
+    // Silently fail if CacheStorage is not available
+    console.error('CacheStorage is not available');
+  }
+};
+
 /**
  * Reads the given file, using the configured resolver plugins.
  */
 // eslint-disable-next-line import/prefer-default-export
 const readFile = async (file, options) => {
+  const {
+    cacheTTL = 0
+  } = options.resolve.resolverOpts;
+  const cacheKey = `read_${file.uri}`;
+  const {
+    cachedResult,
+    cachedError
+  } = await getCacheFileResult({
+    cacheKey,
+    cacheTTL
+  });
+  if (cachedResult !== null) {
+    return cachedResult;
+  }
+  if (cachedError !== null) {
+    throw new _errors_ResolveError_mjs__WEBPACK_IMPORTED_MODULE_3__["default"](`Error while reading file "${file.uri}"`, {
+      cause: cachedError
+    });
+  }
   const optsBoundResolvers = options.resolve.resolvers.map(resolver => {
     const clonedResolver = Object.create(resolver);
     return Object.assign(clonedResolver, options.resolve.resolverOpts);
   });
-  const resolvers = await _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_1__.filter('canRead', [file, options], optsBoundResolvers);
+  const resolvers = await _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_2__.filter('canRead', [file, options], optsBoundResolvers);
 
   // we couldn't find any resolver for this File
   if ((0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(resolvers)) {
-    throw new _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_3__["default"](file.uri);
+    throw new _errors_UnmatchedResolverError_mjs__WEBPACK_IMPORTED_MODULE_4__["default"](file.uri);
   }
   try {
     const {
       result
-    } = await _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_1__.run('read', [file], resolvers);
+    } = await _util_plugins_mjs__WEBPACK_IMPORTED_MODULE_2__.run('read', [file], resolvers);
+    const stringifiedData = new _File_mjs__WEBPACK_IMPORTED_MODULE_1__["default"]({
+      ...file,
+      data: result
+    }).toString();
+    await setCacheFileResult({
+      cacheKey,
+      result: stringifiedData,
+      error: null,
+      cacheTTL
+    });
     return result;
   } catch (error) {
-    throw new _errors_ResolveError_mjs__WEBPACK_IMPORTED_MODULE_2__["default"](`Error while reading file "${file.uri}"`, {
+    var _ref, _error$cause$cause, _error$cause;
+    await setCacheFileResult({
+      cacheKey,
+      result: null,
+      error: (_ref = (_error$cause$cause = error === null || error === void 0 || (_error$cause = error.cause) === null || _error$cause === void 0 ? void 0 : _error$cause.cause) !== null && _error$cause$cause !== void 0 ? _error$cause$cause : error === null || error === void 0 ? void 0 : error.cause) !== null && _ref !== void 0 ? _ref : error,
+      cacheTTL
+    });
+    throw new _errors_ResolveError_mjs__WEBPACK_IMPORTED_MODULE_3__["default"](`Error while reading file "${file.uri}"`, {
       cause: error
     });
   }
@@ -53925,7 +54198,11 @@ const defaultOptions = {
      * true - the dereferencing process will be immutable (deep cloning of ApiDOM is involved)
      * false - the dereferencing process will be mutable
      */
-    immutable: true
+    immutable: true,
+    /**
+     * These options are available in dereference strategy visitors.
+     */
+    dereferenceOpts: {}
   },
   bundle: {
     /**