@amazon-devices/expo-image 2.0.1758683737

package/.eslintrc.js

@@ -0,0 +1,2 @@
+// @generated by expo-module-scripts
+module.exports = require('expo-module-scripts/eslintrc.base.js');

package/CHANGELOG.md

@@ -0,0 +1,285 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others
+
+## 1.6.0 — 2023-10-17
+
+### 🛠 Breaking changes
+
+- Dropped support for Android SDK 21 and 22. ([#24201](https://github.com/expo/expo/pull/24201) by [@behenate](https://github.com/behenate))
+
+### 🎉 New features
+
+- Added support for the `headers` key in the `source` object on web. ([#24447](https://github.com/expo/expo/pull/24447) by [@aleqsio](https://github.com/aleqsio))
+- Add support for setting `tintColor` on SVGs on Android (part 1) ([#24733](https://github.com/expo/expo/pull/24733) by [@alanjhughes](https://github.com/alanjhughes) and [@kadikraman](https://github.com/kadikraman))
+- Add support for setting `tintColor` on SVGs on Android (part 2) ([#24888](https://github.com/expo/expo/pull/24888) by [@kadikraman](https://github.com/kadikraman))
+
+### 🐛 Bug fixes
+
+- Remove `GlideWebpDecoder` until they update their `libwebp` dependency. ([#24656](https://github.com/expo/expo/pull/24656) by [@alanjhughes](https://github.com/alanjhughes))
+- [web] Fix content fit not being applied correctly when using hash placeholders. ([#24542](https://github.com/expo/expo/pull/24542) by [@aleqsio](https://github.com/aleqsio))
+- [macCatalyst] Fix build with `ImageAnalyzer` on macCatalyst below 17.0. ([#24880](https://github.com/expo/expo/pull/24880) by [@kesha-antonov](https://github.com/kesha-antonov))
+
+### 💡 Others
+
+- Ship untranspiled JSX to support custom handling of `jsx` and `createElement`. ([#24889](https://github.com/expo/expo/pull/24889) by [@EvanBacon](https://github.com/EvanBacon))
+- Make `placeholderContentFit` visible in the docs. ([#24801](https://github.com/expo/expo/pull/24801) by [@behenate](https://github.com/behenate))
+
+## 1.0.2 — 2023-09-29
+
+### 🐛 Bug fixes
+
+- Remove `GlideWebpDecoder` until they update their `libwebp` dependency. ([#24656](https://github.com/expo/expo/pull/24656) by [@alanjhughes](https://github.com/alanjhughes))
+
+## 1.3.4 — 2023-09-28
+
+### 🐛 Bug fixes
+
+- Remove `GlideWebpDecoder` until they update their `libwebp` dependency. ([#24656](https://github.com/expo/expo/pull/24656) by [@alanjhughes](https://github.com/alanjhughes))
+
+## 1.5.2 — 2023-09-18
+
+_This version does not introduce any user-facing changes._
+
+## 1.3.3 — 2023-09-15
+
+### 🐛 Bug fixes
+
+- Fixed placeholders aren't always replaced by full-size images on Android. ([#23705](https://github.com/expo/expo/pull/23705) by [@lukmccall](https://github.com/lukmccall))
+- Fix the image components rendering incorrect assets when the Proguard is enabled on Android. ([#23704](https://github.com/expo/expo/pull/23704) by [@lukmccall](https://github.com/lukmccall))
+- Fixed gif and awebp memory leak on Android. ([#24259](https://github.com/expo/expo/pull/24259) by [@jingpeng](https://github.com/jingpeng))
+- Suppress "Operation cancelled by user during sending the request" error when the load request is canceled (interrupted) by a new one. ([#24279](https://github.com/expo/expo/pull/24279) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.5.1 — 2023-09-11
+
+### 🐛 Bug fixes
+
+- Suppress "Operation cancelled by user during sending the request" error when the load request is canceled (interrupted) by a new one. ([#24279](https://github.com/expo/expo/pull/24279) by [@tsapeta](https://github.com/tsapeta))
+- Fixed gif and awebp memory leak on Android. ([#24259](https://github.com/expo/expo/pull/24259) by [@jingpeng](https://github.com/jingpeng))
+
+## 1.5.0 — 2023-09-04
+
+### 🎉 New features
+
+- Added support for React Native 0.73. ([#24018](https://github.com/expo/expo/pull/24018) by [@kudo](https://github.com/kudo))
+
+### 💡 Others
+
+- On iOS, bump SDWebImage versions. ([#23858](https://github.com/expo/expo/pull/23858) by [@alanjhughes](https://github.com/alanjhughes))
+
+## 1.4.1 — 2023-08-02
+
+_This version does not introduce any user-facing changes._
+
+## 1.4.0 — 2023-07-28
+
+### 🎉 New features
+
+- [Web] Add support for `tintColor` prop on web. ([#23434](https://github.com/expo/expo/pull/23434) by [@aleqsio](https://github.com/aleqsio))
+- [Web] Add support for static image responsiveness using `srcset` attributes. ([#22088](https://github.com/expo/expo/pull/22088) by [@aleqsio](https://github.com/aleqsio))
+
+### 🐛 Bug fixes
+
+- Fixed placeholders aren't always replaced by full-size images on Android. ([#23705](https://github.com/expo/expo/pull/23705) by [@lukmccall](https://github.com/lukmccall))
+- Fixed the image components rendering incorrect assets when the Proguard is enabled on Android. ([#23704](https://github.com/expo/expo/pull/23704) by [@lukmccall](https://github.com/lukmccall))
+
+### 💡 Others
+
+- [Web] Refactored and split some functions for better readability. ([#23465](https://github.com/expo/expo/pull/23465) by [@aleqsio](https://github.com/aleqsio))
+
+## 1.3.2 - 2023-07-12
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed `tintColor` prop not working for SVGs. ([#23418](https://github.com/expo/expo/pull/23418) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.3.1 - 2023-06-29
+
+### 🐛 Bug fixes
+
+- Fixed an issue where recyclingKey would reset the image source on mount. ([#23187](https://github.com/expo/expo/pull/23187) by [@hirbod](https://github.com/hirbod))
+
+## 1.3.0 — 2023-06-13
+
+### 🎉 New features
+
+- Add prefetch implementation on web. ([#22630](https://github.com/expo/expo/pull/22630) by [@aleqsio](https://github.com/aleqsio))
+- Add `ImageBackground` component. ([#22347](https://github.com/expo/expo/pull/22347) by [@alanjhughes](https://github.com/alanjhughes))
+- Added support for React Native 0.72. ([#22588](https://github.com/expo/expo/pull/22588) by [@kudo](https://github.com/kudo))
+
+### 🐛 Bug fixes
+
+- Fixed styles order breaking layouting on web. ([#22630](https://github.com/expo/expo/pull/22630) by [@aleqsio](https://github.com/aleqsio))
+- Uses prop spreading on web to pass all unused props to the native image component ([#22340](https://github.com/expo/expo/pull/22340) by [@makkarMeenu](https://github.com/makkarMeenu))
+- Fixed Android build warnings for Gradle version 8. ([#22537](https://github.com/expo/expo/pull/22537), [#22609](https://github.com/expo/expo/pull/22609) by [@kudo](https://github.com/kudo))
+
+### 💡 Others
+
+- Updated `SDWebImage` to `5.15.8`, `SDWebImageWebPCoder` to `0.11.0` and `SDWebImageSVGCoder` to `1.7.0`. ([#22576](https://github.com/expo/expo/pull/22576) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.2.3 — 2023-05-16
+
+### 🐛 Bug fixes
+
+- Upgrade SDWebImageAVIFCoder to fix compiling issue with libavif < 0.11.0. ([#22491](https://github.com/expo/expo/pull/22491) by [@matinzd](https://github.com/matinzd))
+
+## 1.2.2 — 2023-04-27
+
+### 🐛 Bug fixes
+
+- Fix for the "limited" media library permission. ([#22261](https://github.com/expo/expo/pull/22261) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.2.1 — 2023-04-17
+
+### 🐛 Bug fixes
+
+- [Android] Fix `url` property returned by the `onLoad` event. ([#22161](https://github.com/expo/expo/pull/22161) by [@lukmccall](https://github.com/lukmccall))
+- [Android] Fix images not loading after the app was foregrounded. ([#22159](https://github.com/expo/expo/pull/22159) by [@lukmccall](https://github.com/lukmccall))
+- [Android] Fixed image was loaded event if the view dimensions were 0. ([#22157](https://github.com/expo/expo/pull/22157) by [@lukmccall](https://github.com/lukmccall))
+- Fix generating the image from ThumbHash that starts with a slash character. ([#22160](https://github.com/expo/expo/pull/22160) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.2.0 — 2023-04-14
+
+### 🎉 New features
+
+- [Web] Add support for `require()` assets. ([#21798](https://github.com/expo/expo/pull/21798) by [@aleqsio](https://github.com/aleqsio))
+- Add `alt` prop as an alias to `accessibilityLabel`. ([#21884](https://github.com/expo/expo/pull/21884) by [@EvanBacon](https://github.com/EvanBacon))
+- [Web] Add `accessibilityLabel` support on web. ([#21884](https://github.com/expo/expo/pull/21884) by [@EvanBacon](https://github.com/EvanBacon))
+- Added `ThumbHash` support for Android, iOS and Web. ([#21952](https://github.com/expo/expo/pull/21952) by [@behenate](https://github.com/behenate))
+
+### 🐛 Bug fixes
+
+- [Web] Improve transition behavior when switching back and forth two sources. ([#22099](https://github.com/expo/expo/pull/22099) by [@aleqsio](https://github.com/aleqsio))
+- [Web] Prevent breaking in static rendering environments. ([#21883](https://github.com/expo/expo/pull/21883) by [@EvanBacon](https://github.com/EvanBacon))
+- [Android] Fixed image disappearing before navigation animation is complete. ([#22066](https://github.com/expo/expo/pull/22066) by [@sallen450](https://github.com/sallen450))
+- [Web] Fixed monorepo asset resolution in production for Metro web. ([#22094](https://github.com/expo/expo/pull/22094) by [@EvanBacon](https://github.com/EvanBacon))
+
+## 1.1.0 — 2023-03-25
+
+### 🎉 New features
+
+- [Android] Add automatic asset downscaling to improve performance. ([#21628](https://github.com/expo/expo/pull/21628) by [@lukmccall](https://github.com/lukmccall))
+
+### 🐛 Bug fixes
+
+- Fixed the `tintColor` not being passed to native view. ([#21576](https://github.com/expo/expo/pull/21576) by [@andrew-levy](https://github.com/andrew-levy))
+- Fixed `canvas: trying to use a recycled bitmap` on Android. ([#21658](https://github.com/expo/expo/pull/21658) by [@lukmccall](https://github.com/lukmccall))
+- Fixed crashes caused by empty placeholder or source on Android. ([#21695](https://github.com/expo/expo/pull/21695) by [@lukmccall](https://github.com/lukmccall))
+- Fixes `shouldDownscale` don't respect the scale factor on iOS. ([#21839](https://github.com/expo/expo/pull/21839) by [@ouabing](https://github.com/ouabing))
+- Fixes cache policy not being correctly applied when set to `none` on iOS. ([#21840](https://github.com/expo/expo/pull/21840) by [@ouabing](https://github.com/ouabing))
+
+## 1.0.0 — 2023-02-21
+
+_This version does not introduce any user-facing changes._
+
+## 1.0.0-rc.2 — 2023-02-20
+
+### 🎉 New features
+
+- Added `recyclingKey` prop that allows reseting the image view content when the view is recycled. ([#21297](https://github.com/expo/expo/pull/21297) & [#21309](https://github.com/expo/expo/pull/21309) by [@tsapeta](https://github.com/tsapeta) & [@lukmccall](https://github.com/lukmccall))
+
+## 1.0.0-rc.1 — 2023-02-14
+
+### 🐛 Bug fixes
+
+- Fixed `You can't start or clear loads in RequestListener or Target callbacks` on Android. ([#21192](https://github.com/expo/expo/pull/21192) by [@lukmccall](https://github.com/lukmccall))
+- Fixed SVGs are not rendered in the release mode on Android. ([#21214](https://github.com/expo/expo/pull/21214) by [@lukmccall](https://github.com/lukmccall))
+- Stop sending `onProgress` event when the asset size is unknown which led to diving by zero and a crash. ([#21215](https://github.com/expo/expo/pull/21215) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.0.0-rc.0 — 2023-02-09
+
+### 🎉 New features
+
+- Added `placeholderContentFit` prop implementation on the web. ([#21106](https://github.com/expo/expo/pull/21106) by [@aleqsio](https://github.com/aleqsio))
+
+## 1.0.0-beta.6 — 2023-02-06
+
+### 🎉 New features
+
+- Added new prop `placeholderContentFit` to specify custom content fit on the placeholder. ([#21096](https://github.com/expo/expo/pull/21096) by [@magrinj](https://github.com/magrinj))
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed possible freezes by processing images concurrently off the main thread. ([#21086](https://github.com/expo/expo/pull/21086) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.0.0-beta.5 — 2023-02-03
+
+_This version does not introduce any user-facing changes._
+
+## 1.0.0-beta.4 — 2023-01-31
+
+### 🐛 Bug fixes
+
+- Fixed a crash on Android where `isScreenReaderFocusable` crashes devices below api 28. ([#21012](https://github.com/expo/expo/pull/21012) by [@alanhughes](https://github.com/alanjhughes))
+
+## 1.0.0-beta.3 — 2023-01-30
+
+### 🐛 Bug fixes
+
+- Fixed a crash on iOS below 16.0 introduced by the Live Text interaction feature. ([#20987](https://github.com/expo/expo/pull/20987) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.0.0-beta.2 — 2023-01-25
+
+### 🎉 New features
+
+- Added support for Live text interaction. ([#20915](https://github.com/expo/expo/pull/20915) by [@intergalacticspacehighway](https://github.com/intergalacticspacehighway))
+
+### 🐛 Bug fixes
+
+- `ImageProps` now extends `ViewProps`. ([#20942](https://github.com/expo/expo/pull/20942) by [@appden](https://github.com/appden))
+
+## 1.0.0-beta.1 — 2023-01-20
+
+### 🐛 Bug fixes
+
+- Use `SDImageAWebPCoder` on iOS 14+ to speed up loading WebP images. ([#20897](https://github.com/expo/expo/pull/20897) by [@tsapeta](https://github.com/tsapeta))
+
+### 💡 Others
+
+- On Android bump `compileSdkVersion` and `targetSdkVersion` to `33`. ([#20721](https://github.com/expo/expo/pull/20721) by [@lukmccall](https://github.com/lukmccall))
+- Upgraded `SDWebImage` to `5.15.0` and `SDWebImageAVIFCoder` to `0.9.4`. ([#20898](https://github.com/expo/expo/pull/20898) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.0.0-beta.0 — 2023-01-19
+
+### 🎉 New features
+
+- Added support for crossfade transition on Android. ([#20784](https://github.com/expo/expo/pull/20784) by [@lukmccall](https://github.com/lukmccall))
+- Added web support for the `blurRadius` prop. ([#20845](https://github.com/expo/expo/pull/20845) by [@aleqsio](https://github.com/aleqsio))
+- Support for `accessible` and `accessibilityLabel` props on Android. ([#20801](https://github.com/expo/expo/pull/20801) by [@lukmccall](https://github.com/lukmccall))
+- Support for `accessible` and `accessibilityLabel` props on iOS. ([#20892](https://github.com/expo/expo/pull/20892) by [@alanhughes](https://github.com/alanjhughes))
+
+## 1.0.0-alpha.6 — 2023-01-10
+
+### 🎉 New features
+
+- Introduced the `source.cacheKey` parameter to customize the key used for caching the source image. ([#20772](https://github.com/expo/expo/pull/20772) by [@tsapeta](https://github.com/tsapeta), [#20776](https://github.com/expo/expo/pull/20776) by [@lukmccall](https://github.com/lukmccall))
+
+## 1.0.0-alpha.5 — 2023-01-04
+
+### 🎉 New features
+
+- Added support for assets from the iOS Photo Library (`ph://` urls). ([#20700](https://github.com/expo/expo/pull/20700) by [@tsapeta](https://github.com/tsapeta))
+
+### 🐛 Bug fixes
+
+- Fixed `ImageProps` type not allowing an array of styles. ([#20701](https://github.com/expo/expo/pull/20701) by [@tsapeta](https://github.com/tsapeta))
+
+## 1.0.0-alpha.4 — 2022-12-30
+
+### 🐛 Bug fixes
+
+- Fixed compatibility with `react-native-shared-element` on iOS. ([#20592](https://github.com/expo/expo/pull/20592) by [@IjzerenHein](https://github.com/ijzerenhein))
+
+## 1.0.0-alpha.3 — 2022-12-21
+
+### 🎉 New features
+
+- Initial release 🥳

package/CMakeLists.txt

@@ -0,0 +1,91 @@
+#
+# Copyright 2023 Amazon.com, Inc. or its affiliates. All rights reserved.
+#
+# AMAZON PROPRIETARY/CONFIDENTIAL
+#
+# You may not use this file except in compliance with the terms and conditions
+# set forth in the accompanying LICENSE.TXT file.
+#
+# THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+# DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+# IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+#
+set(PACKAGE_NAME "expo-image")
+set(AUTO_LINK_PACKAGE_NAME "${PACKAGE_NAME}-${KEPLER_REACT_NATIVE_MAJOR_VERSION}")
+set(SRC_DIR ${CMAKE_CURRENT_SOURCE_DIR}/kepler)
+set(SOURCES_KEPLER 
+  kepler/ExpoImage.cpp
+  kepler/ExpoImageCacheHandler.cpp
+  kepler/ExpoImageComponent.cpp
+
+  kepler/utils/PlaceholderImageLoaderDelegate.cpp
+  kepler/utils/PrefetchImageLoaderDelegate.cpp
+  kepler/utils/SourceImageLoaderDelegate.cpp
+  kepler/utils/SourceImageLoaderDelegateEmitter.cpp
+
+  kepler/contentposition/ImageContentPosition.cpp
+
+  kepler/blurhash/decode.cpp
+
+  kepler/thumbhash/decode.cpp
+
+  kepler/ImageWrapper/BlurhashImageWrapper.cpp
+  kepler/ImageWrapper/CacheImageWrapper.cpp
+  kepler/ImageWrapper/HashImageWrapper.cpp
+  kepler/ImageWrapper/ImageWrapper.cpp
+  kepler/ImageWrapper/LocalImageWrapper.cpp
+  kepler/ImageWrapper/ThumbhashImageWrapper.cpp
+
+  kepler/managers/ExpoImageManager.cpp
+)
+
+set(KEPLER_INIT kepler/KeplerInit.cpp)
+
+find_library (MBED_CRYPTO NAMES mbedcrypto REQUIRED)
+
+add_library(${PACKAGE_NAME} STATIC ${SOURCES_KEPLER})
+
+
+target_include_directories(
+  ${PACKAGE_NAME}
+  PUBLIC
+  ${SRC_DIR}
+)
+
+target_link_libraries(
+  ${PACKAGE_NAME}
+  PUBLIC
+  keplerui::keplerscript-${KEPLER_REACT_NATIVE_MAJOR_VERSION}
+  ${MBED_CRYPTO}
+)
+
+target_compile_options(
+  ${PACKAGE_NAME}  
+  PRIVATE
+  -fpermissive
+)
+
+add_library(${AUTO_LINK_PACKAGE_NAME} SHARED ${KEPLER_INIT} ${SOURCES_KEPLER})
+
+set_target_properties(${AUTO_LINK_PACKAGE_NAME} PROPERTIES SOVERSION ${KEPLER_REACT_NATIVE_MAJOR_VERSION}.${KEPLER_REACT_NATIVE_MINOR_VERSION})
+
+target_link_libraries(
+  ${AUTO_LINK_PACKAGE_NAME}
+  PRIVATE
+  ${PACKAGE_NAME}  
+)
+
+# Helps in checking undefined references
+add_executable(${AUTO_LINK_PACKAGE_NAME}_exe ${KEPLER_INIT} ${SOURCES_KEPLER})
+target_link_libraries(${AUTO_LINK_PACKAGE_NAME}_exe
+  PRIVATE
+  ${AUTO_LINK_PACKAGE_NAME}
+  keplerui::keplerscript-${KEPLER_REACT_NATIVE_MAJOR_VERSION}
+  ${MBED_CRYPTO}
+)
+target_include_directories(${AUTO_LINK_PACKAGE_NAME}_exe PRIVATE ${SRC_DIR})
+
+install(TARGETS ${AUTO_LINK_PACKAGE_NAME}
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+)

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Amazon.com, Inc. or its affiliates.  All rights reserved.
+
+These materials are licensed as "Program Materials" under the Program Materials License Agreement (the "Agreement").  The Agreement is available at https://developer.amazon.com/support/legal/pml.  See the Agreement for the specific terms and conditions of the Agreement.  Capitalized terms not defined in this file have the meanings given to them in the Agreement.  
+
+If you do not agree to the above terms and conditions, you may not use any file in this package. 
+
+YOUR USE OF THE PROGRAM MATERIALS IN OR ASSOCIATED WITH THIS PACKAGE IS AT YOUR SOLE RISK.  IN NO EVENT WILL AMAZON BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, CONSEQUENTIAL, SPECIAL, INCIDENTAL, OR PUNITIVE DAMAGES (INCLUDING FOR ANY LOSS OF GOODWILL, BUSINESS INTERRUPTION, LOST PROFITS OR DATA, OR COMPUTER FAILURE OR MALFUNCTION) ARISING FROM OR RELATING TO SUCH PROGRAM MATERIALS, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, EVEN IF AMAZON HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS AND DISCLAIMERS APPLY EXCEPT TO THE EXTENT PROHIBITED BY APPLICABLE LAW.

package/README.kepler.md

@@ -0,0 +1,123 @@
+# @amazon-devices/expo-image
+
+## Getting Started
+
+`@amazon-devices/expo-image` provides a cross-platform, performant image component for React Native and Expo.
+
+Provides `Image` component that:
+- Supports [BlurHash](https://blurha.sh) and [ThumbHash](https://evanw.github.io/thumbhash/) - compact representations of a placeholder for an image
+- Transitioning between images when the source changes (no more flickering!)
+- Implements the CSS [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) and [`object-position`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position) properties (see [`contentFit`](#contentfit) and [`contentPosition`](#contentposition) props)
+
+### Installation
+
+1. Add the JavaScript library dependency in the `package.json` file:
+```json
+dependencies: {
+    ...
+    "@amazon-devices/expo-image": "~2.0.0",
+}
+```
+
+2. Reinstall dependencies using `npm install` command.
+
+## Usage Examples
+
+Example of image with thumbhash placeholder and multiple sources
+
+
+```tsx
+import React from 'react';
+import {StyleSheet, View} from 'react-native';
+import {Image} from '@amazon-devices/expo-image';
+
+export const App = () => {
+  return (
+    <View style={styles.container}>
+      <Image
+        source={[
+          'https://images.pexels.com/photos/842711/pexels-photo-842711.jpeg',
+          'https://climateforlife.pl/wp-content/uploads/2023/10/panda.png',
+        ]}
+        style={styles.image}
+        placeholder="thumbhash:/1QcSHQRnh493V4dIh4eXh1h4kJUI"
+      />
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    backgroundColor: 'white',
+    flex: 1,
+  },
+  image: {
+    width: 300,
+    aspectRatio: 1,
+  },
+});
+
+
+```
+
+## API Reference
+
+Check out the dedicated documentation page for info about this library, API reference and more [Official Expo documentation for expo-image](https://github.com/expo/expo/blob/sdk-49/docs/pages/versions/v49.0.0/sdk/image.mdx).
+
+### Components
+
+| Component | Description | Platform support |
+| --------- | ----------- | ---------------- |
+| Image | A cross-platform React component that loads and renders images | All |
+
+### Image Props
+
+| Prop | Description | Platform support |
+| ---- | ----------- | ---------------- |
+| accessibilityLabel | The text that's read by the screen reader when the user interacts with the image. Sets the the alt tag on web which is used for web crawlers and link traversal | All |
+| accessible | When true, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component | All |
+| allowDownscaling | Whether the image should be downscaled to match the size of the view container. Turning off this functionality could negatively impact the application's performance, particularly when working with large assets. However, it would result in smoother image resizing, and end-users would always have access to the highest possible asset quality | Android, Kepler |
+| alt | The text that's read by the screen reader when the user interacts with the image. Sets the the alt tag on web which is used for web crawlers and link traversal. Is an alias for `accessibilityLabel` | All |
+| blurRadius | The radius of the blur in points, 0 means no blur effect. This effect is not applied to placeholders | All |
+| cachePolicy | Determines whether to cache the image and where: on the disk, in the memory or both | Android, iOS |
+| contentFit | Determines how the image should be resized to fit its container. This property tells the image to fill the container in a variety of ways; such as "preserve that aspect ratio" or "stretch up and take up as much space as possible". It mirrors the CSS `object-fit` property | All |
+| contentPosition | It is used together with `contentFit` to specify how the image should be positioned with x/y coordinates inside its own container. An equivalent of the CSS `object-position` property | All |
+| defaultSource | A default value for the image source. WARNING: Deprecated. Provides compatibility for defaultSource from React Native Image. Use placeholder prop instead | All |
+| enableLiveTextInteraction | Enables Live Text interaction with the image | iOS |
+| fadeDuration | WARNING: Deprecated. Provides compatibility for `fadeDuration` from React Native Image. Instead use transition with the provided duration | All |
+| focusable | Whether this View should be focusable with a non-touch input device and receive focus with a hardware keyboard | Android, Kepler |
+| loadingIndicatorSource | WARNING: Deprecated. Provides compatibility for `loadingIndicatorSource` from React Native Image. Use placeholder prop instead | All |
+| onError | Called on an image fetching error | All |
+| onLoad | Called when the image load completes successfully | All |
+| onLoadEnd | Called when the image load either succeeds or fails | All |
+| onLoadStart | Called when the image starts to load | All |
+| onProgress | Called when the image is loading. Can be called multiple times before the image has finished loading. The event object provides details on how many bytes were loaded so far and what's the expected total size | All |
+| placeholder | An image to display while loading the proper image and no image has been displayed yet or the source is unset | All |
+| priority | Priorities for completing loads. If more than one load is queued at a time, the load with the higher priority will be started first. Priorities are considered best effort, there are no guarantees about the order in which loads will start or finish | All |
+| recyclingKey | Changing this prop resets the image view content to blank or a placeholder before loading and rendering the final image. This is especially useful for any kinds of recycling views like FlashList to prevent showing the previous source before the new one fully loads | All |
+| resizeMode | WARNING: Deprecated. Provides compatibility for `resizeMode` from React Native Image. Note that `"repeat"` option is not supported at all. Use the more powerful `contentFit` and `contentPosition` props instead | All |
+| responsivePolicy | Determines whether to choose image source based on container size only on mount or on every resize. Use initial to improve performance | Web |
+| source | The image source, either a remote URL, a local file resource or a number that is the result of the require() function. When provided as an array of sources, the source that fits best into the container size and is closest to the screen scale will be chosen. In this case it is important to provide `width`, `height` and `scale` properties | All |
+| tintColor | A color used to tint template images (a bitmap image where only the opacity matters). The color is applied to every non-transparent pixel, causing the image’s shape to adopt that color. This effect is not applied to placeholders | All |
+| transition | Describes how the image view should transition the contents when switching the image source. If provided as a number, it is the duration in milliseconds of the `'cross-dissolve'` effect | All |
+
+### Methods
+
+| Method | Method type | Description | Platform support |
+| ------ | ----------- | ----------- | ---------------- |
+| clearDiskCache | Asynchronously clears all images from the disk cache | All |
+| clearMemoryCache | Asynchronously clears all images stored in memory | All |
+| prefetch | Preloads images at the given urls that can be later used in the image view. Preloaded images are always cached on the disk, so make sure to use `disk` (default) or `memory-disk` cache policy | All |
+
+## Known Issues
+
+* Does not support SVG's and animated sources
+* `cachePolicy` prop does not work
+* `onProgress` and `onError` callbacks don't work on Kepler
+* `onLoadEnd`, `onLoadStart`, `onLoad` sometimes don't get invoked on Kepler
+
+## Supported Versions
+
+| Package version  | Based on | @amazon-devices/react-native-kepler version |
+| ---------------- | -------- | --------------------------------- |
+| 2.0.x    | expo-image v1.6.0   | 2.0.x            |

package/README.md

@@ -0,0 +1,54 @@
+<p>
+  <a href="https://docs.expo.dev/versions/unversioned/sdk/image/">
+    <img
+      src="../../.github/resources/expo-image.svg"
+      alt="expo-image"
+      height="64" />
+  </a>
+</p>
+
+A cross-platform, performant image component for React Native and Expo.
+
+## Main features
+
+- Designed for speed
+- Support for many image formats (including animated ones)
+- Disk and memory caching
+- Supports [BlurHash](https://blurha.sh) and [ThumbHash](https://evanw.github.io/thumbhash/) - compact representations of a placeholder for an image
+- Transitioning between images when the source changes (no more flickering!)
+- Implements the CSS [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) and [`object-position`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position) properties (see [`contentFit`](#contentfit) and [`contentPosition`](#contentposition) props)
+- Uses performant [`SDWebImage`](https://github.com/SDWebImage/SDWebImage) and [`Glide`](https://github.com/bumptech/glide) under the hood
+
+## Supported image formats
+
+|   Format   | Android | iOS |                        Web                        |
+| :--------: | :-----: | :-: | :-----------------------------------------------: |
+|    WebP    |   ✅    | ✅  |   ✅ [~96% adoption](https://caniuse.com/webp)    |
+| PNG / APNG |   ✅    | ✅  | ✅ / ✅ [~96% adoption](https://caniuse.com/apng) |
+|    AVIF    |   ✅    | ✅  |   ⏳ [~79% adoption](https://caniuse.com/avif)    |
+|    HEIC    |   ✅    | ✅  |  ❌ [not adopted yet](https://caniuse.com/heif)   |
+|    JPEG    |   ✅    | ✅  |                        ✅                         |
+|    GIF     |   ✅    | ✅  |                        ✅                         |
+|    SVG     |   ✅    | ✅  |                        ✅                         |
+|    ICO     |   ✅    | ✅  |                        ✅                         |
+|    ICNS    |   ❌    | ✅  |                        ❌                         |
+
+# API documentation
+
+- [Documentation for the latest release](https://docs.expo.dev/versions/unversioned/sdk/image/)
+
+# Installation
+
+> Currently `expo-image` can be used only with [development builds](https://docs.expo.dev/develop/development-builds/introduction/), in Expo Go, and bare React Native apps with [configured Expo modules](https://docs.expo.dev/bare/installing-expo-modules/).
+> It is not available with Snack yet.
+
+Add the package to your dependencies with the following commands:
+
+```
+npx expo install expo-image
+npx pod-install
+```
+
+# Contributing
+
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide](https://github.com/expo/expo#contributing).

package/THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,24 @@
+License from package.json:
+==============================
+
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.