adaptar-vite-plugin 1.0.3 → 1.0.5

package/dist/hmr-interceptor.d.ts

@@ -7,6 +7,16 @@ export interface AdaptarErrorPayload {
     colno: number | undefined;
     source: string;
     plugin: string | undefined;
+    classification: "render-blocking" | "diagnostic";
+    category: "compile" | "resource";
+    severity: "error" | "advisory";
+    resourceKind: "module" | "stylesheet" | "image" | "font" | "media" | "unknown";
+    renderBlocking: boolean;
+    rootHealth: {
+        state: "unknown";
+        hasRootContent: undefined;
+        readyState: undefined;
+    };
 }
 /**
  * Intercepts Vite's internal WebSocket `send` to catch build/HMR errors

package/dist/hmr-interceptor.js

@@ -1,3 +1,22 @@
+function classifyViteResource(filename, plugin) {
+    const signal = `${filename ?? ""} ${plugin ?? ""}`.toLowerCase();
+    if (/\.(?:css|less|sass|scss|styl)(?:$|[?#\s])/.test(signal) || /css|postcss|tailwind/.test(signal)) {
+        return "stylesheet";
+    }
+    if (/\.(?:avif|bmp|gif|ico|jpe?g|png|svg|webp)(?:$|[?#\s])/.test(signal)) {
+        return "image";
+    }
+    if (/\.(?:woff2?|ttf|otf|eot)(?:$|[?#\s])/.test(signal)) {
+        return "font";
+    }
+    if (/\.(?:aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)(?:$|[?#\s])/.test(signal)) {
+        return "media";
+    }
+    if (/\.(?:c|m)?(?:j|t)sx?(?:$|[?#\s])/.test(signal) || /react|swc|typescript|vite/.test(signal)) {
+        return "module";
+    }
+    return "unknown";
+}
 // How long (ms) to suppress a full-reload after a fatal error so the
 // error overlay stays visible before the iframe clears it.
 const RELOAD_SUPPRESSION_MS = 5_000;
@@ -22,22 +41,42 @@ export function interceptHmrErrors(server) {
             // ── Fatal build / HMR error ──────────────────────────────────────────
             if (payload.type === "error") {
                 const { err } = payload;
+                const filename = err.id ?? err.loc?.file;
+                const resourceKind = classifyViteResource(filename, err.plugin);
+                // A Vite failure in application/module compilation invalidates the
+                // candidate. Asset and stylesheet failures remain visible diagnostics
+                // because they do not prove that the application cannot render.
+                const renderBlocking = resourceKind === "module" || resourceKind === "unknown";
                 const formatted = {
                     message: `[vite] ${err.message || "Internal server error"}`,
                     stack: [err.stack, err.frame].filter(Boolean).join("\n\n"),
-                    filename: err.id ?? err.loc?.file,
+                    filename,
                     lineno: err.loc?.line,
                     colno: err.loc?.column,
                     source: "vite-hmr",
                     plugin: err.plugin,
+                    classification: renderBlocking ? "render-blocking" : "diagnostic",
+                    category: renderBlocking ? "compile" : "resource",
+                    severity: renderBlocking ? "error" : "advisory",
+                    resourceKind,
+                    renderBlocking,
+                    rootHealth: {
+                        state: "unknown",
+                        hasRootContent: undefined,
+                        readyState: undefined,
+                    },
                 };
                 originalSend({
                     type: "custom",
                     event: "adaptar:error",
                     data: formatted,
                 });
-                // Start suppression window so the follow-up full-reload is blocked.
-                suppressReloadUntil = Date.now() + RELOAD_SUPPRESSION_MS;
+                // Only render-blocking compilation errors should interrupt Vite's
+                // normal reload path. Diagnostic asset/style failures are reported but
+                // are allowed to recover normally.
+                if (renderBlocking) {
+                    suppressReloadUntil = Date.now() + RELOAD_SUPPRESSION_MS;
+                }
                 originalSend(payload);
                 return;
             }
@@ -46,6 +85,18 @@ export function interceptHmrErrors(server) {
                 suppressReloadUntil = 0; // reset — only suppress once
                 return;
             }
+            // A Vite update has been compiled and sent to the preview client. The
+            // injected bridge associates this with the server-owned preview operation
+            // ID carried in the iframe URL.
+            if (payload.type === "update") {
+                originalSend(payload);
+                originalSend({
+                    type: "custom",
+                    event: "adaptar:compile-success",
+                    data: { compiledAt: Date.now() },
+                });
+                return;
+            }
         }
         originalSend(payload);
     };

package/dist/html-tags.js

@@ -4,14 +4,50 @@ import { SELECTION_BRIDGE_SCRIPT } from "./scripts/selection-bridge.js";
  * The inline module that subscribes to the `adaptar:error` custom HMR event
  * and forwards it to the parent window via postMessage.
  */
-const HMR_LISTENER_SCRIPT = /* js */ `
-  if (import.meta.hot) {
-    import.meta.hot.on('adaptar:error', (data) => {
-      try {
-        window.parent.postMessage({ source: 'adaptar-preview', type: 'error', error: data }, '*');
-      } catch (_) {}
-    });
-  }
+const HMR_LISTENER_SCRIPT = /* js */ `
+  const adaptarOperationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  const readAdaptarRootHealth = () => {
+    const root = document.getElementById('root');
+    const hasRootContent = Boolean(root && (root.children.length || (root.textContent || '').trim()));
+    return {
+      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),
+      hasRootContent,
+      readyState: document.readyState,
+    };
+  };
+  const postToHost = (type, data) => {
+    try {
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type,
+        operationId: adaptarOperationId,
+        ...data,
+      }, '*');
+    } catch (_) {}
+  };
+
+  if (import.meta.hot) {
+    import.meta.hot.on('adaptar:error', (data) => {
+      postToHost('error', {
+        error: {
+          ...data,
+          rootHealth: readAdaptarRootHealth(),
+        },
+      });
+    });
+    import.meta.hot.on('adaptar:compile-success', (data) => {
+      postToHost('compile-success', {
+        ...(data || {}),
+        rootHealth: readAdaptarRootHealth(),
+      });
+    });
+  }
+
+  postToHost('compile-success', {
+    compiledAt: Date.now(),
+    initial: true,
+    rootHealth: readAdaptarRootHealth(),
+  });
 `.trim();
 export function buildHtmlTags() {
     return [

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  function send(message, stack, filename, lineno, colno, source, plugin) {\n    try {\n      window.parent.postMessage({\n        source: 'adaptar-preview',\n        type: 'error',\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        }\n      }, '*');\n    } catch (_) {}\n  }\n\n  // Resource load errors (scripts, stylesheets)\n  window.addEventListener('error', function(e) {\n    var target = e.target || e.srcElement;\n    if (target && target !== window && target.tagName) {\n      var tag = String(target.tagName).toLowerCase();\n      var url = target.src || target.href;\n      if (url && (tag === 'script' || tag === 'link')) {\n        send(\n          (tag === 'link' ? 'Failed to load stylesheet: ' : 'Failed to load module: ') + url,\n          '', url, undefined, undefined, 'resource-load'\n        );\n        return;\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'\n    );\n  });\n\n  // Unhandled promise rejections\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'\n    );\n  });\n\n  // Console error interception for silent Vite/Syntax errors\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(msg, '', undefined, undefined, undefined, 'console.error');\n    }\n    return nativeConsoleError.apply(console, args);\n  };\n\n  // Blank screen detector\n  window.addEventListener('load', function() {\n    setTimeout(function() {\n      var root = document.getElementById('root');\n      if (root && root.children.length === 0 && !(root.textContent || '').trim()) {\n        send(\n          'Runtime error: Preview failed to render; a component or import may have failed silently.',\n          '', location.href, undefined, undefined, 'blank-screen'\n        );\n      }\n    }, 3000);\n  });\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\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})();";

package/dist/scripts/error-bridge.js

@@ -1,82 +1,288 @@
-export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
-  if (window.__ADAPTAR_ERROR_BRIDGE__) return;
-  window.__ADAPTAR_ERROR_BRIDGE__ = true;
-
-  function send(message, stack, filename, lineno, colno, source, plugin) {
-    try {
-      window.parent.postMessage({
-        source: 'adaptar-preview',
-        type: 'error',
-        error: {
-          message: message || 'Unknown error',
-          stack: stack || '',
-          filename: filename,
-          lineno: lineno,
-          colno: colno,
-          source: source,
-          plugin: plugin
-        }
-      }, '*');
-    } catch (_) {}
-  }
-
-  // Resource load errors (scripts, stylesheets)
-  window.addEventListener('error', function(e) {
-    var target = e.target || e.srcElement;
-    if (target && target !== window && target.tagName) {
-      var tag = String(target.tagName).toLowerCase();
-      var url = target.src || target.href;
-      if (url && (tag === 'script' || tag === 'link')) {
-        send(
-          (tag === 'link' ? 'Failed to load stylesheet: ' : 'Failed to load module: ') + url,
-          '', url, undefined, undefined, 'resource-load'
-        );
-        return;
-      }
-    }
-    send(
-      e.message || (e.error && e.error.message) || 'Runtime error occurred',
-      e.error ? e.error.stack : '',
-      e.filename, e.lineno, e.colno, 'runtime'
-    );
-  });
-
-  // Unhandled promise rejections
-  window.addEventListener('unhandledrejection', function(e) {
-    var r = e.reason;
-    send(
-      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),
-      r && r.stack,
-      r && r.fileName,
-      r && r.lineNumber,
-      r && r.columnNumber,
-      'unhandledrejection'
-    );
-  });
-
-  // Console error interception for silent Vite/Syntax errors
-  var nativeConsoleError = console.error;
-  console.error = function() {
-    var args = Array.prototype.slice.call(arguments);
-    var msg = args.map(function(a) {
-      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));
-    }).join(' ');
-    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {
-      send(msg, '', undefined, undefined, undefined, 'console.error');
-    }
-    return nativeConsoleError.apply(console, args);
-  };
-
-  // Blank screen detector
-  window.addEventListener('load', function() {
-    setTimeout(function() {
-      var root = document.getElementById('root');
-      if (root && root.children.length === 0 && !(root.textContent || '').trim()) {
-        send(
-          'Runtime error: Preview failed to render; a component or import may have failed silently.',
-          '', location.href, undefined, undefined, 'blank-screen'
-        );
-      }
-    }, 3000);
-  });
+export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
+  if (window.__ADAPTAR_ERROR_BRIDGE__) return;
+  window.__ADAPTAR_ERROR_BRIDGE__ = true;
+
+  var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+
+  function readRootHealth() {
+    var root = document.getElementById('root');
+    var hasRootContent = Boolean(
+      root && (root.children.length || (root.textContent || '').trim())
+    );
+
+    return {
+      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),
+      hasRootContent: hasRootContent,
+      readyState: document.readyState
+    };
+  }
+
+  function sendRendered(heartbeat) {
+    try {
+      var rootHealth = readRootHealth();
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: heartbeat ? 'render-heartbeat' : 'preview-rendered',
+        operationId: operationId,
+        renderedAt: Date.now(),
+        hasRootContent: rootHealth.hasRootContent,
+        rootHealth: rootHealth
+      }, '*');
+    } catch (_) {}
+  }
+
+  function classifyResource(target, url) {
+    var tag = String((target && target.tagName) || '').toLowerCase();
+    var rel = String((target && target.rel) || '').toLowerCase();
+    var as = String((target && target.as) || '').toLowerCase();
+    var type = String((target && target.type) || '').toLowerCase();
+    var value = String(url || '').split(/[?#]/)[0].toLowerCase();
+
+    if (
+      as === 'font' ||
+      type.indexOf('font/') === 0 ||
+      /\\.(woff2?|ttf|otf|eot)$/.test(value)
+    ) return 'font';
+    if (
+      tag === 'img' ||
+      as === 'image' ||
+      /\\.(avif|bmp|gif|ico|jpe?g|png|svg|webp)$/.test(value)
+    ) return 'image';
+    if (
+      tag === 'audio' || tag === 'video' || tag === 'source' || tag === 'track' ||
+      as === 'audio' || as === 'video' ||
+      /\\.(aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)$/.test(value)
+    ) return 'media';
+    if (
+      tag === 'script' ||
+      as === 'script' ||
+      rel === 'modulepreload' ||
+      type === 'module' ||
+      /\\.(c|m)?(j|t)sx?$/.test(value)
+    ) return 'module';
+    if (
+      (tag === 'link' && rel === 'stylesheet') ||
+      as === 'style' ||
+      type === 'text/css' ||
+      /\\.(css|less|sass|scss|styl)$/.test(value)
+    ) return 'stylesheet';
+    return 'unknown';
+  }
+
+  function resourceFailureMessage(resourceKind, url) {
+    var labels = {
+      font: 'Failed to load font: ',
+      image: 'Failed to load image: ',
+      media: 'Failed to load media: ',
+      module: 'Failed to load module: ',
+      stylesheet: 'Failed to load stylesheet: ',
+      unknown: 'Failed to load resource: '
+    };
+    return (labels[resourceKind] || labels.unknown) + url;
+  }
+
+  function send(message, stack, filename, lineno, colno, source, plugin, metadata) {
+    try {
+      var details = metadata || {};
+      var rootHealth = readRootHealth();
+      var renderBlocking = details.renderBlocking === true || (
+        details.blockWhenRootEmpty === true && !rootHealth.hasRootContent
+      );
+
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: 'error',
+        operationId: operationId,
+        error: {
+          message: message || 'Unknown error',
+          stack: stack || '',
+          filename: filename,
+          lineno: lineno,
+          colno: colno,
+          source: source,
+          plugin: plugin,
+          classification: renderBlocking ? 'render-blocking' : 'diagnostic',
+          category: details.category || 'runtime',
+          severity: renderBlocking ? 'error' : 'advisory',
+          resourceKind: details.resourceKind || 'unknown',
+          renderBlocking: renderBlocking,
+          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.
+  window.addEventListener('error', function(e) {
+    var target = e.target || e.srcElement;
+    if (target && target !== window && target.tagName) {
+      var url = target.src || target.href || target.currentSrc;
+      var resourceKind = classifyResource(target, url);
+      if (url || resourceKind !== 'unknown') {
+        send(
+          resourceFailureMessage(resourceKind, url || '(unknown resource URL)'),
+          '', url, undefined, undefined, 'resource-load', undefined,
+          {
+            category: 'resource',
+            resourceKind: resourceKind,
+            blockWhenRootEmpty: resourceKind === 'module'
+          }
+        );
+        return;
+      }
+    }
+
+    send(
+      e.message || (e.error && e.error.message) || 'Runtime error occurred',
+      e.error ? e.error.stack : '',
+      e.filename, e.lineno, e.colno, 'runtime', undefined,
+      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }
+    );
+  }, true);
+
+  // An async failure is blocking only when the application has no rendered
+  // root. Interaction failures in an otherwise-rendered page remain visible
+  // diagnostics and never invalidate the candidate by themselves.
+  window.addEventListener('unhandledrejection', function(e) {
+    var r = e.reason;
+    send(
+      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),
+      r && r.stack,
+      r && r.fileName,
+      r && r.lineNumber,
+      r && r.columnNumber,
+      'unhandledrejection', undefined,
+      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }
+    );
+  });
+
+  // Intercept only errors that indicate a Vite/module compilation failure.
+  // Their render-blocking status is still tied to an empty application root;
+  // Vite HMR compile failures are classified separately by the server bridge.
+  var nativeConsoleError = console.error;
+  console.error = function() {
+    var args = Array.prototype.slice.call(arguments);
+    var msg = args.map(function(a) {
+      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));
+    }).join(' ');
+    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {
+      send(
+        msg, '', undefined, undefined, undefined, 'console.error', undefined,
+        { category: 'compile', resourceKind: 'module', blockWhenRootEmpty: true }
+      );
+    }
+    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);
+      });
+    });
+
+    setTimeout(function() {
+      var rootHealth = readRootHealth();
+      if (!rootHealth.hasRootContent) {
+        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 = [];
+
+        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
+          });
+        }
+
+        window.parent.postMessage({
+          source: 'adaptar-preview',
+          type: 'preview-stable',
+          operationId: operationId,
+          stableAt: Date.now(),
+          hasRootContent: rootHealth.hasRootContent,
+          rootHealth: rootHealth,
+          checks: checks,
+          diagnostics: diagnostics
+        }, '*');
+      }
+    }, 3000);
+  });
+
+  window.setInterval(function() { sendRendered(true); }, 20000);
 })();`;

package/package.json

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

package/src/hmr-interceptor.ts

@@ -1,14 +1,54 @@
 import type { ViteDevServer, HMRPayload } from "vite";
 
-export interface AdaptarErrorPayload {
-  message: string;
-  stack: string;
-  filename: string | undefined;
-  lineno: number | undefined;
-  colno: number | undefined;
-  source: string;
-  plugin: string | undefined;
-}
+export interface AdaptarErrorPayload {
+  message: string;
+  stack: string;
+  filename: string | undefined;
+  lineno: number | undefined;
+  colno: number | undefined;
+  source: string;
+  plugin: string | undefined;
+  classification: "render-blocking" | "diagnostic";
+  category: "compile" | "resource";
+  severity: "error" | "advisory";
+  resourceKind:
+    | "module"
+    | "stylesheet"
+    | "image"
+    | "font"
+    | "media"
+    | "unknown";
+  renderBlocking: boolean;
+  rootHealth: {
+    state: "unknown";
+    hasRootContent: undefined;
+    readyState: undefined;
+  };
+}
+
+function classifyViteResource(
+  filename: string | undefined,
+  plugin: string | undefined,
+): AdaptarErrorPayload["resourceKind"] {
+  const signal = `${filename ?? ""} ${plugin ?? ""}`.toLowerCase();
+
+  if (/\.(?:css|less|sass|scss|styl)(?:$|[?#\s])/.test(signal) || /css|postcss|tailwind/.test(signal)) {
+    return "stylesheet";
+  }
+  if (/\.(?:avif|bmp|gif|ico|jpe?g|png|svg|webp)(?:$|[?#\s])/.test(signal)) {
+    return "image";
+  }
+  if (/\.(?:woff2?|ttf|otf|eot)(?:$|[?#\s])/.test(signal)) {
+    return "font";
+  }
+  if (/\.(?:aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)(?:$|[?#\s])/.test(signal)) {
+    return "media";
+  }
+  if (/\.(?:c|m)?(?:j|t)sx?(?:$|[?#\s])/.test(signal) || /react|swc|typescript|vite/.test(signal)) {
+    return "module";
+  }
+  return "unknown";
+}
 
 // How long (ms) to suppress a full-reload after a fatal error so the
 // error overlay stays visible before the iframe clears it.
@@ -35,18 +75,34 @@ export function interceptHmrErrors(server: ViteDevServer): void {
   (server.ws as any).send = function (payload: HMRPayload): void {
     if (payload && typeof payload === "object") {
       // ── Fatal build / HMR error ──────────────────────────────────────────
-      if (payload.type === "error") {
-        const { err } = payload;
-
-        const formatted: AdaptarErrorPayload = {
-          message: `[vite] ${err.message || "Internal server error"}`,
-          stack: [err.stack, err.frame].filter(Boolean).join("\n\n"),
-          filename: err.id ?? err.loc?.file,
-          lineno: err.loc?.line,
-          colno: err.loc?.column,
-          source: "vite-hmr",
-          plugin: err.plugin,
-        };
+      if (payload.type === "error") {
+        const { err } = payload;
+        const filename = err.id ?? err.loc?.file;
+        const resourceKind = classifyViteResource(filename, err.plugin);
+        // A Vite failure in application/module compilation invalidates the
+        // candidate. Asset and stylesheet failures remain visible diagnostics
+        // because they do not prove that the application cannot render.
+        const renderBlocking = resourceKind === "module" || resourceKind === "unknown";
+
+        const formatted: AdaptarErrorPayload = {
+          message: `[vite] ${err.message || "Internal server error"}`,
+          stack: [err.stack, err.frame].filter(Boolean).join("\n\n"),
+          filename,
+          lineno: err.loc?.line,
+          colno: err.loc?.column,
+          source: "vite-hmr",
+          plugin: err.plugin,
+          classification: renderBlocking ? "render-blocking" : "diagnostic",
+          category: renderBlocking ? "compile" : "resource",
+          severity: renderBlocking ? "error" : "advisory",
+          resourceKind,
+          renderBlocking,
+          rootHealth: {
+            state: "unknown",
+            hasRootContent: undefined,
+            readyState: undefined,
+          },
+        };
 
         originalSend({
           type: "custom",
@@ -54,18 +110,35 @@ export function interceptHmrErrors(server: ViteDevServer): void {
           data: formatted,
         });
 
-        // Start suppression window so the follow-up full-reload is blocked.
-        suppressReloadUntil = Date.now() + RELOAD_SUPPRESSION_MS;
+        // Only render-blocking compilation errors should interrupt Vite's
+        // normal reload path. Diagnostic asset/style failures are reported but
+        // are allowed to recover normally.
+        if (renderBlocking) {
+          suppressReloadUntil = Date.now() + RELOAD_SUPPRESSION_MS;
+        }
         originalSend(payload);
         return;
       }
 
       // ── Suppress full-reload that follows a fatal error ──────────────────
-      if (payload.type === "full-reload" && Date.now() < suppressReloadUntil) {
+      if (payload.type === "full-reload" && Date.now() < suppressReloadUntil) {
         suppressReloadUntil = 0; // reset — only suppress once
         return;
-      }
-    }
+      }
+
+      // A Vite update has been compiled and sent to the preview client. The
+      // injected bridge associates this with the server-owned preview operation
+      // ID carried in the iframe URL.
+      if (payload.type === "update") {
+        originalSend(payload);
+        originalSend({
+          type: "custom",
+          event: "adaptar:compile-success",
+          data: { compiledAt: Date.now() },
+        });
+        return;
+      }
+    }
 
     originalSend(payload);
   };

package/src/html-tags.ts

@@ -6,15 +6,51 @@ import { SELECTION_BRIDGE_SCRIPT } from "./scripts/selection-bridge.js";
  * The inline module that subscribes to the `adaptar:error` custom HMR event
  * and forwards it to the parent window via postMessage.
  */
-const HMR_LISTENER_SCRIPT = /* js */ `
-  if (import.meta.hot) {
-    import.meta.hot.on('adaptar:error', (data) => {
-      try {
-        window.parent.postMessage({ source: 'adaptar-preview', type: 'error', error: data }, '*');
-      } catch (_) {}
-    });
-  }
-`.trim();
+const HMR_LISTENER_SCRIPT = /* js */ `
+  const adaptarOperationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+  const readAdaptarRootHealth = () => {
+    const root = document.getElementById('root');
+    const hasRootContent = Boolean(root && (root.children.length || (root.textContent || '').trim()));
+    return {
+      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),
+      hasRootContent,
+      readyState: document.readyState,
+    };
+  };
+  const postToHost = (type, data) => {
+    try {
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type,
+        operationId: adaptarOperationId,
+        ...data,
+      }, '*');
+    } catch (_) {}
+  };
+
+  if (import.meta.hot) {
+    import.meta.hot.on('adaptar:error', (data) => {
+      postToHost('error', {
+        error: {
+          ...data,
+          rootHealth: readAdaptarRootHealth(),
+        },
+      });
+    });
+    import.meta.hot.on('adaptar:compile-success', (data) => {
+      postToHost('compile-success', {
+        ...(data || {}),
+        rootHealth: readAdaptarRootHealth(),
+      });
+    });
+  }
+
+  postToHost('compile-success', {
+    compiledAt: Date.now(),
+    initial: true,
+    rootHealth: readAdaptarRootHealth(),
+  });
+`.trim();
 
 export function buildHtmlTags(): HtmlTagDescriptor[] {
   return [

package/src/scripts/error-bridge.ts

@@ -1,82 +1,288 @@
-export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
-  if (window.__ADAPTAR_ERROR_BRIDGE__) return;
-  window.__ADAPTAR_ERROR_BRIDGE__ = true;
-
-  function send(message, stack, filename, lineno, colno, source, plugin) {
-    try {
-      window.parent.postMessage({
-        source: 'adaptar-preview',
-        type: 'error',
-        error: {
-          message: message || 'Unknown error',
-          stack: stack || '',
-          filename: filename,
-          lineno: lineno,
-          colno: colno,
-          source: source,
-          plugin: plugin
-        }
-      }, '*');
-    } catch (_) {}
-  }
-
-  // Resource load errors (scripts, stylesheets)
-  window.addEventListener('error', function(e) {
-    var target = e.target || e.srcElement;
-    if (target && target !== window && target.tagName) {
-      var tag = String(target.tagName).toLowerCase();
-      var url = target.src || target.href;
-      if (url && (tag === 'script' || tag === 'link')) {
-        send(
-          (tag === 'link' ? 'Failed to load stylesheet: ' : 'Failed to load module: ') + url,
-          '', url, undefined, undefined, 'resource-load'
-        );
-        return;
-      }
-    }
-    send(
-      e.message || (e.error && e.error.message) || 'Runtime error occurred',
-      e.error ? e.error.stack : '',
-      e.filename, e.lineno, e.colno, 'runtime'
-    );
-  });
-
-  // Unhandled promise rejections
-  window.addEventListener('unhandledrejection', function(e) {
-    var r = e.reason;
-    send(
-      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),
-      r && r.stack,
-      r && r.fileName,
-      r && r.lineNumber,
-      r && r.columnNumber,
-      'unhandledrejection'
-    );
-  });
-
-  // Console error interception for silent Vite/Syntax errors
-  var nativeConsoleError = console.error;
-  console.error = function() {
-    var args = Array.prototype.slice.call(arguments);
-    var msg = args.map(function(a) {
-      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));
-    }).join(' ');
-    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {
-      send(msg, '', undefined, undefined, undefined, 'console.error');
-    }
-    return nativeConsoleError.apply(console, args);
-  };
-
-  // Blank screen detector
-  window.addEventListener('load', function() {
-    setTimeout(function() {
-      var root = document.getElementById('root');
-      if (root && root.children.length === 0 && !(root.textContent || '').trim()) {
-        send(
-          'Runtime error: Preview failed to render; a component or import may have failed silently.',
-          '', location.href, undefined, undefined, 'blank-screen'
-        );
-      }
-    }, 3000);
-  });
-})();`;
+export const ERROR_BRIDGE_SCRIPT = /* js */ `(function(){
+  if (window.__ADAPTAR_ERROR_BRIDGE__) return;
+  window.__ADAPTAR_ERROR_BRIDGE__ = true;
+
+  var operationId = new URL(window.location.href).searchParams.get('__adaptarOperation') || undefined;
+
+  function readRootHealth() {
+    var root = document.getElementById('root');
+    var hasRootContent = Boolean(
+      root && (root.children.length || (root.textContent || '').trim())
+    );
+
+    return {
+      state: !root ? 'missing' : (hasRootContent ? 'healthy' : 'empty'),
+      hasRootContent: hasRootContent,
+      readyState: document.readyState
+    };
+  }
+
+  function sendRendered(heartbeat) {
+    try {
+      var rootHealth = readRootHealth();
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: heartbeat ? 'render-heartbeat' : 'preview-rendered',
+        operationId: operationId,
+        renderedAt: Date.now(),
+        hasRootContent: rootHealth.hasRootContent,
+        rootHealth: rootHealth
+      }, '*');
+    } catch (_) {}
+  }
+
+  function classifyResource(target, url) {
+    var tag = String((target && target.tagName) || '').toLowerCase();
+    var rel = String((target && target.rel) || '').toLowerCase();
+    var as = String((target && target.as) || '').toLowerCase();
+    var type = String((target && target.type) || '').toLowerCase();
+    var value = String(url || '').split(/[?#]/)[0].toLowerCase();
+
+    if (
+      as === 'font' ||
+      type.indexOf('font/') === 0 ||
+      /\\.(woff2?|ttf|otf|eot)$/.test(value)
+    ) return 'font';
+    if (
+      tag === 'img' ||
+      as === 'image' ||
+      /\\.(avif|bmp|gif|ico|jpe?g|png|svg|webp)$/.test(value)
+    ) return 'image';
+    if (
+      tag === 'audio' || tag === 'video' || tag === 'source' || tag === 'track' ||
+      as === 'audio' || as === 'video' ||
+      /\\.(aac|flac|m4a|m4v|mov|mp3|mp4|ogg|ogv|wav|webm|vtt)$/.test(value)
+    ) return 'media';
+    if (
+      tag === 'script' ||
+      as === 'script' ||
+      rel === 'modulepreload' ||
+      type === 'module' ||
+      /\\.(c|m)?(j|t)sx?$/.test(value)
+    ) return 'module';
+    if (
+      (tag === 'link' && rel === 'stylesheet') ||
+      as === 'style' ||
+      type === 'text/css' ||
+      /\\.(css|less|sass|scss|styl)$/.test(value)
+    ) return 'stylesheet';
+    return 'unknown';
+  }
+
+  function resourceFailureMessage(resourceKind, url) {
+    var labels = {
+      font: 'Failed to load font: ',
+      image: 'Failed to load image: ',
+      media: 'Failed to load media: ',
+      module: 'Failed to load module: ',
+      stylesheet: 'Failed to load stylesheet: ',
+      unknown: 'Failed to load resource: '
+    };
+    return (labels[resourceKind] || labels.unknown) + url;
+  }
+
+  function send(message, stack, filename, lineno, colno, source, plugin, metadata) {
+    try {
+      var details = metadata || {};
+      var rootHealth = readRootHealth();
+      var renderBlocking = details.renderBlocking === true || (
+        details.blockWhenRootEmpty === true && !rootHealth.hasRootContent
+      );
+
+      window.parent.postMessage({
+        source: 'adaptar-preview',
+        type: 'error',
+        operationId: operationId,
+        error: {
+          message: message || 'Unknown error',
+          stack: stack || '',
+          filename: filename,
+          lineno: lineno,
+          colno: colno,
+          source: source,
+          plugin: plugin,
+          classification: renderBlocking ? 'render-blocking' : 'diagnostic',
+          category: details.category || 'runtime',
+          severity: renderBlocking ? 'error' : 'advisory',
+          resourceKind: details.resourceKind || 'unknown',
+          renderBlocking: renderBlocking,
+          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.
+  window.addEventListener('error', function(e) {
+    var target = e.target || e.srcElement;
+    if (target && target !== window && target.tagName) {
+      var url = target.src || target.href || target.currentSrc;
+      var resourceKind = classifyResource(target, url);
+      if (url || resourceKind !== 'unknown') {
+        send(
+          resourceFailureMessage(resourceKind, url || '(unknown resource URL)'),
+          '', url, undefined, undefined, 'resource-load', undefined,
+          {
+            category: 'resource',
+            resourceKind: resourceKind,
+            blockWhenRootEmpty: resourceKind === 'module'
+          }
+        );
+        return;
+      }
+    }
+
+    send(
+      e.message || (e.error && e.error.message) || 'Runtime error occurred',
+      e.error ? e.error.stack : '',
+      e.filename, e.lineno, e.colno, 'runtime', undefined,
+      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }
+    );
+  }, true);
+
+  // An async failure is blocking only when the application has no rendered
+  // root. Interaction failures in an otherwise-rendered page remain visible
+  // diagnostics and never invalidate the candidate by themselves.
+  window.addEventListener('unhandledrejection', function(e) {
+    var r = e.reason;
+    send(
+      r && r.message ? r.message : String(r || 'Unhandled Promise Rejection'),
+      r && r.stack,
+      r && r.fileName,
+      r && r.lineNumber,
+      r && r.columnNumber,
+      'unhandledrejection', undefined,
+      { category: 'runtime', resourceKind: 'module', blockWhenRootEmpty: true }
+    );
+  });
+
+  // Intercept only errors that indicate a Vite/module compilation failure.
+  // Their render-blocking status is still tied to an empty application root;
+  // Vite HMR compile failures are classified separately by the server bridge.
+  var nativeConsoleError = console.error;
+  console.error = function() {
+    var args = Array.prototype.slice.call(arguments);
+    var msg = args.map(function(a) {
+      return typeof a === 'string' ? a : (a && a.message ? a.message : String(a));
+    }).join(' ');
+    if (/Failed to load module|Internal Server Error|Syntax Error/i.test(msg)) {
+      send(
+        msg, '', undefined, undefined, undefined, 'console.error', undefined,
+        { category: 'compile', resourceKind: 'module', blockWhenRootEmpty: true }
+      );
+    }
+    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);
+      });
+    });
+
+    setTimeout(function() {
+      var rootHealth = readRootHealth();
+      if (!rootHealth.hasRootContent) {
+        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 = [];
+
+        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
+          });
+        }
+
+        window.parent.postMessage({
+          source: 'adaptar-preview',
+          type: 'preview-stable',
+          operationId: operationId,
+          stableAt: Date.now(),
+          hasRootContent: rootHealth.hasRootContent,
+          rootHealth: rootHealth,
+          checks: checks,
+          diagnostics: diagnostics
+        }, '*');
+      }
+    }, 3000);
+  });
+
+  window.setInterval(function() { sendRendered(true); }, 20000);
+})();`;