@symbiote-native/engine 1.2.0 → 1.3.0

package/build/permissions-android/index.ios.js

@@ -0,0 +1,31 @@
+// PermissionsAndroid off Android: RN's PermissionsAndroid.js `Platform.OS !== 'android'` branches.
+// Each call warns that the module is Android-only (RN's own user-facing warning) and resolves a
+// fixed answer; nothing reaches native.
+import { ANDROID_ONLY_WARNING, CHECK_PERMISSION_DEPRECATED, PERMISSIONS, REQUEST_PERMISSION_DEPRECATED, RESULTS, } from './shared.js';
+export { PERMISSIONS, RESULTS, } from './shared.js';
+export const PermissionsAndroid = {
+    PERMISSIONS,
+    RESULTS,
+    checkPermission(_permission) {
+        console.warn(CHECK_PERMISSION_DEPRECATED);
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    check(_permission) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    requestPermission(_permission, _rationale) {
+        console.warn(REQUEST_PERMISSION_DEPRECATED);
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    request(_permission, _rationale) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(RESULTS.DENIED);
+    },
+    requestMultiple(_permissions) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve({});
+    },
+};

package/build/permissions-android/index.js

@@ -1,184 +1,3 @@
-// PermissionsAndroid module: JS wrapper over Android's runtime-permissions
-// model. Mirrors RN's Libraries/PermissionsAndroid/PermissionsAndroid.js,
-// exposing the modern API: check / request / requestMultiple /
-// shouldShowRequestPermissionRationale, plus the frozen PERMISSIONS and RESULTS
-// constant maps. Imperative JS->native calls with no Fabric view of their own,
-// like Vibration / Keyboard.
-//
-// symbiote is iOS-first and this module is Android-only, so it MUST degrade
-// gracefully when the native module is absent (on iOS, or headless). RN throws
-// "works only for Android"; we instead resolve a safe default + dlog so a
-// cross-platform smoke never hard-crashes the process. Never reject/throw
-// synchronously on a missing module.
-//
-// The native contract is confirmed from RN's TurboModule spec at
-// specs_DEPRECATED/modules/INativePermissionsAndroid.js (`'PermissionsAndroid'`):
-//   checkPermission(permission): Promise<boolean>
-//   requestPermission(permission): Promise<string>
-//   shouldShowRequestPermissionRationale(permission): Promise<boolean>
-//   requestMultiplePermissions(permissions): Promise<{[permission]: string}>
-import { getNativeModule } from '../native-modules/index.js';
-import { dlog } from '../debug.js';
-import { isBoolean } from '../type-guards.js';
-// The native module name RN registers this TurboModule under
-// (`TurboModuleRegistry.get<Spec>('PermissionsAndroid')`). NOTE: a module name is
-// only provable on a real host (a headless fake answers to any name); this name
-// is device-verify-pending.
-const PERMISSIONS_ANDROID_MODULE = 'PermissionsAndroid';
-// The runtime-permission result strings Android can return. Modeled as a frozen
-// `as const` map: the generated-style constant-map exception to "no magic
-// strings".
-export const RESULTS = Object.freeze({
-    GRANTED: 'granted',
-    DENIED: 'denied',
-    NEVER_ASK_AGAIN: 'never_ask_again',
-});
-// The full Android permission-string map, copied verbatim from RN's source.
-// Frozen `as const` constant map (the same string-map exception as RESULTS).
-export const PERMISSIONS = Object.freeze({
-    READ_CALENDAR: 'android.permission.READ_CALENDAR',
-    WRITE_CALENDAR: 'android.permission.WRITE_CALENDAR',
-    CAMERA: 'android.permission.CAMERA',
-    READ_CONTACTS: 'android.permission.READ_CONTACTS',
-    WRITE_CONTACTS: 'android.permission.WRITE_CONTACTS',
-    GET_ACCOUNTS: 'android.permission.GET_ACCOUNTS',
-    ACCESS_FINE_LOCATION: 'android.permission.ACCESS_FINE_LOCATION',
-    ACCESS_COARSE_LOCATION: 'android.permission.ACCESS_COARSE_LOCATION',
-    ACCESS_BACKGROUND_LOCATION: 'android.permission.ACCESS_BACKGROUND_LOCATION',
-    RECORD_AUDIO: 'android.permission.RECORD_AUDIO',
-    READ_PHONE_STATE: 'android.permission.READ_PHONE_STATE',
-    CALL_PHONE: 'android.permission.CALL_PHONE',
-    READ_CALL_LOG: 'android.permission.READ_CALL_LOG',
-    WRITE_CALL_LOG: 'android.permission.WRITE_CALL_LOG',
-    ADD_VOICEMAIL: 'com.android.voicemail.permission.ADD_VOICEMAIL',
-    READ_VOICEMAIL: 'com.android.voicemail.permission.READ_VOICEMAIL',
-    WRITE_VOICEMAIL: 'com.android.voicemail.permission.WRITE_VOICEMAIL',
-    USE_SIP: 'android.permission.USE_SIP',
-    PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS',
-    BODY_SENSORS: 'android.permission.BODY_SENSORS',
-    BODY_SENSORS_BACKGROUND: 'android.permission.BODY_SENSORS_BACKGROUND',
-    SEND_SMS: 'android.permission.SEND_SMS',
-    RECEIVE_SMS: 'android.permission.RECEIVE_SMS',
-    READ_SMS: 'android.permission.READ_SMS',
-    RECEIVE_WAP_PUSH: 'android.permission.RECEIVE_WAP_PUSH',
-    RECEIVE_MMS: 'android.permission.RECEIVE_MMS',
-    READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
-    READ_MEDIA_IMAGES: 'android.permission.READ_MEDIA_IMAGES',
-    READ_MEDIA_VIDEO: 'android.permission.READ_MEDIA_VIDEO',
-    READ_MEDIA_AUDIO: 'android.permission.READ_MEDIA_AUDIO',
-    READ_MEDIA_VISUAL_USER_SELECTED: 'android.permission.READ_MEDIA_VISUAL_USER_SELECTED',
-    WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
-    BLUETOOTH_CONNECT: 'android.permission.BLUETOOTH_CONNECT',
-    BLUETOOTH_SCAN: 'android.permission.BLUETOOTH_SCAN',
-    BLUETOOTH_ADVERTISE: 'android.permission.BLUETOOTH_ADVERTISE',
-    ACCESS_MEDIA_LOCATION: 'android.permission.ACCESS_MEDIA_LOCATION',
-    ACCEPT_HANDOVER: 'android.permission.ACCEPT_HANDOVER',
-    ACTIVITY_RECOGNITION: 'android.permission.ACTIVITY_RECOGNITION',
-    ANSWER_PHONE_CALLS: 'android.permission.ANSWER_PHONE_CALLS',
-    READ_PHONE_NUMBERS: 'android.permission.READ_PHONE_NUMBERS',
-    UWB_RANGING: 'android.permission.UWB_RANGING',
-    POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
-    NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
-});
-// Narrow the native string result into a known RESULTS value. Any unrecognized
-// string is passed through as a IPermissionStatus only when it matches; otherwise
-// we fall back to DENIED: a runtime guard at the trust boundary, not an `as`.
-function toPermissionStatus(value) {
-    if (value === RESULTS.GRANTED ||
-        value === RESULTS.DENIED ||
-        value === RESULTS.NEVER_ASK_AGAIN) {
-        return value;
-    }
-    return RESULTS.DENIED;
-}
-// Narrow the native requestMultiplePermissions() return into a per-permission
-// status map. Each value is run through toPermissionStatus; non-object returns
-// yield an empty map.
-function toStatusMap(value) {
-    const result = {};
-    if (typeof value !== 'object' || value === null)
-        return result;
-    for (const key of Object.keys(value)) {
-        result[key] = toPermissionStatus(Reflect.get(value, key));
-    }
-    return result;
-}
-// Resolved FRESH on every call, deliberately NOT memoized at module load. The original
-// self-contained module resolved once at import, but moving it into the engine made it a
-// shared singleton; a cached null would survive a module being linked later (or the headless
-// smoke flipping a fake module on after its first import). getNativeModule is a cheap proxy
-// lookup, so per-call resolution costs nothing and stays correct. Returns null on iOS / headless.
-function getModule() {
-    const module = getNativeModule(PERMISSIONS_ANDROID_MODULE);
-    dlog(`PermissionsAndroid: module ${module ? 'resolved' : 'NOT resolved (null)'}`);
-    return module;
-}
-export const PermissionsAndroid = {
-    PERMISSIONS,
-    RESULTS,
-    // Resolve whether a permission has already been granted. Without a native
-    // module (iOS / headless) resolve false. Never throw.
-    async check(permission) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.check -> module unavailable, resolving false');
-            return false;
-        }
-        dlog(`PermissionsAndroid.check -> ${permission}`);
-        const granted = await permissionsModule.checkPermission(permission);
-        return isBoolean(granted) ? granted : false;
-    },
-    // Prompt the user for a permission, resolving a RESULTS status. If a rationale
-    // is supplied and DialogManagerAndroid is present, show it first; otherwise
-    // proceed straight to the native request (dlog the skip). Without the
-    // PermissionsAndroid module resolve RESULTS.DENIED. Never throw.
-    async request(permission, rationale) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.request -> module unavailable, resolving DENIED');
-            return RESULTS.DENIED;
-        }
-        dlog(`PermissionsAndroid.request -> ${permission}`);
-        if (rationale !== undefined) {
-            const shouldShow = await permissionsModule.shouldShowRequestPermissionRationale(permission);
-            const dialogModule = getNativeModule('DialogManagerAndroid');
-            if (isBoolean(shouldShow) && shouldShow && dialogModule !== null) {
-                return new Promise((resolve, reject) => {
-                    dialogModule.showAlert(rationale, () => reject(new Error('Error showing rationale')), () => {
-                        permissionsModule
-                            .requestPermission(permission)
-                            .then(status => resolve(toPermissionStatus(status)))
-                            .catch(reject);
-                    });
-                });
-            }
-            dlog('PermissionsAndroid.request -> rationale skipped (DialogManagerAndroid unavailable)');
-        }
-        const status = await permissionsModule.requestPermission(permission);
-        return toPermissionStatus(status);
-    },
-    // Prompt for several permissions at once, resolving a per-permission status
-    // map. Without a native module resolve an empty map. Never throw.
-    async requestMultiple(permissions) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.requestMultiple -> module unavailable, resolving {}');
-            return {};
-        }
-        dlog(`PermissionsAndroid.requestMultiple -> ${permissions.join(', ')}`);
-        const statuses = await permissionsModule.requestMultiplePermissions(permissions);
-        return toStatusMap(statuses);
-    },
-    // Whether the OS recommends showing a rationale before re-requesting. Without
-    // a native module resolve false. Never throw.
-    async shouldShowRequestPermissionRationale(permission) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.shouldShowRequestPermissionRationale -> module unavailable, resolving false');
-            return false;
-        }
-        dlog(`PermissionsAndroid.shouldShowRequestPermissionRationale -> ${permission}`);
-        const shouldShow = await permissionsModule.shouldShowRequestPermissionRationale(permission);
-        return isBoolean(shouldShow) ? shouldShow : false;
-    },
-};
+// PermissionsAndroid: base / headless build. Metro picks index.android.ts / index.ios.ts on a
+// device; off those, RN's non-Android branch is the default.
+export * from './index.ios.js';

package/build/permissions-android/shared.d.ts

@@ -0,0 +1,63 @@
+export declare const PERMISSIONS_ANDROID_MODULE = "PermissionsAndroid";
+export declare const ANDROID_ONLY_WARNING = "\"PermissionsAndroid\" module works only for Android platform.";
+export declare const CHECK_PERMISSION_DEPRECATED = "\"PermissionsAndroid.checkPermission\" is deprecated. Use \"PermissionsAndroid.check\" instead";
+export declare const REQUEST_PERMISSION_DEPRECATED = "\"PermissionsAndroid.requestPermission\" is deprecated. Use \"PermissionsAndroid.request\" instead";
+export declare const RESULTS: Readonly<{
+    readonly GRANTED: "granted";
+    readonly DENIED: "denied";
+    readonly NEVER_ASK_AGAIN: "never_ask_again";
+}>;
+export type IPermissionStatus = (typeof RESULTS)[keyof typeof RESULTS];
+export declare const PERMISSIONS: Readonly<{
+    readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
+    readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
+    readonly CAMERA: "android.permission.CAMERA";
+    readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
+    readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
+    readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
+    readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
+    readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
+    readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
+    readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
+    readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
+    readonly CALL_PHONE: "android.permission.CALL_PHONE";
+    readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
+    readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
+    readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
+    readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
+    readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
+    readonly USE_SIP: "android.permission.USE_SIP";
+    readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
+    readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
+    readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
+    readonly SEND_SMS: "android.permission.SEND_SMS";
+    readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
+    readonly READ_SMS: "android.permission.READ_SMS";
+    readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
+    readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
+    readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
+    readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
+    readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
+    readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
+    readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
+    readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
+    readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
+    readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
+    readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
+    readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
+    readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
+    readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
+    readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
+    readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
+    readonly UWB_RANGING: "android.permission.UWB_RANGING";
+    readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
+    readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
+}>;
+export type IPermission = (typeof PERMISSIONS)[keyof typeof PERMISSIONS];
+export type IRationale = {
+    title: string;
+    message: string;
+    buttonPositive?: string;
+    buttonNegative?: string;
+    buttonNeutral?: string;
+};

package/build/permissions-android/shared.js

@@ -0,0 +1,66 @@
+// PermissionsAndroid, platform-neutral half: the frozen PERMISSIONS / RESULTS maps and the public
+// types, copied verbatim from RN's Libraries/PermissionsAndroid/PermissionsAndroid.js. The behavior
+// is per platform, as in RN: index.android.ts talks to the native module, index.ios.ts is RN's
+// `Platform.OS !== 'android'` branch.
+//
+// The native contract, from RN's TurboModule spec (`'PermissionsAndroid'`):
+//   checkPermission(permission): Promise<boolean>
+//   requestPermission(permission): Promise<string>
+//   shouldShowRequestPermissionRationale(permission): Promise<boolean>
+//   requestMultiplePermissions(permissions): Promise<{[permission]: string}>
+export const PERMISSIONS_ANDROID_MODULE = 'PermissionsAndroid';
+export const ANDROID_ONLY_WARNING = '"PermissionsAndroid" module works only for Android platform.';
+export const CHECK_PERMISSION_DEPRECATED = '"PermissionsAndroid.checkPermission" is deprecated. Use "PermissionsAndroid.check" instead';
+export const REQUEST_PERMISSION_DEPRECATED = '"PermissionsAndroid.requestPermission" is deprecated. Use "PermissionsAndroid.request" instead';
+// The runtime-permission result strings Android can return.
+export const RESULTS = Object.freeze({
+    GRANTED: 'granted',
+    DENIED: 'denied',
+    NEVER_ASK_AGAIN: 'never_ask_again',
+});
+// The full Android permission-string map, copied verbatim from RN's source.
+export const PERMISSIONS = Object.freeze({
+    READ_CALENDAR: 'android.permission.READ_CALENDAR',
+    WRITE_CALENDAR: 'android.permission.WRITE_CALENDAR',
+    CAMERA: 'android.permission.CAMERA',
+    READ_CONTACTS: 'android.permission.READ_CONTACTS',
+    WRITE_CONTACTS: 'android.permission.WRITE_CONTACTS',
+    GET_ACCOUNTS: 'android.permission.GET_ACCOUNTS',
+    ACCESS_FINE_LOCATION: 'android.permission.ACCESS_FINE_LOCATION',
+    ACCESS_COARSE_LOCATION: 'android.permission.ACCESS_COARSE_LOCATION',
+    ACCESS_BACKGROUND_LOCATION: 'android.permission.ACCESS_BACKGROUND_LOCATION',
+    RECORD_AUDIO: 'android.permission.RECORD_AUDIO',
+    READ_PHONE_STATE: 'android.permission.READ_PHONE_STATE',
+    CALL_PHONE: 'android.permission.CALL_PHONE',
+    READ_CALL_LOG: 'android.permission.READ_CALL_LOG',
+    WRITE_CALL_LOG: 'android.permission.WRITE_CALL_LOG',
+    ADD_VOICEMAIL: 'com.android.voicemail.permission.ADD_VOICEMAIL',
+    READ_VOICEMAIL: 'com.android.voicemail.permission.READ_VOICEMAIL',
+    WRITE_VOICEMAIL: 'com.android.voicemail.permission.WRITE_VOICEMAIL',
+    USE_SIP: 'android.permission.USE_SIP',
+    PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS',
+    BODY_SENSORS: 'android.permission.BODY_SENSORS',
+    BODY_SENSORS_BACKGROUND: 'android.permission.BODY_SENSORS_BACKGROUND',
+    SEND_SMS: 'android.permission.SEND_SMS',
+    RECEIVE_SMS: 'android.permission.RECEIVE_SMS',
+    READ_SMS: 'android.permission.READ_SMS',
+    RECEIVE_WAP_PUSH: 'android.permission.RECEIVE_WAP_PUSH',
+    RECEIVE_MMS: 'android.permission.RECEIVE_MMS',
+    READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
+    READ_MEDIA_IMAGES: 'android.permission.READ_MEDIA_IMAGES',
+    READ_MEDIA_VIDEO: 'android.permission.READ_MEDIA_VIDEO',
+    READ_MEDIA_AUDIO: 'android.permission.READ_MEDIA_AUDIO',
+    READ_MEDIA_VISUAL_USER_SELECTED: 'android.permission.READ_MEDIA_VISUAL_USER_SELECTED',
+    WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
+    BLUETOOTH_CONNECT: 'android.permission.BLUETOOTH_CONNECT',
+    BLUETOOTH_SCAN: 'android.permission.BLUETOOTH_SCAN',
+    BLUETOOTH_ADVERTISE: 'android.permission.BLUETOOTH_ADVERTISE',
+    ACCESS_MEDIA_LOCATION: 'android.permission.ACCESS_MEDIA_LOCATION',
+    ACCEPT_HANDOVER: 'android.permission.ACCEPT_HANDOVER',
+    ACTIVITY_RECOGNITION: 'android.permission.ACTIVITY_RECOGNITION',
+    ANSWER_PHONE_CALLS: 'android.permission.ANSWER_PHONE_CALLS',
+    READ_PHONE_NUMBERS: 'android.permission.READ_PHONE_NUMBERS',
+    UWB_RANGING: 'android.permission.UWB_RANGING',
+    POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
+    NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
+});

package/build/platform/index.android.js

@@ -3,7 +3,7 @@
 // from the PlatformConstants native module (RN spec NativePlatformConstantsAndroid.js,
 // a different payload from iOS). Metro picks this on an Android host. The module name is
 // the same 'PlatformConstants'; only the shape differs.
-import { createConstantsResolver, } from './shared.js';
+import { createConstantsResolver, gatedIsTesting, } from './shared.js';
 // The filename already selected this host: 'android' is a literal, not a probe.
 const OS_ANDROID = 'android';
 // RN reads isTV off the uiMode constant.
@@ -37,14 +37,12 @@ export const Platform = {
     get isVision() {
         return false;
     },
-    // RN gates this behind __DEV__; shared has no __DEV__ flag, so we read the native
-    // flag directly: a release build's native module reports false anyway.
     get isTesting() {
-        return resolveConstants()?.isTesting ?? false;
+        return gatedIsTesting(resolveConstants());
     },
     get isDisableAnimations() {
         const constants = resolveConstants();
-        return constants?.isDisableAnimations ?? constants?.isTesting ?? false;
+        return constants?.isDisableAnimations ?? gatedIsTesting(constants);
     },
     get isMacCatalyst() {
         return false;

package/build/platform/index.ios.js

@@ -3,7 +3,7 @@
 // (RN spec NativePlatformConstantsIOS.js), read lazily and cached via the shared
 // resolver. Metro picks this on an iOS host; it is also the base re-export target
 // (platform.ts) so tsc / tsx / web (no Metro) land here too.
-import { createConstantsResolver, UNKNOWN_VERSION, } from './shared.js';
+import { createConstantsResolver, gatedIsTesting, UNKNOWN_VERSION, } from './shared.js';
 // interfaceIdiom values RN compares against for the device-class getters.
 const IDIOM_PAD = 'pad';
 const IDIOM_TV = 'tv';
@@ -39,13 +39,13 @@ export const Platform = {
         return idiomEquals(IDIOM_VISION);
     },
     get isTesting() {
-        return resolveConstants()?.isTesting ?? false;
+        return gatedIsTesting(resolveConstants());
     },
     // RN: isDisableAnimations ?? isTesting. The native flag wins; absent, it tracks
     // isTesting (test runs disable animations by default).
     get isDisableAnimations() {
         const constants = resolveConstants();
-        return constants?.isDisableAnimations ?? constants?.isTesting ?? false;
+        return constants?.isDisableAnimations ?? gatedIsTesting(constants);
     },
     get isMacCatalyst() {
         return resolveConstants()?.isMacCatalyst ?? false;

package/build/platform/shared.d.ts

@@ -23,3 +23,7 @@ export interface IPlatformStatic<TConstants> {
     select<T>(spec: IPlatformSelectSpec<T>): T | undefined;
 }
 export declare function createConstantsResolver<TConstants>(guard: (value: unknown) => value is TConstants): () => TConstants | undefined;
+export declare function isDevBuild(): boolean;
+export declare function gatedIsTesting(constants: {
+    isTesting?: boolean;
+} | undefined): boolean;

package/build/platform/shared.js

@@ -38,3 +38,12 @@ export function createConstantsResolver(guard) {
         return cached;
     };
 }
+// Metro's `__DEV__` global: `true` in a dev bundle, `false` in release. Read off globalThis so a
+// host that never defines it (headless tooling) counts as release, like any unset flag.
+export function isDevBuild() {
+    return Reflect.get(globalThis, '__DEV__') === true;
+}
+// RN's `isTesting`: the native flag in a dev build only (`if (__DEV__) … return false`).
+export function gatedIsTesting(constants) {
+    return isDevBuild() && (constants?.isTesting ?? false);
+}

package/build/platform-color/index.android.d.ts

@@ -0,0 +1,4 @@
+import type { IDynamicColorIOSTuple, IOpaqueColorValue } from './shared';
+export * from './shared';
+export declare function PlatformColor(...names: string[]): IOpaqueColorValue;
+export declare function DynamicColorIOS(_tuple: IDynamicColorIOSTuple): IOpaqueColorValue;

package/build/platform-color/index.android.js

@@ -0,0 +1,7 @@
+export * from './shared.js';
+export function PlatformColor(...names) {
+    return { resource_paths: names };
+}
+export function DynamicColorIOS(_tuple) {
+    throw new Error('DynamicColorIOS is not available on this platform.');
+}

package/build/platform-color/index.d.ts

@@ -1,22 +1,4 @@
-export interface IDynamicColorIOSTuple {
-    light: IColorValue;
-    dark: IColorValue;
-    highContrastLight?: IColorValue;
-    highContrastDark?: IColorValue;
-}
-export interface IOpaqueColorValue {
-    readonly semantic?: readonly string[];
-    readonly dynamic?: {
-        readonly light: IColorValue;
-        readonly dark: IColorValue;
-        readonly highContrastLight?: IColorValue;
-        readonly highContrastDark?: IColorValue;
-    };
-}
-export type IColorValue = string | number | IOpaqueColorValue;
+import type { IDynamicColorIOSTuple, IOpaqueColorValue } from './shared';
+export * from './shared';
 export declare function PlatformColor(...names: string[]): IOpaqueColorValue;
 export declare function DynamicColorIOS(tuple: IDynamicColorIOSTuple): IOpaqueColorValue;
-export declare function isOpaqueColorValue(value: unknown): value is IOpaqueColorValue;
-export declare function setColorProcessor(process: (value: IColorValue) => unknown): void;
-export declare function processColor(color: IColorValue): unknown;
-export declare function isProcessableColor(value: unknown): value is IColorValue;

package/build/platform-color/index.js

@@ -1,10 +1,4 @@
-// PlatformColor / DynamicColorIOS: opaque color values the native side resolves
-// (iOS UIColor: semantic system colors and appearance-aware light/dark tuples).
-// These are pure object constructors with no native dependency, so they live in
-// shared and every adapter re-exports them. The opaque shape ({ semantic } /
-// { dynamic }) is exactly what RN's processColor and the iOS RCTConvert UIColor
-// path read, so our commit-time color seam routes these objects through the
-// injected processor just like CSS-string colors (see commit.ts processValue).
+export * from './shared.js';
 export function PlatformColor(...names) {
     return { semantic: names };
 }
@@ -18,41 +12,3 @@ export function DynamicColorIOS(tuple) {
         },
     };
 }
-// True for the opaque objects above: the color seam uses this to route them
-// through the platform processor alongside CSS-string colors.
-export function isOpaqueColorValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        ('semantic' in value || 'dynamic' in value));
-}
-// Color props must reach Fabric as platform ints, not CSS strings. Fabric's C++ color
-// parser silently drops strings. The actual conversion (processColor) is RN-platform-specific,
-// so it is injected here rather than imported, keeping shared free of a react-native dependency
-// (and the headless harness working). This module is the sole owner of "run a value through the
-// platform color processor" - every color-touching consumer (commit's fabricProps,
-// process-box-shadow, process-filter, process-background-image, StatusBar android) imports
-// processColor/isProcessableColor from here, never from commit.ts.
-let colorProcessor = value => value;
-export function setColorProcessor(process) {
-    colorProcessor = process;
-}
-// Public mirror of RN's processColor: run a color through the injected platform processor (the
-// canary wires RN's own). Off a real host it resolves CSS strings and opaque PlatformColor
-// objects to the platform ints Fabric expects; headless (no processor wired) it is the identity,
-// so smokes see the input unchanged.
-export function processColor(color) {
-    return colorProcessor(color);
-}
-// A color-keyed value the platform processor must convert before Fabric: a CSS string, a numeric
-// literal, or an opaque PlatformColor / DynamicColorIOS object. `undefined` is left untouched.
-//
-// A number used to be excluded here on the reasoning that it was "already a resolved platform
-// int". Nothing in the pipeline produces one: the CSS parser emits hex STRINGS, and fabricProps
-// builds a fresh payload object instead of writing the resolved value back into node.props, so a
-// number reaching this guard is always the author's own literal. Excluding it committed
-// `color: 0xff0000ff` (opaque red, rrggbbaa) unrotated, and native reads that as aarrggbb: blue.
-export function isProcessableColor(value) {
-    return (typeof value === 'string' ||
-        typeof value === 'number' ||
-        isOpaqueColorValue(value));
-}

package/build/platform-color/shared.d.ts

@@ -0,0 +1,21 @@
+export interface IDynamicColorIOSTuple {
+    light: IColorValue;
+    dark: IColorValue;
+    highContrastLight?: IColorValue;
+    highContrastDark?: IColorValue;
+}
+export interface IOpaqueColorValue {
+    readonly semantic?: readonly string[];
+    readonly resource_paths?: readonly string[];
+    readonly dynamic?: {
+        readonly light: IColorValue;
+        readonly dark: IColorValue;
+        readonly highContrastLight?: IColorValue;
+        readonly highContrastDark?: IColorValue;
+    };
+}
+export type IColorValue = string | number | IOpaqueColorValue;
+export declare function isOpaqueColorValue(value: unknown): value is IOpaqueColorValue;
+export declare function setColorProcessor(process: (value: IColorValue) => unknown): void;
+export declare function processColor(color: IColorValue): unknown;
+export declare function isProcessableColor(value: unknown): value is IColorValue;

package/build/platform-color/shared.js

@@ -0,0 +1,41 @@
+// PlatformColor / DynamicColorIOS: opaque colors native resolves. Constructors are per platform
+// because the shapes differ: iOS reads { semantic } / { dynamic } (PlatformColorParser.mm),
+// Android only { resource_paths } (ColorPropConverter). The C++ seam forwards the object as-is.
+// True for the opaque objects above: the color seam uses this to route them
+// through the platform processor alongside CSS-string colors.
+export function isOpaqueColorValue(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        ('semantic' in value || 'dynamic' in value || 'resource_paths' in value));
+}
+// Color props must reach Fabric as platform ints, not CSS strings. Fabric's C++ color
+// parser silently drops strings. The actual conversion (processColor) is RN-platform-specific,
+// so it is injected here rather than imported, keeping shared free of a react-native dependency
+// (and the headless harness working). This module is the sole owner of "run a value through the
+// platform color processor" - every color-touching consumer (commit's fabricProps,
+// process-box-shadow, process-filter, process-background-image, StatusBar android) imports
+// processColor/isProcessableColor from here, never from commit.ts.
+let colorProcessor = value => value;
+export function setColorProcessor(process) {
+    colorProcessor = process;
+}
+// Public mirror of RN's processColor: run a color through the injected platform processor (the
+// canary wires RN's own). Off a real host it resolves CSS strings and opaque PlatformColor
+// objects to the platform ints Fabric expects; headless (no processor wired) it is the identity,
+// so smokes see the input unchanged.
+export function processColor(color) {
+    return colorProcessor(color);
+}
+// A color-keyed value the platform processor must convert before Fabric: a CSS string, a numeric
+// literal, or an opaque PlatformColor / DynamicColorIOS object. `undefined` is left untouched.
+//
+// A number used to be excluded here on the reasoning that it was "already a resolved platform
+// int". Nothing in the pipeline produces one: the CSS parser emits hex STRINGS, and fabricProps
+// builds a fresh payload object instead of writing the resolved value back into node.props, so a
+// number reaching this guard is always the author's own literal. Excluding it committed
+// `color: 0xff0000ff` (opaque red, rrggbbaa) unrotated, and native reads that as aarrggbb: blue.
+export function isProcessableColor(value) {
+    return (typeof value === 'string' ||
+        typeof value === 'number' ||
+        isOpaqueColorValue(value));
+}

package/build/settings/index.android.d.ts

@@ -0,0 +1,6 @@
+export declare const Settings: {
+    get(_key: string): unknown;
+    set(_settings: Record<string, unknown>): void;
+    watchKeys(_keys: string | string[], _callback: () => void): number;
+    clearWatch(_watchId: number): void;
+};

package/build/settings/index.android.js

@@ -0,0 +1,21 @@
+// Settings, Android build: RN's SettingsFallback (Settings.js resolves to it off iOS). Android has
+// no SettingsManager, so every call warns and does nothing — no JS snapshot, no watchers. The
+// warning is RN's own user-facing one, not a diagnostic log.
+const UNSUPPORTED = 'Settings is not yet supported on this platform.';
+const NO_WATCH_ID = -1;
+export const Settings = {
+    get(_key) {
+        console.warn(UNSUPPORTED);
+        return null;
+    },
+    set(_settings) {
+        console.warn(UNSUPPORTED);
+    },
+    watchKeys(_keys, _callback) {
+        console.warn(UNSUPPORTED);
+        return NO_WATCH_ID;
+    },
+    clearWatch(_watchId) {
+        console.warn(UNSUPPORTED);
+    },
+};

package/build/settings/index.d.ts

@@ -1,8 +1 @@
-declare class SettingsImpl {
-    get(key: string): unknown;
-    set(settings: Record<string, unknown>): void;
-    watchKeys(keys: string | string[], callback: () => void): number;
-    clearWatch(watchId: number): void;
-}
-export declare const Settings: SettingsImpl;
-export {};
+export * from './index.ios';

package/build/settings/index.ios.d.ts

@@ -0,0 +1,8 @@
+declare class SettingsImpl {
+    get(key: string): unknown;
+    set(settings: Record<string, unknown>): void;
+    watchKeys(keys: string | string[], callback: () => void): number;
+    clearWatch(watchId: number): void;
+}
+export declare const Settings: SettingsImpl;
+export {};