FSA: Update spec links in IDL to point to whatwg/fs

These links will soon be invalid, since we're about to remove all
content from WICG/file-system-access that's duplicated with whatwg/fs

Also updates the README to mention both specs

See WICG/file-system-access#392

Change-Id: I90274697a69e1ca45c4626dca5cb7cad0a0c14dc
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/4049000
Commit-Queue: Austin Sullivan <asully@chromium.org>
Reviewed-by: Daseul Lee <dslee@chromium.org>
Cr-Commit-Position: refs/heads/main@{#1075237}

third_party/blink/renderer/modules/file_system_access/README.md

@@ -12,8 +12,14 @@ contains the mojom interfaces for these APIs.
 
 ## APIs In this directory
 
-This directory contains the implementation of the
-[File System Access API](https://wicg.github.io/file-system-access/).
+This directory contains the implementation of the File System Access API. This
+API spans two specifications:
+  * [whatwg/fs](https://fs.spec.whatwg.org/) specifies access to the
+    [origin private file system](https://fs.spec.whatwg.org/#origin-private-file-system)
+    and all shared interfaces.
+  * [WICG/file-system-access](https://wicg.github.io/file-system-access/)
+    specifies access to the local file system, including the picker APIs and
+    drag-and-drop.
 
 It consists of the following parts:
 
@@ -22,7 +28,8 @@ It consists of the following parts:
    promisified API.
 
  * `StorageManager.getDirectory`: An entry point that gives access to the same
-   sandboxed filesystem as what is available through the old API. 
+   [sandboxed filesystem](https://fs.spec.whatwg.org/#origin-private-file-system)
+   as what is available through the old API.
 
  * `FileSystemWritableFileStream`: a more modern API with similar functionality to the
    old `FileWriter` API. The implementation of this actually does make use of
@@ -31,5 +38,5 @@ It consists of the following parts:
    to the new mojom API as well.
 
  * `showOpenFilePicker`, `showSaveFilePicker` and `showDirectorPicker`: Entry points
-   on `window`, that let a website pop-up a file or directory picker, prompting the 
+   on `window`, that let a website pop-up a file or directory picker, prompting the
    user to select one or more files or directories, to which the website than gets access.

third_party/blink/renderer/modules/file_system_access/file_system_create_writable_options.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#dictdef-filesystemcreatewritableoptions
+// https://fs.spec.whatwg.org/#dictdef-filesystemcreatewritableoptions
 dictionary FileSystemCreateWritableOptions {
   boolean keepExistingData = false;
   [RuntimeEnabled=FileSystemAccessAPIExperimental] boolean autoClose = false;

third_party/blink/renderer/modules/file_system_access/file_system_directory_handle.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#filesystemdirectoryhandle
+// https://fs.spec.whatwg.org/#filesystemdirectoryhandle
 [
     Exposed=(Window,Worker),
     SecureContext,

third_party/blink/renderer/modules/file_system_access/file_system_directory_iterator.idl

@@ -3,7 +3,7 @@
 // found in the LICENSE file.
 
 // Async iterator returned by FileSystemDirectoryHandle.getEntries().
-// https://wicg.github.io/file-system-access/#api-filesystemdirectoryhandle-asynciterable
+// https://fs.spec.whatwg.org/#api-filesystemdirectoryhandle-asynciterable
 // https://www.ecma-international.org/ecma-262/9.0/index.html#sec-asynciterator-interface
 [
     LegacyNoInterfaceObject,

third_party/blink/renderer/modules/file_system_access/file_system_file_handle.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#filesystemfilehandle
+// https://fs.spec.whatwg.org/#filesystemfilehandle
 [
     Exposed=(Window,Worker),
     SecureContext,

third_party/blink/renderer/modules/file_system_access/file_system_get_directory_options.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#dictdef-filesystemgetdirectoryoptions
+// https://fs.spec.whatwg.org/#dictdef-filesystemgetdirectoryoptions
 dictionary FileSystemGetDirectoryOptions {
   boolean create = false;
 };

third_party/blink/renderer/modules/file_system_access/file_system_get_file_options.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#dictdef-filesystemgetfileoptions
+// https://fs.spec.whatwg.org/#dictdef-filesystemgetfileoptions
 dictionary FileSystemGetFileOptions {
   boolean create = false;
 };

third_party/blink/renderer/modules/file_system_access/file_system_handle.idl

@@ -2,13 +2,13 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#enumdef-filesystemhandlekind
+// https://fs.spec.whatwg.org/#enumdef-filesystemhandlekind
 enum FileSystemHandleKind {
   "file",
   "directory",
 };
 
-// https://wicg.github.io/file-system-access/#filesystemhandle
+// https://fs.spec.whatwg.org/#filesystemhandle
 [
     Exposed=(Window,Worker),
     SecureContext,

third_party/blink/renderer/modules/file_system_access/file_system_read_write_options.idl

@@ -2,9 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(fivedots): Replace link with one pointing to spec, once it lands.
-// https://github.com/whatwg/fs/blob/main/AccessHandle.md
-
+// https://fs.spec.whatwg.org/#dictdef-filesystemreadwriteoptions
 dictionary FileSystemReadWriteOptions {
   [EnforceRange] unsigned long long at = 0;
 };

third_party/blink/renderer/modules/file_system_access/file_system_remove_options.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#dictdef-filesystemremoveoptions
+// https://fs.spec.whatwg.org/#dictdef-filesystemremoveoptions
 dictionary FileSystemRemoveOptions {
   boolean recursive = false;
 };

third_party/blink/renderer/modules/file_system_access/file_system_writable_file_stream.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#filesystemwritablefilestream
+// https://fs.spec.whatwg.org/#filesystemwritablefilestream
 [
     Exposed=(Window,Worker),
     SecureContext,

third_party/blink/renderer/modules/file_system_access/storage_manager_file_system_access.idl

@@ -2,7 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#sandboxed-filesystem
+// https://fs.spec.whatwg.org/#sandboxed-filesystem
 [
     SecureContext,
     RuntimeEnabled=FileSystemAccessOriginPrivate,

third_party/blink/renderer/modules/file_system_access/write_params.idl

@@ -2,14 +2,14 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// https://wicg.github.io/file-system-access/#enumdef-writecommandtype
+// https://fs.spec.whatwg.org/#enumdef-writecommandtype
 enum WriteCommandType {
   "truncate",
   "seek",
   "write",
 };
 
-// https://wicg.github.io/file-system-access/#dictdef-writeparams
+// https://fs.spec.whatwg.org/#dictdef-writeparams
 dictionary WriteParams {
   required WriteCommandType type;
   unsigned long long? size;