@aguacerowx/react-native 0.0.50 → 0.0.52

package/src/nexrad/nexradDiag.js

@@ -1,144 +1,150 @@
-/**
- * NEXRAD pipeline diagnostics (Android / Metro).
- *
- * Verbose phases / perf: off unless {@code global.__AGUACERO_NEXRAD_DEBUG = true}
- * (filter {@code [Aguacero][NEXRAD]} and {@code [Aguacero][NEXRAD][PERF]}).
- *
- * Legacy pipe line-by-line bridge logs: only if {@code global.__AGUACERO_NEXRAD_PIPE_TRACE = true}.
- */
-
-export function nexradDiagEnabled() {
-    return typeof globalThis !== 'undefined' && globalThis.__AGUACERO_NEXRAD_DEBUG === true;
-}
-
-/**
- * Opt-in only — line-by-line bridge logs.
- * @param {string} tag
- * @param {Record<string, unknown>} [detail]
- */
-export function nexradPipeTrace(tag, detail) {
-    if (typeof globalThis === 'undefined' || globalThis.__AGUACERO_NEXRAD_PIPE_TRACE !== true) {
-        return;
-    }
-    try {
-        const msg =
-            detail !== undefined && detail !== null && typeof detail === 'object'
-                ? JSON.stringify(detail)
-                : detail === undefined || detail === null
-                  ? ''
-                  : String(detail);
-        console.warn(`[Aguacero][NEXRAD][PIPE] ${tag}`, msg);
-    } catch {
-        console.warn(`[Aguacero][NEXRAD][PIPE] ${tag}`, '(unserializable detail)');
-    }
-}
-
-export function nexradDiag(phase, detail) {
-    if (!nexradDiagEnabled()) return;
-    if (detail !== undefined) {
-        console.warn(`[Aguacero][NEXRAD] ${phase}`, detail);
-    } else {
-        console.warn(`[Aguacero][NEXRAD] ${phase}`);
-    }
-}
-
-/**
- * @param {string} label
- * @returns {{ elapsedMs: () => number, end: (detail?: Record<string, unknown>) => number }}
- */
-export function nexradPerfSpan(label) {
-    const hasPerf = typeof performance !== 'undefined' && typeof performance.now === 'function';
-    const t0 = hasPerf ? performance.now() : Date.now();
-    return {
-        elapsedMs() {
-            const t1 = hasPerf ? performance.now() : Date.now();
-            return t1 - t0;
-        },
-        end(detail) {
-            const msActual = hasPerf ? performance.now() - t0 : Date.now() - t0;
-            if (!nexradDiagEnabled()) {
-                return msActual;
-            }
-            const payload =
-                detail !== undefined && detail !== null && typeof detail === 'object'
-                    ? { ms: msActual, ...detail }
-                    : { ms: msActual };
-            console.warn(`[Aguacero][NEXRAD][PERF] ${label}`, payload);
-            return msActual;
-        },
-    };
-}
-
-/**
- * @param {Record<string, unknown>} [extra]
- */
-export function nexradDiagBootSnapshot(extra = {}) {
-    if (!nexradDiagEnabled()) return;
-    const g = typeof globalThis !== 'undefined' ? globalThis : {};
-    nexradDiag('boot.snapshot', {
-        ...extra,
-        workerType: typeof Worker,
-        navigatorProduct: typeof navigator !== 'undefined' ? navigator.product : undefined,
-        hermesInternal: typeof g.HermesInternal !== 'undefined',
-    });
-}
-
-/**
- * @param {Uint8Array} gateData
- * @param {number} nGates
- * @param {number} nRays
- * @param {number} valueScale
- * @param {number} valueOffset
- * @param {number} lutMin
- * @param {number} lutMax
- */
-export function nexradDiagGateTextureSummary(gateData, nGates, nRays, valueScale, valueOffset, lutMin, lutMax) {
-    if (!nexradDiagEnabled()) {
-        return { skipped: true };
-    }
-    if (!gateData?.length) return { error: 'empty' };
-    const pairCount = nGates * nRays;
-    const expected = pairCount * 2;
-    if (gateData.length < expected) {
-        return { error: 'shortBuffer', len: gateData.length, expected };
-    }
-    let sampleN = 0;
-    let nodataN = 0;
-    let inLutN = 0;
-    let minRaw = 32767;
-    let maxRaw = -32768;
-    let minPhys = Infinity;
-    let maxPhys = -Infinity;
-    const stride = Math.max(1, Math.floor(pairCount / 25000));
-    for (let p = 0; p < pairCount; p += stride) {
-        const o = p * 2;
-        const lo = gateData[o];
-        const hi = gateData[o + 1];
-        let raw = lo + hi * 256;
-        if (raw >= 32768) raw -= 65536;
-        sampleN++;
-        if (raw <= -32768) {
-            nodataN++;
-            continue;
-        }
-        if (raw < minRaw) minRaw = raw;
-        if (raw > maxRaw) maxRaw = raw;
-        const phys = raw * valueScale + valueOffset;
-        if (phys < minPhys) minPhys = phys;
-        if (phys > maxPhys) maxPhys = phys;
-        if (phys >= lutMin && phys <= lutMax) inLutN++;
-    }
-    return {
-        samples: sampleN,
-        nodataSamples: nodataN,
-        inLutSamples: inLutN,
-        minRaw: minRaw <= maxRaw ? minRaw : null,
-        maxRaw: minRaw <= maxRaw ? maxRaw : null,
-        minPhys: Number.isFinite(minPhys) ? minPhys : null,
-        maxPhys: Number.isFinite(maxPhys) ? maxPhys : null,
-        lutMin,
-        lutMax,
-        valueScale,
-        valueOffset,
-    };
-}
+/**
+ * NEXRAD pipeline diagnostics (Android / Metro).
+ *
+ * Verbose phases / perf: off unless {@code global.__AGUACERO_NEXRAD_DEBUG = true}
+ * (filter {@code [Aguacero][NEXRAD]} and {@code [Aguacero][NEXRAD][PERF]}).
+ *
+ * Legacy pipe line-by-line bridge logs: only if {@code global.__AGUACERO_NEXRAD_PIPE_TRACE = true}.
+ */
+
+export function nexradDiagEnabled() {
+    if (typeof globalThis !== 'undefined' && globalThis.__AGUACERO_NEXRAD_DEBUG === true) {
+        return true;
+    }
+    if (typeof globalThis !== 'undefined' && globalThis.__AGUACERO_DEBUG__ === true) {
+        return true;
+    }
+    return false;
+}
+
+/**
+ * Opt-in only — line-by-line bridge logs.
+ * @param {string} tag
+ * @param {Record<string, unknown>} [detail]
+ */
+export function nexradPipeTrace(tag, detail) {
+    if (typeof globalThis === 'undefined' || globalThis.__AGUACERO_NEXRAD_PIPE_TRACE !== true) {
+        return;
+    }
+    try {
+        const msg =
+            detail !== undefined && detail !== null && typeof detail === 'object'
+                ? JSON.stringify(detail)
+                : detail === undefined || detail === null
+                  ? ''
+                  : String(detail);
+        console.warn(`[Aguacero][NEXRAD][PIPE] ${tag}`, msg);
+    } catch {
+        console.warn(`[Aguacero][NEXRAD][PIPE] ${tag}`, '(unserializable detail)');
+    }
+}
+
+export function nexradDiag(phase, detail) {
+    if (!nexradDiagEnabled()) return;
+    if (detail !== undefined) {
+        console.warn(`[Aguacero][NEXRAD] ${phase}`, detail);
+    } else {
+        console.warn(`[Aguacero][NEXRAD] ${phase}`);
+    }
+}
+
+/**
+ * @param {string} label
+ * @returns {{ elapsedMs: () => number, end: (detail?: Record<string, unknown>) => number }}
+ */
+export function nexradPerfSpan(label) {
+    const hasPerf = typeof performance !== 'undefined' && typeof performance.now === 'function';
+    const t0 = hasPerf ? performance.now() : Date.now();
+    return {
+        elapsedMs() {
+            const t1 = hasPerf ? performance.now() : Date.now();
+            return t1 - t0;
+        },
+        end(detail) {
+            const msActual = hasPerf ? performance.now() - t0 : Date.now() - t0;
+            if (!nexradDiagEnabled()) {
+                return msActual;
+            }
+            const payload =
+                detail !== undefined && detail !== null && typeof detail === 'object'
+                    ? { ms: msActual, ...detail }
+                    : { ms: msActual };
+            console.warn(`[Aguacero][NEXRAD][PERF] ${label}`, payload);
+            return msActual;
+        },
+    };
+}
+
+/**
+ * @param {Record<string, unknown>} [extra]
+ */
+export function nexradDiagBootSnapshot(extra = {}) {
+    if (!nexradDiagEnabled()) return;
+    const g = typeof globalThis !== 'undefined' ? globalThis : {};
+    nexradDiag('boot.snapshot', {
+        ...extra,
+        workerType: typeof Worker,
+        navigatorProduct: typeof navigator !== 'undefined' ? navigator.product : undefined,
+        hermesInternal: typeof g.HermesInternal !== 'undefined',
+    });
+}
+
+/**
+ * @param {Uint8Array} gateData
+ * @param {number} nGates
+ * @param {number} nRays
+ * @param {number} valueScale
+ * @param {number} valueOffset
+ * @param {number} lutMin
+ * @param {number} lutMax
+ */
+export function nexradDiagGateTextureSummary(gateData, nGates, nRays, valueScale, valueOffset, lutMin, lutMax) {
+    if (!nexradDiagEnabled()) {
+        return { skipped: true };
+    }
+    if (!gateData?.length) return { error: 'empty' };
+    const pairCount = nGates * nRays;
+    const expected = pairCount * 2;
+    if (gateData.length < expected) {
+        return { error: 'shortBuffer', len: gateData.length, expected };
+    }
+    let sampleN = 0;
+    let nodataN = 0;
+    let inLutN = 0;
+    let minRaw = 32767;
+    let maxRaw = -32768;
+    let minPhys = Infinity;
+    let maxPhys = -Infinity;
+    const stride = Math.max(1, Math.floor(pairCount / 25000));
+    for (let p = 0; p < pairCount; p += stride) {
+        const o = p * 2;
+        const lo = gateData[o];
+        const hi = gateData[o + 1];
+        let raw = lo + hi * 256;
+        if (raw >= 32768) raw -= 65536;
+        sampleN++;
+        if (raw <= -32768) {
+            nodataN++;
+            continue;
+        }
+        if (raw < minRaw) minRaw = raw;
+        if (raw > maxRaw) maxRaw = raw;
+        const phys = raw * valueScale + valueOffset;
+        if (phys < minPhys) minPhys = phys;
+        if (phys > maxPhys) maxPhys = phys;
+        if (phys >= lutMin && phys <= lutMax) inLutN++;
+    }
+    return {
+        samples: sampleN,
+        nodataSamples: nodataN,
+        inLutSamples: inLutN,
+        minRaw: minRaw <= maxRaw ? minRaw : null,
+        maxRaw: minRaw <= maxRaw ? maxRaw : null,
+        minPhys: Number.isFinite(minPhys) ? minPhys : null,
+        maxPhys: Number.isFinite(maxPhys) ? maxPhys : null,
+        lutMin,
+        lutMax,
+        valueScale,
+        valueOffset,
+    };
+}