Fix SmartDocs race condition - make spec loading synchronous

js/smartdocs_integration.js

@@ -11,25 +11,38 @@
   Drupal.behaviors.smartdocsFieldFormatter = {
     attach: function (context) {
       let specMap = {};
+      let pendingRequests = 0;
+
       for (let fieldName in drupalSettings.smartdocsFieldFormatter) {
         if (drupalSettings.smartdocsFieldFormatter.hasOwnProperty(fieldName)) {
           const field = drupalSettings.smartdocsFieldFormatter[fieldName];
           for (let fieldDelta = 0; fieldDelta < field.openApiFiles.length; fieldDelta++) {
             // Each openApiFile var has the spec url and file extension.
             const fileUrl = field.openApiFiles[fieldDelta].fileUrl;
             const fileExtention = field.openApiFiles[fieldDelta].fileExtension;
+
+            // Track pending AJAX requests
+            pendingRequests++;
+
             // Get the OpenAPI spec file from the server.
-            $.get(fileUrl, function(data, status) {
-              if (fileExtention === 'json') {
-                // JSON files do not need any conversion.
-                specMap[field.entityId] = data;
+            $.ajax({
+              url: fileUrl,
+              async: false, // Make synchronous to ensure data loads before SmartDocs initializes
+              success: function(data, status) {
+                if (fileExtention === 'json') {
+                  // JSON files do not need any conversion.
+                  specMap[field.entityId] = data;
+                }
+                else {
+                  // YAML files need to be parsed into javascript object.
+                  specMap[field.entityId]  = jsyaml.load(data);
+                }
+                // Store the spec into session storage.
+                sessionStorage.setItem('specs', JSON.stringify(specMap));
+              },
+              complete: function() {
+                pendingRequests--;
               }
-              else {
-                // YAML files need to be parsed into javascript object.
-                specMap[field.entityId]  = jsyaml.load(data);
-             }
-              // Store the spec into session storage.
-              sessionStorage.setItem('specs', JSON.stringify(specMap));
             });
           }
         }