@aguacerowx/javascript-sdk 0.0.28 → 0.0.29

package/src/nws/nwsSdkConstants.js

@@ -1,368 +1,368 @@
-/**
- * NWS alert styling defaults — palette from `nwsEventColorsDefaults.js` (synced with
- * aguacero-frontend `defaultColormaps`). Unknown CAP event names still fall back to
- * {@link WARNING_DEFAULT_COLOR}.
- */
-
-import { NWS_ALERT_EVENT_NAMES, NWS_EVENT_COLORS } from './nwsEventColorsDefaults.js';
-
-export { NWS_ALERT_EVENT_NAMES, NWS_EVENT_COLORS };
-
-/** @deprecated Use {@link NWS_EVENT_COLORS}. */
-export const NWS_SDK_EVENT_COLOR = NWS_EVENT_COLORS;
-
-/** @deprecated Use {@link NWS_ALERT_EVENT_NAMES}. */
-export const NWS_SDK_EVENT_NAMES = NWS_ALERT_EVENT_NAMES;
-
-export const NWS_DEFAULT_FILL_OPACITY = 0.5;
-
-/** Warnings outline-only by default for convective + flash-flood warnings — same as aguacero-frontend. */
-export const NWS_DEFAULT_FILL_HIDDEN = Object.fromEntries(
-    [
-        'Tornado Warning',
-        'Tornado Warning (Observed)',
-        'Tornado Warning (PDS)',
-        'Tornado Warning (Emergency)',
-        'Severe Thunderstorm Warning',
-        'Severe Thunderstorm Warning (Considerable)',
-        'Severe Thunderstorm Warning (Destructive)',
-        'Flash Flood Warning',
-        'Flash Flood Warning (Considerable)',
-        'Flash Flood Warning (Emergency)',
-        'Flash Flood Statement',
-    ].map((name) => [name, true])
-);
-
-export const NWS_WARNINGS_SUBTYPE_PARENT = {
-    'Tornado Warning (Observed)': 'Tornado Warning',
-    'Tornado Warning (PDS)': 'Tornado Warning',
-    'Tornado Warning (Emergency)': 'Tornado Warning',
-    'Severe Thunderstorm Warning (Considerable)': 'Severe Thunderstorm Warning',
-    'Severe Thunderstorm Warning (Destructive)': 'Severe Thunderstorm Warning',
-    'Flash Flood Warning (Considerable)': 'Flash Flood Warning',
-    'Flash Flood Warning (Emergency)': 'Flash Flood Warning',
-};
-
-export const NWS_ALERT_END_TIME_PROP_KEYS = ['ends', 'expires', 'expires_at'];
-
-export function resolveNwsAlertUserColor(userColors, eventName) {
-    const uc = userColors ?? {};
-    const own = uc[eventName];
-    if (own != null && String(own).trim() !== '') return own;
-    if (eventName === 'Tornado Warning (Observed)') {
-        const legacy = uc['Tornado Warning (Reported)'];
-        if (legacy != null && String(legacy).trim() !== '') return legacy;
-    }
-    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
-    if (parent) {
-        const p = uc[parent];
-        if (p != null && String(p).trim() !== '') return p;
-    }
-    return undefined;
-}
-
-export function isNwsAlertDisabled(disabled, eventName) {
-    const d = disabled ?? {};
-    if (d[eventName] === true) return true;
-    if (eventName === 'Tornado Warning (Observed)' && d['Tornado Warning (Reported)'] === true) {
-        return true;
-    }
-    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
-    return parent != null && d[parent] === true;
-}
-
-export function isNwsPerEventToggleHidden(hiddenMap, eventName) {
-    const h = hiddenMap ?? {};
-    if (typeof h[eventName] === 'boolean') return h[eventName] === true;
-    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
-    return parent != null && h[parent] === true;
-}
-
-export function resolveNwsAlertUserFillOpacity(fillOpacity, eventName) {
-    const fo = fillOpacity ?? {};
-    const own = fo[eventName];
-    if (typeof own === 'number' && Number.isFinite(own)) return own;
-    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
-    if (parent) {
-        const p = fo[parent];
-        if (typeof p === 'number' && Number.isFinite(p)) return p;
-    }
-    return undefined;
-}
-
-export function resolveNwsAlertLineStyleForEvent(lineStyles, eventName) {
-    return (lineStyles ?? {})[eventName];
-}
-
-export function resolveNwsAlertLineWidths(override, baseWidth) {
-    const o = override ?? {};
-    const innerW =
-        typeof o.innerWidth === 'number' && Number.isFinite(o.innerWidth) && o.innerWidth > 0
-            ? o.innerWidth
-            : baseWidth;
-    let outerW = innerW;
-    if (typeof o.casingRatio === 'number' && Number.isFinite(o.casingRatio) && o.casingRatio >= 1) {
-        outerW = innerW * o.casingRatio;
-    } else if (typeof o.outerWidth === 'number' && Number.isFinite(o.outerWidth) && o.outerWidth > 0) {
-        outerW = Math.max(innerW, o.outerWidth);
-    }
-    return { innerW, outerW };
-}
-
-function mergeNwsLineStyleDefinedKeys(builtin, user) {
-    const b = { ...(builtin ?? {}) };
-    const u = user ?? {};
-    for (const k of ['innerColor', 'outerColor', 'innerWidth', 'outerWidth', 'casingRatio', 'lineDash']) {
-        if (u[k] !== undefined) b[k] = u[k];
-    }
-    return b;
-}
-
-export function getNwsBuiltinLineStyleForEvent(eventName, fillHex) {
-    switch (eventName) {
-        case 'Tornado Warning (PDS)':
-        case 'Severe Thunderstorm Warning (Considerable)':
-        case 'Flash Flood Warning (Considerable)':
-            return {
-                outerColor: '#000000',
-                innerColor: fillHex,
-                casingRatio: 1.5,
-            };
-        case 'Tornado Warning (Emergency)':
-        case 'Severe Thunderstorm Warning (Destructive)':
-        case 'Flash Flood Warning (Emergency)':
-            return {
-                innerColor: '#FFFFFF',
-                outerColor: fillHex,
-                casingRatio: 1.6,
-            };
-        default:
-            break;
-    }
-    if (NWS_DEFAULT_FILL_HIDDEN[eventName] === true) {
-        return {
-            outerColor: '#000000',
-            innerWidth: 3,
-            casingRatio: 1.4,
-        };
-    }
-    return undefined;
-}
-
-export function resolveNwsAlertLineStyleWithBuiltin(lineStyles, eventName, fillHex) {
-    const user = resolveNwsAlertLineStyleForEvent(lineStyles ?? {}, eventName);
-    const builtin = getNwsBuiltinLineStyleForEvent(eventName, fillHex);
-    return mergeNwsLineStyleDefinedKeys(builtin, user);
-}
-
-export function darkenHex(hex, factor = 0.75) {
-    const m = hex.match(/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i) ?? hex.match(/^#?([a-f\d])([a-f\d])([a-f\d])$/i);
-    if (!m) return hex;
-    const toNum = (s) => parseInt(s.length === 1 ? s + s : s, 16);
-    const r = Math.round(toNum(m[1]) * factor);
-    const g = Math.round(toNum(m[2]) * factor);
-    const b = Math.round(toNum(m[3]) * factor);
-    return `#${[r, g, b]
-        .map((x) => Math.max(0, Math.min(255, x)).toString(16).padStart(2, '0'))
-        .join('')}`;
-}
-
-const WARNING_DEFAULT_COLOR = { fill: '#f59e0b', stroke: '#d97706' };
-
-export function getWarningColorsForEvent(eventName, userSettings) {
-    if (!eventName || typeof eventName !== 'string') return WARNING_DEFAULT_COLOR;
-    const key = eventName.trim();
-    const fill = resolveNwsAlertUserColor(userSettings?.colors ?? {}, key) ?? NWS_EVENT_COLORS[key];
-    if (!fill) return WARNING_DEFAULT_COLOR;
-    return { fill, stroke: darkenHex(fill) };
-}
-
-const NWS_EMPHASIS_OUTLINE_MIN_INNER_PX = 3.5;
-
-function nwsEventIsEmphasisOutline(eventName) {
-    return (
-        eventName.startsWith('Tornado ') ||
-        eventName.startsWith('Severe Thunderstorm ') ||
-        eventName.startsWith('Flash Flood ')
-    );
-}
-
-/**
- * Union of built-in convective names plus any keys referenced in user settings (so Mapbox `match`
- * expressions include per-event colors/toggles for arbitrary alert types).
- * @param {object} [settings]
- * @returns {string[]}
- */
-export function collectNwsExpressionEventKeys(settings) {
-    const s = new Set(NWS_ALERT_EVENT_NAMES);
-    const addObj = (o) => {
-        if (!o || typeof o !== 'object') return;
-        for (const k of Object.keys(o)) {
-            if (k) s.add(k);
-        }
-    };
-    if (settings && typeof settings === 'object') {
-        addObj(settings.colors);
-        if (Array.isArray(settings.includedAlerts)) {
-            for (const name of settings.includedAlerts) {
-                if (name != null && String(name).trim() !== '') {
-                    s.add(String(name).trim());
-                }
-            }
-        }
-        addObj(settings.fillHidden);
-        addObj(settings.lineHidden);
-        addObj(settings.fillOpacity);
-        addObj(settings.lineStyles);
-        addObj(settings.flashStyles);
-    }
-    return [...s].sort((a, b) => a.localeCompare(b));
-}
-
-export function buildNwsDualLinePaint(userColors, lineStyles, baseWidth, eventNames) {
-    const names = eventNames ?? collectNwsExpressionEventKeys({ colors: userColors, lineStyles });
-    const casingColorPairs = [];
-    const coreColorPairs = [];
-    const casingWidthParts = [];
-    const coreWidthParts = [];
-
-    for (const name of names) {
-        const fill =
-            resolveNwsAlertUserColor(userColors, name) ?? NWS_EVENT_COLORS[name] ?? WARNING_DEFAULT_COLOR.fill;
-        const strokeDefault = darkenHex(fill);
-        const o = resolveNwsAlertLineStyleWithBuiltin(lineStyles, name, fill);
-        let { innerW, outerW } = resolveNwsAlertLineWidths(o, baseWidth);
-        const userLineOnly = resolveNwsAlertLineStyleForEvent(lineStyles ?? {}, name);
-        const u = userLineOnly;
-        const userCustomLineWidth =
-            (typeof u?.innerWidth === 'number' && Number.isFinite(u.innerWidth) && u.innerWidth > 0) ||
-            (typeof u?.outerWidth === 'number' && Number.isFinite(u.outerWidth) && u.outerWidth > 0) ||
-            (typeof u?.casingRatio === 'number' && Number.isFinite(u.casingRatio) && u.casingRatio >= 1);
-        if (nwsEventIsEmphasisOutline(name) && !userCustomLineWidth && innerW < NWS_EMPHASIS_OUTLINE_MIN_INNER_PX) {
-            const scale = NWS_EMPHASIS_OUTLINE_MIN_INNER_PX / innerW;
-            innerW = NWS_EMPHASIS_OUTLINE_MIN_INNER_PX;
-            outerW = Math.max(outerW * scale, innerW * 1.12);
-        }
-        const innerC =
-            typeof o?.innerColor === 'string' && o.innerColor.trim() !== '' ? o.innerColor : strokeDefault;
-        let outerC = typeof o?.outerColor === 'string' && o.outerColor.trim() !== '' ? o.outerColor : innerC;
-        if (outerW <= innerW) {
-            outerC = innerC;
-        }
-        casingColorPairs.push(name, outerC);
-        coreColorPairs.push(name, innerC);
-        casingWidthParts.push(name, outerW);
-        coreWidthParts.push(name, innerW);
-    }
-
-    return {
-        casingColor: ['match', ['get', 'event_name'], ...casingColorPairs, WARNING_DEFAULT_COLOR.stroke],
-        coreColor: ['match', ['get', 'event_name'], ...coreColorPairs, WARNING_DEFAULT_COLOR.stroke],
-        casingWidth: ['match', ['get', 'event_name'], ...casingWidthParts, baseWidth],
-        coreWidth: ['match', ['get', 'event_name'], ...coreWidthParts, baseWidth],
-    };
-}
-
-export function buildNwsFillColorExpression(userColors, eventNames) {
-    const names = eventNames ?? collectNwsExpressionEventKeys({ colors: userColors });
-    const pairs = [];
-    for (const name of names) {
-        pairs.push(
-            name,
-            resolveNwsAlertUserColor(userColors, name) ?? NWS_EVENT_COLORS[name] ?? WARNING_DEFAULT_COLOR.fill
-        );
-    }
-    return ['match', ['get', 'event_name'], ...pairs, WARNING_DEFAULT_COLOR.fill];
-}
-
-function buildNwsPerEventFillFactorExpr(fillHidden, fillOpacityByEvent, eventNames) {
-    const fh = fillHidden ?? {};
-    const fo = fillOpacityByEvent ?? {};
-    const pairs = [];
-    const names = eventNames ?? collectNwsExpressionEventKeys({ fillHidden: fh, fillOpacity: fo });
-    for (const name of names) {
-        const hidden = isNwsPerEventToggleHidden(fh, name);
-        const raw = resolveNwsAlertUserFillOpacity(fo, name);
-        const scale =
-            typeof raw === 'number' && Number.isFinite(raw) ? Math.max(0, Math.min(1, raw)) : NWS_DEFAULT_FILL_OPACITY;
-        pairs.push(name, hidden ? 0 : scale);
-    }
-    return ['match', ['get', 'event_name'], ...pairs, NWS_DEFAULT_FILL_OPACITY];
-}
-
-function buildNwsPerEventLineFactorExpr(lineHidden, eventNames) {
-    const lh = lineHidden ?? {};
-    const pairs = [];
-    const names = eventNames ?? collectNwsExpressionEventKeys({ lineHidden: lh });
-    for (const name of names) {
-        pairs.push(name, isNwsPerEventToggleHidden(lh, name) ? 0 : 1);
-    }
-    return ['match', ['get', 'event_name'], ...pairs, 1];
-}
-
-export function buildWarningsFillOpacityExpr(visible, fillOpacity, fillHidden, fillOpacityByEvent, eventNames) {
-    const factor = buildNwsPerEventFillFactorExpr(fillHidden, fillOpacityByEvent, eventNames);
-    const base = visible ? fillOpacity : 0;
-    return ['*', base, factor];
-}
-
-export function buildWarningsLineOpacityExpr(visible, lineOpacity, lineHidden, eventNames) {
-    const factor = buildNwsPerEventLineFactorExpr(lineHidden, eventNames);
-    const base = visible ? lineOpacity : 0;
-    return ['*', base, factor];
-}
-
-function nwsWarningsLineDashLiteral(mode) {
-    if (!mode || mode === 'solid') return null;
-    if (mode === 'dash') return [3, 2];
-    return [0.5, 2];
-}
-
-function nwsLineDasharrayExprForMode(mode) {
-    const lit = nwsWarningsLineDashLiteral(mode);
-    if (lit == null) {
-        return ['literal', [1, 0]];
-    }
-    return ['literal', lit];
-}
-
-/**
- * Literal-only dash pattern for one {@link NwsWatchesWarningsOverlay} line mode (`solid` | `dash` | `dot`).
- * Use where Mapbox RN cannot apply data-driven `line-dasharray` (see {@link buildNwsLineDasharrayExpression}).
- */
-export function buildNwsLineDasharrayLiteralExpression(mode) {
-    return nwsLineDasharrayExprForMode(mode);
-}
-
-function resolveNwsAlertLineStyleForEventDash(lineStyles, name, defaultMode) {
-    return resolveNwsAlertLineStyleForEvent(lineStyles, name)?.lineDash ?? defaultMode;
-}
-
-export function buildNwsLineDasharrayExpression(lineStyles, defaultMode, eventNames) {
-    const names = eventNames ?? collectNwsExpressionEventKeys({ lineStyles });
-    const pairs = [];
-    for (const name of names) {
-        const mode = resolveNwsAlertLineStyleForEventDash(lineStyles, name, defaultMode);
-        pairs.push(name, nwsLineDasharrayExprForMode(mode));
-    }
-    return ['match', ['get', 'event_name'], ...pairs, nwsLineDasharrayExprForMode(defaultMode)];
-}
-
-/** @deprecated Mapbox layers no longer use a `disabled` filter; scope is applied to GeoJSON (`alertScope` / `includedAlerts`). */
-export function buildNwsDisabledFilterExpr(disabled) {
-    if (!disabled) return undefined;
-    const disabledNames = new Set();
-    for (const [key, val] of Object.entries(disabled)) {
-        if (val === true) disabledNames.add(key);
-    }
-    for (const subtype of Object.keys(NWS_WARNINGS_SUBTYPE_PARENT)) {
-        if (isNwsAlertDisabled(disabled, subtype)) {
-            disabledNames.add(subtype);
-        }
-    }
-    if (disabled['Tornado Warning (Reported)'] === true) {
-        disabledNames.add('Tornado Warning (Observed)');
-    }
-    if (disabledNames.size === 0) return undefined;
-    return ['!', ['in', ['get', 'event_name'], ['literal', Array.from(disabledNames)]]];
-}
+/**
+ * NWS alert styling defaults — palette from `nwsEventColorsDefaults.js` (synced with
+ * aguacero-frontend `defaultColormaps`). Unknown CAP event names still fall back to
+ * {@link WARNING_DEFAULT_COLOR}.
+ */
+
+import { NWS_ALERT_EVENT_NAMES, NWS_EVENT_COLORS } from './nwsEventColorsDefaults.js';
+
+export { NWS_ALERT_EVENT_NAMES, NWS_EVENT_COLORS };
+
+/** @deprecated Use {@link NWS_EVENT_COLORS}. */
+export const NWS_SDK_EVENT_COLOR = NWS_EVENT_COLORS;
+
+/** @deprecated Use {@link NWS_ALERT_EVENT_NAMES}. */
+export const NWS_SDK_EVENT_NAMES = NWS_ALERT_EVENT_NAMES;
+
+export const NWS_DEFAULT_FILL_OPACITY = 0.5;
+
+/** Warnings outline-only by default for convective + flash-flood warnings — same as aguacero-frontend. */
+export const NWS_DEFAULT_FILL_HIDDEN = Object.fromEntries(
+    [
+        'Tornado Warning',
+        'Tornado Warning (Observed)',
+        'Tornado Warning (PDS)',
+        'Tornado Warning (Emergency)',
+        'Severe Thunderstorm Warning',
+        'Severe Thunderstorm Warning (Considerable)',
+        'Severe Thunderstorm Warning (Destructive)',
+        'Flash Flood Warning',
+        'Flash Flood Warning (Considerable)',
+        'Flash Flood Warning (Emergency)',
+        'Flash Flood Statement',
+    ].map((name) => [name, true])
+);
+
+export const NWS_WARNINGS_SUBTYPE_PARENT = {
+    'Tornado Warning (Observed)': 'Tornado Warning',
+    'Tornado Warning (PDS)': 'Tornado Warning',
+    'Tornado Warning (Emergency)': 'Tornado Warning',
+    'Severe Thunderstorm Warning (Considerable)': 'Severe Thunderstorm Warning',
+    'Severe Thunderstorm Warning (Destructive)': 'Severe Thunderstorm Warning',
+    'Flash Flood Warning (Considerable)': 'Flash Flood Warning',
+    'Flash Flood Warning (Emergency)': 'Flash Flood Warning',
+};
+
+export const NWS_ALERT_END_TIME_PROP_KEYS = ['ends', 'expires', 'expires_at'];
+
+export function resolveNwsAlertUserColor(userColors, eventName) {
+    const uc = userColors ?? {};
+    const own = uc[eventName];
+    if (own != null && String(own).trim() !== '') return own;
+    if (eventName === 'Tornado Warning (Observed)') {
+        const legacy = uc['Tornado Warning (Reported)'];
+        if (legacy != null && String(legacy).trim() !== '') return legacy;
+    }
+    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
+    if (parent) {
+        const p = uc[parent];
+        if (p != null && String(p).trim() !== '') return p;
+    }
+    return undefined;
+}
+
+export function isNwsAlertDisabled(disabled, eventName) {
+    const d = disabled ?? {};
+    if (d[eventName] === true) return true;
+    if (eventName === 'Tornado Warning (Observed)' && d['Tornado Warning (Reported)'] === true) {
+        return true;
+    }
+    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
+    return parent != null && d[parent] === true;
+}
+
+export function isNwsPerEventToggleHidden(hiddenMap, eventName) {
+    const h = hiddenMap ?? {};
+    if (typeof h[eventName] === 'boolean') return h[eventName] === true;
+    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
+    return parent != null && h[parent] === true;
+}
+
+export function resolveNwsAlertUserFillOpacity(fillOpacity, eventName) {
+    const fo = fillOpacity ?? {};
+    const own = fo[eventName];
+    if (typeof own === 'number' && Number.isFinite(own)) return own;
+    const parent = NWS_WARNINGS_SUBTYPE_PARENT[eventName];
+    if (parent) {
+        const p = fo[parent];
+        if (typeof p === 'number' && Number.isFinite(p)) return p;
+    }
+    return undefined;
+}
+
+export function resolveNwsAlertLineStyleForEvent(lineStyles, eventName) {
+    return (lineStyles ?? {})[eventName];
+}
+
+export function resolveNwsAlertLineWidths(override, baseWidth) {
+    const o = override ?? {};
+    const innerW =
+        typeof o.innerWidth === 'number' && Number.isFinite(o.innerWidth) && o.innerWidth > 0
+            ? o.innerWidth
+            : baseWidth;
+    let outerW = innerW;
+    if (typeof o.casingRatio === 'number' && Number.isFinite(o.casingRatio) && o.casingRatio >= 1) {
+        outerW = innerW * o.casingRatio;
+    } else if (typeof o.outerWidth === 'number' && Number.isFinite(o.outerWidth) && o.outerWidth > 0) {
+        outerW = Math.max(innerW, o.outerWidth);
+    }
+    return { innerW, outerW };
+}
+
+function mergeNwsLineStyleDefinedKeys(builtin, user) {
+    const b = { ...(builtin ?? {}) };
+    const u = user ?? {};
+    for (const k of ['innerColor', 'outerColor', 'innerWidth', 'outerWidth', 'casingRatio', 'lineDash']) {
+        if (u[k] !== undefined) b[k] = u[k];
+    }
+    return b;
+}
+
+export function getNwsBuiltinLineStyleForEvent(eventName, fillHex) {
+    switch (eventName) {
+        case 'Tornado Warning (PDS)':
+        case 'Severe Thunderstorm Warning (Considerable)':
+        case 'Flash Flood Warning (Considerable)':
+            return {
+                outerColor: '#000000',
+                innerColor: fillHex,
+                casingRatio: 1.5,
+            };
+        case 'Tornado Warning (Emergency)':
+        case 'Severe Thunderstorm Warning (Destructive)':
+        case 'Flash Flood Warning (Emergency)':
+            return {
+                innerColor: '#FFFFFF',
+                outerColor: fillHex,
+                casingRatio: 1.6,
+            };
+        default:
+            break;
+    }
+    if (NWS_DEFAULT_FILL_HIDDEN[eventName] === true) {
+        return {
+            outerColor: '#000000',
+            innerWidth: 3,
+            casingRatio: 1.4,
+        };
+    }
+    return undefined;
+}
+
+export function resolveNwsAlertLineStyleWithBuiltin(lineStyles, eventName, fillHex) {
+    const user = resolveNwsAlertLineStyleForEvent(lineStyles ?? {}, eventName);
+    const builtin = getNwsBuiltinLineStyleForEvent(eventName, fillHex);
+    return mergeNwsLineStyleDefinedKeys(builtin, user);
+}
+
+export function darkenHex(hex, factor = 0.75) {
+    const m = hex.match(/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i) ?? hex.match(/^#?([a-f\d])([a-f\d])([a-f\d])$/i);
+    if (!m) return hex;
+    const toNum = (s) => parseInt(s.length === 1 ? s + s : s, 16);
+    const r = Math.round(toNum(m[1]) * factor);
+    const g = Math.round(toNum(m[2]) * factor);
+    const b = Math.round(toNum(m[3]) * factor);
+    return `#${[r, g, b]
+        .map((x) => Math.max(0, Math.min(255, x)).toString(16).padStart(2, '0'))
+        .join('')}`;
+}
+
+const WARNING_DEFAULT_COLOR = { fill: '#f59e0b', stroke: '#d97706' };
+
+export function getWarningColorsForEvent(eventName, userSettings) {
+    if (!eventName || typeof eventName !== 'string') return WARNING_DEFAULT_COLOR;
+    const key = eventName.trim();
+    const fill = resolveNwsAlertUserColor(userSettings?.colors ?? {}, key) ?? NWS_EVENT_COLORS[key];
+    if (!fill) return WARNING_DEFAULT_COLOR;
+    return { fill, stroke: darkenHex(fill) };
+}
+
+const NWS_EMPHASIS_OUTLINE_MIN_INNER_PX = 3.5;
+
+function nwsEventIsEmphasisOutline(eventName) {
+    return (
+        eventName.startsWith('Tornado ') ||
+        eventName.startsWith('Severe Thunderstorm ') ||
+        eventName.startsWith('Flash Flood ')
+    );
+}
+
+/**
+ * Union of built-in convective names plus any keys referenced in user settings (so Mapbox `match`
+ * expressions include per-event colors/toggles for arbitrary alert types).
+ * @param {object} [settings]
+ * @returns {string[]}
+ */
+export function collectNwsExpressionEventKeys(settings) {
+    const s = new Set(NWS_ALERT_EVENT_NAMES);
+    const addObj = (o) => {
+        if (!o || typeof o !== 'object') return;
+        for (const k of Object.keys(o)) {
+            if (k) s.add(k);
+        }
+    };
+    if (settings && typeof settings === 'object') {
+        addObj(settings.colors);
+        if (Array.isArray(settings.includedAlerts)) {
+            for (const name of settings.includedAlerts) {
+                if (name != null && String(name).trim() !== '') {
+                    s.add(String(name).trim());
+                }
+            }
+        }
+        addObj(settings.fillHidden);
+        addObj(settings.lineHidden);
+        addObj(settings.fillOpacity);
+        addObj(settings.lineStyles);
+        addObj(settings.flashStyles);
+    }
+    return [...s].sort((a, b) => a.localeCompare(b));
+}
+
+export function buildNwsDualLinePaint(userColors, lineStyles, baseWidth, eventNames) {
+    const names = eventNames ?? collectNwsExpressionEventKeys({ colors: userColors, lineStyles });
+    const casingColorPairs = [];
+    const coreColorPairs = [];
+    const casingWidthParts = [];
+    const coreWidthParts = [];
+
+    for (const name of names) {
+        const fill =
+            resolveNwsAlertUserColor(userColors, name) ?? NWS_EVENT_COLORS[name] ?? WARNING_DEFAULT_COLOR.fill;
+        const strokeDefault = darkenHex(fill);
+        const o = resolveNwsAlertLineStyleWithBuiltin(lineStyles, name, fill);
+        let { innerW, outerW } = resolveNwsAlertLineWidths(o, baseWidth);
+        const userLineOnly = resolveNwsAlertLineStyleForEvent(lineStyles ?? {}, name);
+        const u = userLineOnly;
+        const userCustomLineWidth =
+            (typeof u?.innerWidth === 'number' && Number.isFinite(u.innerWidth) && u.innerWidth > 0) ||
+            (typeof u?.outerWidth === 'number' && Number.isFinite(u.outerWidth) && u.outerWidth > 0) ||
+            (typeof u?.casingRatio === 'number' && Number.isFinite(u.casingRatio) && u.casingRatio >= 1);
+        if (nwsEventIsEmphasisOutline(name) && !userCustomLineWidth && innerW < NWS_EMPHASIS_OUTLINE_MIN_INNER_PX) {
+            const scale = NWS_EMPHASIS_OUTLINE_MIN_INNER_PX / innerW;
+            innerW = NWS_EMPHASIS_OUTLINE_MIN_INNER_PX;
+            outerW = Math.max(outerW * scale, innerW * 1.12);
+        }
+        const innerC =
+            typeof o?.innerColor === 'string' && o.innerColor.trim() !== '' ? o.innerColor : strokeDefault;
+        let outerC = typeof o?.outerColor === 'string' && o.outerColor.trim() !== '' ? o.outerColor : innerC;
+        if (outerW <= innerW) {
+            outerC = innerC;
+        }
+        casingColorPairs.push(name, outerC);
+        coreColorPairs.push(name, innerC);
+        casingWidthParts.push(name, outerW);
+        coreWidthParts.push(name, innerW);
+    }
+
+    return {
+        casingColor: ['match', ['get', 'event_name'], ...casingColorPairs, WARNING_DEFAULT_COLOR.stroke],
+        coreColor: ['match', ['get', 'event_name'], ...coreColorPairs, WARNING_DEFAULT_COLOR.stroke],
+        casingWidth: ['match', ['get', 'event_name'], ...casingWidthParts, baseWidth],
+        coreWidth: ['match', ['get', 'event_name'], ...coreWidthParts, baseWidth],
+    };
+}
+
+export function buildNwsFillColorExpression(userColors, eventNames) {
+    const names = eventNames ?? collectNwsExpressionEventKeys({ colors: userColors });
+    const pairs = [];
+    for (const name of names) {
+        pairs.push(
+            name,
+            resolveNwsAlertUserColor(userColors, name) ?? NWS_EVENT_COLORS[name] ?? WARNING_DEFAULT_COLOR.fill
+        );
+    }
+    return ['match', ['get', 'event_name'], ...pairs, WARNING_DEFAULT_COLOR.fill];
+}
+
+function buildNwsPerEventFillFactorExpr(fillHidden, fillOpacityByEvent, eventNames) {
+    const fh = fillHidden ?? {};
+    const fo = fillOpacityByEvent ?? {};
+    const pairs = [];
+    const names = eventNames ?? collectNwsExpressionEventKeys({ fillHidden: fh, fillOpacity: fo });
+    for (const name of names) {
+        const hidden = isNwsPerEventToggleHidden(fh, name);
+        const raw = resolveNwsAlertUserFillOpacity(fo, name);
+        const scale =
+            typeof raw === 'number' && Number.isFinite(raw) ? Math.max(0, Math.min(1, raw)) : NWS_DEFAULT_FILL_OPACITY;
+        pairs.push(name, hidden ? 0 : scale);
+    }
+    return ['match', ['get', 'event_name'], ...pairs, NWS_DEFAULT_FILL_OPACITY];
+}
+
+function buildNwsPerEventLineFactorExpr(lineHidden, eventNames) {
+    const lh = lineHidden ?? {};
+    const pairs = [];
+    const names = eventNames ?? collectNwsExpressionEventKeys({ lineHidden: lh });
+    for (const name of names) {
+        pairs.push(name, isNwsPerEventToggleHidden(lh, name) ? 0 : 1);
+    }
+    return ['match', ['get', 'event_name'], ...pairs, 1];
+}
+
+export function buildWarningsFillOpacityExpr(visible, fillOpacity, fillHidden, fillOpacityByEvent, eventNames) {
+    const factor = buildNwsPerEventFillFactorExpr(fillHidden, fillOpacityByEvent, eventNames);
+    const base = visible ? fillOpacity : 0;
+    return ['*', base, factor];
+}
+
+export function buildWarningsLineOpacityExpr(visible, lineOpacity, lineHidden, eventNames) {
+    const factor = buildNwsPerEventLineFactorExpr(lineHidden, eventNames);
+    const base = visible ? lineOpacity : 0;
+    return ['*', base, factor];
+}
+
+function nwsWarningsLineDashLiteral(mode) {
+    if (!mode || mode === 'solid') return null;
+    if (mode === 'dash') return [3, 2];
+    return [0.5, 2];
+}
+
+function nwsLineDasharrayExprForMode(mode) {
+    const lit = nwsWarningsLineDashLiteral(mode);
+    if (lit == null) {
+        return ['literal', [1, 0]];
+    }
+    return ['literal', lit];
+}
+
+/**
+ * Literal-only dash pattern for one {@link NwsWatchesWarningsOverlay} line mode (`solid` | `dash` | `dot`).
+ * Use where Mapbox RN cannot apply data-driven `line-dasharray` (see {@link buildNwsLineDasharrayExpression}).
+ */
+export function buildNwsLineDasharrayLiteralExpression(mode) {
+    return nwsLineDasharrayExprForMode(mode);
+}
+
+function resolveNwsAlertLineStyleForEventDash(lineStyles, name, defaultMode) {
+    return resolveNwsAlertLineStyleForEvent(lineStyles, name)?.lineDash ?? defaultMode;
+}
+
+export function buildNwsLineDasharrayExpression(lineStyles, defaultMode, eventNames) {
+    const names = eventNames ?? collectNwsExpressionEventKeys({ lineStyles });
+    const pairs = [];
+    for (const name of names) {
+        const mode = resolveNwsAlertLineStyleForEventDash(lineStyles, name, defaultMode);
+        pairs.push(name, nwsLineDasharrayExprForMode(mode));
+    }
+    return ['match', ['get', 'event_name'], ...pairs, nwsLineDasharrayExprForMode(defaultMode)];
+}
+
+/** @deprecated Mapbox layers no longer use a `disabled` filter; scope is applied to GeoJSON (`alertScope` / `includedAlerts`). */
+export function buildNwsDisabledFilterExpr(disabled) {
+    if (!disabled) return undefined;
+    const disabledNames = new Set();
+    for (const [key, val] of Object.entries(disabled)) {
+        if (val === true) disabledNames.add(key);
+    }
+    for (const subtype of Object.keys(NWS_WARNINGS_SUBTYPE_PARENT)) {
+        if (isNwsAlertDisabled(disabled, subtype)) {
+            disabledNames.add(subtype);
+        }
+    }
+    if (disabled['Tornado Warning (Reported)'] === true) {
+        disabledNames.add('Tornado Warning (Observed)');
+    }
+    if (disabledNames.size === 0) return undefined;
+    return ['!', ['in', ['get', 'event_name'], ['literal', Array.from(disabledNames)]]];
+}