adaptar-vite-plugin 1.0.5 → 1.0.6

package/dist/html-tags.js

@@ -6,6 +6,7 @@ import { SELECTION_BRIDGE_SCRIPT } from "./scripts/selection-bridge.js";
  */
 const HMR_LISTENER_SCRIPT = /* js */ `
   const adaptarOperationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  let adaptarBlockingHmrError = false;
   const readAdaptarRootHealth = () => {
     const root = document.getElementById('root');
     const hasRootContent = Boolean(root && (root.children.length || (root.textContent || '').trim()));
@@ -28,6 +29,9 @@ const HMR_LISTENER_SCRIPT = /* js */ `
 
   if (import.meta.hot) {
     import.meta.hot.on('adaptar:error', (data) => {
+      if (data?.renderBlocking === true) {
+        adaptarBlockingHmrError = true;
+      }
       postToHost('error', {
         error: {
           ...data,
@@ -36,10 +40,21 @@ const HMR_LISTENER_SCRIPT = /* js */ `
       });
     });
     import.meta.hot.on('adaptar:compile-success', (data) => {
+      const rootHealth = readAdaptarRootHealth();
       postToHost('compile-success', {
         ...(data || {}),
-        rootHealth: readAdaptarRootHealth(),
+        rootHealth,
       });
+      if (adaptarBlockingHmrError && rootHealth.hasRootContent) {
+        adaptarBlockingHmrError = false;
+        postToHost('preview-recovered', {
+          recoveredAt: Date.now(),
+          reason: 'hmr-compile-recovered',
+          resolvedSources: ['vite-hmr'],
+          hasRootContent: true,
+          rootHealth,
+        });
+      }
     });
   }
 

package/dist/scripts/error-bridge.d.ts

@@ -1 +1 @@
-export declare const ERROR_BRIDGE_SCRIPT = "(function(){\n  if (window.__ADAPTAR_ERROR_BRIDGE__) return;\n  window.__ADAPTAR_ERROR_BRIDGE__ = true;\n\n  var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;\n\n  function readRootHealth() {\n    var root = document.getElementById('root');\n    var hasRootContent = Boolean(\n      root && (root.children.length || (root.textContent || '').trim())\n    );\n\n    return {\n      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),\n      hasRootContent: hasRootContent,\n      readyState: document.readyState\n    };\n  }\n\n  function sendRendered(heartbeat) {\n    try {\n      var rootHealth = readRootHealth();\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: heartbeat ? 'render-heartbeat' : 'preview-rendered',\n        operationId: operationId,\n        renderedAt: Date.now(),\n        hasRootContent: rootHealth.hasRootContent,\n        rootHealth: rootHealth\n      }, '*');\n    } catch (_) {}\n  }\n\n  function classifyResource(target, url) {\n    var tag = String((target && target.tagName) || '').toLowerCase();\n    var rel = String((target && target.rel) || '').toLowerCase();\n    var as = String((target && target.as) || '').toLowerCase();\n    var type = String((target && target.type) || '').toLowerCase();\n    var value = String(url || '').split(/[?#]/)[0].toLowerCase();\n\n    if (\n      as === 'font' ||\n      type.indexOf('font/') === 0 ||\n      /\\.(woff2?|ttf|otf|eot)$/.test(value)\n    ) return 'font';\n    if (\n      tag === 'img' ||\n      as === 'image' ||\n      /\\.(avif|bmp|gif|ico|jpe?g|png|svg|webp)$/.test(value)\n    ) return 'image';\n    if (\n      tag === 'audio' || tag === 'video' || tag === 'source' || tag === 'track' ||\n      as === 'audio' || as === 'video' ||\n      /\\.(aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)$/.test(value)\n    ) return 'media';\n    if (\n      tag === 'script' ||\n      as === 'script' ||\n      rel === 'modulepreload' ||\n      type === 'module' ||\n      /\\.(c|m)?(j|t)sx?$/.test(value)\n    ) return 'module';\n    if (\n      (tag === 'link' && rel === 'stylesheet') ||\n      as === 'style' ||\n      type === 'text/css' ||\n      /\\.(css|less|sass|scss|styl)$/.test(value)\n    ) return 'stylesheet';\n    return 'unknown';\n  }\n\n  function resourceFailureMessage(resourceKind, url) {\n    var labels = {\n      font: 'Failed to load font: ',\n      image: 'Failed to load image: ',\n      media: 'Failed to load media: ',\n      module: 'Failed to load module: ',\n      stylesheet: 'Failed to load stylesheet: ',\n      unknown: 'Failed to load resource: '\n    };\n    return (labels[resourceKind] || labels.unknown) + url;\n  }\n\n  function send(message, stack, filename, lineno, colno, source, plugin, metadata) {\n    try {\n      var details = metadata || {};\n      var rootHealth = readRootHealth();\n      var renderBlocking = details.renderBlocking === true || (\n        details.blockWhenRootEmpty === true && !rootHealth.hasRootContent\n      );\n\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: 'error',\n        operationId: operationId,\n        error: {\n          message: message || 'Unknown error',\n          stack: stack || '',\n          filename: filename,\n          lineno: lineno,\n          colno: colno,\n          source: source,\n          plugin: plugin,\n          classification: renderBlocking ? 'render-blocking' : 'diagnostic',\n          category: details.category || 'runtime',\n          severity: renderBlocking ? 'error' : 'advisory',\n          resourceKind: details.resourceKind || 'unknown',\n          renderBlocking: renderBlocking,\n          rootHealth: rootHealth\n        }\n      }, '*');\n    } catch (_) {}\n  }\n\n  // Resource failures remain observable, but only a module required before\n  // the application mounts can be classified as render-blocking. Images,\n  // fonts, media, and stylesheets are quality diagnostics.\n  window.addEventListener('error', function(e) {\n    var target = e.target || e.srcElement;\n    if (target && target !== window && target.tagName) {\n      var url = target.src || target.href || target.currentSrc;\n      var resourceKind = classifyResource(target, url);\n      if (url || resourceKind !== 'unknown') {\n        send(\n          resourceFailureMessage(resourceKind, url || '(unknown resource URL)'),\n          '', url, undefined, undefined, 'resource-load', undefined,\n          {\n            category: 'resource',\n            resourceKind: resourceKind,\n            blockWhenRootEmpty: resourceKind === 'module'\n          }\n        );\n        return;\n      }\n    }\n\n    send(\n      e.message || (e.error && e.error.message) || 'Runtime error occurred',\n      e.error ? e.error.stack : '',\n      e.filename, e.lineno, e.colno, 'runtime', undefined,\n      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }\n    );\n  }, true);\n\n  // An async failure is blocking only when the application has no rendered\n  // root. Interaction failures in an otherwise-rendered page remain visible\n  // diagnostics and never invalidate the candidate by themselves.\n  window.addEventListener('unhandledrejection', function(e) {\n    var r = e.reason;\n    send(\n      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),\n      r && r.stack,\n      r && r.fileName,\n      r && r.lineNumber,\n      r && r.columnNumber,\n      'unhandledrejection', undefined,\n      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }\n    );\n  });\n\n  // Intercept only errors that indicate a Vite/module compilation failure.\n  // Their render-blocking status is still tied to an empty application root;\n  // Vite HMR compile failures are classified separately by the server bridge.\n  var nativeConsoleError = console.error;\n  console.error = function() {\n    var args = Array.prototype.slice.call(arguments);\n    var msg = args.map(function(a) {\n      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));\n    }).join(' ');\n    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {\n      send(\n        msg, '', undefined, undefined, undefined, 'console.error', undefined,\n        { category: 'compile', resourceKind: 'module', blockWhenRootEmpty: true }\n      );\n    }\n    return nativeConsoleError.apply(console, args);\n  };\n\n  // Blank root is a deterministic rendering failure. Quality checks are sent\n  // separately as advisory diagnostics once a root is healthy.\n  window.addEventListener('load', function() {\n    requestAnimationFrame(function() {\n      requestAnimationFrame(function() {\n        sendRendered(false);\n      });\n    });\n\n    setTimeout(function() {\n      var rootHealth = readRootHealth();\n      if (!rootHealth.hasRootContent) {\n        send(\n          'Runtime error: Preview failed to render; a component or import may have failed silently.',\n          '', location.href, undefined, undefined, 'blank-screen', undefined,\n          { category: 'render', resourceKind: 'document', renderBlocking: true }\n        );\n      } else {\n        var images = Array.prototype.slice.call(document.querySelectorAll('img'));\n        var controls = Array.prototype.slice.call(\n          document.querySelectorAll('button, a[href], input, select, textarea')\n        );\n        var checks = {\n          viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,\n          horizontalOverflow:\n            document.documentElement.scrollWidth >\n            (document.documentElement.clientWidth || window.innerWidth || 0) + 2,\n          brokenImages: images.filter(function(img) {\n            return img.complete && img.naturalWidth === 0;\n          }).length,\n          missingImageAlt: images.filter(function(img) {\n            return !img.hasAttribute('alt');\n          }).length,\n          unlabeledControls: controls.filter(function(control) {\n            var label = (\n              control.getAttribute('aria-label') ||\n              control.getAttribute('title') ||\n              control.textContent ||\n              control.value ||\n              ''\n            ).trim();\n            return !label;\n          }).length\n        };\n        var diagnostics = [];\n\n        if (checks.horizontalOverflow) {\n          diagnostics.push({\n            code: 'horizontal-overflow',\n            classification: 'diagnostic',\n            category: 'layout',\n            severity: 'advisory',\n            resourceKind: 'quality',\n            renderBlocking: false,\n            message: 'The preview has horizontal overflow.'\n          });\n        }\n        if (checks.brokenImages > 0) {\n          diagnostics.push({\n            code: 'broken-images',\n            classification: 'diagnostic',\n            category: 'asset',\n            severity: 'advisory',\n            resourceKind: 'image',\n            renderBlocking: false,\n            message: 'One or more images could not be displayed.',\n            count: checks.brokenImages\n          });\n        }\n        if (checks.missingImageAlt > 0) {\n          diagnostics.push({\n            code: 'missing-image-alt',\n            classification: 'diagnostic',\n            category: 'accessibility',\n            severity: 'advisory',\n            resourceKind: 'image',\n            renderBlocking: false,\n            message: 'One or more images are missing alternative text.',\n            count: checks.missingImageAlt\n          });\n        }\n        if (checks.unlabeledControls > 0) {\n          diagnostics.push({\n            code: 'unlabeled-controls',\n            classification: 'diagnostic',\n            category: 'accessibility',\n            severity: 'advisory',\n            resourceKind: 'control',\n            renderBlocking: false,\n            message: 'One or more controls do not have an accessible label.',\n            count: checks.unlabeledControls\n          });\n        }\n\n        window.parent.postMessage({\n          source: 'adaptar-preview',\n          type: 'preview-stable',\n          operationId: operationId,\n          stableAt: Date.now(),\n          hasRootContent: rootHealth.hasRootContent,\n          rootHealth: rootHealth,\n          checks: checks,\n          diagnostics: diagnostics\n        }, '*');\n      }\n    }, 3000);\n  });\n\n  window.setInterval(function() { sendRendered(true); }, 20000);\n})();";
+export declare const ERROR_BRIDGE_SCRIPT = "(function(){\n  if (window.__ADAPTAR_ERROR_BRIDGE__) return;\n  window.__ADAPTAR_ERROR_BRIDGE__ = true;\n\n  var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;\n  var activeBlockingSources = Object.create(null);\n  var blankCheckStartedAt = 0;\n  var blankCheckTimer;\n  var blankFailureReported = false;\n  var BLANK_CONFIRMATION_MS = 8000;\n  var ROOT_CHECK_INTERVAL_MS = 500;\n\n  function readRootHealth() {\n    var root = document.getElementById('root');\n    var hasRootContent = Boolean(\n      root && (root.children.length || (root.textContent || '').trim())\n    );\n\n    return {\n      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),\n      hasRootContent: hasRootContent,\n      readyState: document.readyState\n    };\n  }\n\n  function sendRendered(heartbeat) {\n    try {\n      var rootHealth = readRootHealth();\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: heartbeat ? 'render-heartbeat' : 'preview-rendered',\n        operationId: operationId,\n        renderedAt: Date.now(),\n        hasRootContent: rootHealth.hasRootContent,\n        rootHealth: rootHealth\n      }, '*');\n    } catch (_) {}\n  }\n\n  function classifyResource(target, url) {\n    var tag = String((target && target.tagName) || '').toLowerCase();\n    var rel = String((target && target.rel) || '').toLowerCase();\n    var as = String((target && target.as) || '').toLowerCase();\n    var type = String((target && target.type) || '').toLowerCase();\n    var value = String(url || '').split(/[?#]/)[0].toLowerCase();\n\n    if (\n      as === 'font' ||\n      type.indexOf('font/') === 0 ||\n      /\\.(woff2?|ttf|otf|eot)$/.test(value)\n    ) return 'font';\n    if (\n      tag === 'img' ||\n      as === 'image' ||\n      /\\.(avif|bmp|gif|ico|jpe?g|png|svg|webp)$/.test(value)\n    ) return 'image';\n    if (\n      tag === 'audio' || tag === 'video' || tag === 'source' || tag === 'track' ||\n      as === 'audio' || as === 'video' ||\n      /\\.(aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)$/.test(value)\n    ) return 'media';\n    if (\n      tag === 'script' ||\n      as === 'script' ||\n      rel === 'modulepreload' ||\n      type === 'module' ||\n      /\\.(c|m)?(j|t)sx?$/.test(value)\n    ) return 'module';\n    if (\n      (tag === 'link' && rel === 'stylesheet') ||\n      as === 'style' ||\n      type === 'text/css' ||\n      /\\.(css|less|sass|scss|styl)$/.test(value)\n    ) return 'stylesheet';\n    return 'unknown';\n  }\n\n  function resourceFailureMessage(resourceKind, url) {\n    var labels = {\n      font: 'Failed to load font: ',\n      image: 'Failed to load image: ',\n      media: 'Failed to load media: ',\n      module: 'Failed to load module: ',\n      stylesheet: 'Failed to load stylesheet: ',\n      unknown: 'Failed to load resource: '\n    };\n    return (labels[resourceKind] || labels.unknown) + url;\n  }\n\n  function send(message, stack, filename, lineno, colno, source, plugin, metadata) {\n    try {\n      var details = metadata || {};\n      var rootHealth = readRootHealth();\n      var renderBlocking = details.renderBlocking === true || (\n        details.blockWhenRootEmpty === true && !rootHealth.hasRootContent\n      );\n      var errorSource = source || 'unknown';\n\n      if (renderBlocking) {\n        activeBlockingSources[errorSource] = true;\n      }\n\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: 'error',\n        operationId: operationId,\n        error: {\n          message: message || 'Unknown error',\n          stack: stack || '',\n          filename: filename,\n          lineno: lineno,\n          colno: colno,\n          source: source,\n          plugin: plugin,\n          classification: renderBlocking ? 'render-blocking' : 'diagnostic',\n          category: details.category || 'runtime',\n          severity: renderBlocking ? 'error' : 'advisory',\n          resourceKind: details.resourceKind || 'unknown',\n          renderBlocking: renderBlocking,\n          rootHealth: rootHealth\n        }\n      }, '*');\n    } catch (_) {}\n  }\n\n  function recoverBlockingErrorsIfRendered(reason) {\n    try {\n      var rootHealth = readRootHealth();\n      var resolvedSources = Object.keys(activeBlockingSources);\n      if (!rootHealth.hasRootContent || resolvedSources.length === 0) return;\n\n      activeBlockingSources = Object.create(null);\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: 'preview-recovered',\n        operationId: operationId,\n        recoveredAt: Date.now(),\n        reason: reason || 'root-healthy',\n        resolvedSources: resolvedSources,\n        hasRootContent: true,\n        rootHealth: rootHealth\n      }, '*');\n    } catch (_) {}\n  }\n\n  // Resource failures remain observable, but only a module required before\n  // the application mounts can be classified as render-blocking. Images,\n  // fonts, media, and stylesheets are quality diagnostics.\n  window.addEventListener('error', function(e) {\n    var target = e.target || e.srcElement;\n    if (target && target !== window && target.tagName) {\n      var url = target.src || target.href || target.currentSrc;\n      var resourceKind = classifyResource(target, url);\n      if (url || resourceKind !== 'unknown') {\n        send(\n          resourceFailureMessage(resourceKind, url || '(unknown resource URL)'),\n          '', url, undefined, undefined, 'resource-load', undefined,\n          {\n            category: 'resource',\n            resourceKind: resourceKind,\n            blockWhenRootEmpty: resourceKind === 'module'\n          }\n        );\n        return;\n      }\n    }\n\n    send(\n      e.message || (e.error && e.error.message) || 'Runtime error occurred',\n      e.error ? e.error.stack : '',\n      e.filename, e.lineno, e.colno, 'runtime', undefined,\n      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }\n    );\n  }, true);\n\n  // An async failure is blocking only when the application has no rendered\n  // root. Interaction failures in an otherwise-rendered page remain visible\n  // diagnostics and never invalidate the candidate by themselves.\n  window.addEventListener('unhandledrejection', function(e) {\n    var r = e.reason;\n    send(\n      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),\n      r && r.stack,\n      r && r.fileName,\n      r && r.lineNumber,\n      r && r.columnNumber,\n      'unhandledrejection', undefined,\n      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }\n    );\n  });\n\n  // Intercept only errors that indicate a Vite/module compilation failure.\n  // Their render-blocking status is still tied to an empty application root;\n  // Vite HMR compile failures are classified separately by the server bridge.\n  var nativeConsoleError = console.error;\n  console.error = function() {\n    var args = Array.prototype.slice.call(arguments);\n    var msg = args.map(function(a) {\n      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));\n    }).join(' ');\n    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {\n      send(\n        msg, '', undefined, undefined, undefined, 'console.error', undefined,\n        { category: 'compile', resourceKind: 'module', blockWhenRootEmpty: true }\n      );\n    }\n    return nativeConsoleError.apply(console, args);\n  };\n\n  function sendStable(rootHealth) {\n    var images = Array.prototype.slice.call(document.querySelectorAll('img'));\n    var controls = Array.prototype.slice.call(\n      document.querySelectorAll('button, a[href], input, select, textarea')\n    );\n    var checks = {\n      viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,\n      horizontalOverflow:\n        document.documentElement.scrollWidth >\n        (document.documentElement.clientWidth || window.innerWidth || 0) + 2,\n      brokenImages: images.filter(function(img) {\n        return img.complete && img.naturalWidth === 0;\n      }).length,\n      missingImageAlt: images.filter(function(img) {\n        return !img.hasAttribute('alt');\n      }).length,\n      unlabeledControls: controls.filter(function(control) {\n        var label = (\n          control.getAttribute('aria-label') ||\n          control.getAttribute('title') ||\n          control.textContent ||\n          control.value ||\n          ''\n        ).trim();\n        return !label;\n      }).length\n    };\n    var diagnostics = [];\n\n    if (checks.horizontalOverflow) {\n      diagnostics.push({\n        code: 'horizontal-overflow',\n        classification: 'diagnostic',\n        category: 'layout',\n        severity: 'advisory',\n        resourceKind: 'quality',\n        renderBlocking: false,\n        message: 'The preview has horizontal overflow.'\n      });\n    }\n    if (checks.brokenImages > 0) {\n      diagnostics.push({\n        code: 'broken-images',\n        classification: 'diagnostic',\n        category: 'asset',\n        severity: 'advisory',\n        resourceKind: 'image',\n        renderBlocking: false,\n        message: 'One or more images could not be displayed.',\n        count: checks.brokenImages\n      });\n    }\n    if (checks.missingImageAlt > 0) {\n      diagnostics.push({\n        code: 'missing-image-alt',\n        classification: 'diagnostic',\n        category: 'accessibility',\n        severity: 'advisory',\n        resourceKind: 'image',\n        renderBlocking: false,\n        message: 'One or more images are missing alternative text.',\n        count: checks.missingImageAlt\n      });\n    }\n    if (checks.unlabeledControls > 0) {\n      diagnostics.push({\n        code: 'unlabeled-controls',\n        classification: 'diagnostic',\n        category: 'accessibility',\n        severity: 'advisory',\n        resourceKind: 'control',\n        renderBlocking: false,\n        message: 'One or more controls do not have an accessible label.',\n        count: checks.unlabeledControls\n      });\n    }\n\n    window.parent.postMessage({\n      source: 'adaptar-preview',\n      type: 'preview-stable',\n      operationId: operationId,\n      stableAt: Date.now(),\n      hasRootContent: rootHealth.hasRootContent,\n      rootHealth: rootHealth,\n      checks: checks,\n      diagnostics: diagnostics\n    }, '*');\n  }\n\n  function confirmPreviewHealth() {\n    var rootHealth = readRootHealth();\n    if (rootHealth.hasRootContent) {\n      if (blankCheckTimer) {\n        clearTimeout(blankCheckTimer);\n        blankCheckTimer = undefined;\n      }\n      blankCheckStartedAt = 0;\n      blankFailureReported = false;\n      recoverBlockingErrorsIfRendered('root-recovered');\n      sendStable(rootHealth);\n      return;\n    }\n\n    if (!blankCheckStartedAt) blankCheckStartedAt = Date.now();\n    if (Date.now() - blankCheckStartedAt >= BLANK_CONFIRMATION_MS) {\n      if (!blankFailureReported) {\n        blankFailureReported = true;\n        send(\n          'Runtime error: Preview failed to render; a component or import may have failed silently.',\n          '', location.href, undefined, undefined, 'blank-screen', undefined,\n          { category: 'render', resourceKind: 'document', renderBlocking: true }\n        );\n      }\n      blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);\n      return;\n    }\n\n    blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);\n  }\n\n  // A blank root is blocking only when it remains blank across a sustained\n  // observation window. Normal React mounting and Vite reloads are transient.\n  window.addEventListener('load', function() {\n    blankCheckStartedAt = Date.now();\n    requestAnimationFrame(function() {\n      requestAnimationFrame(function() {\n        sendRendered(false);\n      });\n    });\n\n    setTimeout(confirmPreviewHealth, 3000);\n  });\n\n  window.setInterval(function() {\n    sendRendered(true);\n  }, 20000);\n  window.setInterval(function() {\n    recoverBlockingErrorsIfRendered('root-health-monitor');\n  }, 1000);\n})();";

package/dist/scripts/error-bridge.js

@@ -3,6 +3,12 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
   window.__ADAPTAR_ERROR_BRIDGE__ = true;
 
   var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  var activeBlockingSources = Object.create(null);
+  var blankCheckStartedAt = 0;
+  var blankCheckTimer;
+  var blankFailureReported = false;
+  var BLANK_CONFIRMATION_MS = 8000;
+  var ROOT_CHECK_INTERVAL_MS = 500;
 
   function readRootHealth() {
     var root = document.getElementById('root');
@@ -88,6 +94,11 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
       var renderBlocking = details.renderBlocking === true || (
         details.blockWhenRootEmpty === true && !rootHealth.hasRootContent
       );
+      var errorSource = source || 'unknown';
+
+      if (renderBlocking) {
+        activeBlockingSources[errorSource] = true;
+      }
 
       window.parent.postMessage({
         source: 'adaptar-preview',
@@ -112,6 +123,26 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
     } catch (_) {}
   }
 
+  function recoverBlockingErrorsIfRendered(reason) {
+    try {
+      var rootHealth = readRootHealth();
+      var resolvedSources = Object.keys(activeBlockingSources);
+      if (!rootHealth.hasRootContent || resolvedSources.length === 0) return;
+
+      activeBlockingSources = Object.create(null);
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: 'preview-recovered',
+        operationId: operationId,
+        recoveredAt: Date.now(),
+        reason: reason || 'root-healthy',
+        resolvedSources: resolvedSources,
+        hasRootContent: true,
+        rootHealth: rootHealth
+      }, '*');
+    } catch (_) {}
+  }
+
   // Resource failures remain observable, but only a module required before
   // the application mounts can be classified as render-blocking. Images,
   // fonts, media, and stylesheets are quality diagnostics.
@@ -176,113 +207,143 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
     return nativeConsoleError.apply(console, args);
   };
 
-  // Blank root is a deterministic rendering failure. Quality checks are sent
-  // separately as advisory diagnostics once a root is healthy.
-  window.addEventListener('load', function() {
-    requestAnimationFrame(function() {
-      requestAnimationFrame(function() {
-        sendRendered(false);
+  function sendStable(rootHealth) {
+    var images = Array.prototype.slice.call(document.querySelectorAll('img'));
+    var controls = Array.prototype.slice.call(
+      document.querySelectorAll('button, a[href], input, select, textarea')
+    );
+    var checks = {
+      viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,
+      horizontalOverflow:
+        document.documentElement.scrollWidth >
+        (document.documentElement.clientWidth || window.innerWidth || 0) + 2,
+      brokenImages: images.filter(function(img) {
+        return img.complete && img.naturalWidth === 0;
+      }).length,
+      missingImageAlt: images.filter(function(img) {
+        return !img.hasAttribute('alt');
+      }).length,
+      unlabeledControls: controls.filter(function(control) {
+        var label = (
+          control.getAttribute('aria-label') ||
+          control.getAttribute('title') ||
+          control.textContent ||
+          control.value ||
+          ''
+        ).trim();
+        return !label;
+      }).length
+    };
+    var diagnostics = [];
+
+    if (checks.horizontalOverflow) {
+      diagnostics.push({
+        code: 'horizontal-overflow',
+        classification: 'diagnostic',
+        category: 'layout',
+        severity: 'advisory',
+        resourceKind: 'quality',
+        renderBlocking: false,
+        message: 'The preview has horizontal overflow.'
       });
-    });
+    }
+    if (checks.brokenImages > 0) {
+      diagnostics.push({
+        code: 'broken-images',
+        classification: 'diagnostic',
+        category: 'asset',
+        severity: 'advisory',
+        resourceKind: 'image',
+        renderBlocking: false,
+        message: 'One or more images could not be displayed.',
+        count: checks.brokenImages
+      });
+    }
+    if (checks.missingImageAlt > 0) {
+      diagnostics.push({
+        code: 'missing-image-alt',
+        classification: 'diagnostic',
+        category: 'accessibility',
+        severity: 'advisory',
+        resourceKind: 'image',
+        renderBlocking: false,
+        message: 'One or more images are missing alternative text.',
+        count: checks.missingImageAlt
+      });
+    }
+    if (checks.unlabeledControls > 0) {
+      diagnostics.push({
+        code: 'unlabeled-controls',
+        classification: 'diagnostic',
+        category: 'accessibility',
+        severity: 'advisory',
+        resourceKind: 'control',
+        renderBlocking: false,
+        message: 'One or more controls do not have an accessible label.',
+        count: checks.unlabeledControls
+      });
+    }
 
-    setTimeout(function() {
-      var rootHealth = readRootHealth();
-      if (!rootHealth.hasRootContent) {
+    window.parent.postMessage({
+      source: 'adaptar-preview',
+      type: 'preview-stable',
+      operationId: operationId,
+      stableAt: Date.now(),
+      hasRootContent: rootHealth.hasRootContent,
+      rootHealth: rootHealth,
+      checks: checks,
+      diagnostics: diagnostics
+    }, '*');
+  }
+
+  function confirmPreviewHealth() {
+    var rootHealth = readRootHealth();
+    if (rootHealth.hasRootContent) {
+      if (blankCheckTimer) {
+        clearTimeout(blankCheckTimer);
+        blankCheckTimer = undefined;
+      }
+      blankCheckStartedAt = 0;
+      blankFailureReported = false;
+      recoverBlockingErrorsIfRendered('root-recovered');
+      sendStable(rootHealth);
+      return;
+    }
+
+    if (!blankCheckStartedAt) blankCheckStartedAt = Date.now();
+    if (Date.now() - blankCheckStartedAt >= BLANK_CONFIRMATION_MS) {
+      if (!blankFailureReported) {
+        blankFailureReported = true;
         send(
           'Runtime error: Preview failed to render; a component or import may have failed silently.',
           '', location.href, undefined, undefined, 'blank-screen', undefined,
           { category: 'render', resourceKind: 'document', renderBlocking: true }
         );
-      } else {
-        var images = Array.prototype.slice.call(document.querySelectorAll('img'));
-        var controls = Array.prototype.slice.call(
-          document.querySelectorAll('button, a[href], input, select, textarea')
-        );
-        var checks = {
-          viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,
-          horizontalOverflow:
-            document.documentElement.scrollWidth >
-            (document.documentElement.clientWidth || window.innerWidth || 0) + 2,
-          brokenImages: images.filter(function(img) {
-            return img.complete && img.naturalWidth === 0;
-          }).length,
-          missingImageAlt: images.filter(function(img) {
-            return !img.hasAttribute('alt');
-          }).length,
-          unlabeledControls: controls.filter(function(control) {
-            var label = (
-              control.getAttribute('aria-label') ||
-              control.getAttribute('title') ||
-              control.textContent ||
-              control.value ||
-              ''
-            ).trim();
-            return !label;
-          }).length
-        };
-        var diagnostics = [];
+      }
+      blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);
+      return;
+    }
 
-        if (checks.horizontalOverflow) {
-          diagnostics.push({
-            code: 'horizontal-overflow',
-            classification: 'diagnostic',
-            category: 'layout',
-            severity: 'advisory',
-            resourceKind: 'quality',
-            renderBlocking: false,
-            message: 'The preview has horizontal overflow.'
-          });
-        }
-        if (checks.brokenImages > 0) {
-          diagnostics.push({
-            code: 'broken-images',
-            classification: 'diagnostic',
-            category: 'asset',
-            severity: 'advisory',
-            resourceKind: 'image',
-            renderBlocking: false,
-            message: 'One or more images could not be displayed.',
-            count: checks.brokenImages
-          });
-        }
-        if (checks.missingImageAlt > 0) {
-          diagnostics.push({
-            code: 'missing-image-alt',
-            classification: 'diagnostic',
-            category: 'accessibility',
-            severity: 'advisory',
-            resourceKind: 'image',
-            renderBlocking: false,
-            message: 'One or more images are missing alternative text.',
-            count: checks.missingImageAlt
-          });
-        }
-        if (checks.unlabeledControls > 0) {
-          diagnostics.push({
-            code: 'unlabeled-controls',
-            classification: 'diagnostic',
-            category: 'accessibility',
-            severity: 'advisory',
-            resourceKind: 'control',
-            renderBlocking: false,
-            message: 'One or more controls do not have an accessible label.',
-            count: checks.unlabeledControls
-          });
-        }
+    blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);
+  }
 
-        window.parent.postMessage({
-          source: 'adaptar-preview',
-          type: 'preview-stable',
-          operationId: operationId,
-          stableAt: Date.now(),
-          hasRootContent: rootHealth.hasRootContent,
-          rootHealth: rootHealth,
-          checks: checks,
-          diagnostics: diagnostics
-        }, '*');
-      }
-    }, 3000);
+  // A blank root is blocking only when it remains blank across a sustained
+  // observation window. Normal React mounting and Vite reloads are transient.
+  window.addEventListener('load', function() {
+    blankCheckStartedAt = Date.now();
+    requestAnimationFrame(function() {
+      requestAnimationFrame(function() {
+        sendRendered(false);
+      });
+    });
+
+    setTimeout(confirmPreviewHealth, 3000);
   });
 
-  window.setInterval(function() { sendRendered(true); }, 20000);
+  window.setInterval(function() {
+    sendRendered(true);
+  }, 20000);
+  window.setInterval(function() {
+    recoverBlockingErrorsIfRendered('root-health-monitor');
+  }, 1000);
 })();`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adaptar-vite-plugin",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Vite plugin for Adaptar preview error and selection bridging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/html-tags.ts

@@ -8,6 +8,7 @@ import { SELECTION_BRIDGE_SCRIPT } from "./scripts/selection-bridge.js";
  */
 const HMR_LISTENER_SCRIPT = /* js */ `
   const adaptarOperationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  let adaptarBlockingHmrError = false;
   const readAdaptarRootHealth = () => {
     const root = document.getElementById('root');
     const hasRootContent = Boolean(root && (root.children.length || (root.textContent || '').trim()));
@@ -30,6 +31,9 @@ const HMR_LISTENER_SCRIPT = /* js */ `
 
   if (import.meta.hot) {
     import.meta.hot.on('adaptar:error', (data) => {
+      if (data?.renderBlocking === true) {
+        adaptarBlockingHmrError = true;
+      }
       postToHost('error', {
         error: {
           ...data,
@@ -38,10 +42,21 @@ const HMR_LISTENER_SCRIPT = /* js */ `
       });
     });
     import.meta.hot.on('adaptar:compile-success', (data) => {
+      const rootHealth = readAdaptarRootHealth();
       postToHost('compile-success', {
         ...(data || {}),
-        rootHealth: readAdaptarRootHealth(),
+        rootHealth,
       });
+      if (adaptarBlockingHmrError && rootHealth.hasRootContent) {
+        adaptarBlockingHmrError = false;
+        postToHost('preview-recovered', {
+          recoveredAt: Date.now(),
+          reason: 'hmr-compile-recovered',
+          resolvedSources: ['vite-hmr'],
+          hasRootContent: true,
+          rootHealth,
+        });
+      }
     });
   }
 

package/src/scripts/error-bridge.ts

@@ -3,6 +3,12 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
   window.__ADAPTAR_ERROR_BRIDGE__ = true;
 
   var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  var activeBlockingSources = Object.create(null);
+  var blankCheckStartedAt = 0;
+  var blankCheckTimer;
+  var blankFailureReported = false;
+  var BLANK_CONFIRMATION_MS = 8000;
+  var ROOT_CHECK_INTERVAL_MS = 500;
 
   function readRootHealth() {
     var root = document.getElementById('root');
@@ -88,6 +94,11 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
       var renderBlocking = details.renderBlocking === true || (
         details.blockWhenRootEmpty === true && !rootHealth.hasRootContent
       );
+      var errorSource = source || 'unknown';
+
+      if (renderBlocking) {
+        activeBlockingSources[errorSource] = true;
+      }
 
       window.parent.postMessage({
         source: 'adaptar-preview',
@@ -112,6 +123,26 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
     } catch (_) {}
   }
 
+  function recoverBlockingErrorsIfRendered(reason) {
+    try {
+      var rootHealth = readRootHealth();
+      var resolvedSources = Object.keys(activeBlockingSources);
+      if (!rootHealth.hasRootContent || resolvedSources.length === 0) return;
+
+      activeBlockingSources = Object.create(null);
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: 'preview-recovered',
+        operationId: operationId,
+        recoveredAt: Date.now(),
+        reason: reason || 'root-healthy',
+        resolvedSources: resolvedSources,
+        hasRootContent: true,
+        rootHealth: rootHealth
+      }, '*');
+    } catch (_) {}
+  }
+
   // Resource failures remain observable, but only a module required before
   // the application mounts can be classified as render-blocking. Images,
   // fonts, media, and stylesheets are quality diagnostics.
@@ -176,113 +207,143 @@ export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
     return nativeConsoleError.apply(console, args);
   };
 
-  // Blank root is a deterministic rendering failure. Quality checks are sent
-  // separately as advisory diagnostics once a root is healthy.
-  window.addEventListener('load', function() {
-    requestAnimationFrame(function() {
-      requestAnimationFrame(function() {
-        sendRendered(false);
+  function sendStable(rootHealth) {
+    var images = Array.prototype.slice.call(document.querySelectorAll('img'));
+    var controls = Array.prototype.slice.call(
+      document.querySelectorAll('button, a[href], input, select, textarea')
+    );
+    var checks = {
+      viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,
+      horizontalOverflow:
+        document.documentElement.scrollWidth >
+        (document.documentElement.clientWidth || window.innerWidth || 0) + 2,
+      brokenImages: images.filter(function(img) {
+        return img.complete && img.naturalWidth === 0;
+      }).length,
+      missingImageAlt: images.filter(function(img) {
+        return !img.hasAttribute('alt');
+      }).length,
+      unlabeledControls: controls.filter(function(control) {
+        var label = (
+          control.getAttribute('aria-label') ||
+          control.getAttribute('title') ||
+          control.textContent ||
+          control.value ||
+          ''
+        ).trim();
+        return !label;
+      }).length
+    };
+    var diagnostics = [];
+
+    if (checks.horizontalOverflow) {
+      diagnostics.push({
+        code: 'horizontal-overflow',
+        classification: 'diagnostic',
+        category: 'layout',
+        severity: 'advisory',
+        resourceKind: 'quality',
+        renderBlocking: false,
+        message: 'The preview has horizontal overflow.'
       });
-    });
+    }
+    if (checks.brokenImages > 0) {
+      diagnostics.push({
+        code: 'broken-images',
+        classification: 'diagnostic',
+        category: 'asset',
+        severity: 'advisory',
+        resourceKind: 'image',
+        renderBlocking: false,
+        message: 'One or more images could not be displayed.',
+        count: checks.brokenImages
+      });
+    }
+    if (checks.missingImageAlt > 0) {
+      diagnostics.push({
+        code: 'missing-image-alt',
+        classification: 'diagnostic',
+        category: 'accessibility',
+        severity: 'advisory',
+        resourceKind: 'image',
+        renderBlocking: false,
+        message: 'One or more images are missing alternative text.',
+        count: checks.missingImageAlt
+      });
+    }
+    if (checks.unlabeledControls > 0) {
+      diagnostics.push({
+        code: 'unlabeled-controls',
+        classification: 'diagnostic',
+        category: 'accessibility',
+        severity: 'advisory',
+        resourceKind: 'control',
+        renderBlocking: false,
+        message: 'One or more controls do not have an accessible label.',
+        count: checks.unlabeledControls
+      });
+    }
 
-    setTimeout(function() {
-      var rootHealth = readRootHealth();
-      if (!rootHealth.hasRootContent) {
+    window.parent.postMessage({
+      source: 'adaptar-preview',
+      type: 'preview-stable',
+      operationId: operationId,
+      stableAt: Date.now(),
+      hasRootContent: rootHealth.hasRootContent,
+      rootHealth: rootHealth,
+      checks: checks,
+      diagnostics: diagnostics
+    }, '*');
+  }
+
+  function confirmPreviewHealth() {
+    var rootHealth = readRootHealth();
+    if (rootHealth.hasRootContent) {
+      if (blankCheckTimer) {
+        clearTimeout(blankCheckTimer);
+        blankCheckTimer = undefined;
+      }
+      blankCheckStartedAt = 0;
+      blankFailureReported = false;
+      recoverBlockingErrorsIfRendered('root-recovered');
+      sendStable(rootHealth);
+      return;
+    }
+
+    if (!blankCheckStartedAt) blankCheckStartedAt = Date.now();
+    if (Date.now() - blankCheckStartedAt >= BLANK_CONFIRMATION_MS) {
+      if (!blankFailureReported) {
+        blankFailureReported = true;
         send(
           'Runtime error: Preview failed to render; a component or import may have failed silently.',
           '', location.href, undefined, undefined, 'blank-screen', undefined,
           { category: 'render', resourceKind: 'document', renderBlocking: true }
         );
-      } else {
-        var images = Array.prototype.slice.call(document.querySelectorAll('img'));
-        var controls = Array.prototype.slice.call(
-          document.querySelectorAll('button, a[href], input, select, textarea')
-        );
-        var checks = {
-          viewportWidth: document.documentElement.clientWidth || window.innerWidth || 0,
-          horizontalOverflow:
-            document.documentElement.scrollWidth >
-            (document.documentElement.clientWidth || window.innerWidth || 0) + 2,
-          brokenImages: images.filter(function(img) {
-            return img.complete && img.naturalWidth === 0;
-          }).length,
-          missingImageAlt: images.filter(function(img) {
-            return !img.hasAttribute('alt');
-          }).length,
-          unlabeledControls: controls.filter(function(control) {
-            var label = (
-              control.getAttribute('aria-label') ||
-              control.getAttribute('title') ||
-              control.textContent ||
-              control.value ||
-              ''
-            ).trim();
-            return !label;
-          }).length
-        };
-        var diagnostics = [];
+      }
+      blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);
+      return;
+    }
 
-        if (checks.horizontalOverflow) {
-          diagnostics.push({
-            code: 'horizontal-overflow',
-            classification: 'diagnostic',
-            category: 'layout',
-            severity: 'advisory',
-            resourceKind: 'quality',
-            renderBlocking: false,
-            message: 'The preview has horizontal overflow.'
-          });
-        }
-        if (checks.brokenImages > 0) {
-          diagnostics.push({
-            code: 'broken-images',
-            classification: 'diagnostic',
-            category: 'asset',
-            severity: 'advisory',
-            resourceKind: 'image',
-            renderBlocking: false,
-            message: 'One or more images could not be displayed.',
-            count: checks.brokenImages
-          });
-        }
-        if (checks.missingImageAlt > 0) {
-          diagnostics.push({
-            code: 'missing-image-alt',
-            classification: 'diagnostic',
-            category: 'accessibility',
-            severity: 'advisory',
-            resourceKind: 'image',
-            renderBlocking: false,
-            message: 'One or more images are missing alternative text.',
-            count: checks.missingImageAlt
-          });
-        }
-        if (checks.unlabeledControls > 0) {
-          diagnostics.push({
-            code: 'unlabeled-controls',
-            classification: 'diagnostic',
-            category: 'accessibility',
-            severity: 'advisory',
-            resourceKind: 'control',
-            renderBlocking: false,
-            message: 'One or more controls do not have an accessible label.',
-            count: checks.unlabeledControls
-          });
-        }
+    blankCheckTimer = setTimeout(confirmPreviewHealth, ROOT_CHECK_INTERVAL_MS);
+  }
 
-        window.parent.postMessage({
-          source: 'adaptar-preview',
-          type: 'preview-stable',
-          operationId: operationId,
-          stableAt: Date.now(),
-          hasRootContent: rootHealth.hasRootContent,
-          rootHealth: rootHealth,
-          checks: checks,
-          diagnostics: diagnostics
-        }, '*');
-      }
-    }, 3000);
+  // A blank root is blocking only when it remains blank across a sustained
+  // observation window. Normal React mounting and Vite reloads are transient.
+  window.addEventListener('load', function() {
+    blankCheckStartedAt = Date.now();
+    requestAnimationFrame(function() {
+      requestAnimationFrame(function() {
+        sendRendered(false);
+      });
+    });
+
+    setTimeout(confirmPreviewHealth, 3000);
   });
 
-  window.setInterval(function() { sendRendered(true); }, 20000);
+  window.setInterval(function() {
+    sendRendered(true);
+  }, 20000);
+  window.setInterval(function() {
+    recoverBlockingErrorsIfRendered('root-health-monitor');
+  }, 1000);
 })();`;