@qontinui/ui-bridge-native 0.6.15 → 0.7.0

package/dist/core/index.mjs

@@ -762,6 +762,13 @@ function computeVisibility(state, clip) {
   const onScreen = spansOverlap(rect.left, rect.right, clip.left, clip.right) && spansOverlap(rect.top, rect.bottom, clip.top, clip.bottom);
   return onScreen ? { visibility: "visible" } : { visibility: "hidden", visibilityReason: "off-screen" };
 }
+function copyRouteInfo(info) {
+  const copy = { ...info };
+  if (info.params) copy.params = { ...info.params };
+  if (info.queryParams) copy.queryParams = { ...info.queryParams };
+  if (info.routeStack) copy.routeStack = [...info.routeStack];
+  return copy;
+}
 function inferActions(type, scrollAncestorId) {
   const baseActions = scrollAncestorId ? ["focus", "blur", "scrollIntoView"] : ["focus", "blur"];
   switch (type) {
@@ -826,6 +833,16 @@ var NativeUIBridgeRegistry = class {
      * already installs.
      */
     this.routeProvider = null;
+    /**
+     * The route TEMPLATE the app last reported through `useRouteAwareness`
+     * (via {@link setRouteInfo}), emitted on every snapshot as `page.route`.
+     *
+     * Deliberately NOT named `routeInfo`: `createSnapshot`'s parameter of that
+     * name is the CONCRETE `{currentRoute, segments, activeTab}` read from the
+     * route provider. The two must never be confused — the concrete path is
+     * user input, and this slot is the router-asserted template.
+     */
+    this.reportedRoute = void 0;
     /**
      * Device pixel ratio used to project `state.layout` (logical dp) into the
      * physical-pixel `bbox` emitted on each snapshot element. Defaults to `1`
@@ -884,6 +901,22 @@ var NativeUIBridgeRegistry = class {
   getRouteProvider() {
     return this.routeProvider;
   }
+  /**
+   * Set the route info emitted as `page.route` on every snapshot — the
+   * router-asserted TEMPLATE, normally reported by `useRouteAwareness`.
+   * Pass `undefined` to clear it (the hook does so on unmount), after which
+   * snapshots omit `page` again.
+   *
+   * The value is copied, so a later mutation by the caller cannot alter what
+   * is stored or what an already-emitted snapshot holds.
+   */
+  setRouteInfo(info) {
+    this.reportedRoute = info ? copyRouteInfo(info) : void 0;
+  }
+  /** Read-only accessor for the reported route info, if any (a copy). */
+  getRouteInfo() {
+    return this.reportedRoute ? copyRouteInfo(this.reportedRoute) : void 0;
+  }
   /**
    * Resolve the snapshot's `activeTab`: an explicit `getActiveTab()` on the
    * route provider wins, otherwise derive it from the Expo Router segments the
@@ -1724,6 +1757,12 @@ var NativeUIBridgeRegistry = class {
       // hosts that wire no route provider.
       ...resolvedRoute.currentRoute ? { route: resolvedRoute.currentRoute } : {},
       ...resolvedRoute.activeTab ? { activeTab: resolvedRoute.activeTab } : {},
+      // The router-asserted route TEMPLATE, spelled as the web SDK's
+      // `snapshot.page.route`. Emitted on the ONE assembly point both route
+      // branches above share (the explicit-`routeInfo` branch the server's
+      // `getSnapshot` override uses, and the provider fallback). Omitted, not
+      // nulled, when unset — the same convention as the aliases above.
+      ...this.reportedRoute ? { page: { route: copyRouteInfo(this.reportedRoute) } } : {},
       registration: this.getRegistrationCoverage()
     };
     if (this.appInfo) {
@@ -1770,6 +1809,9 @@ var NativeUIBridgeRegistry = class {
           }
         }
       }
+      if (this.reportedRoute) {
+        snapshot.page = { route: copyRouteInfo(this.reportedRoute) };
+      }
     }
     return snapshot;
   }