@qontinui/ui-bridge-native 0.6.5 → 0.6.7

package/dist/server/design-handlers.d.ts

@@ -42,6 +42,26 @@ export interface NativeDesignHandlers {
 }
 /**
  * Create design review handlers.
+ *
+ * @param registry - the registered native element registry
+ * @param viewportProvider - optional injected viewport getter. Same shape as
+ *   the `viewportProvider` consumed by `handlers.ts`/`getPageHealth`. This is
+ *   injected by `createServerHandlers` from the `NativeServerConfig` the host
+ *   passes to `UIBridgeNativeProvider`/`NativeUIBridgeServer`, which in turn
+ *   reads `Dimensions.get('screen')` (or `'window'`). The indirection exists
+ *   because `require('react-native')` from this file crashes the host RN
+ *   app the moment any design endpoint is invoked: Metro/Hermes raise
+ *   `unknownModuleError` past every try/catch and tear down the JS thread.
+ *   This was the same latent crash that took out 0.6.3/0.6.4 page-health
+ *   handler — the design handlers had it too, just hiding on unused
+ *   endpoints until `POST /design/responsive` was first called.
+ *
+ *   When the injected provider is absent (tests, custom hosts) the design
+ *   handlers fall back to `{width:0, height:0}` — the responsive snapshot
+ *   degenerates to "zero-dimension viewport" rather than crashing.
  */
-export declare function createDesignHandlers(registry: NativeUIBridgeRegistry): NativeDesignHandlers;
+export declare function createDesignHandlers(registry: NativeUIBridgeRegistry, viewportProvider?: () => {
+    width: number;
+    height: number;
+}): NativeDesignHandlers;
 //# sourceMappingURL=design-handlers.d.ts.map

package/dist/server/design-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design-handlers.d.ts","sourceRoot":"","sources":["../../src/server/design-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAqDjG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnF,qBAAqB,EAAE,CACrB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,iBAAiB,EAAE,CACjB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAChF,sBAAsB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC5F,cAAc,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,cAAc,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACnF,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACrF,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,kBAAkB,EAAE,CAClB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC,CAAC;IACxE,YAAY,EAAE,CACZ,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,oBAAoB,CAwS3F"}
+{"version":3,"file":"design-handlers.d.ts","sourceRoot":"","sources":["../../src/server/design-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAqDjG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnF,qBAAqB,EAAE,CACrB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,iBAAiB,EAAE,CACjB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAChF,sBAAsB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC5F,cAAc,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,cAAc,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACnF,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACrF,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,kBAAkB,EAAE,CAClB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC,CAAC;IACxE,YAAY,EAAE,CACZ,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,gBAAgB,CAAC,EAAE,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD,oBAAoB,CAwStB"}

package/dist/server/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AAQpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAQV,oBAAoB,EAKrB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAiQhF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,CAAC,EAAE;IACP,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClF,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACA,oBAAoB,CA80BtB"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAQV,oBAAoB,EAKrB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAiQhF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,CAAC,EAAE;IACP,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClF,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACA,oBAAoB,CAy1BtB"}

package/dist/server/index.js

@@ -197,6 +197,10 @@ function extractHandlerNames(props) {
   if (!props) return [];
   return Object.keys(props).filter((k) => typeof props[k] === "function");
 }
+function matchesCurrentRoute(registrationRoute, currentRoute) {
+  if (registrationRoute == null || registrationRoute === "") return true;
+  return registrationRoute === currentRoute;
+}
 
 // src/design/design-inspector-native.ts
 function toCssValue(value) {
@@ -456,15 +460,9 @@ function success(data) {
 function error(message, code) {
   return { success: false, error: message, code, timestamp: Date.now() };
 }
-function createDesignHandlers(registry) {
+function createDesignHandlers(registry, viewportProvider) {
   function getScreenDimensions() {
-    try {
-      const { Dimensions } = __require("react-native");
-      const screen = Dimensions.get("screen");
-      return { width: screen.width, height: screen.height };
-    } catch {
-      return { width: 0, height: 0 };
-    }
+    return viewportProvider?.() ?? { width: 0, height: 0 };
   }
   return {
     // 1. GET /design/element/:id/styles
@@ -892,7 +890,7 @@ function diagnosePageHealth(elements, viewport) {
   let outsideViewport = 0;
   for (const { rect } of visible) {
     if (rect.width === 0 || rect.height === 0) zeroSize++;
-    if (rect.x + rect.width < 0 || rect.y + rect.height < 0 || rect.x > 1 || rect.y > 1) {
+    if (rect.x + rect.width < 0 || rect.x > 1) {
       outsideViewport++;
     }
   }
@@ -900,7 +898,7 @@ function diagnosePageHealth(elements, viewport) {
   findings.push({
     check: "visual_anomalies",
     severity: anomalySeverity,
-    detail: `zero_size=${zeroSize}, outside_viewport=${outsideViewport}`,
+    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(
@@ -1110,7 +1108,7 @@ function error2(message, code) {
   };
 }
 function createServerHandlers(registry, executor, config) {
-  const designHandlers = createDesignHandlers(registry);
+  const designHandlers = createDesignHandlers(registry, config?.viewportProvider);
   return {
     // Elements
     getElements: async (ctx) => {
@@ -1118,7 +1116,7 @@ function createServerHandlers(registry, executor, config) {
       const forRoute = ctx.query?.route || ctx.body?.route;
       let allElements = visibleOnly ? registry.getMountedVisibleElements() : registry.getAllElements();
       if (forRoute) {
-        allElements = allElements.filter((e) => e.registrationRoute === forRoute);
+        allElements = allElements.filter((e) => matchesCurrentRoute(e.registrationRoute, forRoute));
       }
       const elements = allElements.map((e) => {
         const handlers = extractHandlerNames(e.props);