Restore configurability to filesystem watchers…

package.json

@@ -30,6 +30,7 @@
     "@babel/core": "7.18.6",
     "@electron/remote": "2.1.2",
     "@formatjs/fast-memoize": "^2.2.6",
+    "@parcel/watcher": "^2.5.6",
     "@pulsar-edit/atom-keymap": "^9.1.0",
     "@pulsar-edit/fuzzy-native": "1.3.1",
     "@pulsar-edit/get-scrollbar-style": "^1.0.1",
@@ -74,6 +75,7 @@
     "encoding-selector": "file:packages/encoding-selector",
     "etch": "0.14.1",
     "event-kit": "^2.5.3",
+    "fdir": "^6.5.0",
     "find-and-replace": "file:packages/find-and-replace",
     "find-parent-dir": "^0.3.0",
     "focus-trap": "6.3.0",

src/atom-environment.js

@@ -488,35 +488,48 @@ class AtomEnvironment {
     // need other disposing objects to be able to check it. We won't need to
     // reset it because another environment will be created.
     this.isDestroying = true;
+    this.emitter.emit('will-destroy');
 
     this.disposables.dispose();
+
     if (this.workspace) this.workspace.destroy();
     this.workspace = null;
     this.themes.workspace = null;
+
     if (this.project) this.project.destroy();
     this.project = null;
+
     this.commands.clear();
+
     if (this.stylesElement) this.stylesElement.remove();
+
     this.uriHandlerRegistry.destroy();
 
     this.uninstallWindowEventHandler();
   }
 
-  /**
-   * @memberof AtomEnvironment
-   * @function onDidBeep
-   * @desc Invoke the given callback whenever {@link ::beep} is called.
-   * @listens ::beep
-   * @param {function} callback - Function to be called whenever {@link ::beep} is called.
-   * @returns {Disposable} on which `.dispose()` can be called to unsubscribe.
-   * @category Event Subscription
-   */
+  // Extend: Invoke the given callback when the environment is destroying, as
+  // happens during window close or reload.
+  //
+  // * `callback` {Function} to be called when the environment starts
+  //   destroying
+  //
+  // Returns a {Disposable} on which `.dispose()` can be called to unsubscribe.
+  onWillDestroy (callback) {
+    return this.emitter.on('will-destroy', callback);
+  }
+
+  // Extended: Invoke the given callback whenever {::beep} is called.
+  //
+  // * `callback` {Function} to be called whenever {::beep} is called
+  //
+  // Returns a {Disposable} on which `.dispose()` can be called to unsubscribe.
   onDidBeep(callback) {
     return this.emitter.on('did-beep', callback);
   }
 
   // Extended: Invoke the given callback when there is an unhandled error, but
-  // before the devtools pop open
+  // before the devtools pop open.
   //
   // * `callback` {Function} to be called whenever there is an unhandled error
   //   * `event` {Object}

src/config-schema.js

@@ -353,13 +353,21 @@ const configSchema = {
       },
       fileSystemWatcher: {
         description:
-          'Choose the underlying implementation used to watch for filesystem changes. Emulating changes will miss any events caused by applications other than Pulsar, but may help prevent crashes or freezes.',
+          'Choose the underlying implementation used to watch for filesystem changes. It’s usually best to let Pulsar handle this, but if you have issues with filesystem events, you can opt into a specific watcher that may work better for your platform.',
         type: 'string',
-        default: 'native',
+        default: 'default',
         enum: [
           {
-            value: 'native',
-            description: 'Native operating system APIs'
+            value: 'default',
+            description: 'Default (let Pulsar decide)'
+          },
+          {
+            value: 'nsfw',
+            description: 'Node Sentinel File Watcher'
+          },
+          {
+            value: 'parcel',
+            description: '@parcel/watcher'
           }
         ]
       },