@qontinui/ui-bridge-native 0.7.0 → 0.7.1

package/dist/server/index.mjs

@@ -1264,7 +1264,7 @@ var NATIVE_PAGE_HEALTH_PRODUCER_ID = "sdk-native/page-health";
 function defaultProducer() {
   return {
     id: NATIVE_PAGE_HEALTH_PRODUCER_ID,
-    version: "0.7.0" 
+    version: "0.7.1" 
   };
 }
 function pageHealthUnknown(code, detail, options = {}) {
@@ -1306,14 +1306,7 @@ var LOADING_PHRASES = [
   "initializing",
   "fetching"
 ];
-var EMPTY_PHRASES = [
-  "no data",
-  "no results",
-  "nothing here",
-  "empty",
-  "no items",
-  "get started"
-];
+var EMPTY_PHRASES = ["no data", "no results", "nothing here", "empty", "no items", "get started"];
 function severityRank(s) {
   if (s === "CRITICAL") return 3;
   if (s === "WARNING") return 2;
@@ -1388,20 +1381,44 @@ function observe(input, producer, evaluatedAt) {
   }
   return analyze(elements, viewport, base);
 }
+function nothingOnScreenDetail(elements, visibleCount, visibilityUnstated) {
+  if (visibilityUnstated === 0 && visibleCount > 0) {
+    return `all ${visibleCount} visible element(s) have no measured layout yet, so spatial coverage, layout regions and visual anomalies cannot be measured`;
+  }
+  if (visibilityUnstated > 0) {
+    const geometry = visibleCount > 0 ? ` and none of the ${visibleCount} visible one(s) has a measured layout` : "";
+    return `${visibilityUnstated} of ${elements.length} element(s) carry no boolean \`state.visible\`${geometry}, so no element can be placed on screen; spatial coverage, layout regions and visual anomalies cannot be measured`;
+  }
+  const unmounted = elements.filter((el) => el.state?.mounted === false).length;
+  return `all ${elements.length} registered element(s) report visible: false (unmounted=${unmounted}, off-screen route or otherwise=${elements.length - unmounted}), so whatever is on screen is not a registered element and there is nothing on screen to measure; this says nothing about whether the screen is blank`;
+}
 function analyze(elements, viewport, base) {
   const findings = [];
-  const considered = elements.filter((el) => el.state.visible);
-  const visible = considered.flatMap((el) => {
+  const onScreen = elements.filter((el) => el.state?.visible === true);
+  const visibilityUnstated = elements.filter(
+    (el) => typeof el.state?.visible !== "boolean"
+  ).length;
+  const visible = onScreen.flatMap((el) => {
     const rect = normalizeRect(el.state, viewport);
     return rect ? [{ el, rect }] : [];
   });
-  const withoutGeometry = considered.length - visible.length;
-  const unmeasured = withoutGeometry > 0 ? [{ dimension: "geometry", count: withoutGeometry, code: "input_missing" }] : [];
-  const coverage = { considered: considered.length, measured: visible.length, unmeasured };
-  if (considered.length > 0 && visible.length === 0) {
+  const withoutGeometry = onScreen.length - visible.length;
+  const unmeasured = [];
+  if (withoutGeometry > 0) {
+    unmeasured.push({ dimension: "geometry", count: withoutGeometry, code: "input_missing" });
+  }
+  if (visibilityUnstated > 0) {
+    unmeasured.push({ dimension: "visibility", count: visibilityUnstated, code: "input_missing" });
+  }
+  const coverage = {
+    considered: onScreen.length + visibilityUnstated,
+    measured: visible.length,
+    unmeasured
+  };
+  if (elements.length > 0 && visible.length === 0) {
     return Observation.unknown(
       "input_missing",
-      `all ${considered.length} visible element(s) have no measured layout yet, so spatial coverage, layout regions and visual anomalies cannot be measured`,
+      nothingOnScreenDetail(elements, onScreen.length, visibilityUnstated),
       Observation.provenance({ ...base, coverage })
     );
   }
@@ -1491,7 +1508,7 @@ function analyze(elements, viewport, base) {
   for (const el of elements) {
     const elType = el.type ?? "";
     if (SKIP_TEXT_TYPES.has(elType)) continue;
-    const text = (el.state.textContent ?? "").toString();
+    const text = (el.state?.textContent ?? "").toString();
     if (!text) continue;
     const textLower = text.toLowerCase();
     for (const p of ERROR_PHRASES) {
@@ -1532,7 +1549,7 @@ function analyze(elements, viewport, base) {
   for (const el of elements) {
     if (!INTERACTIVE_TYPES2.has(el.type)) continue;
     interactiveTotal++;
-    if (el.state.enabled === false) interactiveDisabled++;
+    if (el.state?.enabled === false) interactiveDisabled++;
   }
   const interactiveSeverity = interactiveTotal > 0 && interactiveDisabled / interactiveTotal > 0.5 ? "WARNING" : "OK";
   findings.push({
@@ -1556,9 +1573,7 @@ function analyze(elements, viewport, base) {
     detail: `zero_size=${zeroSize}, outside_viewport=${outsideViewport} (horizontal-overflow only; below/above-fold scrollable content is not an anomaly)`,
     data: { zero_size: zeroSize, outside_viewport: outsideViewport }
   });
-  const heatmap = grid.map(
-    (row) => row.map((cell) => cell ? "#" : ".").join("")
-  );
+  const heatmap = grid.map((row) => row.map((cell) => cell ? "#" : ".").join(""));
   return Observation.measured(
     {
       summary: worstSeverity(findings),
@@ -2544,7 +2559,7 @@ function createServerHandlers(registry, executor, config) {
       };
       if (config?.appInfo) {
         response.uiBridge = {
-          version: "0.7.0",
+          version: "0.7.1",
           ...config.appInfo,
           capabilities: ["elements", "components", "actions", "design"],
           elementCount: stats.elements,