vscode-fs 0.0.4 → 0.0.5

package/dist/index.cjs

@@ -167,10 +167,11 @@ function joinPath(basePath, ...segments) {
 	return vscode_uri.Utils.joinPath(vscode_uri.URI.file(basePath), ...segments).fsPath;
 }
 async function createNodeFileSystem() {
-	const [fs, trash, glob] = await Promise.all([
+	const [fs, trash, glob, watch] = await Promise.all([
 		import("node:fs"),
 		import("trash").then((m) => m.default),
-		import("tinyglobby").then((m) => m.glob)
+		import("tinyglobby").then((m) => m.glob),
+		import("chokidar").then((m) => m.watch)
 	]);
 	async function resolveFileType(path) {
 		const lstats = await fs.promises.lstat(path);
@@ -324,6 +325,37 @@ async function createNodeFileSystem() {
 				deep: options?.deep,
 				fs
 			}));
+		},
+		createWatcher: async (pattern, options) => {
+			const watcher = watch(pattern.pattern, { cwd: pattern.baseUri.fsPath });
+			return new Promise((resolve) => {
+				watcher.on("ready", () => {
+					const onDidCreateListeners = /* @__PURE__ */ new Set();
+					const onDidChangeListeners = /* @__PURE__ */ new Set();
+					const onDidDeleteListeners = /* @__PURE__ */ new Set();
+					if (options?.ignoreChangeEvents !== true) watcher.on("add", (path) => onDidCreateListeners.forEach((listener) => listener(vscode_uri.URI.file(path))));
+					if (options?.ignoreChangeEvents !== true) watcher.on("change", (path) => onDidChangeListeners.forEach((listener) => listener(vscode_uri.URI.file(path))));
+					if (options?.ignoreDeleteEvents !== true) watcher.on("unlink", (path) => onDidDeleteListeners.forEach((listener) => listener(vscode_uri.URI.file(path))));
+					resolve({
+						ignoreChangeEvents: options?.ignoreChangeEvents ?? false,
+						ignoreCreateEvents: options?.ignoreCreateEvents ?? false,
+						ignoreDeleteEvents: options?.ignoreDeleteEvents ?? false,
+						onDidCreate: (listener) => {
+							onDidCreateListeners.add(listener);
+							return { dispose: () => onDidCreateListeners.delete(listener) };
+						},
+						onDidChange: (listener) => {
+							onDidChangeListeners.add(listener);
+							return { dispose: () => onDidChangeListeners.delete(listener) };
+						},
+						onDidDelete: (listener) => {
+							onDidDeleteListeners.add(listener);
+							return { dispose: () => onDidDeleteListeners.delete(listener) };
+						},
+						dispose: () => watcher.close()
+					});
+				});
+			});
 		}
 	};
 }

package/dist/index.d.cts

@@ -212,6 +212,66 @@ interface FileSystem {
      */
     deep?: number;
   }): Promise<URI[]>;
+  createWatcher(pattern: RelativePattern, options?: {
+    /**
+     * Ignore create events.
+     *
+     * @default false
+     */
+    ignoreCreateEvents?: boolean;
+    /**
+     * Ignore change events.
+     *
+     * @default false
+     */
+    ignoreChangeEvents?: boolean;
+    /**
+     * Ignore delete events.
+     *
+     * @default false
+     */
+    ignoreDeleteEvents?: boolean;
+  }): Promise<FileSystemWatcher>;
+}
+interface Disposable {
+  /** Dispose resources. */
+  dispose(): unknown;
+}
+/**
+ * A file system watcher notifies about changes to files and folders
+ * on disk or from other {@link FileSystemProvider FileSystemProviders}.
+ *
+ * To get an instance of a `FileSystemWatcher` use
+ * {@link workspace.createFileSystemWatcher createFileSystemWatcher}.
+ */
+interface FileSystemWatcher extends Disposable {
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores creation file system events.
+   */
+  readonly ignoreCreateEvents: boolean;
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores change file system events.
+   */
+  readonly ignoreChangeEvents: boolean;
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores delete file system events.
+   */
+  readonly ignoreDeleteEvents: boolean;
+  /**
+   * An event which fires on file/folder creation.
+   */
+  onDidCreate(listener: (e: URI) => unknown): Disposable;
+  /**
+   * An event which fires on file/folder change.
+   */
+  onDidChange(listener: (e: URI) => unknown): Disposable;
+  /**
+   * An event which fires on file/folder deletion.
+   */
+  onDidDelete(listener: (e: URI) => unknown): Disposable;
 }
 /**
  * The `FileStat`-type represents metadata about a file
@@ -337,4 +397,4 @@ declare function toFileSystemError(error: NodeJS.ErrnoException): FileSystemErro
 //#region src/node.d.ts
 declare function createNodeFileSystem(): Promise<FileSystem>;
 //#endregion
-export { FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileType, IsDirectory, IsFile, IsSymbolicLink, RelativePattern, createFileSystemError, createNodeFileSystem, toFileSystemError };
+export { Disposable, FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileSystemWatcher, FileType, IsDirectory, IsFile, IsSymbolicLink, RelativePattern, createFileSystemError, createNodeFileSystem, toFileSystemError };

package/dist/index.d.mts

@@ -212,6 +212,66 @@ interface FileSystem {
      */
     deep?: number;
   }): Promise<URI[]>;
+  createWatcher(pattern: RelativePattern, options?: {
+    /**
+     * Ignore create events.
+     *
+     * @default false
+     */
+    ignoreCreateEvents?: boolean;
+    /**
+     * Ignore change events.
+     *
+     * @default false
+     */
+    ignoreChangeEvents?: boolean;
+    /**
+     * Ignore delete events.
+     *
+     * @default false
+     */
+    ignoreDeleteEvents?: boolean;
+  }): Promise<FileSystemWatcher>;
+}
+interface Disposable {
+  /** Dispose resources. */
+  dispose(): unknown;
+}
+/**
+ * A file system watcher notifies about changes to files and folders
+ * on disk or from other {@link FileSystemProvider FileSystemProviders}.
+ *
+ * To get an instance of a `FileSystemWatcher` use
+ * {@link workspace.createFileSystemWatcher createFileSystemWatcher}.
+ */
+interface FileSystemWatcher extends Disposable {
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores creation file system events.
+   */
+  readonly ignoreCreateEvents: boolean;
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores change file system events.
+   */
+  readonly ignoreChangeEvents: boolean;
+  /**
+   * true if this file system watcher has been created such that
+   * it ignores delete file system events.
+   */
+  readonly ignoreDeleteEvents: boolean;
+  /**
+   * An event which fires on file/folder creation.
+   */
+  onDidCreate(listener: (e: URI) => unknown): Disposable;
+  /**
+   * An event which fires on file/folder change.
+   */
+  onDidChange(listener: (e: URI) => unknown): Disposable;
+  /**
+   * An event which fires on file/folder deletion.
+   */
+  onDidDelete(listener: (e: URI) => unknown): Disposable;
 }
 /**
  * The `FileStat`-type represents metadata about a file
@@ -337,4 +397,4 @@ declare function toFileSystemError(error: NodeJS.ErrnoException): FileSystemErro
 //#region src/node.d.ts
 declare function createNodeFileSystem(): Promise<FileSystem>;
 //#endregion
-export { FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileType, IsDirectory, IsFile, IsSymbolicLink, RelativePattern, createFileSystemError, createNodeFileSystem, toFileSystemError };
+export { Disposable, FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileSystemWatcher, FileType, IsDirectory, IsFile, IsSymbolicLink, RelativePattern, createFileSystemError, createNodeFileSystem, toFileSystemError };

package/dist/index.mjs

@@ -166,10 +166,11 @@ function joinPath(basePath, ...segments) {
 	return Utils.joinPath(URI.file(basePath), ...segments).fsPath;
 }
 async function createNodeFileSystem() {
-	const [fs, trash, glob] = await Promise.all([
+	const [fs, trash, glob, watch] = await Promise.all([
 		import("node:fs"),
 		import("trash").then((m) => m.default),
-		import("tinyglobby").then((m) => m.glob)
+		import("tinyglobby").then((m) => m.glob),
+		import("chokidar").then((m) => m.watch)
 	]);
 	async function resolveFileType(path) {
 		const lstats = await fs.promises.lstat(path);
@@ -323,6 +324,37 @@ async function createNodeFileSystem() {
 				deep: options?.deep,
 				fs
 			}));
+		},
+		createWatcher: async (pattern, options) => {
+			const watcher = watch(pattern.pattern, { cwd: pattern.baseUri.fsPath });
+			return new Promise((resolve) => {
+				watcher.on("ready", () => {
+					const onDidCreateListeners = /* @__PURE__ */ new Set();
+					const onDidChangeListeners = /* @__PURE__ */ new Set();
+					const onDidDeleteListeners = /* @__PURE__ */ new Set();
+					if (options?.ignoreChangeEvents !== true) watcher.on("add", (path) => onDidCreateListeners.forEach((listener) => listener(URI.file(path))));
+					if (options?.ignoreChangeEvents !== true) watcher.on("change", (path) => onDidChangeListeners.forEach((listener) => listener(URI.file(path))));
+					if (options?.ignoreDeleteEvents !== true) watcher.on("unlink", (path) => onDidDeleteListeners.forEach((listener) => listener(URI.file(path))));
+					resolve({
+						ignoreChangeEvents: options?.ignoreChangeEvents ?? false,
+						ignoreCreateEvents: options?.ignoreCreateEvents ?? false,
+						ignoreDeleteEvents: options?.ignoreDeleteEvents ?? false,
+						onDidCreate: (listener) => {
+							onDidCreateListeners.add(listener);
+							return { dispose: () => onDidCreateListeners.delete(listener) };
+						},
+						onDidChange: (listener) => {
+							onDidChangeListeners.add(listener);
+							return { dispose: () => onDidChangeListeners.delete(listener) };
+						},
+						onDidDelete: (listener) => {
+							onDidDeleteListeners.add(listener);
+							return { dispose: () => onDidDeleteListeners.delete(listener) };
+						},
+						dispose: () => watcher.close()
+					});
+				});
+			});
 		}
 	};
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vscode-fs",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "VSCode like simple、serializable and cross-platform file system utilities.",
   "author": "Naily Zero <zero@naily.cc> (https://naily.cc)",
   "license": "MIT",
@@ -45,6 +45,7 @@
     "vscode-uri": "^3.1.0"
   },
   "dependencies": {
+    "chokidar": "^5.0.0",
     "tinyglobby": "^0.2.15",
     "trash": "^10.1.1"
   },