@aguacerowx/react-native 0.0.46 → 0.0.49

package/lib/typescript/nexrad/nexradNativeCommandIds.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @param {keyof typeof ANDROID_COMMAND_FALLBACK} commandName
+ * @returns {number | string | null}
+ */
+export function resolveNexradCommandId(commandName: keyof typeof ANDROID_COMMAND_FALLBACK): number | string | null;
+/** @type {Record<string, number>} */
+declare const ANDROID_COMMAND_FALLBACK: Record<string, number>;
+export {};
+//# sourceMappingURL=nexradNativeCommandIds.d.ts.map

package/lib/typescript/nexrad/nexradNativeCommandIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexradNativeCommandIds.d.ts","sourceRoot":"","sources":["../../../src/nexrad/nexradNativeCommandIds.js"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,oDAHW,MAAM,OAAO,wBAAwB,GACnC,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBlC;AA3BD,qCAAqC;AACrC,wCADW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM9B"}

package/lib/typescript/nexrad/radarArchiveCore.bundled.d.ts

@@ -0,0 +1,8 @@
+export function fetchAndParseArchive(url: any, objectKey: any, radarVariable: any, groupId: any, radarSource: any, options: any): Promise<any>;
+export function objectKeyToUrl(objectKey: any, radarSource?: string): any;
+export function setNexradArchiveApiKey(k: any): void;
+export function setNexradArchiveBundleId(bundleId: any): void;
+export function setNexradArchiveSiteOrigin(origin: any): void;
+export function setNexradSitesFetchAuth(apiKey: any, bundleId: any): void;
+export function setNexradSitesJsonUrl(url: any): void;
+//# sourceMappingURL=radarArchiveCore.bundled.d.ts.map

package/lib/typescript/nexrad/radarArchiveCore.bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radarArchiveCore.bundled.d.ts","sourceRoot":"","sources":["../../../src/nexrad/radarArchiveCore.bundled.js"],"names":[],"mappings":"AA6rNA,+IAwNC;AAlyCD,0EAKC;AA1ID,qDAEC;AACD,8DAEC;AACD,8DAGC;AA94BD,0EAKC;AAVD,sDAEC"}

package/lib/typescript/nexrad/radarDecode.worker.bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radarDecode.worker.bundled.d.ts","sourceRoot":"","sources":["../../../src/nexrad/radarDecode.worker.bundled.js"],"names":[],"mappings":"AAwkBA,qDAmCC;AAID,6CAEC;AACD;;SAIC;AACD,yEA2BC;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiIC;AAnxBD,uCAAqB;AACrB,sCAAoB;AACpB,wCAAsB;AACtB,uCAAqB;AACrB,uCAAqB;AACrB,sEAUC;AACD,2DAUC;AACD,8FAUC;AACD,yBAOE;AACF,yDAQC;AACD,oDAKC;AACD,4CAEC;AACD;;;;;;;;;;;cAsCC;AACD,uCAKC;AACD;;;;;KA2EC;AACD,+CAkFC;AACD;;;;;EAoBa;AACb;;;;;EA4Ba;AACb;;;;;EAca;AACb,uDAOC;AACD,yCAUmB;AACnB,kCAAwC;AACxC,yCAemB;AACnB,kCAAwC;AACxC,wDAcC;AACD,yDAOC;AACD,uDAkLC;AACD,8CAUC;AAuCD,mCAAwB"}

package/lib/typescript/nexrad/radarFrameGpuMatch.bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radarFrameGpuMatch.bundled.d.ts","sourceRoot":"","sources":["../../../src/nexrad/radarFrameGpuMatch.bundled.js"],"names":[],"mappings":"AAKA,yDA4CC;AAqBD,8EAGC;AAvBD,yDAmBC"}

package/lib/typescript/nws/NwsAlertsOverlay.android.d.ts

@@ -0,0 +1,2 @@
+export { default, resolveNwsAndroidLayerAnchors } from "./NwsAlertsOverlay.native.js";
+//# sourceMappingURL=NwsAlertsOverlay.android.d.ts.map

package/lib/typescript/nws/NwsAlertsOverlay.android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NwsAlertsOverlay.android.d.ts","sourceRoot":"","sources":["../../../src/nws/NwsAlertsOverlay.android.js"],"names":[],"mappings":""}

package/lib/typescript/nws/NwsAlertsOverlay.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("./NwsAlertsOverlay.native.js").default;
+export default _default;
+//# sourceMappingURL=NwsAlertsOverlay.d.ts.map

package/lib/typescript/nws/NwsAlertsOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NwsAlertsOverlay.d.ts","sourceRoot":"","sources":["../../../src/nws/NwsAlertsOverlay.js"],"names":[],"mappings":""}

package/lib/typescript/nws/NwsAlertsOverlay.ios.d.ts

@@ -0,0 +1,2 @@
+export { default, resolveNwsAndroidLayerAnchors } from "./NwsAlertsOverlay.native.js";
+//# sourceMappingURL=NwsAlertsOverlay.ios.d.ts.map

package/lib/typescript/nws/NwsAlertsOverlay.ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NwsAlertsOverlay.ios.d.ts","sourceRoot":"","sources":["../../../src/nws/NwsAlertsOverlay.ios.js"],"names":[],"mappings":""}

package/lib/typescript/nws/NwsAlertsOverlay.native.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @param {object} state - {@link AguaceroCore} state
+ * @param {object} wopt - watches/warnings options (same shape as mapsgl {@link WeatherLayerManager#configureWatchesWarnings})
+ * @returns {{ weatherLayerId: string | null, fillBelowId: string | null, lineBelowId: string }}
+ */
+export function resolveNwsAndroidLayerAnchors(state: object, wopt: object): {
+    weatherLayerId: string | null;
+    fillBelowId: string | null;
+    lineBelowId: string;
+};
+/**
+ * @param {object} props
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} props.core
+ * @param {object} props.watchesWarnings - merged options ({ enabled, alertsBaseUrl, nwsAlertSettings, ... })
+ * @param {(payload: object) => void} [props.onNwsAlertClick]
+ */
+export default function NwsAlertsOverlay({ core, watchesWarnings, onNwsAlertClick }: {
+    core: any;
+    watchesWarnings: object;
+    onNwsAlertClick?: ((payload: object) => void) | undefined;
+}): any;
+//# sourceMappingURL=NwsAlertsOverlay.native.d.ts.map

package/lib/typescript/nws/NwsAlertsOverlay.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NwsAlertsOverlay.native.d.ts","sourceRoot":"","sources":["../../../src/nws/NwsAlertsOverlay.native.js"],"names":[],"mappings":"AAiMA;;;;GAIG;AACH,qDAJW,MAAM,QACN,MAAM,GACJ;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAwB9F;AAED;;;;;GAKG;AACH,qFAJG;IAAiE,IAAI,EAA7D,GAAiD;IACnC,eAAe,EAA7B,MAAM;IAC4B,eAAe,cAAvC,MAAM,KAAK,IAAI;CAAyB,OA4O5D"}

package/lib/typescript/nws/eventSourceRnPolyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventSourceRnPolyfill.d.ts","sourceRoot":"","sources":["../../../src/nws/eventSourceRnPolyfill.js"],"names":[],"mappings":"AAwLA;;GAEG;AACH,qDAGC"}

package/lib/typescript/nws/nwsAndroidConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nwsAndroidConstants.d.ts","sourceRoot":"","sources":["../../../src/nws/nwsAndroidConstants.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,2CAA4C,8BAA8B,CAAC;AAE3E,6GAA6G;AAC7G,8CAA+C,0BAA0B,CAAC"}

package/lib/typescript/satellite/satelliteAndroidController.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Target frame first, then remaining frames by increasing temporal distance to {@code targetUnix}.
+ * @param {{ unix: number; url: string; shaderFileName: string }[]} frames
+ * @param {number | null} targetUnix
+ */
+export function sortFramesByTargetProximity(frames: {
+    unix: number;
+    url: string;
+    shaderFileName: string;
+}[], targetUnix: number | null): {
+    unix: number;
+    url: string;
+    shaderFileName: string;
+}[];
+/**
+ * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
+ * @param {number} satelliteTimestamp
+ */
+export function buildSatelliteFetchParts(state: any, satelliteTimestamp: number): {
+    url: string;
+    shaderFileName: any;
+    frameKey: number;
+    apiKey: any;
+} | null;
+export class SatelliteAndroidController {
+    /**
+     * @param {import('@aguacerowx/javascript-sdk').AguaceroCore} core
+     * @param {React.RefObject<{ syncSatellite?: (json: string) => void; clearSatellite?: () => void; activateSatelliteCachedUnix?: (unix: number) => void; updateSatelliteStyle?: (json: string) => void }>} satelliteLayerRef
+     */
+    constructor(core: any, satelliteLayerRef: React.RefObject<{
+        syncSatellite?: (json: string) => void;
+        clearSatellite?: () => void;
+        activateSatelliteCachedUnix?: (unix: number) => void;
+        updateSatelliteStyle?: (json: string) => void;
+    }>);
+    core: any;
+    satelliteLayerRef: React.RefObject<{
+        syncSatellite?: (json: string) => void;
+        clearSatellite?: () => void;
+        activateSatelliteCachedUnix?: (unix: number) => void;
+        updateSatelliteStyle?: (json: string) => void;
+    }>;
+    _destroyed: boolean;
+    /** @type {string | undefined} */
+    _cachedRunKey: string | undefined;
+    /** @type {string | undefined} */
+    _cachedTimelineSig: string | undefined;
+    /** @type {number | null | undefined} */
+    _lastTargetUnix: number | null | undefined;
+    /** @type {string | undefined} */
+    _lastStyleJson: string | undefined;
+    destroy(): void;
+    /**
+     * @param {import('@aguacerowx/javascript-sdk').AguaceroCoreState} state
+     */
+    sync(state: any): void;
+}
+//# sourceMappingURL=satelliteAndroidController.d.ts.map

package/lib/typescript/satellite/satelliteAndroidController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satelliteAndroidController.d.ts","sourceRoot":"","sources":["../../../src/satellite/satelliteAndroidController.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,oDAHW;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,cACvD,MAAM,GAAG,IAAI;UADL,MAAM;SAAO,MAAM;oBAAkB,MAAM;IAiB7D;AAED;;;GAGG;AACH,yEAFW,MAAM;;;;;SA4BhB;AAED;IACI;;;OAGG;IACH,0CAFW,KAAK,CAAC,SAAS,CAAC;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC,EAcvM;IAXG,UAAgB;IAChB;wBAJyC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;yBAAmB,MAAM,IAAI;sCAAgC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;+BAAyB,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;OAIvJ;IAC1C,oBAAuB;IACvB,iCAAiC;IACjC,eADW,MAAM,GAAG,SAAS,CACC;IAC9B,iCAAiC;IACjC,oBADW,MAAM,GAAG,SAAS,CACM;IACnC,wCAAwC;IACxC,iBADW,MAAM,GAAG,IAAI,GAAG,SAAS,CACJ;IAChC,iCAAiC;IACjC,gBADW,MAAM,GAAG,SAAS,CACE;IAGnC,gBAQC;IAED;;OAEG;IACH,uBA8IC;CACJ"}

package/lib/typescript/satelliteBridgeDiag.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Always-on warnings for satellite bridge debugging (Metro + many device log sinks).
+ * Filter Xcode / Metro: `sat-bridge` or `AguaceroWX`.
+ */
+export function satBridgeWarn(tag: any, detail: any): void;
+//# sourceMappingURL=satelliteBridgeDiag.d.ts.map

package/lib/typescript/satelliteBridgeDiag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satelliteBridgeDiag.d.ts","sourceRoot":"","sources":["../../src/satelliteBridgeDiag.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,2DAUC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aguacerowx/react-native",
-  "version": "0.0.46",
+  "version": "0.0.49",
   "description": "Native weather rendering for React Native",
   "license": "ISC",
   "author": "Michael Barletta",
@@ -35,6 +35,7 @@
     "prepare": "npm run build"
   },
   "devDependencies": {
+    "proj4": "^2.11.0",
     "react-native-builder-bob": "^0.23.2",
     "typescript": "^5.0.2"
   },
@@ -49,7 +50,7 @@
     "base64-js": "^1.5.1"
   },
   "react-native-builder-bob": {
-    "source": ".",
+    "source": "src",
     "output": "lib",
     "targets": [
       "commonjs",

package/src/MapManager.js

@@ -43,6 +43,7 @@ function deepMerge(target, source) {
  * @param {string} [props.styleUrl]
  * @param {string} [props.belowID] - Style layer id to insert Aguacero weather **below** (alias: `weatherBeforeLayerId`). With `styleURL`, required for correct stacking; may be set alone to override the default `AML_-_terrain` anchor on the default style.
  * @param {string} [props.weatherBeforeLayerId]
+ * @param {import('react').ReactNode} [props.children] - Render inside Mapbox.MapView; use for WeatherLayerManager so map sources (e.g. NEXRAD site circles) register on the map.
  */
 export const MapManager = forwardRef(({
     mapboxToken,
@@ -247,8 +248,13 @@ export const MapManager = forwardRef(({
 });
 
 const styles = StyleSheet.create({
+    /**
+     * Full-bleed positioning so RNMapbox/Mapbox gets non-zero bounds on the first layout pass.
+     * A plain flex:1 sibling tree (e.g. map + absolute overlays under Expo Tabs) can still yield
+     * a transient 0×0 MapView, which triggers maps-core "Invalid size … fall back to {64, 64}".
+     */
     container: {
-        flex: 1,
+        ...StyleSheet.absoluteFillObject,
         backgroundColor: '#1a1a2e',
     },
     centerContent: {
@@ -256,7 +262,7 @@ const styles = StyleSheet.create({
         alignItems: 'center',
     },
     map: {
-        flex: 1,
+        ...StyleSheet.absoluteFillObject,
     },
     errorText: {
         color: '#FF6B6B',

package/src/NexradRadarLayer.android.js

@@ -2,16 +2,12 @@ import React, { forwardRef, useImperativeHandle, useRef } from 'react';
 import { StyleSheet, UIManager, findNodeHandle } from 'react-native';
 import NexradRadarLayerNative from './NexradRadarLayerNativeComponent';
 import { nexradDiag, nexradPerfSpan } from './nexrad/nexradDiag';
+import { resolveNexradCommandId } from './nexrad/nexradNativeCommandIds';
 
 const NATIVE_COMPONENT_NAME = 'NexradRadarLayer';
 
 function getCommandId(commandName) {
-    try {
-        const config = UIManager.getViewManagerConfig(NATIVE_COMPONENT_NAME);
-        return config?.Commands?.[commandName] ?? null;
-    } catch {
-        return null;
-    }
+    return resolveNexradCommandId(commandName);
 }
 
 export const NexradRadarLayer = forwardRef((props, ref) => {

package/src/NexradRadarLayer.ios.js

@@ -1,13 +1,113 @@
-import React, { forwardRef, useImperativeHandle } from 'react';
+import React, { forwardRef, useImperativeHandle, useRef } from 'react';
+import { StyleSheet, UIManager, findNodeHandle } from 'react-native';
+import NexradRadarLayerNative from './NexradRadarLayerNativeComponent';
+import { nexradDiag, nexradPerfSpan } from './nexrad/nexradDiag';
+import { resolveNexradCommandId } from './nexrad/nexradNativeCommandIds';
 
-/** NEXRAD native rendering is Android-only; iOS is a no-op stub. */
 export const NexradRadarLayer = forwardRef((props, ref) => {
+    const nativeRef = useRef(null);
+
     useImperativeHandle(ref, () => ({
-        uploadNexradFrame() {},
-        uploadNexradStyleOnly() {},
-        clearNexrad() {},
+        uploadNexradFrame(json) {
+            const bridge = nexradPerfSpan('bridge.dispatchViewManagerCommand.uploadNexradFrame');
+            const id = resolveNexradCommandId('uploadNexradFrame');
+            const handle = findNodeHandle(nativeRef.current);
+            if (id != null && handle != null) {
+                UIManager.dispatchViewManagerCommand(handle, id, [json]);
+                bridge.end({
+                    jsonChars: typeof json === 'string' ? json.length : 0,
+                    ok: true,
+                });
+            } else {
+                bridge.end({
+                    jsonChars: typeof json === 'string' ? json.length : 0,
+                    ok: false,
+                    commandId: id,
+                    hasHandle: handle != null,
+                    hasRef: nativeRef.current != null,
+                });
+                nexradDiag('bridge.uploadNexradFrameBlocked', {
+                    commandId: id,
+                    hasHandle: handle != null,
+                    hasRef: nativeRef.current != null,
+                });
+            }
+        },
+        uploadNexradStyleOnly(json) {
+            const bridge = nexradPerfSpan('bridge.dispatchViewManagerCommand.uploadNexradStyleOnly');
+            const id = resolveNexradCommandId('uploadNexradStyleOnly');
+            const handle = findNodeHandle(nativeRef.current);
+            if (id != null && handle != null) {
+                UIManager.dispatchViewManagerCommand(handle, id, [json]);
+                bridge.end({
+                    jsonChars: typeof json === 'string' ? json.length : 0,
+                    ok: true,
+                });
+            } else {
+                bridge.end({
+                    jsonChars: typeof json === 'string' ? json.length : 0,
+                    ok: false,
+                    commandId: id,
+                    hasHandle: handle != null,
+                });
+                nexradDiag('bridge.uploadNexradStyleOnlyBlocked', {
+                    commandId: id,
+                    hasHandle: handle != null,
+                });
+            }
+        },
+        clearNexrad() {
+            const bridge = nexradPerfSpan('bridge.dispatchViewManagerCommand.clearNexrad');
+            const id = resolveNexradCommandId('clearNexrad');
+            const handle = findNodeHandle(nativeRef.current);
+            if (id != null && handle != null) {
+                UIManager.dispatchViewManagerCommand(handle, id, []);
+                bridge.end({ ok: true });
+            } else {
+                bridge.end({ ok: false, commandId: id, hasHandle: handle != null });
+            }
+        },
+        activateNexradCachedFrame(nativeGpuCacheKey) {
+            const bridge = nexradPerfSpan('bridge.dispatchViewManagerCommand.activateNexradCachedFrame');
+            const id = resolveNexradCommandId('activateNexradCachedFrame');
+            const handle = findNodeHandle(nativeRef.current);
+            if (id != null && handle != null && typeof nativeGpuCacheKey === 'string') {
+                UIManager.dispatchViewManagerCommand(handle, id, [nativeGpuCacheKey]);
+                bridge.end({
+                    keyLen: nativeGpuCacheKey.length,
+                    ok: true,
+                });
+            } else {
+                bridge.end({
+                    keyLen: typeof nativeGpuCacheKey === 'string' ? nativeGpuCacheKey.length : 0,
+                    ok: false,
+                    commandId: id,
+                    hasHandle: handle != null,
+                });
+                nexradDiag('bridge.activateNexradCachedFrameBlocked', {
+                    commandId: id,
+                    hasHandle: handle != null,
+                    keyType: typeof nativeGpuCacheKey,
+                });
+            }
+        },
     }));
-    return null;
+
+    return (
+        <NexradRadarLayerNative
+            ref={nativeRef}
+            belowID={props.belowID}
+            style={styles.overlay}
+            pointerEvents="none"
+            collapsable={false}
+        />
+    );
+});
+
+const styles = StyleSheet.create({
+    overlay: {
+        ...StyleSheet.absoluteFillObject,
+    },
 });
 
 NexradRadarLayer.displayName = 'NexradRadarLayer';

package/src/SatelliteLayer.android.js

@@ -1,16 +1,13 @@
 import React, { forwardRef, useImperativeHandle, useRef } from 'react';
-import { StyleSheet, UIManager, findNodeHandle } from 'react-native';
+import { StyleSheet } from 'react-native';
 import SatelliteLayerNative from './SatelliteLayerNativeComponent';
+import { dispatchViewManagerCommandCompat } from './dispatchViewManagerCommandCompat';
+import { satBridgeWarn } from './satelliteBridgeDiag';
 
 const NATIVE_COMPONENT_NAME = 'SatelliteLayer';
 
-function getCommandId(commandName) {
-    try {
-        const config = UIManager.getViewManagerConfig(NATIVE_COMPONENT_NAME);
-        return config?.Commands?.[commandName] ?? null;
-    } catch {
-        return null;
-    }
+function warnFailed(commandName) {
+    satBridgeWarn(`SatelliteLayer:${commandName}:dispatch-failed`, {});
 }
 
 export const SatelliteLayer = forwardRef((props, ref) => {
@@ -18,32 +15,29 @@ export const SatelliteLayer = forwardRef((props, ref) => {
 
     useImperativeHandle(ref, () => ({
         syncSatellite(json) {
-            const id = getCommandId('syncSatellite');
-            const handle = findNodeHandle(nativeRef.current);
-            if (id != null && handle != null && typeof json === 'string') {
-                UIManager.dispatchViewManagerCommand(handle, id, [json]);
-            }
+            if (typeof json !== 'string') return;
+            satBridgeWarn('SatelliteLayer.syncSatellite called', { jsonChars: json.length });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'syncSatellite', [json]);
+            if (!ok) warnFailed('syncSatellite');
         },
         clearSatellite() {
-            const id = getCommandId('clearSatellite');
-            const handle = findNodeHandle(nativeRef.current);
-            if (id != null && handle != null) {
-                UIManager.dispatchViewManagerCommand(handle, id, []);
-            }
+            satBridgeWarn('SatelliteLayer.clearSatellite called', {});
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'clearSatellite', []);
+            if (!ok) warnFailed('clearSatellite');
         },
         activateSatelliteCachedUnix(unix) {
-            const id = getCommandId('activateSatelliteCachedUnix');
-            const handle = findNodeHandle(nativeRef.current);
-            if (id != null && handle != null && typeof unix === 'number') {
-                UIManager.dispatchViewManagerCommand(handle, id, [unix]);
-            }
+            if (typeof unix !== 'number') return;
+            satBridgeWarn('SatelliteLayer.activateSatelliteCachedUnix called', { unix });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'activateSatelliteCachedUnix', [
+                unix,
+            ]);
+            if (!ok) warnFailed('activateSatelliteCachedUnix');
         },
         updateSatelliteStyle(json) {
-            const id = getCommandId('updateSatelliteStyle');
-            const handle = findNodeHandle(nativeRef.current);
-            if (id != null && handle != null && typeof json === 'string') {
-                UIManager.dispatchViewManagerCommand(handle, id, [json]);
-            }
+            if (typeof json !== 'string') return;
+            satBridgeWarn('SatelliteLayer.updateSatelliteStyle called', { jsonChars: json.length });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'updateSatelliteStyle', [json]);
+            if (!ok) warnFailed('updateSatelliteStyle');
         },
     }));
 

package/src/SatelliteLayer.ios.js

@@ -1,16 +1,70 @@
-import React, { forwardRef, useImperativeHandle } from 'react';
+import React, { forwardRef, useImperativeHandle, useRef } from 'react';
+import { StyleSheet } from 'react-native';
+import SatelliteLayerNative from './SatelliteLayerNativeComponent';
+import { dispatchViewManagerCommandCompat } from './dispatchViewManagerCommandCompat';
+import { satBridgeWarn } from './satelliteBridgeDiag';
+
+const NATIVE_COMPONENT_NAME = 'SatelliteLayer';
+
+function warnFailed(commandName) {
+    satBridgeWarn(`SatelliteLayer:${commandName}:dispatch-failed`, {
+        hint: 'compat helper returned false — see prior sat-bridge dispatch:* logs',
+    });
+}
 
-/** Satellite native rendering is Android-only; iOS is a no-op stub. */
 export const SatelliteLayer = forwardRef((props, ref) => {
+    const nativeRef = useRef(null);
+
     useImperativeHandle(ref, () => ({
-        syncSatellite() {},
-        clearSatellite() {},
-        activateSatelliteCachedUnix() {},
-        updateSatelliteStyle() {},
+        syncSatellite(json) {
+            if (typeof json !== 'string') return;
+            satBridgeWarn('SatelliteLayer.syncSatellite called', {
+                jsonChars: json.length,
+                nativeRefAttached: Boolean(nativeRef.current),
+            });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'syncSatellite', [json]);
+            if (!ok) warnFailed('syncSatellite');
+        },
+        clearSatellite() {
+            satBridgeWarn('SatelliteLayer.clearSatellite called', {
+                nativeRefAttached: Boolean(nativeRef.current),
+            });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'clearSatellite', []);
+            if (!ok) warnFailed('clearSatellite');
+        },
+        activateSatelliteCachedUnix(unix) {
+            if (typeof unix !== 'number') return;
+            satBridgeWarn('SatelliteLayer.activateSatelliteCachedUnix called', { unix });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'activateSatelliteCachedUnix', [
+                unix,
+            ]);
+            if (!ok) warnFailed('activateSatelliteCachedUnix');
+        },
+        updateSatelliteStyle(json) {
+            if (typeof json !== 'string') return;
+            satBridgeWarn('SatelliteLayer.updateSatelliteStyle called', { jsonChars: json.length });
+            const ok = dispatchViewManagerCommandCompat(nativeRef, NATIVE_COMPONENT_NAME, 'updateSatelliteStyle', [json]);
+            if (!ok) warnFailed('updateSatelliteStyle');
+        },
     }));
-    return null;
+
+    return (
+        <SatelliteLayerNative
+            ref={nativeRef}
+            belowID={props.belowID}
+            style={styles.overlay}
+            pointerEvents="none"
+            collapsable={false}
+        />
+    );
 });
 
 SatelliteLayer.displayName = 'SatelliteLayer';
 
+const styles = StyleSheet.create({
+    overlay: {
+        ...StyleSheet.absoluteFillObject,
+    },
+});
+
 export default SatelliteLayer;