expo-file-system 19.0.3 → 19.0.5

package/CHANGELOG.md

@@ -10,6 +10,14 @@
 
 ### 💡 Others
 
+## 19.0.5 — 2025-08-25
+
+_This version does not introduce any user-facing changes._
+
+## 19.0.4 — 2025-08-21
+
+_This version does not introduce any user-facing changes._
+
 ## 19.0.3 — 2025-08-18
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '19.0.3'
+version = '19.0.5'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "19.0.3"
+    versionName "19.0.5"
   }
 }
 

package/build/ExpoFileSystem.types.d.ts

@@ -69,9 +69,11 @@ export declare class Directory {
      */
     list(): (Directory | File)[];
     /**
-     * Retrieves an object containing properties of a directory
+     * Retrieves an object containing properties of a directory.
+     *
      * @throws Error If the application does not have read access to the directory, or if the path does not point to a directory (e.g., it points to a file).
-     * @returns An object with directory metadata (e.g., size, creation date, etc.).
+     *
+     * @returns An object with directory metadata (for example, size, creation date, and so on).
      */
     info(): DirectoryInfo;
     /**
@@ -79,10 +81,10 @@ export declare class Directory {
      */
     size: number | null;
     /**
-     * @platform android
      * A static method that opens a file picker to select a directory.
      * @param initialUri An optional uri pointing to an initial folder on which the directory picker is opened.
-     * @returns a `Directory` instance. The underlying uri will be a content uri on Android.
+     * @returns a `Directory` instance. The underlying uri will be a content URI on Android.
+     * @platform android
      */
     static pickDirectoryAsync(initialUri?: string): Promise<Directory>;
 }
@@ -156,8 +158,8 @@ export declare class File {
     delete(): void;
     /**
      * Retrieves an object containing properties of a file
-     * @throws Error If the application does not have read access to the file, or if the path does not point to a file (e.g., it points to a directory).
-     * @returns An object with file metadata (e.g., size, creation date, etc.).
+     * @throws Error If the application does not have read access to the file, or if the path does not point to a file (for example, it points to a directory).
+     * @returns An object with file metadata (for example, size, creation date, and so on).
      */
     info(options?: InfoOptions): FileInfo;
     /**
@@ -180,15 +182,18 @@ export declare class File {
      */
     move(destination: Directory | File): void;
     /**
-     * Returns a FileHandle object that can be used to read and write data to the file.
+     * Returns A `FileHandle` object that can be used to read and write data to the file.
      * @throws Error if the file does not exist or cannot be opened.
      */
     open(): FileHandle;
     /**
      * A static method that downloads a file from the network.
+     *
      * @param url - The URL of the file to download.
      * @param destination - The destination directory or file. If a directory is provided, the resulting filename will be determined based on the response headers.
+     *
      * @returns A promise that resolves to the downloaded file.
+     *
      * @example
      * ```ts
      * const file = await File.downloadFileAsync("https://example.com/image.png", new Directory(Paths.document));
@@ -196,11 +201,14 @@ export declare class File {
      */
     static downloadFileAsync(url: string, destination: Directory | File, options?: DownloadOptions): Promise<File>;
     /**
-     * @platform android
      * A static method that opens a file picker to select a single file of specified type.
-     * @param initialUri An optional uri pointing to an initial folder on which the file picker is opened.
+     *
+     * @platform android
+     *
+     * @param initialUri An optional URI pointing to an initial folder on which the file picker is opened.
      * @param mimeType A mime type that is used to filter out files that can be picked out.
      * @returns a `File` instance.
+     * @platform android
      */
     static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File>;
     /**
@@ -260,6 +268,7 @@ export type FileInfo = {
 export type InfoOptions = {
     /**
      * Whether to return the MD5 hash of the file.
+     *
      * @default false
      */
     md5?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../src/ExpoFileSystem.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../src/ExpoFileSystem.types.ts"],"names":[],"mappings":"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"}

package/build/FileSystem.d.ts

@@ -28,13 +28,26 @@ export declare class Paths extends PathUtilities {
      */
     static info(...uris: string[]): PathInfo;
 }
+/**
+ * Represents a file on the filesystem.
+ *
+ * A `File` instance can be created for any path, and does not need to exist on the filesystem during creation.
+ *
+ * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
+ * @example
+ * ```ts
+ * const file = new File(File.cache, "subdirName", "file.txt");
+ * ```
+ */
 export declare class File extends ExpoFileSystem.FileSystemFile implements Blob {
     /**
-     * Creates an instance of a file.
-     * @param uris An array of: `file:///` string URIs, `File` instances, `Directory` instances representing an arbitrary location on the file system. The location does not need to exist, or it may already contain a directory.
+     * Creates an instance of a file. It can be created for any path, and does not need to exist on the filesystem during creation.
+     *
+     * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
+     * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
      * @example
      * ```ts
-     * const file = new File("file:///path/to/file.txt");
+     * const file = new File(File.cache, "subdirName", "file.txt");
      * ```
      */
     constructor(...uris: (string | File | Directory)[]);
@@ -58,14 +71,22 @@ export declare class File extends ExpoFileSystem.FileSystemFile implements Blob
  * Represents a directory on the filesystem.
  *
  * A `Directory` instance can be created for any path, and does not need to exist on the filesystem during creation.
+ *
+ * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
+ * @example
+ * ```ts
+ * const directory = new Directory(File.cache, "subdirName");
+ * ```
  */
 export declare class Directory extends ExpoFileSystem.FileSystemDirectory {
     /**
-     * Creates an instance of a directory.
-     * @param uris -  An array of: `file:///` string URIs, `File` instances, `Directory` instances representing an arbitrary location on the file system. The location does not need to exist, or it may already contain a file.
+     * Creates an instance of a directory. It can be created for any path, and does not need to exist on the filesystem during creation.
+     *
+     * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
+     * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
      * @example
      * ```ts
-     * const directory = new Directory("file:///path/to/directory");
+     * const directory = new Directory(File.cache, "subdirName");
      * ```
      */
     constructor(...uris: (string | File | Directory)[]);

package/build/FileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../src/FileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,qBAAa,KAAM,SAAQ,aAAa;IACtC;;OAEG;IACH,MAAM,KAAK,KAAK,cAEf;IAED;;OAEG;IACH,MAAM,KAAK,MAAM,cAEhB;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,cAElB;IACD,MAAM,KAAK,qBAAqB,8BAS/B;IAED;;OAEG;IACH,MAAM,KAAK,cAAc,WAExB;IAED;;OAEG;IACH,MAAM,KAAK,kBAAkB,WAE5B;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ;CAGzC;AAED,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAe,YAAW,IAAI;IACrE;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;OAGG;IACH,IAAI,SAAS,WAEZ;IAED;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,cAAc;IAId,cAAc;IAIR,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKzC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAIjD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAGhE;AAiBD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC,mBAAmB;IAC/D;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;;OAIG;IACM,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE;IAOrC;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKvD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;CAGzC"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../src/FileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,qBAAa,KAAM,SAAQ,aAAa;IACtC;;OAEG;IACH,MAAM,KAAK,KAAK,cAEf;IAED;;OAEG;IACH,MAAM,KAAK,MAAM,cAEhB;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,cAElB;IACD,MAAM,KAAK,qBAAqB,8BAS/B;IAED;;OAEG;IACH,MAAM,KAAK,cAAc,WAExB;IAED;;OAEG;IACH,MAAM,KAAK,kBAAkB,WAE5B;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ;CAGzC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAe,YAAW,IAAI;IACrE;;;;;;;;;OASG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;OAGG;IACH,IAAI,SAAS,WAEZ;IAED;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,cAAc;IAId,cAAc;IAIR,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKzC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAIjD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAGhE;AAiBD;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC,mBAAmB;IAC/D;;;;;;;;;OASG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;;OAIG;IACM,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE;IAOrC;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKvD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;CAGzC"}

package/expo-module.config.json

@@ -12,7 +12,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.filesystem",
-      "version": "19.0.3",
+      "version": "19.0.5",
       "repository": "local-maven-repo"
     }
   }

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.0.3/expo.modules.filesystem-19.0.3.module → 19.0.5/expo.modules.filesystem-19.0.5.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "19.0.3",
+    "version": "19.0.5",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -75,8 +75,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.3.aar",
-          "url": "expo.modules.filesystem-19.0.3.aar",
+          "name": "expo.modules.filesystem-19.0.5.aar",
+          "url": "expo.modules.filesystem-19.0.5.aar",
           "size": 373316,
           "sha512": "36dc7ab692103570111d72588e7674ae1c7cf2c0665a351738f87dc0af98dbccb34aef221f34b5630403f2d6fd46a13cd22e4b3fb75a90f6b8b0bc2a41dd49cf",
           "sha256": "977ef17ccaa7a6f8c09c70d2f2f2f0c1002f07df8b3756ce3905a37a7288b41b",
@@ -153,8 +153,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.3.aar",
-          "url": "expo.modules.filesystem-19.0.3.aar",
+          "name": "expo.modules.filesystem-19.0.5.aar",
+          "url": "expo.modules.filesystem-19.0.5.aar",
           "size": 373316,
           "sha512": "36dc7ab692103570111d72588e7674ae1c7cf2c0665a351738f87dc0af98dbccb34aef221f34b5630403f2d6fd46a13cd22e4b3fb75a90f6b8b0bc2a41dd49cf",
           "sha256": "977ef17ccaa7a6f8c09c70d2f2f2f0c1002f07df8b3756ce3905a37a7288b41b",
@@ -173,8 +173,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.3-sources.jar",
-          "url": "expo.modules.filesystem-19.0.3-sources.jar",
+          "name": "expo.modules.filesystem-19.0.5-sources.jar",
+          "url": "expo.modules.filesystem-19.0.5-sources.jar",
           "size": 28421,
           "sha512": "c91977ae610fa808ea0765cd14182ad1d8961f59cbdf2df2396e7f77fe8cadbcd152018902a4f09474177b5ea77f78c107d6016c127d0546c4e9b0ebbf2b13fe",
           "sha256": "9cf826cfa827700e415e780bc1b4a49477ea31486d465154824b7331c89e9dc7",

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.module.md5

@@ -0,0 +1 @@
+423f97e182b388b0bb864d1c6e99e176

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.module.sha1

@@ -0,0 +1 @@
+5acaf624a6f86152dacf4b05b60fc91284f4abad

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.module.sha256

@@ -0,0 +1 @@
+b80fb6ce987e4b7f65e72affdcd4f6988d96a3af110cc40a3760c15dd19b2c5c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.module.sha512

@@ -0,0 +1 @@
+dad6ebef53bb0ca799675f417c47aa5e4d089c35db21f88e9c8a570604aa4970255519944131428df5a2a20d434d93693a9fc93773db9db2d25ce2825aa6d304

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.0.3/expo.modules.filesystem-19.0.3.pom → 19.0.5/expo.modules.filesystem-19.0.5.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
-  <version>19.0.3</version>
+  <version>19.0.5</version>
   <packaging>aar</packaging>
   <name>expo.modules.filesystem</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.pom.md5

@@ -0,0 +1 @@
+53a2ad7b85bf8e39dccdc490e4aac2a7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.pom.sha1

@@ -0,0 +1 @@
+fe337162a65850593acb70d1c3a3620da4c7a356

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.pom.sha256

@@ -0,0 +1 @@
+68c8f32767b0549b2e733d132cb21ac82bd86fb0e8fbff4b0529a6838d0fc438

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.5/expo.modules.filesystem-19.0.5.pom.sha512

@@ -0,0 +1 @@
+8377212c44357f227e871376bd85a005aae507df0851780cc0f12d6ce946b81e6029edf05c58625077387b474e1dd87af730f31180009387a1f9c64e21c732ab

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
   <versioning>
-    <latest>19.0.3</latest>
-    <release>19.0.3</release>
+    <latest>19.0.5</latest>
+    <release>19.0.5</release>
     <versions>
-      <version>19.0.3</version>
+      <version>19.0.5</version>
     </versions>
-    <lastUpdated>20250818203955</lastUpdated>
+    <lastUpdated>20250825161907</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.md5

@@ -1 +1 @@
-bf814914808c5cde6a874f5314c5c03c
+7bcef1846b11745f444541f602117f32

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha1

@@ -1 +1 @@
-a6a0d0e61b39cdf7af63bdade461ea017c77ee7f
+651729a270d482d1a8d111f3955875e0cb25f905

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha256

@@ -1 +1 @@
-7d7c0cb2bef2183a4840f8b5af5032596df0279a3db9935719845c5b38d16fe6
+f9657fccdaffaef75d442cc36cdf0cc203bc358226c7220f1ab6695a3ee1fdd5

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha512

@@ -1 +1 @@
-94088dcb40367cbe08c959ce13e74789a467191884f402298b4ee4982db73bbb8138fc7bfeb9af43d37f74a8f608b357353b20a8b020a4d76064318458554c67
+db43a9e891bb1afca0c9f43724e00a1e2ced2dfa353934f8e77d8942bc76b2be6a30fc86c9e03ba94214a26c4ed0e19fdbe72851f31a882e39d9973a50359dd5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.0.3",
+  "version": "19.0.5",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -35,12 +35,12 @@
     "preset": "expo-module-scripts"
   },
   "devDependencies": {
-    "expo-module-scripts": "^5.0.2",
-    "jest-expo": "~54.0.1"
+    "expo-module-scripts": "^5.0.3",
+    "jest-expo": "~54.0.2"
   },
   "peerDependencies": {
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "475cdabd3faad56f0e8c4abcaaf21140c01c094f"
+  "gitHead": "ef0b9ecf9645d3e93587d5ee5030dbfcbf735bbd"
 }

package/src/ExpoFileSystem.types.ts

@@ -79,9 +79,11 @@ export declare class Directory {
   list(): (Directory | File)[];
 
   /**
-   * Retrieves an object containing properties of a directory
+   * Retrieves an object containing properties of a directory.
+   *
    * @throws Error If the application does not have read access to the directory, or if the path does not point to a directory (e.g., it points to a file).
-   * @returns An object with directory metadata (e.g., size, creation date, etc.).
+   *
+   * @returns An object with directory metadata (for example, size, creation date, and so on).
    */
   info(): DirectoryInfo;
 
@@ -91,10 +93,10 @@ export declare class Directory {
   size: number | null;
 
   /**
-   * @platform android
    * A static method that opens a file picker to select a directory.
    * @param initialUri An optional uri pointing to an initial folder on which the directory picker is opened.
-   * @returns a `Directory` instance. The underlying uri will be a content uri on Android.
+   * @returns a `Directory` instance. The underlying uri will be a content URI on Android.
+   * @platform android
    */
   static pickDirectoryAsync(initialUri?: string): Promise<Directory>;
 }
@@ -181,8 +183,8 @@ export declare class File {
 
   /**
    * Retrieves an object containing properties of a file
-   * @throws Error If the application does not have read access to the file, or if the path does not point to a file (e.g., it points to a directory).
-   * @returns An object with file metadata (e.g., size, creation date, etc.).
+   * @throws Error If the application does not have read access to the file, or if the path does not point to a file (for example, it points to a directory).
+   * @returns An object with file metadata (for example, size, creation date, and so on).
    */
   info(options?: InfoOptions): FileInfo;
 
@@ -210,16 +212,19 @@ export declare class File {
   move(destination: Directory | File): void;
 
   /**
-   * Returns a FileHandle object that can be used to read and write data to the file.
+   * Returns A `FileHandle` object that can be used to read and write data to the file.
    * @throws Error if the file does not exist or cannot be opened.
    */
   open(): FileHandle;
 
   /**
    * A static method that downloads a file from the network.
+   *
    * @param url - The URL of the file to download.
    * @param destination - The destination directory or file. If a directory is provided, the resulting filename will be determined based on the response headers.
+   *
    * @returns A promise that resolves to the downloaded file.
+   *
    * @example
    * ```ts
    * const file = await File.downloadFileAsync("https://example.com/image.png", new Directory(Paths.document));
@@ -232,11 +237,14 @@ export declare class File {
   ): Promise<File>;
 
   /**
-   * @platform android
    * A static method that opens a file picker to select a single file of specified type.
-   * @param initialUri An optional uri pointing to an initial folder on which the file picker is opened.
+   *
+   * @platform android
+   *
+   * @param initialUri An optional URI pointing to an initial folder on which the file picker is opened.
    * @param mimeType A mime type that is used to filter out files that can be picked out.
    * @returns a `File` instance.
+   * @platform android
    */
   static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File>;
 
@@ -323,6 +331,7 @@ export type FileInfo = {
 export type InfoOptions = {
   /**
    * Whether to return the MD5 hash of the file.
+   *
    * @default false
    */
   md5?: boolean;

package/src/FileSystem.ts

@@ -57,13 +57,26 @@ export class Paths extends PathUtilities {
   }
 }
 
+/**
+ * Represents a file on the filesystem.
+ *
+ * A `File` instance can be created for any path, and does not need to exist on the filesystem during creation.
+ *
+ * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
+ * @example
+ * ```ts
+ * const file = new File(File.cache, "subdirName", "file.txt");
+ * ```
+ */
 export class File extends ExpoFileSystem.FileSystemFile implements Blob {
   /**
-   * Creates an instance of a file.
-   * @param uris An array of: `file:///` string URIs, `File` instances, `Directory` instances representing an arbitrary location on the file system. The location does not need to exist, or it may already contain a directory.
+   * Creates an instance of a file. It can be created for any path, and does not need to exist on the filesystem during creation.
+   *
+   * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
+   * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
    * @example
    * ```ts
-   * const file = new File("file:///path/to/file.txt");
+   * const file = new File(File.cache, "subdirName", "file.txt");
    * ```
    */
   constructor(...uris: (string | File | Directory)[]) {
@@ -134,14 +147,22 @@ File.pickFileAsync = async function (initialUri?: string, mimeType?: string) {
  * Represents a directory on the filesystem.
  *
  * A `Directory` instance can be created for any path, and does not need to exist on the filesystem during creation.
+ *
+ * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
+ * @example
+ * ```ts
+ * const directory = new Directory(File.cache, "subdirName");
+ * ```
  */
 export class Directory extends ExpoFileSystem.FileSystemDirectory {
   /**
-   * Creates an instance of a directory.
-   * @param uris -  An array of: `file:///` string URIs, `File` instances, `Directory` instances representing an arbitrary location on the file system. The location does not need to exist, or it may already contain a file.
+   * Creates an instance of a directory. It can be created for any path, and does not need to exist on the filesystem during creation.
+   *
+   * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
+   * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
    * @example
    * ```ts
-   * const directory = new Directory("file:///path/to/directory");
+   * const directory = new Directory(File.cache, "subdirName");
    * ```
    */
   constructor(...uris: (string | File | Directory)[]) {

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.module.md5

@@ -1 +0,0 @@
-115b0114af05e17995f5bdab07a3ab16

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.module.sha1

@@ -1 +0,0 @@
-733bfd800ab7ebc1d1c82e642b4edead8a901d5f

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.module.sha256

@@ -1 +0,0 @@
-150872c129c64983be7ab2056d944f25320d581de315845c19d76eaa1c0980f7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.module.sha512

@@ -1 +0,0 @@
-855720b3802de8a9b796433f6d8e05d5c3b456737b0f6f4f629015a5cd04667216e93f6ab85ddd074864405ef689ee5ea446463c9bef1f54d8525123e852d1e0

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.pom.md5

@@ -1 +0,0 @@
-bd9d6af2053adec1ffb3073e8d903b4b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.pom.sha1

@@ -1 +0,0 @@
-6d75988f414535c89f497db1cc5582b4c1944204

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.pom.sha256

@@ -1 +0,0 @@
-236607b1436c81d824e4ef0676fbabc20af5c3c4fa7fc377ae96635a450a10e8

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.3/expo.modules.filesystem-19.0.3.pom.sha512

@@ -1 +0,0 @@
-93c9c7905bf9a196739eefc98d7f0722ec9a2be6f237e7ac7413279b3b6e9684cc3e62d386d4490c95e1d752b37be2e911e23974f41d661564ee44226320557f