@amazon-devices/expo-system-ui 2.0.1758683737

package/build/ExpoSystemUI.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoSystemUI.web.js","sourceRoot":"","sources":["../src/ExpoSystemUI.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,sBAAsB;AACtB,OAAO,cAAc,MAAM,kDAAkD,CAAC;AAE9E,eAAe;IACb,IAAI,IAAI;QACN,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,uBAAuB;QACrB,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC5B,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,uBAAuB,CAAC,KAAoB;QAC1C,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,IAAI,OAAO,CAAC;QACzD,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import { Platform } from 'expo-modules-core';\n// @ts-ignore: untyped\nimport normalizeColor from 'react-native-web/dist/cjs/modules/normalizeColor';\n\nexport default {\n  get name(): string {\n    return 'ExpoSystemUI';\n  },\n  getBackgroundColorAsync() {\n    if (Platform.isDOMAvailable) {\n      return normalizeColor(document.body.style.backgroundColor);\n    } else {\n      return null;\n    }\n  },\n  setBackgroundColorAsync(color: string | null) {\n    if (Platform.isDOMAvailable) {\n      document.body.style.backgroundColor = color ?? 'white';\n    }\n  },\n};\n"]}

package/build/SystemUI.d.ts

@@ -0,0 +1,23 @@
+import { ColorValue } from 'react-native';
+/**
+ * Changes the root view background color.
+ * Call this function in the root file outside of you component.
+ *
+ * @example
+ * ```ts
+ * SystemUI.setBackgroundColorAsync("black");
+ * ```
+ * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).
+ */
+export declare function setBackgroundColorAsync(color: ColorValue | null): Promise<void>;
+/**
+ * Gets the root view background color.
+ *
+ * @example
+ * ```ts
+ * const color = await SystemUI.getBackgroundColorAsync();
+ * ```
+ * @returns Current root view background color in hex format. Returns `null` if the background color is not set.
+ */
+export declare function getBackgroundColorAsync(): Promise<ColorValue | null>;
+//# sourceMappingURL=SystemUI.d.ts.map

package/build/SystemUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemUI.d.ts","sourceRoot":"","sources":["../src/SystemUI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAIlE;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrF;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE1E"}

package/build/SystemUI.js

@@ -0,0 +1,34 @@
+import { Platform, processColor } from 'react-native';
+import ExpoSystemUI from './ExpoSystemUI';
+/**
+ * Changes the root view background color.
+ * Call this function in the root file outside of you component.
+ *
+ * @example
+ * ```ts
+ * SystemUI.setBackgroundColorAsync("black");
+ * ```
+ * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).
+ */
+export async function setBackgroundColorAsync(color) {
+    if (color == null) {
+        return await ExpoSystemUI.setBackgroundColorAsync(null);
+    }
+    else {
+        const colorNumber = Platform.OS === 'web' ? color : processColor(color);
+        return await ExpoSystemUI.setBackgroundColorAsync(colorNumber);
+    }
+}
+/**
+ * Gets the root view background color.
+ *
+ * @example
+ * ```ts
+ * const color = await SystemUI.getBackgroundColorAsync();
+ * ```
+ * @returns Current root view background color in hex format. Returns `null` if the background color is not set.
+ */
+export async function getBackgroundColorAsync() {
+    return await ExpoSystemUI.getBackgroundColorAsync();
+}
+//# sourceMappingURL=SystemUI.js.map

package/build/SystemUI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemUI.js","sourceRoot":"","sources":["../src/SystemUI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAwB;IACpE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,YAAY,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,MAAM,YAAY,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;AACtD,CAAC","sourcesContent":["import { ColorValue, Platform, processColor } from 'react-native';\n\nimport ExpoSystemUI from './ExpoSystemUI';\n\n/**\n * Changes the root view background color.\n * Call this function in the root file outside of you component.\n *\n * @example\n * ```ts\n * SystemUI.setBackgroundColorAsync(\"black\");\n * ```\n * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).\n */\nexport async function setBackgroundColorAsync(color: ColorValue | null): Promise<void> {\n  if (color == null) {\n    return await ExpoSystemUI.setBackgroundColorAsync(null);\n  } else {\n    const colorNumber = Platform.OS === 'web' ? color : processColor(color);\n    return await ExpoSystemUI.setBackgroundColorAsync(colorNumber);\n  }\n}\n\n/**\n * Gets the root view background color.\n *\n * @example\n * ```ts\n * const color = await SystemUI.getBackgroundColorAsync();\n * ```\n * @returns Current root view background color in hex format. Returns `null` if the background color is not set.\n */\nexport async function getBackgroundColorAsync(): Promise<ColorValue | null> {\n  return await ExpoSystemUI.getBackgroundColorAsync();\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,10 @@
+{
+  "name": "expo-system-ui",
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["ExpoSystemUIModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.systemui.SystemUIModule"]
+  }
+}

package/ios/ExpoSystemUI/ExpoSystemUIModule.swift

@@ -0,0 +1,72 @@
+// Copyright 2021-present 650 Industries. (AKA Expo) All rights reserved.
+
+import ExpoModulesCore
+
+public class ExpoSystemUIModule: Module {
+  private static let colorKey = "ExpoSystemUI.backgroundColor"
+  public func definition() -> ModuleDefinition {
+    Name("ExpoSystemUI")
+
+    OnCreate {
+      // TODO: Maybe read from the app manifest instead of from Info.plist.
+      // Set / reset the initial color on reload and app start.
+      let color = UserDefaults.standard.integer(forKey: Self.colorKey)
+
+      if color > 0 {
+        Self.setBackgroundColorAsync(color: color)
+      } else {
+        Self.setBackgroundColorAsync(color: nil)
+      }
+    }
+
+    AsyncFunction("getBackgroundColorAsync") { () -> String? in
+      Self.getBackgroundColor()
+    }
+
+    AsyncFunction("setBackgroundColorAsync") { (color: Int?) in
+      Self.setBackgroundColorAsync(color: color)
+    }
+  }
+
+  static func getBackgroundColor() -> String? {
+    var color: String?
+    EXUtilities.performSynchronously {
+      // Get the root view controller of the delegate window.
+      if let window = UIApplication.shared.delegate?.window, let backgroundColor = window?.rootViewController?.view.backgroundColor?.cgColor {
+        color = EXUtilities.hexString(with: backgroundColor)
+      }
+    }
+    return color
+  }
+
+  static func setBackgroundColorAsync(color: Int?) {
+    EXUtilities.performSynchronously {
+      if color == nil {
+        if let window = UIApplication.shared.delegate?.window {
+          UserDefaults.standard.removeObject(forKey: colorKey)
+          let interfaceStyle = window?.traitCollection.userInterfaceStyle
+          window?.backgroundColor = nil
+
+          switch interfaceStyle {
+          case .dark:
+            window?.rootViewController?.view.backgroundColor = .black
+          case .light:
+            window?.rootViewController?.view.backgroundColor = .white
+          default:
+            window?.rootViewController?.view.backgroundColor = .white
+          }
+        }
+        return
+      }
+      UserDefaults.standard.set(color, forKey: colorKey)
+      let backgroundColor = EXUtilities.uiColor(color)
+      // Set the app-wide window, this could have future issues when running multiple React apps,
+      // i.e. dev client can't use expo-system-ui.
+      // Without setting the window backgroundColor, native-stack modals will show the wrong color.
+      if let window = UIApplication.shared.delegate?.window {
+        window?.backgroundColor = backgroundColor
+        window?.rootViewController?.view.backgroundColor = backgroundColor
+      }
+    }
+  }
+}

package/ios/ExpoSystemUI.podspec

@@ -0,0 +1,31 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExpoSystemUI'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platform       = :ios, '13.0'
+  s.swift_version  = '5.4'
+  s.source         = { git: 'https://github.com/expo/expo.git' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES'
+  }
+
+  if !$ExpoUseSources&.include?(package['name']) && ENV['EXPO_USE_SOURCE'].to_i == 0 && File.exist?("#{s.name}.xcframework") && Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.10.0')
+    s.source_files = "#{s.name}/**/*.h"
+    s.vendored_frameworks = "#{s.name}.xcframework"
+  else
+    s.source_files = "#{s.name}/**/*.{h,m,swift}"
+  end
+end

package/kepler/ExpoSystemUI.cpp

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include "ExpoSystemUI.h"
+
+#include <KeplerScript/logger/KPLog.h>
+#include <Volta/graphics/Color.h>
+
+ExpoSystemUI::ExpoSystemUI(volta::react::IKeplerUIManager& uiManager) : syncDelegate(uiManager) {}
+
+volta::react::Promise ExpoSystemUI::getBackgroundColorAsync() {
+    return volta::react::Promise([this](std::shared_ptr<volta::react::Promise> promise) {
+        try {
+            auto rgbColorStr = syncDelegate.getBackgroundColor();
+            promise->resolve(rgbColorStr);
+        } catch (std::exception& e) {
+            promise->reject(std::string{"getBackgroundColorAsync error: " + std::string(e.what())});
+        }
+    });
+}
+
+volta::react::Promise ExpoSystemUI::resetBackgroundColorAsync() {
+    return volta::react::Promise([this](std::shared_ptr<volta::react::Promise> promise) {
+        try {
+            syncDelegate.resetBackgroundColor();
+            promise->resolve();
+        } catch (std::exception& e) {
+            promise->reject(std::string{"resetBackgroundColorAsync error: " + std::string(e.what())});
+        }
+    });
+}
+
+volta::react::Promise ExpoSystemUI::setBackgroundColorAsync(int64_t color) {
+    return volta::react::Promise([this, color](std::shared_ptr<volta::react::Promise> promise) {
+        try {
+            syncDelegate.setBackgroundColor(color);
+            promise->resolve();
+        } catch (std::exception& e) {
+            promise->reject(std::string{"setBackgroundColorAsync error: " + std::string(e.what())});
+        }
+    });
+}

package/kepler/ExpoSystemUI.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include <KeplerScript/components/KeplerViewComponent.h>
+#include <KeplerScript/modules/KeplerTurboModule.h>
+#include <Volta/graphics/Color.h>
+
+#include "ExpoSystemUIImpl.h"
+#include "IKeplerUIManager.h"
+
+class KEPLERSCRIPT_EXPORT ExpoSystemUI {
+public:
+    explicit ExpoSystemUI(volta::react::IKeplerUIManager&);
+
+    volta::react::Promise getBackgroundColorAsync();
+    volta::react::Promise resetBackgroundColorAsync();
+    volta::react::Promise setBackgroundColorAsync(int64_t color);
+
+private:
+#ifdef UNIT_TEST
+public:
+#endif
+    ExpoSystemUIImpl syncDelegate;
+};

package/kepler/ExpoSystemUIImpl.cpp

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include "ExpoSystemUIImpl.h"
+
+#include <KeplerScript/logger/KPLog.h>
+#include <Volta/graphics/Color.h>
+
+#include <iomanip>
+#include <sstream>
+
+ExpoSystemUIImpl::ExpoSystemUIImpl(volta::react::IKeplerUIManager& uiManager) {
+    view = uiManager.getComponentViewByTag(1);
+    if (view == nullptr) {
+        throw std::runtime_error("Failing getting view instance (view can't be nullptr)");
+    }
+    systemBackgroundColor = view->getBackgroundColor();
+}
+
+std::string ExpoSystemUIImpl::getBackgroundColor() {
+    volta::graphics::Color color = view->getBackgroundColor();
+    std::ostringstream rgbColor;
+    rgbColor << "#" << std::setfill('0') << std::hex << std::setw(2) << color.r() << std::setw(2) << color.g()
+             << std::setw(2) << color.b();
+    return rgbColor.str();
+}
+
+void ExpoSystemUIImpl::resetBackgroundColor() {
+    view->setBackgroundColor(systemBackgroundColor.argb());
+}
+
+void ExpoSystemUIImpl::setBackgroundColor(int64_t color) {
+    view->setBackgroundColor(color);
+}

package/kepler/ExpoSystemUIImpl.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include <KeplerScript/components/KeplerViewComponent.h>
+#include <KeplerScript/modules/KeplerTurboModule.h>
+#include <Volta/graphics/Color.h>
+
+#include "IKeplerUIManager.h"
+
+class KEPLERSCRIPT_EXPORT ExpoSystemUIImpl {
+public:
+    explicit ExpoSystemUIImpl(volta::react::IKeplerUIManager&);
+
+    std::string getBackgroundColor();
+    void resetBackgroundColor();
+    void setBackgroundColor(int64_t color);
+
+private:
+#ifdef UNIT_TEST
+public:
+#endif
+    std::shared_ptr<volta::react::KeplerViewComponent> view;
+    volta::graphics::Color systemBackgroundColor{0, 0, 0, 0};
+};

package/kepler/ExpoSystemUITurboModule.cpp

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include "ExpoSystemUITurboModule.h"
+
+#include <KeplerScript/logger/KPLog.h>
+#include <Volta/graphics/Color.h>
+
+#include <memory>
+
+#include "ExpoUIManager.h"
+
+ExpoSystemUITurboModule::ExpoSystemUITurboModule() : volta::react::KeplerTurboModule("ExpoSystemUI") {
+    volta::react::KPLog.debug("ExpoSystemUI constructor {}", name());
+}
+
+void ExpoSystemUITurboModule::aggregateMethods(
+        volta::react::MethodAggregator<volta::react::KeplerTurboModule>& methodAggregator) const noexcept {
+    volta::react::KPLog.debug("ExpoSystemUITurboModule::aggregateMethods");
+
+    methodAggregator.addMethod("getBackgroundColorAsync", 0, &ExpoSystemUITurboModule::getBackgroundColorAsync);
+    methodAggregator.addMethod("resetBackgroundColorAsync", 0, &ExpoSystemUITurboModule::resetBackgroundColorAsync);
+    methodAggregator.addMethod("setBackgroundColorAsync", 1, &ExpoSystemUITurboModule::setBackgroundColorAsync);
+}
+
+volta::react::Promise ExpoSystemUITurboModule::getBackgroundColorAsync() {
+    volta::react::KPLog.debug("ExpoSystemUI::getBackgroundColorAsync");
+    ensureSystemUIInitialized();
+    return lazyDelegate->getBackgroundColorAsync();
+}
+
+volta::react::Promise ExpoSystemUITurboModule::resetBackgroundColorAsync() {
+    volta::react::KPLog.debug("ExpoSystemUI::resetBackgroundColorAsync");
+    ensureSystemUIInitialized();
+    return lazyDelegate->resetBackgroundColorAsync();
+}
+
+volta::react::Promise ExpoSystemUITurboModule::setBackgroundColorAsync(int64_t color) {
+    volta::react::KPLog.debug("ExpoSystemUI::setBackgroundColorAsync, color {}", color);
+    ensureSystemUIInitialized();
+    return lazyDelegate->setBackgroundColorAsync(color);
+}
+
+void ExpoSystemUITurboModule::ensureSystemUIInitialized() {
+    volta::react::KPLog.debug("ExpoSystemUI::ensureSystemUIInitialized");
+    if (lazyDelegate) {
+        return;
+    }
+
+    volta::react::ExpoUIManager expoUIManager;
+    lazyDelegate = std::make_unique<ExpoSystemUI>(expoUIManager);
+}

package/kepler/ExpoSystemUITurboModule.h

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include <KeplerScript/components/KeplerViewComponent.h>
+#include <KeplerScript/modules/KeplerTurboModule.h>
+#include <Volta/graphics/Color.h>
+
+#include "ExpoSystemUI.h"
+#include "ExpoUIManager.h"
+
+class KEPLERSCRIPT_EXPORT ExpoSystemUITurboModule : public volta::react::KeplerTurboModule {
+public:
+    ExpoSystemUITurboModule();
+
+protected:
+    void aggregateMethods(
+            volta::react::MethodAggregator<volta::react::KeplerTurboModule>& methodAggregator) const noexcept override;
+
+    volta::react::Promise getBackgroundColorAsync();
+    volta::react::Promise resetBackgroundColorAsync();
+    volta::react::Promise setBackgroundColorAsync(int64_t color);
+
+private:
+    void ensureSystemUIInitialized();
+
+    std::unique_ptr<ExpoSystemUI> lazyDelegate;
+};

package/kepler/KeplerInit.cpp

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include <KeplerScript/logger/KPLog.h>
+#include <KeplerScript/utils/autolink/KeplerAutoLinkInfo.h>
+#include <keplerui-072/keplerscript-export.h>
+
+#include "ExpoSystemUITurboModule.h"
+#include "RegisterModule.h"
+
+extern "C" {
+KEPLERSCRIPT_EXPORT void keplerAutoLinkInitV1(const kepler::autolink::v1::KeplerAutoLinkInfo* autoLinkInfo) noexcept {
+    volta::react::KPLog.debug("keplerAutoLinkInitV1 for ExpoSystemUI");
+
+    REGISTER_MODULE(autoLinkInfo, ExpoSystemUITurboModule, "ExpoSystemUI");
+
+    volta::react::KPLog.debug("after registering module");
+}
+}
+
+int main() {
+    return 0;
+}

package/kepler/test/ExpoSystemUI.cpp

@@ -0,0 +1,154 @@
+/*
+ * Copyright (c) 2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+
+#include <JsonContainer/JsonContainer.h>
+#include <KeplerScript/components/KeplerViewComponent.h>
+#include <KeplerScript/modules/KeplerTurboModule.h>
+#include <KeplerScript/modules/Promise.h>
+#include <KeplerScript/private/modules/CallbackParameterTypes.h>
+#include <gmock/gmock-actions.h>
+#include <gmock/gmock.h>
+#include <gtest/gtest.h>
+
+#include <exception>
+#include <memory>
+#include <variant>
+
+#include "../ExpoSystemUITurboModule.h"
+#include "JSObjectsConversion.h"
+#include "catch.hpp"
+#include "gtest/gtest.h"
+
+namespace volta::react {
+
+using namespace std::string_literals;
+using CallbackArgs = std::vector<std::variant<CALLBACK_PARAM_SUPPORTED_TYPES>>;
+
+namespace {
+
+class MockKeplerUIManager : public IKeplerUIManager {
+public:
+    MOCK_METHOD((std::shared_ptr<KeplerViewComponent>), getComponentViewByTag, (int32_t), (override));
+    MOCK_METHOD((bool), isOnUIThread, (), (override));
+    MOCK_METHOD((void), executeOnUIThread, (const std::function<void()>&), (override));
+};
+
+// TODO: uncomment and use once Callback and Promise become testable
+// void reject(CallbackArgs& vargs) {
+//     std::string errorMsg;
+//     try {
+//         REQUIRE(vargs.size() == 1);
+//         auto& jsonContainer = std::get<utils::json::JsonContainer>(vargs.front());
+//         auto jsonMap = ExpoUtils::convertJsonContainerToNativeJSObject(jsonContainer);
+//         errorMsg = std::get<std::string>(jsonMap.at("message"));
+//     } catch (std::exception& e) {
+//         errorMsg = e.what();
+//     }
+//     FAIL("Promise invoked rejectedCallback: "s + errorMsg);
+// }
+
+// void evalPromise(const Promise& promise, std::function<void(CallbackArgs&)>&& resolve) {
+//     auto pAction = std::make_shared<Promise>(Callback(std::move(resolve)), Callback(reject));
+//     promise.promiseOperation_(pAction);
+// }
+
+// auto getBackgroundColorSync(ExpoSystemUI& systemUI) {
+//     auto pColor = systemUI.getBackgroundColorAsync();
+//     std::string color;
+//     auto resolve = [&color](auto& vargs) {
+//         REQUIRE(vargs.size() == 1);
+//         color = std::get<std::string>(vargs.front());
+//     };
+
+//     evalPromise(pColor, resolve);
+//     return color;
+// }
+using testing::Ne;
+using testing::Return;
+
+ExpoSystemUIImpl createModule(const std::shared_ptr<KeplerViewComponent>& mockRootView) {
+    MockKeplerUIManager mock;
+    EXPECT_CALL(mock, getComponentViewByTag(Ne(1))).Times(0);
+    EXPECT_CALL(mock, getComponentViewByTag(1)).WillRepeatedly(Return(mockRootView));
+    return ExpoSystemUIImpl(mock);
+}
+
+}  // namespace
+
+TEST_CASE("ExpoSystemUI fails to initialise") {
+    MockKeplerUIManager mock;
+    EXPECT_CALL(mock, getComponentViewByTag(Ne(1))).Times(0);
+    EXPECT_CALL(mock, getComponentViewByTag(1)).WillOnce(Return(nullptr));
+    REQUIRE_THROWS(ExpoSystemUI(mock));
+}
+
+TEST_CASE("ExpoSystemUI") {
+    // setup
+    constexpr int iBlack = static_cast<int>(0xff000000);
+    constexpr int iWhite = static_cast<int>(0xffffffff);
+    const auto sBlack = "#000000"s;
+    const auto sWhite = "#ffffff"s;  // outputs are case-sensitive
+
+    auto mockRootView = std::make_shared<KeplerViewComponent>();
+    mockRootView->setBackgroundColor(iBlack);
+    auto expoSystemUI = createModule(mockRootView);
+
+    SECTION("getBackgroundColorAsync") {
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::Black);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sBlack);
+    }
+
+    SECTION("setBackgroundColorAsync") {
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::Black);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sBlack);
+
+        expoSystemUI.setBackgroundColor(iWhite);
+
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::White);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sWhite);
+    }
+
+    SECTION("resetBackgroundColorAsync") {
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::Black);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sBlack);
+
+        mockRootView->setBackgroundColor(iWhite);
+
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::White);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sWhite);
+
+        expoSystemUI.resetBackgroundColor();
+
+        REQUIRE(mockRootView->getBackgroundColor() == volta::graphics::Color::Black);
+        REQUIRE(expoSystemUI.getBackgroundColor() == sBlack);
+    }
+}
+
+TEST_CASE("ExpoSystemUITurboModule") {
+    ExpoSystemUITurboModule tmodule;
+
+    SECTION("aggregateMethods") {
+        std::weak_ptr<facebook::react::Instance> instance;
+        REQUIRE(tmodule.methodContainerMap_.empty());
+
+        tmodule.triggerMethodAggregation(*tmodule.jsQueue_, instance);
+
+        auto registeredMethods = {
+                "getBackgroundColorAsync",
+                "resetBackgroundColorAsync",
+                "setBackgroundColorAsync",
+        };
+        for (const auto& methodName : registeredMethods) {
+            REQUIRE(tmodule.methodContainerMap_.find(methodName) != tmodule.methodContainerMap_.end());
+        }
+
+        REQUIRE(tmodule.methodContainerMap_.size() ==
+                registeredMethods.size() + 2);  // "addListener" and "removeListeners" are added by default
+    }
+}
+}  // namespace volta::react

package/package.json

@@ -0,0 +1 @@
+{"name": "@amazon-devices/expo-system-ui", "version": "2.0.1758683737+2.7.0", "description": "Interact with system UI elements", "main": "build/SystemUI.js", "types": "build/SystemUI.d.ts", "scripts": {"build": "expo-module build", "clean": "expo-module clean", "lint": "expo-module lint", "test": "expo-module test", "expo-module": "expo-module"}, "kepler": {"temporary-alias-for-package": {"name": "expo-system-ui", "version": "2.7.0"}}, "keywords": ["react-native", "expo", "background-color", "user-interface", "appearance"], "repository": {"type": "git", "url": "https://github.com/expo/expo.git", "directory": "packages/expo-system-ui"}, "bugs": {"url": "https://github.com/expo/expo/issues"}, "author": "650 Industries, Inc.", "license": "See license in LICENSE", "homepage": "https://docs.expo.dev/versions/latest/sdk/system-ui", "dependencies": {"@react-native/normalize-color": "^2.0.0", "debug": "^4.3.2"}, "jest": {"preset": "expo-module-scripts"}, "devDependencies": {"expo-module-scripts": "^3.0.0"}, "peerDependencies": {"expo": "*"}}

package/plugin/babel.config.js

@@ -0,0 +1 @@
+module.exports = require('expo-module-scripts/babel.config.plugin');

package/plugin/build/withAndroidRootViewBackgroundColor.d.ts

@@ -0,0 +1,6 @@
+import { ExpoConfig } from 'expo/config';
+import { ConfigPlugin } from 'expo/config-plugins';
+export declare const withAndroidRootViewBackgroundColor: ConfigPlugin;
+export declare const withRootViewBackgroundColorColors: ConfigPlugin;
+export declare const withRootViewBackgroundColorStyles: ConfigPlugin;
+export declare function getRootViewBackgroundColor(config: Pick<ExpoConfig, 'android' | 'backgroundColor'>): string | null;

package/plugin/build/withAndroidRootViewBackgroundColor.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRootViewBackgroundColorStyles = exports.withRootViewBackgroundColorColors = exports.withAndroidRootViewBackgroundColor = void 0;
+exports.getRootViewBackgroundColor = getRootViewBackgroundColor;
+const config_plugins_1 = require("expo/config-plugins");
+const { assignColorValue } = config_plugins_1.AndroidConfig.Colors;
+const { assignStylesValue, getAppThemeLightNoActionBarGroup } = config_plugins_1.AndroidConfig.Styles;
+const ANDROID_WINDOW_BACKGROUND = 'android:windowBackground';
+const WINDOW_BACKGROUND_COLOR = 'activityBackground';
+const withAndroidRootViewBackgroundColor = (config) => {
+    config = (0, exports.withRootViewBackgroundColorColors)(config);
+    config = (0, exports.withRootViewBackgroundColorStyles)(config);
+    return config;
+};
+exports.withAndroidRootViewBackgroundColor = withAndroidRootViewBackgroundColor;
+const withRootViewBackgroundColorColors = (config) => {
+    return (0, config_plugins_1.withAndroidColors)(config, async (config) => {
+        config.modResults = assignColorValue(config.modResults, {
+            value: getRootViewBackgroundColor(config),
+            name: WINDOW_BACKGROUND_COLOR,
+        });
+        return config;
+    });
+};
+exports.withRootViewBackgroundColorColors = withRootViewBackgroundColorColors;
+const withRootViewBackgroundColorStyles = (config) => {
+    return (0, config_plugins_1.withAndroidStyles)(config, async (config) => {
+        config.modResults = assignStylesValue(config.modResults, {
+            add: !!getRootViewBackgroundColor(config),
+            parent: getAppThemeLightNoActionBarGroup(),
+            name: ANDROID_WINDOW_BACKGROUND,
+            value: `@color/${WINDOW_BACKGROUND_COLOR}`,
+        });
+        return config;
+    });
+};
+exports.withRootViewBackgroundColorStyles = withRootViewBackgroundColorStyles;
+function getRootViewBackgroundColor(config) {
+    return config.android?.backgroundColor || config.backgroundColor || null;
+}