expo-clipboard 4.2.0 → 4.4.0

package/CHANGELOG.md

@@ -10,6 +10,24 @@
 
 ### 💡 Others
 
+## 4.4.0 — 2023-08-02
+
+_This version does not introduce any user-facing changes._
+
+## 4.3.0 — 2023-06-21
+
+### 📚 3rd party library updates
+
+- Updated `robolectric` to `4.10`. ([#22395](https://github.com/expo/expo/pull/22395) by [@josephyanks](https://github.com/josephyanks))
+
+### 🎉 New features
+
+- On iOS, added native `ClipboardPasteButton` view that uses `UIPasteControl`. ([#22823](https://github.com/expo/expo/pull/22823) by [@alanjhughes](https://github.com/alanjhughes))
+
+### 🐛 Bug fixes
+
+- 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))
+
 ## 4.2.0 — 2023-05-08
 
 _This version does not introduce any user-facing changes._

package/README.md

@@ -1,4 +1,11 @@
-# expo-clipboard
+<p>
+  <a href="https://docs.expo.dev/versions/latest/sdk/clipboard/">
+    <img
+      src="../../.github/resources/expo-clipboard.svg"
+      alt="expo-clipboard"
+      height="64" />
+  </a>
+</p>
 
 `expo-clipboard` provides an interface for getting and setting Clipboard content on Android, iOS, and Web.
 

package/android/build.gradle

@@ -3,7 +3,7 @@ apply plugin: 'kotlin-android'
 apply plugin: 'maven-publish'
 
 group = 'host.exp.exponent'
-version = '4.2.0'
+version = '4.4.0'
 
 buildscript {
   def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
@@ -35,19 +35,11 @@ buildscript {
   }
 }
 
-// Creating sources with comments
-task androidSourcesJar(type: Jar) {
-  classifier = 'sources'
-  from android.sourceSets.main.java.srcDirs
-}
-
 afterEvaluate {
   publishing {
     publications {
       release(MavenPublication) {
         from components.release
-        // Add additional sourcesJar to artifacts
-        artifact(androidSourcesJar)
       }
     }
     repositories {
@@ -70,15 +62,21 @@ android {
     jvmTarget = JavaVersion.VERSION_11.majorVersion
   }
 
+  namespace "expo.modules.clipboard"
   defaultConfig {
     minSdkVersion safeExtGet("minSdkVersion", 21)
     targetSdkVersion safeExtGet("targetSdkVersion", 33)
     versionCode 3
-    versionName '4.2.0'
+    versionName '4.4.0'
   }
   lintOptions {
     abortOnError false
   }
+  publishing {
+    singleVariant("release") {
+      withSourcesJar()
+    }
+  }
 }
 
 repositories {

package/android/src/main/AndroidManifest.xml

@@ -1,5 +1,4 @@
-<manifest package="expo.modules.clipboard"
-  xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
   <application>
     <provider
       android:name=".ClipboardFileProvider"

package/build/Clipboard.d.ts

@@ -1,5 +1,6 @@
 import { Subscription } from 'expo-modules-core';
 import { ClipboardImage, ContentType, GetImageOptions, GetStringOptions, SetStringOptions } from './Clipboard.types';
+import { ClipboardPasteButton } from './ClipboardPasteButton';
 type ClipboardEvent = {
     /**
      * @deprecated Returns empty string. Use [`getStringAsync()`](#getstringasyncoptions) instead to retrieve clipboard content.
@@ -144,5 +145,14 @@ export declare function addClipboardListener(listener: (event: ClipboardEvent) =
  * ```
  */
 export declare function removeClipboardListener(subscription: Subscription): void;
+/**
+ * Property that determines if the `ClipboardPasteButton` is available.
+ *
+ * This requires the users device to be using at least iOS 16.
+ *
+ * `true` if the component is available, and `false` otherwise.
+ */
+export declare const isPasteButtonAvailable: boolean;
 export * from './Clipboard.types';
+export { ClipboardPasteButton };
 //# sourceMappingURL=Clipboard.d.ts.map

package/build/Clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.d.ts","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAiC,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAO3B,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAKjD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK1D;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAKpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAK5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAKtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,YAAY,CAe5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY,QAEjE;AAED,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"Clipboard.d.ts","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAiC,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAKjD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK1D;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAKpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAK5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAKtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,YAAY,CAe5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY,QAEjE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,OACiC,CAAC;AAEvE,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/build/Clipboard.js

@@ -1,4 +1,5 @@
 import { EventEmitter, UnavailabilityError, Platform } from 'expo-modules-core';
+import { ClipboardPasteButton } from './ClipboardPasteButton';
 import ExpoClipboard from './ExpoClipboard';
 const emitter = new EventEmitter(ExpoClipboard);
 const onClipboardEventName = 'onClipboardChanged';
@@ -204,5 +205,14 @@ export function addClipboardListener(listener) {
 export function removeClipboardListener(subscription) {
     emitter.removeSubscription(subscription);
 }
+/**
+ * Property that determines if the `ClipboardPasteButton` is available.
+ *
+ * This requires the users device to be using at least iOS 16.
+ *
+ * `true` if the component is available, and `false` otherwise.
+ */
+export const isPasteButtonAvailable = Platform.OS === 'ios' ? ExpoClipboard.isPasteButtonAvailable : false;
 export * from './Clipboard.types';
+export { ClipboardPasteButton };
 //# sourceMappingURL=Clipboard.js.map

package/build/Clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.js","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter, Subscription, UnavailabilityError, Platform } from 'expo-modules-core';\n\nimport {\n  ClipboardImage,\n  ContentType,\n  GetImageOptions,\n  GetStringOptions,\n  SetStringOptions,\n} from './Clipboard.types';\nimport ExpoClipboard from './ExpoClipboard';\n\nconst emitter = new EventEmitter(ExpoClipboard);\n\nconst onClipboardEventName = 'onClipboardChanged';\n\ntype ClipboardEvent = {\n  /**\n   * @deprecated Returns empty string. Use [`getStringAsync()`](#getstringasyncoptions) instead to retrieve clipboard content.\n   */\n  content: string;\n  /**\n   * An array of content types that are available on the clipboard.\n   */\n  contentTypes: ContentType[];\n};\n\nexport { Subscription, ClipboardEvent };\n\n/**\n * Gets the content of the user's clipboard. Please note that calling this method on web will prompt\n * the user to grant your app permission to \"see text and images copied to the clipboard.\"\n *\n * @param options Options for the clipboard content to be retrieved.\n * @returns A promise that resolves to the content of the clipboard.\n */\nexport async function getStringAsync(options: GetStringOptions = {}): Promise<string> {\n  if (!ExpoClipboard.getStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'getStringAsync');\n  }\n  return await ExpoClipboard.getStringAsync(options);\n}\n\n/**\n * Sets the content of the user's clipboard.\n *\n * @param text The string to save to the clipboard.\n * @param options Options for the clipboard content to be set.\n * @returns On web, this returns a promise that fulfills to a boolean value indicating whether or not\n * the string was saved to the user's clipboard. On iOS and Android, the promise always resolves to `true`.\n */\nexport async function setStringAsync(\n  text: string,\n  options: SetStringOptions = {}\n): Promise<boolean> {\n  if (!ExpoClipboard.setStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'setStringAsync');\n  }\n  return ExpoClipboard.setStringAsync(text, options);\n}\n\n/**\n * Sets the content of the user's clipboard.\n * @deprecated Use [`setStringAsync()`](#setstringasynctext-options) instead.\n *\n * @returns On web, this returns a boolean value indicating whether or not the string was saved to\n * the user's clipboard. On iOS and Android, nothing is returned.\n */\nexport function setString(text: string): void {\n  if (Platform.OS === 'web') {\n    // on web, we need to return legacy method,\n    // because of different return type\n    return ExpoClipboard.setString(text);\n  } else {\n    setStringAsync(text);\n  }\n}\n\n/**\n * Returns whether the clipboard has text content. Returns true for both plain text and rich text (e.g. HTML).\n *\n * On web, this requires the user to grant your app permission to _\"see text and images copied to the clipboard\"_.\n *\n * @returns A promise that fulfills to `true` if clipboard has text content, resolves to `false` otherwise.\n */\nexport function hasStringAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasStringAsync');\n  }\n  return ExpoClipboard.hasStringAsync();\n}\n\n/**\n * Gets the URL from the user's clipboard.\n *\n * @returns A promise that fulfills to the URL in the clipboard.\n * @platform ios\n */\nexport async function getUrlAsync(): Promise<string | null> {\n  if (!ExpoClipboard.getUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'getUrlAsync');\n  }\n  return await ExpoClipboard.getUrlAsync();\n}\n\n/**\n * Sets a URL in the user's clipboard.\n *\n * This function behaves the same as [`setStringAsync()`](#setstringasynctext-options), except that\n * it sets the clipboard content type to be a URL. It lets your app or other apps know that the\n * clipboard contains a URL and behave accordingly.\n *\n * @param url The URL to save to the clipboard.\n * @platform ios\n */\nexport async function setUrlAsync(url: string): Promise<void> {\n  if (!ExpoClipboard.setUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'setUrlAsync');\n  }\n  return ExpoClipboard.setUrlAsync(url);\n}\n\n/**\n * Returns whether the clipboard has a URL content.\n *\n * @returns A promise that fulfills to `true` if clipboard has URL content, resolves to `false` otherwise.\n * @platform ios\n */\nexport async function hasUrlAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasUrlAsync');\n  }\n  return await ExpoClipboard.hasUrlAsync();\n}\n\n/**\n * Gets the image from the user's clipboard and returns it in the specified format. Please note that calling\n * this method on web will prompt the user to grant your app permission to \"see text and images copied to the clipboard.\"\n *\n * @param options A `GetImageOptions` object to specify the desired format of the image.\n * @returns If there was an image in the clipboard, the promise resolves to\n * a [`ClipboardImage`](#clipboardimage) object containing the base64 string and metadata of the image.\n * Otherwise, it resolves to `null`.\n *\n * @example\n * ```tsx\n * const img = await Clipboard.getImageAsync({ format: 'png' });\n * // ...\n * <Image source={{ uri: img?.data }} style={{ width: 200, height: 200 }} />\n * ```\n */\nexport async function getImageAsync(options: GetImageOptions): Promise<ClipboardImage | null> {\n  if (!ExpoClipboard.getImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'getImageAsync');\n  }\n  return await ExpoClipboard.getImageAsync(options);\n}\n\n/**\n * Sets an image in the user's clipboard.\n *\n * @param base64Image Image encoded as a base64 string, without MIME type.\n *\n * @example\n * ```tsx\n * const result = await ImagePicker.launchImageLibraryAsync({\n *   mediaTypes: ImagePicker.MediaTypeOptions.Images,\n *   base64: true,\n * });\n * await Clipboard.setImageAsync(result.base64);\n * ```\n */\nexport async function setImageAsync(base64Image: string): Promise<void> {\n  if (!ExpoClipboard.setImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'setImageAsync');\n  }\n  return ExpoClipboard.setImageAsync(base64Image);\n}\n\n/**\n * Returns whether the clipboard has an image content.\n *\n * On web, this requires the user to grant your app permission to _\"see text and images copied to the clipboard\"_.\n *\n * @returns A promise that fulfills to `true` if clipboard has image content, resolves to `false` otherwise.\n */\nexport async function hasImageAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasImageAsync');\n  }\n  return ExpoClipboard.hasImageAsync();\n}\n\n/**\n * Adds a listener that will fire whenever the content of the user's clipboard changes. This method\n * is a no-op on Web.\n *\n * @param listener Callback to execute when listener is triggered. The callback is provided a\n * single argument that is an object containing information about clipboard contents.\n *\n * @example\n * ```typescript\n * Clipboard.addClipboardListener(({ contentTypes }: ClipboardEvent) => {\n *   if (contentTypes.includes(Clipboard.ContentType.PLAIN_TEXT)) {\n *     Clipboard.getStringAsync().then(content => {\n *       alert('Copy pasta! Here\\'s the string that was copied: ' + content)\n *     });\n *   } else if (contentTypes.includes(Clipboard.ContentType.IMAGE)) {\n *     alert('Yay! Clipboard contains an image');\n *   }\n * });\n * ```\n */\nexport function addClipboardListener(listener: (event: ClipboardEvent) => void): Subscription {\n  // TODO: Get rid of this wrapper once we remove deprecated `content` property (not before SDK47)\n  const listenerWrapper = (event: ClipboardEvent) => {\n    const wrappedEvent: ClipboardEvent = {\n      ...event,\n      get content(): string {\n        console.warn(\n          \"The 'content' property of the clipboard event is deprecated. Use 'getStringAsync()' instead to get clipboard content\"\n        );\n        return '';\n      },\n    };\n    listener(wrappedEvent);\n  };\n  return emitter.addListener<ClipboardEvent>(onClipboardEventName, listenerWrapper);\n}\n\n/**\n * Removes the listener added by addClipboardListener. This method is a no-op on Web.\n *\n * @param subscription The subscription to remove (created by addClipboardListener).\n *\n * @example\n * ```typescript\n * const subscription = addClipboardListener(() => {\n *   alert('Copy pasta!');\n * });\n * removeClipboardListener(subscription);\n * ```\n */\nexport function removeClipboardListener(subscription: Subscription) {\n  emitter.removeSubscription(subscription);\n}\n\nexport * from './Clipboard.types';\n"]}
+{"version":3,"file":"Clipboard.js","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter, Subscription, UnavailabilityError, Platform } from 'expo-modules-core';\n\nimport {\n  ClipboardImage,\n  ContentType,\n  GetImageOptions,\n  GetStringOptions,\n  SetStringOptions,\n} from './Clipboard.types';\nimport { ClipboardPasteButton } from './ClipboardPasteButton';\nimport ExpoClipboard from './ExpoClipboard';\n\nconst emitter = new EventEmitter(ExpoClipboard);\n\nconst onClipboardEventName = 'onClipboardChanged';\n\ntype ClipboardEvent = {\n  /**\n   * @deprecated Returns empty string. Use [`getStringAsync()`](#getstringasyncoptions) instead to retrieve clipboard content.\n   */\n  content: string;\n  /**\n   * An array of content types that are available on the clipboard.\n   */\n  contentTypes: ContentType[];\n};\n\nexport { Subscription, ClipboardEvent };\n\n/**\n * Gets the content of the user's clipboard. Please note that calling this method on web will prompt\n * the user to grant your app permission to \"see text and images copied to the clipboard.\"\n *\n * @param options Options for the clipboard content to be retrieved.\n * @returns A promise that resolves to the content of the clipboard.\n */\nexport async function getStringAsync(options: GetStringOptions = {}): Promise<string> {\n  if (!ExpoClipboard.getStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'getStringAsync');\n  }\n  return await ExpoClipboard.getStringAsync(options);\n}\n\n/**\n * Sets the content of the user's clipboard.\n *\n * @param text The string to save to the clipboard.\n * @param options Options for the clipboard content to be set.\n * @returns On web, this returns a promise that fulfills to a boolean value indicating whether or not\n * the string was saved to the user's clipboard. On iOS and Android, the promise always resolves to `true`.\n */\nexport async function setStringAsync(\n  text: string,\n  options: SetStringOptions = {}\n): Promise<boolean> {\n  if (!ExpoClipboard.setStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'setStringAsync');\n  }\n  return ExpoClipboard.setStringAsync(text, options);\n}\n\n/**\n * Sets the content of the user's clipboard.\n * @deprecated Use [`setStringAsync()`](#setstringasynctext-options) instead.\n *\n * @returns On web, this returns a boolean value indicating whether or not the string was saved to\n * the user's clipboard. On iOS and Android, nothing is returned.\n */\nexport function setString(text: string): void {\n  if (Platform.OS === 'web') {\n    // on web, we need to return legacy method,\n    // because of different return type\n    return ExpoClipboard.setString(text);\n  } else {\n    setStringAsync(text);\n  }\n}\n\n/**\n * Returns whether the clipboard has text content. Returns true for both plain text and rich text (e.g. HTML).\n *\n * On web, this requires the user to grant your app permission to _\"see text and images copied to the clipboard\"_.\n *\n * @returns A promise that fulfills to `true` if clipboard has text content, resolves to `false` otherwise.\n */\nexport function hasStringAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasStringAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasStringAsync');\n  }\n  return ExpoClipboard.hasStringAsync();\n}\n\n/**\n * Gets the URL from the user's clipboard.\n *\n * @returns A promise that fulfills to the URL in the clipboard.\n * @platform ios\n */\nexport async function getUrlAsync(): Promise<string | null> {\n  if (!ExpoClipboard.getUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'getUrlAsync');\n  }\n  return await ExpoClipboard.getUrlAsync();\n}\n\n/**\n * Sets a URL in the user's clipboard.\n *\n * This function behaves the same as [`setStringAsync()`](#setstringasynctext-options), except that\n * it sets the clipboard content type to be a URL. It lets your app or other apps know that the\n * clipboard contains a URL and behave accordingly.\n *\n * @param url The URL to save to the clipboard.\n * @platform ios\n */\nexport async function setUrlAsync(url: string): Promise<void> {\n  if (!ExpoClipboard.setUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'setUrlAsync');\n  }\n  return ExpoClipboard.setUrlAsync(url);\n}\n\n/**\n * Returns whether the clipboard has a URL content.\n *\n * @returns A promise that fulfills to `true` if clipboard has URL content, resolves to `false` otherwise.\n * @platform ios\n */\nexport async function hasUrlAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasUrlAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasUrlAsync');\n  }\n  return await ExpoClipboard.hasUrlAsync();\n}\n\n/**\n * Gets the image from the user's clipboard and returns it in the specified format. Please note that calling\n * this method on web will prompt the user to grant your app permission to \"see text and images copied to the clipboard.\"\n *\n * @param options A `GetImageOptions` object to specify the desired format of the image.\n * @returns If there was an image in the clipboard, the promise resolves to\n * a [`ClipboardImage`](#clipboardimage) object containing the base64 string and metadata of the image.\n * Otherwise, it resolves to `null`.\n *\n * @example\n * ```tsx\n * const img = await Clipboard.getImageAsync({ format: 'png' });\n * // ...\n * <Image source={{ uri: img?.data }} style={{ width: 200, height: 200 }} />\n * ```\n */\nexport async function getImageAsync(options: GetImageOptions): Promise<ClipboardImage | null> {\n  if (!ExpoClipboard.getImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'getImageAsync');\n  }\n  return await ExpoClipboard.getImageAsync(options);\n}\n\n/**\n * Sets an image in the user's clipboard.\n *\n * @param base64Image Image encoded as a base64 string, without MIME type.\n *\n * @example\n * ```tsx\n * const result = await ImagePicker.launchImageLibraryAsync({\n *   mediaTypes: ImagePicker.MediaTypeOptions.Images,\n *   base64: true,\n * });\n * await Clipboard.setImageAsync(result.base64);\n * ```\n */\nexport async function setImageAsync(base64Image: string): Promise<void> {\n  if (!ExpoClipboard.setImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'setImageAsync');\n  }\n  return ExpoClipboard.setImageAsync(base64Image);\n}\n\n/**\n * Returns whether the clipboard has an image content.\n *\n * On web, this requires the user to grant your app permission to _\"see text and images copied to the clipboard\"_.\n *\n * @returns A promise that fulfills to `true` if clipboard has image content, resolves to `false` otherwise.\n */\nexport async function hasImageAsync(): Promise<boolean> {\n  if (!ExpoClipboard.hasImageAsync) {\n    throw new UnavailabilityError('Clipboard', 'hasImageAsync');\n  }\n  return ExpoClipboard.hasImageAsync();\n}\n\n/**\n * Adds a listener that will fire whenever the content of the user's clipboard changes. This method\n * is a no-op on Web.\n *\n * @param listener Callback to execute when listener is triggered. The callback is provided a\n * single argument that is an object containing information about clipboard contents.\n *\n * @example\n * ```typescript\n * Clipboard.addClipboardListener(({ contentTypes }: ClipboardEvent) => {\n *   if (contentTypes.includes(Clipboard.ContentType.PLAIN_TEXT)) {\n *     Clipboard.getStringAsync().then(content => {\n *       alert('Copy pasta! Here\\'s the string that was copied: ' + content)\n *     });\n *   } else if (contentTypes.includes(Clipboard.ContentType.IMAGE)) {\n *     alert('Yay! Clipboard contains an image');\n *   }\n * });\n * ```\n */\nexport function addClipboardListener(listener: (event: ClipboardEvent) => void): Subscription {\n  // TODO: Get rid of this wrapper once we remove deprecated `content` property (not before SDK47)\n  const listenerWrapper = (event: ClipboardEvent) => {\n    const wrappedEvent: ClipboardEvent = {\n      ...event,\n      get content(): string {\n        console.warn(\n          \"The 'content' property of the clipboard event is deprecated. Use 'getStringAsync()' instead to get clipboard content\"\n        );\n        return '';\n      },\n    };\n    listener(wrappedEvent);\n  };\n  return emitter.addListener<ClipboardEvent>(onClipboardEventName, listenerWrapper);\n}\n\n/**\n * Removes the listener added by addClipboardListener. This method is a no-op on Web.\n *\n * @param subscription The subscription to remove (created by addClipboardListener).\n *\n * @example\n * ```typescript\n * const subscription = addClipboardListener(() => {\n *   alert('Copy pasta!');\n * });\n * removeClipboardListener(subscription);\n * ```\n */\nexport function removeClipboardListener(subscription: Subscription) {\n  emitter.removeSubscription(subscription);\n}\n\n/**\n * Property that determines if the `ClipboardPasteButton` is available.\n *\n * This requires the users device to be using at least iOS 16.\n *\n * `true` if the component is available, and `false` otherwise.\n */\nexport const isPasteButtonAvailable: boolean =\n  Platform.OS === 'ios' ? ExpoClipboard.isPasteButtonAvailable : false;\n\nexport * from './Clipboard.types';\nexport { ClipboardPasteButton };\n"]}

package/build/Clipboard.types.d.ts

@@ -1,3 +1,4 @@
+import { ViewProps, StyleProp, ViewStyle } from 'react-native';
 export interface GetImageOptions {
     /**
      * The format of the clipboard image to be converted to.
@@ -71,4 +72,75 @@ export interface SetStringOptions {
      */
     inputFormat?: StringFormat;
 }
+export interface ClipboardPasteButtonProps extends ViewProps {
+    /**
+     * A callback that is called with the result of the paste action.
+     * Inspect the `type` property to determine the type of the pasted data.
+     
+     * Can be one of `text` or `image`.
+     *
+     * @example
+     * ```ts
+     *   onPress={(data) => {
+     *     if (data.type === 'image') {
+     *       setImageData(data);
+     *    } else {
+     *       setTextData(data);
+     *     }
+     *   }}
+     * ```
+     */
+    onPress: (data: PasteEventPayload) => void;
+    /**
+     * The backgroundColor of the button.
+     * Leaving this as the default allows the color to adjust to the system theme settings.
+     */
+    backgroundColor?: string | null;
+    /**
+     * The foregroundColor of the button.
+     * @default white
+     */
+    foregroundColor?: string | null;
+    /**
+     * The cornerStyle of the button.
+     * @default capsule
+     *
+     * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uibutton/configuration/cornerstyle) for more details.
+     */
+    cornerStyle?: CornerStyle | null;
+    /**
+     * The displayMode of the button.
+     * @default `iconAndLabel`
+     *
+     * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol/displaymode) for more details.
+     */
+    displayMode?: DisplayMode | null;
+    /**
+     * The custom style to apply to the button. Should not include `backgroundColor`, `borderRadius` or `color`
+     * properties.
+     */
+    style?: StyleProp<Omit<ViewStyle, 'backgroundColor' | 'borderRadius' | 'color'>>;
+    /**
+     * The options to use when pasting an image from the clipboard.
+     */
+    imageOptions?: GetImageOptions | null;
+    /**
+     * An array of the content types that will cause the button to become active
+     * @note do not include `plain-text` and `html` at the same time as this will cause all text to be treated as `html`
+     * @default ['plain-text', 'image']
+     */
+    acceptedContentTypes?: AcceptedContentType[];
+}
+type AcceptedContentType = 'plain-text' | 'image' | 'url' | 'html';
+type CornerStyle = 'dynamic' | 'fixed' | 'capsule' | 'large' | 'medium' | 'small';
+type DisplayMode = 'iconAndLabel' | 'iconOnly' | 'labelOnly';
+export type PasteEventPayload = TextPasteEvent | ImagePasteEvent;
+export interface TextPasteEvent {
+    text: string;
+    type: 'text';
+}
+export interface ImagePasteEvent extends ClipboardImage {
+    type: 'image';
+}
+export {};
 //# sourceMappingURL=Clipboard.types.d.ts.map

package/build/Clipboard.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.types.d.ts","sourceRoot":"","sources":["../src/Clipboard.types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;OAcG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf;;OAEG;IACH,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,UAAU,cAAc;IACxB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B"}
+{"version":3,"file":"Clipboard.types.d.ts","sourceRoot":"","sources":["../src/Clipboard.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG/D,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;OAcG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf;;OAEG;IACH,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,UAAU,cAAc;IACxB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAGD,MAAM,WAAW,yBAA0B,SAAQ,SAAS;IAC1D;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IACjF;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9C;AAED,KAAK,mBAAmB,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnE,KAAK,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,KAAK,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,eAAe,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,OAAO,CAAC;CACf"}

package/build/Clipboard.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.types.js","sourceRoot":"","sources":["../src/Clipboard.types.ts"],"names":[],"mappings":"AAyCA;;GAEG;AACH,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf;;OAEG;IACH,0BAAW,CAAA;AACb,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,wCAAwB,CAAA;IACxB,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB","sourcesContent":["// @needsAudit\nexport interface GetImageOptions {\n  /**\n   * The format of the clipboard image to be converted to.\n   */\n  format: 'png' | 'jpeg';\n  /**\n   * Specify the quality of the returned image, between `0` and `1`. Defaults to `1` (highest quality).\n   * Applicable only when `format` is set to `jpeg`, ignored otherwise.\n   * @default 1\n   */\n  jpegQuality?: number;\n}\n\n// @needsAudit\nexport interface ClipboardImage {\n  /**\n   * A Base64-encoded string of the image data.\n   * Its format is dependent on the `format` option.\n   *\n   * > **NOTE:** The string is already prepended with `data:image/png;base64,` or `data:image/jpeg;base64,` prefix.\n   *\n   * You can use it directly as the source of an `Image` element.\n   * @example\n   * ```ts\n   * <Image\n   *   source={{ uri: clipboardImage.data }}\n   *   style={{ width: 200, height: 200 }}\n   * />\n   * ```\n   */\n  data: string;\n  /**\n   * Dimensions (`width` and `height`) of the image pasted from clipboard.\n   */\n  size: {\n    width: number;\n    height: number;\n  };\n}\n\n/**\n * Type used to define what type of data is stored in the clipboard.\n */\nexport enum ContentType {\n  PLAIN_TEXT = 'plain-text',\n  HTML = 'html',\n  IMAGE = 'image',\n  /**\n   * @platform iOS\n   */\n  URL = 'url',\n}\n\n/**\n * Type used to determine string format stored in the clipboard.\n */\nexport enum StringFormat {\n  PLAIN_TEXT = 'plainText',\n  HTML = 'html',\n}\n\nexport interface GetStringOptions {\n  /**\n   * The target format of the clipboard string to be converted to, if possible.\n   *\n   * @default StringFormat.PLAIN_TEXT\n   */\n  preferredFormat?: StringFormat;\n}\n\nexport interface SetStringOptions {\n  /**\n   * The input format of the provided string.\n   * Adjusting this option can help other applications interpret copied string properly.\n   *\n   * @default StringFormat.PLAIN_TEXT\n   */\n  inputFormat?: StringFormat;\n}\n"]}
+{"version":3,"file":"Clipboard.types.js","sourceRoot":"","sources":["../src/Clipboard.types.ts"],"names":[],"mappings":"AA2CA;;GAEG;AACH,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf;;OAEG;IACH,0BAAW,CAAA;AACb,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,wCAAwB,CAAA;IACxB,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB","sourcesContent":["import { ViewProps, StyleProp, ViewStyle } from 'react-native';\n\n// @needsAudit\nexport interface GetImageOptions {\n  /**\n   * The format of the clipboard image to be converted to.\n   */\n  format: 'png' | 'jpeg';\n  /**\n   * Specify the quality of the returned image, between `0` and `1`. Defaults to `1` (highest quality).\n   * Applicable only when `format` is set to `jpeg`, ignored otherwise.\n   * @default 1\n   */\n  jpegQuality?: number;\n}\n\n// @needsAudit\nexport interface ClipboardImage {\n  /**\n   * A Base64-encoded string of the image data.\n   * Its format is dependent on the `format` option.\n   *\n   * > **NOTE:** The string is already prepended with `data:image/png;base64,` or `data:image/jpeg;base64,` prefix.\n   *\n   * You can use it directly as the source of an `Image` element.\n   * @example\n   * ```ts\n   * <Image\n   *   source={{ uri: clipboardImage.data }}\n   *   style={{ width: 200, height: 200 }}\n   * />\n   * ```\n   */\n  data: string;\n  /**\n   * Dimensions (`width` and `height`) of the image pasted from clipboard.\n   */\n  size: {\n    width: number;\n    height: number;\n  };\n}\n\n/**\n * Type used to define what type of data is stored in the clipboard.\n */\nexport enum ContentType {\n  PLAIN_TEXT = 'plain-text',\n  HTML = 'html',\n  IMAGE = 'image',\n  /**\n   * @platform iOS\n   */\n  URL = 'url',\n}\n\n/**\n * Type used to determine string format stored in the clipboard.\n */\nexport enum StringFormat {\n  PLAIN_TEXT = 'plainText',\n  HTML = 'html',\n}\n\nexport interface GetStringOptions {\n  /**\n   * The target format of the clipboard string to be converted to, if possible.\n   *\n   * @default StringFormat.PLAIN_TEXT\n   */\n  preferredFormat?: StringFormat;\n}\n\nexport interface SetStringOptions {\n  /**\n   * The input format of the provided string.\n   * Adjusting this option can help other applications interpret copied string properly.\n   *\n   * @default StringFormat.PLAIN_TEXT\n   */\n  inputFormat?: StringFormat;\n}\n\n// @needsAudit\nexport interface ClipboardPasteButtonProps extends ViewProps {\n  /**\n   * A callback that is called with the result of the paste action.\n   * Inspect the `type` property to determine the type of the pasted data.\n   \n   * Can be one of `text` or `image`.\n   *\n   * @example\n   * ```ts\n   *   onPress={(data) => {\n   *     if (data.type === 'image') {\n   *       setImageData(data);\n   *    } else {\n   *       setTextData(data);\n   *     }\n   *   }}\n   * ```\n   */\n  onPress: (data: PasteEventPayload) => void;\n  /**\n   * The backgroundColor of the button.\n   * Leaving this as the default allows the color to adjust to the system theme settings.\n   */\n  backgroundColor?: string | null;\n  /**\n   * The foregroundColor of the button.\n   * @default white\n   */\n  foregroundColor?: string | null;\n  /**\n   * The cornerStyle of the button.\n   * @default capsule\n   *\n   * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uibutton/configuration/cornerstyle) for more details.\n   */\n  cornerStyle?: CornerStyle | null;\n  /**\n   * The displayMode of the button.\n   * @default `iconAndLabel`\n   *\n   * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol/displaymode) for more details.\n   */\n  displayMode?: DisplayMode | null;\n  /**\n   * The custom style to apply to the button. Should not include `backgroundColor`, `borderRadius` or `color`\n   * properties.\n   */\n  style?: StyleProp<Omit<ViewStyle, 'backgroundColor' | 'borderRadius' | 'color'>>;\n  /**\n   * The options to use when pasting an image from the clipboard.\n   */\n  imageOptions?: GetImageOptions | null;\n  /**\n   * An array of the content types that will cause the button to become active\n   * @note do not include `plain-text` and `html` at the same time as this will cause all text to be treated as `html`\n   * @default ['plain-text', 'image']\n   */\n  acceptedContentTypes?: AcceptedContentType[];\n}\n\ntype AcceptedContentType = 'plain-text' | 'image' | 'url' | 'html';\n\ntype CornerStyle = 'dynamic' | 'fixed' | 'capsule' | 'large' | 'medium' | 'small';\n\ntype DisplayMode = 'iconAndLabel' | 'iconOnly' | 'labelOnly';\n\nexport type PasteEventPayload = TextPasteEvent | ImagePasteEvent;\n\nexport interface TextPasteEvent {\n  text: string;\n  type: 'text';\n}\n\nexport interface ImagePasteEvent extends ClipboardImage {\n  type: 'image';\n}\n"]}

package/build/ClipboardPasteButton.d.ts

@@ -0,0 +1,20 @@
+import { ClipboardPasteButtonProps } from './Clipboard.types';
+/**
+ * This component displays the `UIPasteControl` button on your screen. This allows pasting from the clipboard without requesting permission from the user.
+ *
+ * You should only attempt to render this if [`Clipboard.isPasteButtonAvailable`](#ispastebuttonavailable)
+ * is `true`. This component will render nothing if it is not available, and you will get
+ * a warning in development mode (`__DEV__ === true`).
+ *
+ * The properties of this component extend from `View`; however, you should not attempt to set
+ * `backgroundColor`, `color` or `borderRadius` with the `style` property. Apple restricts customisation of this view.
+ * Instead, you should use the backgroundColor and foregroundColor properties to set the colors of the button, the cornerStyle property to change the border radius,
+ * and the displayMode property to change the appearance of the icon and label. The word "Paste" is not editable and neither is the icon.
+ *
+ * Make sure to attach height and width via the style props as without these styles, the button will
+ * not appear on the screen.
+ *
+ * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol) for more details.
+ */
+export declare function ClipboardPasteButton({ onPress, ...restProps }: ClipboardPasteButtonProps): JSX.Element | null;
+//# sourceMappingURL=ClipboardPasteButton.d.ts.map

package/build/ClipboardPasteButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardPasteButton.d.ts","sourceRoot":"","sources":["../src/ClipboardPasteButton.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAqB,MAAM,mBAAmB,CAAC;AAIjF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,yBAAyB,sBAaxF"}

package/build/ClipboardPasteButton.js

@@ -0,0 +1,33 @@
+import React from 'react';
+import ExpoClipboardPasteButton from './ExpoClipboardPasteButton';
+// @needsAudit
+/**
+ * This component displays the `UIPasteControl` button on your screen. This allows pasting from the clipboard without requesting permission from the user.
+ *
+ * You should only attempt to render this if [`Clipboard.isPasteButtonAvailable`](#ispastebuttonavailable)
+ * is `true`. This component will render nothing if it is not available, and you will get
+ * a warning in development mode (`__DEV__ === true`).
+ *
+ * The properties of this component extend from `View`; however, you should not attempt to set
+ * `backgroundColor`, `color` or `borderRadius` with the `style` property. Apple restricts customisation of this view.
+ * Instead, you should use the backgroundColor and foregroundColor properties to set the colors of the button, the cornerStyle property to change the border radius,
+ * and the displayMode property to change the appearance of the icon and label. The word "Paste" is not editable and neither is the icon.
+ *
+ * Make sure to attach height and width via the style props as without these styles, the button will
+ * not appear on the screen.
+ *
+ * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol) for more details.
+ */
+export function ClipboardPasteButton({ onPress, ...restProps }) {
+    if (!ExpoClipboardPasteButton) {
+        if (__DEV__) {
+            console.warn("'ApplePasteButton' is not available.");
+        }
+        return null;
+    }
+    const onPastePressed = ({ nativeEvent }) => {
+        onPress(nativeEvent);
+    };
+    return React.createElement(ExpoClipboardPasteButton, { onPastePressed: onPastePressed, ...restProps });
+}
+//# sourceMappingURL=ClipboardPasteButton.js.map

package/build/ClipboardPasteButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardPasteButton.js","sourceRoot":"","sources":["../src/ClipboardPasteButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,wBAAwB,MAAM,4BAA4B,CAAC;AAElE,cAAc;AACd;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,EAA6B;IACvF,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;SACtD;QACD,OAAO,IAAI,CAAC;KACb;IAED,MAAM,cAAc,GAAG,CAAC,EAAE,WAAW,EAA2C,EAAE,EAAE;QAClF,OAAO,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,oBAAC,wBAAwB,IAAC,cAAc,EAAE,cAAc,KAAM,SAAS,GAAI,CAAC;AACrF,CAAC","sourcesContent":["import React from 'react';\nimport { NativeSyntheticEvent } from 'react-native';\n\nimport { ClipboardPasteButtonProps, PasteEventPayload } from './Clipboard.types';\nimport ExpoClipboardPasteButton from './ExpoClipboardPasteButton';\n\n// @needsAudit\n/**\n * This component displays the `UIPasteControl` button on your screen. This allows pasting from the clipboard without requesting permission from the user.\n *\n * You should only attempt to render this if [`Clipboard.isPasteButtonAvailable`](#ispastebuttonavailable)\n * is `true`. This component will render nothing if it is not available, and you will get\n * a warning in development mode (`__DEV__ === true`).\n *\n * The properties of this component extend from `View`; however, you should not attempt to set\n * `backgroundColor`, `color` or `borderRadius` with the `style` property. Apple restricts customisation of this view.\n * Instead, you should use the backgroundColor and foregroundColor properties to set the colors of the button, the cornerStyle property to change the border radius,\n * and the displayMode property to change the appearance of the icon and label. The word \"Paste\" is not editable and neither is the icon.\n *\n * Make sure to attach height and width via the style props as without these styles, the button will\n * not appear on the screen.\n *\n * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol) for more details.\n */\nexport function ClipboardPasteButton({ onPress, ...restProps }: ClipboardPasteButtonProps) {\n  if (!ExpoClipboardPasteButton) {\n    if (__DEV__) {\n      console.warn(\"'ApplePasteButton' is not available.\");\n    }\n    return null;\n  }\n\n  const onPastePressed = ({ nativeEvent }: NativeSyntheticEvent<PasteEventPayload>) => {\n    onPress(nativeEvent);\n  };\n\n  return <ExpoClipboardPasteButton onPastePressed={onPastePressed} {...restProps} />;\n}\n"]}

package/build/ExpoClipboardPasteButton.d.ts

@@ -0,0 +1,3 @@
+declare let ExpoClipboard: any;
+export default ExpoClipboard;
+//# sourceMappingURL=ExpoClipboardPasteButton.d.ts.map

package/build/ExpoClipboardPasteButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoClipboardPasteButton.d.ts","sourceRoot":"","sources":["../src/ExpoClipboardPasteButton.ts"],"names":[],"mappings":"AAGA,QAAA,IAAI,aAAa,EAAE,GAAG,CAAC;AAMvB,eAAe,aAAa,CAAC"}

package/build/ExpoClipboardPasteButton.js

@@ -0,0 +1,8 @@
+import { requireNativeViewManager } from 'expo-modules-core';
+import { Platform } from 'react-native';
+let ExpoClipboard;
+if (Platform.OS === 'ios') {
+    ExpoClipboard = requireNativeViewManager('ExpoClipboard');
+}
+export default ExpoClipboard;
+//# sourceMappingURL=ExpoClipboardPasteButton.js.map

package/build/ExpoClipboardPasteButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoClipboardPasteButton.js","sourceRoot":"","sources":["../src/ExpoClipboardPasteButton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,IAAI,aAAkB,CAAC;AAEvB,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE;IACzB,aAAa,GAAG,wBAAwB,CAAC,eAAe,CAAC,CAAC;CAC3D;AAED,eAAe,aAAa,CAAC","sourcesContent":["import { requireNativeViewManager } from 'expo-modules-core';\nimport { Platform } from 'react-native';\n\nlet ExpoClipboard: any;\n\nif (Platform.OS === 'ios') {\n  ExpoClipboard = requireNativeViewManager('ExpoClipboard');\n}\n\nexport default ExpoClipboard;\n"]}

package/ios/ClipboardModule.swift

@@ -9,7 +9,7 @@ public class ClipboardModule: Module {
   public func definition() -> ModuleDefinition {
     Name("ExpoClipboard")
 
-    // MARK: Strings
+    // MARK: - Strings
 
     AsyncFunction("getStringAsync") { (options: GetStringOptions) -> String in
       switch options.preferredFormat {
@@ -35,7 +35,7 @@ public class ClipboardModule: Module {
       return UIPasteboard.general.hasStrings || UIPasteboard.general.hasHTML
     }
 
-    // MARK: URLs
+    // MARK: - URLs
 
     AsyncFunction("getUrlAsync") { () -> String? in
       return UIPasteboard.general.url?.absoluteString
@@ -49,7 +49,7 @@ public class ClipboardModule: Module {
       return UIPasteboard.general.hasURLs
     }
 
-    // MARK: Images
+    // MARK: - Images
 
     AsyncFunction("setImageAsync") { (content: String) in
       guard let data = Data(base64Encoded: content),
@@ -82,7 +82,14 @@ public class ClipboardModule: Module {
       ]
     }
 
-    // MARK: Events
+    Property("isPasteButtonAvailable") { () -> Bool in
+      if #available(iOS 16.0, *) {
+        return true
+      }
+      return false
+    }
+
+    // MARK: - Events
 
     Events(onClipboardChanged)
 
@@ -99,6 +106,44 @@ public class ClipboardModule: Module {
     OnStopObserving {
       NotificationCenter.default.removeObserver(self, name: UIPasteboard.changedNotification, object: nil)
     }
+
+    // MARK: - View
+
+    View(ClipboardPasteButton.self) {
+      Events("onPastePressed")
+
+      Prop("backgroundColor") { (view, color: UIColor?) in
+        if view.baseBackgroundColor != color {
+          view.baseBackgroundColor = color
+        }
+      }
+
+      Prop("foregroundColor") { (view, color: UIColor?) in
+        if view.baseForegroundColor != color {
+          view.baseForegroundColor = color
+        }
+      }
+
+      Prop("acceptedContentTypes") { (view, types: [AcceptedTypes]?) in
+        view.acceptedContentTypes = types ?? []
+      }
+
+      Prop("cornerStyle") { (view, style: CornerStyle?) in
+        view.cornerStyle = style ?? .capsule
+      }
+
+      Prop("displayMode") { (view, mode: DisplayMode?) in
+        view.displayMode = mode ?? .iconAndLabel
+      }
+
+      Prop("imageOptions") { (view, options: GetImageOptions?) in
+        view.imageOptions = options ?? GetImageOptions()
+      }
+
+      OnViewDidUpdateProps { view in
+        view.update()
+      }
+    }
   }
 
   @objc

package/ios/ClipboardPasteButton.swift

@@ -0,0 +1,170 @@
+import ExpoModulesCore
+import UniformTypeIdentifiers
+
+class ClipboardPasteButton: ExpoView {
+  let onPastePressed = EventDispatcher()
+
+  // MARK: - Properties
+  var baseBackgroundColor: UIColor?
+  var baseForegroundColor: UIColor?
+  var cornerStyle: CornerStyle = .capsule
+  var displayMode: DisplayMode = .iconAndLabel
+  var acceptedContentTypes: [AcceptedTypes] = []
+  var imageOptions = GetImageOptions()
+
+  private var childView: UIView?
+
+  func update() {
+    unmountChild()
+    if #available(iOS 16.0, *) {
+      mountView()
+    } else {
+      log.error("ClipboardPasteButton is only supported on iOS 16 and above")
+    }
+  }
+
+  @available(iOS 16.0, *)
+  private func mountView() {
+    let configuration = UIPasteControl.Configuration()
+    configuration.baseBackgroundColor = baseBackgroundColor
+    configuration.baseForegroundColor = baseForegroundColor
+    configuration.cornerStyle = cornerStyle.toCornerStyle()
+    configuration.displayMode = displayMode.toUIDisplayMode()
+
+    let control = UIPasteControl(configuration: configuration)
+    control.translatesAutoresizingMaskIntoConstraints = false
+    control.target = self
+    setContentTypes()
+
+    self.addSubview(control)
+    childView = control
+
+    NSLayoutConstraint.activate([
+      control.topAnchor.constraint(equalTo: topAnchor),
+      control.bottomAnchor.constraint(equalTo: bottomAnchor),
+      control.leadingAnchor.constraint(equalTo: leadingAnchor),
+      control.trailingAnchor.constraint(equalTo: trailingAnchor)
+    ])
+  }
+
+  override func paste(itemProviders: [NSItemProvider]) {
+    guard #available(iOS 14.0, *) else {
+      return
+    }
+    for provider in itemProviders {
+      if provider.hasItemConformingToTypeIdentifier(UTType.image.identifier) {
+        _ = provider.loadObject(ofClass: UIImage.self) { data, error in
+          guard error == nil else {
+            log.error("Error loading pasted image")
+            return
+          }
+          self.processImage(item: data)
+        }
+      } else if provider.hasItemConformingToTypeIdentifier(UTType.url.identifier) {
+        _ = provider.loadObject(ofClass: URL.self) { data, error in
+          guard error == nil else {
+            log.error("Error loading pasted content")
+            return
+          }
+
+          self.onPastePressed([
+            "type": "text",
+            "text": data?.absoluteString
+          ])
+        }
+      } else if provider.hasItemConformingToTypeIdentifier(UTType.html.identifier) && acceptedContentTypes.contains(.html) {
+        _ = provider.loadObject(ofClass: String.self) { data, error in
+          guard error == nil else {
+            log.error("Error loading pasted content")
+            return
+          }
+          self.processHtml(data: data)
+        }
+      } else if provider.hasItemConformingToTypeIdentifier(UTType.utf8PlainText.identifier) && !acceptedContentTypes.contains(.html) {
+        _ = provider.loadObject(ofClass: String.self) { data, error in
+          guard error == nil else {
+            log.error("Error loading pasted content")
+            return
+          }
+
+          guard let data = data as? String else {
+            log.error("Failed to read text data")
+            return
+          }
+
+          self.onPastePressed([
+            "type": "text",
+            "text": data
+          ])
+        }
+      }
+    }
+  }
+
+  @available(iOS 14.0, *)
+  private func setContentTypes() {
+    if acceptedContentTypes.isEmpty {
+      pasteConfiguration = UIPasteConfiguration(acceptableTypeIdentifiers: [
+        UTType.utf8PlainText.identifier,
+        UTType.image.identifier
+      ])
+    } else {
+      pasteConfiguration = UIPasteConfiguration(acceptableTypeIdentifiers: acceptedContentTypes.map {
+        $0.typeIdentifier()
+      })
+    }
+  }
+
+  private func processImage(item: NSItemProviderReading?) {
+    guard let image = item as? UIImage else {
+      log.error("Failed to read image data")
+      return
+    }
+
+    guard let data = imageToData(image) else {
+      log.error("Failed to process image data")
+      return
+    }
+
+    guard let fileSystem = appContext?.fileSystem else {
+      log.error("Failed to access FileSystem")
+      return
+    }
+
+    let imageData = "data:\(imageOptions.imageFormat.getMimeType());base64,\(data.base64EncodedString())"
+    self.onPastePressed([
+      "type": "image",
+      "data": imageData,
+      "size": [
+        "width": image.size.width,
+        "height": image.size.height
+      ]
+    ])
+  }
+
+  private func processHtml(data: String?) {
+    guard let htmlString = data as? String else {
+      log.error("Failed to read html data")
+      return
+    }
+
+    let attributedString = try? NSAttributedString(htmlString: htmlString)
+
+    self.onPastePressed([
+      "type": "text",
+      "text": attributedString?.htmlString ?? ""
+    ])
+  }
+
+  private func unmountChild() {
+    childView?.removeFromSuperview()
+    childView = nil
+  }
+
+  private func imageToData(_ image: UIImage) -> Data? {
+    switch imageOptions.imageFormat {
+    case .jpeg: return image.jpegData(compressionQuality: imageOptions.jpegQuality)
+    case .png: return image.pngData()
+    }
+  }
+}

package/ios/ClipboardPasteButtonRecords.swift

@@ -0,0 +1,67 @@
+import ExpoModulesCore
+
+enum CornerStyle: String, Enumerable {
+  case dynamic
+  case fixed
+  case capsule
+  case large
+  case medium
+  case small
+
+  @available(iOS 16.0, *)
+  func toCornerStyle() -> UIButton.Configuration.CornerStyle {
+    switch self {
+    case .dynamic:
+      return .dynamic
+    case .fixed:
+      return .fixed
+    case .capsule:
+      return .capsule
+    case .large:
+      return .large
+    case .medium:
+      return .medium
+    case .small:
+      return .small
+    }
+  }
+}
+
+enum DisplayMode: String, Enumerable {
+  case iconAndLabel
+  case iconOnly
+  case labelOnly
+
+  @available(iOS 16.0, *)
+  func toUIDisplayMode() -> UIPasteControl.DisplayMode {
+    switch self {
+    case .iconOnly:
+      return .iconOnly
+    case .labelOnly:
+      return .labelOnly
+    case .iconAndLabel:
+      return .iconAndLabel
+    }
+  }
+}
+
+enum AcceptedTypes: String, Enumerable {
+  case plainText = "plain-text"
+  case url
+  case html
+  case image
+
+  @available(iOS 14.0, *)
+  func typeIdentifier() -> String {
+    switch self {
+    case .plainText:
+      return UTType.utf8PlainText.identifier
+    case .html:
+      return UTType.html.identifier
+    case .image:
+      return UTType.image.identifier
+    case .url:
+      return UTType.url.identifier
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-clipboard",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "description": "ExpoClipboard standalone module",
   "main": "build/Clipboard.js",
   "types": "build/Clipboard.d.ts",
@@ -39,5 +39,5 @@
   "jest": {
     "preset": "expo-module-scripts/universal"
   },
-  "gitHead": "4ba50c428c8369bb6b3a51a860d4898ad4ccbe78"
+  "gitHead": "2240630a92eb79a4e4bf73e1439916c394876478"
 }

package/src/Clipboard.ts

@@ -7,6 +7,7 @@ import {
   GetStringOptions,
   SetStringOptions,
 } from './Clipboard.types';
+import { ClipboardPasteButton } from './ClipboardPasteButton';
 import ExpoClipboard from './ExpoClipboard';
 
 const emitter = new EventEmitter(ExpoClipboard);
@@ -244,4 +245,15 @@ export function removeClipboardListener(subscription: Subscription) {
   emitter.removeSubscription(subscription);
 }
 
+/**
+ * Property that determines if the `ClipboardPasteButton` is available.
+ *
+ * This requires the users device to be using at least iOS 16.
+ *
+ * `true` if the component is available, and `false` otherwise.
+ */
+export const isPasteButtonAvailable: boolean =
+  Platform.OS === 'ios' ? ExpoClipboard.isPasteButtonAvailable : false;
+
 export * from './Clipboard.types';
+export { ClipboardPasteButton };

package/src/Clipboard.types.ts

@@ -1,3 +1,5 @@
+import { ViewProps, StyleProp, ViewStyle } from 'react-native';
+
 // @needsAudit
 export interface GetImageOptions {
   /**
@@ -78,3 +80,81 @@ export interface SetStringOptions {
    */
   inputFormat?: StringFormat;
 }
+
+// @needsAudit
+export interface ClipboardPasteButtonProps extends ViewProps {
+  /**
+   * A callback that is called with the result of the paste action.
+   * Inspect the `type` property to determine the type of the pasted data.
+   
+   * Can be one of `text` or `image`.
+   *
+   * @example
+   * ```ts
+   *   onPress={(data) => {
+   *     if (data.type === 'image') {
+   *       setImageData(data);
+   *    } else {
+   *       setTextData(data);
+   *     }
+   *   }}
+   * ```
+   */
+  onPress: (data: PasteEventPayload) => void;
+  /**
+   * The backgroundColor of the button.
+   * Leaving this as the default allows the color to adjust to the system theme settings.
+   */
+  backgroundColor?: string | null;
+  /**
+   * The foregroundColor of the button.
+   * @default white
+   */
+  foregroundColor?: string | null;
+  /**
+   * The cornerStyle of the button.
+   * @default capsule
+   *
+   * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uibutton/configuration/cornerstyle) for more details.
+   */
+  cornerStyle?: CornerStyle | null;
+  /**
+   * The displayMode of the button.
+   * @default `iconAndLabel`
+   *
+   * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol/displaymode) for more details.
+   */
+  displayMode?: DisplayMode | null;
+  /**
+   * The custom style to apply to the button. Should not include `backgroundColor`, `borderRadius` or `color`
+   * properties.
+   */
+  style?: StyleProp<Omit<ViewStyle, 'backgroundColor' | 'borderRadius' | 'color'>>;
+  /**
+   * The options to use when pasting an image from the clipboard.
+   */
+  imageOptions?: GetImageOptions | null;
+  /**
+   * An array of the content types that will cause the button to become active
+   * @note do not include `plain-text` and `html` at the same time as this will cause all text to be treated as `html`
+   * @default ['plain-text', 'image']
+   */
+  acceptedContentTypes?: AcceptedContentType[];
+}
+
+type AcceptedContentType = 'plain-text' | 'image' | 'url' | 'html';
+
+type CornerStyle = 'dynamic' | 'fixed' | 'capsule' | 'large' | 'medium' | 'small';
+
+type DisplayMode = 'iconAndLabel' | 'iconOnly' | 'labelOnly';
+
+export type PasteEventPayload = TextPasteEvent | ImagePasteEvent;
+
+export interface TextPasteEvent {
+  text: string;
+  type: 'text';
+}
+
+export interface ImagePasteEvent extends ClipboardImage {
+  type: 'image';
+}

package/src/ClipboardPasteButton.tsx

@@ -0,0 +1,38 @@
+import React from 'react';
+import { NativeSyntheticEvent } from 'react-native';
+
+import { ClipboardPasteButtonProps, PasteEventPayload } from './Clipboard.types';
+import ExpoClipboardPasteButton from './ExpoClipboardPasteButton';
+
+// @needsAudit
+/**
+ * This component displays the `UIPasteControl` button on your screen. This allows pasting from the clipboard without requesting permission from the user.
+ *
+ * You should only attempt to render this if [`Clipboard.isPasteButtonAvailable`](#ispastebuttonavailable)
+ * is `true`. This component will render nothing if it is not available, and you will get
+ * a warning in development mode (`__DEV__ === true`).
+ *
+ * The properties of this component extend from `View`; however, you should not attempt to set
+ * `backgroundColor`, `color` or `borderRadius` with the `style` property. Apple restricts customisation of this view.
+ * Instead, you should use the backgroundColor and foregroundColor properties to set the colors of the button, the cornerStyle property to change the border radius,
+ * and the displayMode property to change the appearance of the icon and label. The word "Paste" is not editable and neither is the icon.
+ *
+ * Make sure to attach height and width via the style props as without these styles, the button will
+ * not appear on the screen.
+ *
+ * @see [Apple Documentation](https://developer.apple.com/documentation/uikit/uipastecontrol) for more details.
+ */
+export function ClipboardPasteButton({ onPress, ...restProps }: ClipboardPasteButtonProps) {
+  if (!ExpoClipboardPasteButton) {
+    if (__DEV__) {
+      console.warn("'ApplePasteButton' is not available.");
+    }
+    return null;
+  }
+
+  const onPastePressed = ({ nativeEvent }: NativeSyntheticEvent<PasteEventPayload>) => {
+    onPress(nativeEvent);
+  };
+
+  return <ExpoClipboardPasteButton onPastePressed={onPastePressed} {...restProps} />;
+}

package/src/ExpoClipboardPasteButton.ts

@@ -0,0 +1,10 @@
+import { requireNativeViewManager } from 'expo-modules-core';
+import { Platform } from 'react-native';
+
+let ExpoClipboard: any;
+
+if (Platform.OS === 'ios') {
+  ExpoClipboard = requireNativeViewManager('ExpoClipboard');
+}
+
+export default ExpoClipboard;

package/tsconfig.json

@@ -5,5 +5,5 @@
     "outDir": "./build"
   },
   "include": ["./src"],
-  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__stories__/*"]
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"]
 }