vscode-fs 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# vscode-fs
+
+VSCode like simple、serializable and cross-platform file system utilities.

package/dist/index.cjs

@@ -0,0 +1,217 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let vscode_uri = require("vscode-uri");
+
+//#region src/types.ts
+/**
+* Enumeration of file types. The types `File` and `Directory` can also be
+* a symbolic links, in that case use `FileType.File | FileType.SymbolicLink` and
+* `FileType.Directory | FileType.SymbolicLink`.
+*/
+let FileType = /* @__PURE__ */ function(FileType) {
+	/**
+	* The file type is unknown.
+	*/
+	FileType[FileType["Unknown"] = 0] = "Unknown";
+	/**
+	* A regular file.
+	*/
+	FileType[FileType["File"] = 1] = "File";
+	/**
+	* A directory.
+	*/
+	FileType[FileType["Directory"] = 2] = "Directory";
+	/**
+	* A symbolic link to a file.
+	*/
+	FileType[FileType["SymbolicLink"] = 64] = "SymbolicLink";
+	return FileType;
+}({});
+let FileSystemError;
+(function(_FileSystemError) {
+	function isFileSystemError(error) {
+		return error instanceof FileSystemErrorImpl;
+	}
+	_FileSystemError.isFileSystemError = isFileSystemError;
+})(FileSystemError || (FileSystemError = {}));
+let FileSystemProviderErrorCode = /* @__PURE__ */ function(FileSystemProviderErrorCode) {
+	FileSystemProviderErrorCode["FileExists"] = "EntryExists";
+	FileSystemProviderErrorCode["FileNotFound"] = "EntryNotFound";
+	FileSystemProviderErrorCode["FileNotADirectory"] = "EntryNotADirectory";
+	FileSystemProviderErrorCode["FileIsADirectory"] = "EntryIsADirectory";
+	FileSystemProviderErrorCode["FileExceedsStorageQuota"] = "EntryExceedsStorageQuota";
+	FileSystemProviderErrorCode["FileTooLarge"] = "EntryTooLarge";
+	FileSystemProviderErrorCode["FileWriteLocked"] = "EntryWriteLocked";
+	FileSystemProviderErrorCode["NoPermissions"] = "NoPermissions";
+	FileSystemProviderErrorCode["Unavailable"] = "Unavailable";
+	FileSystemProviderErrorCode["Unknown"] = "Unknown";
+	return FileSystemProviderErrorCode;
+}({});
+
+//#endregion
+//#region src/error.ts
+var FileSystemErrorImpl = class FileSystemErrorImpl extends Error {
+	static create(error, code) {
+		const providerError = new FileSystemErrorImpl(error.toString(), code);
+		this.markAsFileSystemProviderError(providerError, code);
+		return providerError;
+	}
+	static markAsFileSystemProviderError(error, code) {
+		error.name = code ? `${code} (FileSystemError)` : `FileSystemError`;
+		return error;
+	}
+	constructor(message, code) {
+		super(message);
+		this.code = code;
+	}
+};
+function createFileSystemError(error, code) {
+	return FileSystemErrorImpl.create(error, code);
+}
+function toFileSystemError(error) {
+	let resultError = error;
+	let code;
+	switch (error.code) {
+		case "ENOENT":
+			code = FileSystemProviderErrorCode.FileNotFound;
+			break;
+		case "EISDIR":
+			code = FileSystemProviderErrorCode.FileIsADirectory;
+			break;
+		case "ENOTDIR":
+			code = FileSystemProviderErrorCode.FileNotADirectory;
+			break;
+		case "EEXIST":
+			code = FileSystemProviderErrorCode.FileExists;
+			break;
+		case "EPERM":
+		case "EACCES":
+			code = FileSystemProviderErrorCode.NoPermissions;
+			break;
+		case "ERR_UNC_HOST_NOT_ALLOWED":
+			resultError = `${error.message}. Please update the 'security.allowedUNCHosts' setting if you want to allow this host.`;
+			code = FileSystemProviderErrorCode.Unknown;
+			break;
+		default: code = FileSystemProviderErrorCode.Unknown;
+	}
+	return createFileSystemError(resultError, code);
+}
+
+//#endregion
+//#region src/node.ts
+function isErrnoException(err) {
+	return err !== null && typeof err === "object" && "code" in err;
+}
+function toFileType(stats) {
+	if (stats.isFile()) return FileType.File;
+	if (stats.isDirectory()) return FileType.Directory;
+	if (stats.isSymbolicLink()) return FileType.SymbolicLink;
+	return FileType.Unknown;
+}
+async function wrap(fn) {
+	try {
+		return await fn();
+	} catch (error) {
+		if (FileSystemError.isFileSystemError(error)) throw error;
+		throw toFileSystemError(error);
+	}
+}
+function joinPath(basePath, ...segments) {
+	return vscode_uri.Utils.joinPath(vscode_uri.URI.file(basePath), ...segments).fsPath;
+}
+async function createNodeFileSystem() {
+	const [fs, trash] = await Promise.all([import("node:fs"), import("trash").then((m) => m.default)]);
+	async function resolveFileType(path) {
+		const lstats = await fs.promises.lstat(path);
+		if (!lstats.isSymbolicLink()) return {
+			type: toFileType(lstats),
+			stats: lstats
+		};
+		let targetStats = null;
+		try {
+			targetStats = await fs.promises.stat(path);
+		} catch {}
+		const baseType = targetStats ? toFileType(targetStats) : FileType.Unknown;
+		const stats = targetStats ?? lstats;
+		return {
+			type: baseType | FileType.SymbolicLink,
+			stats
+		};
+	}
+	async function getEntryType(dirPath, entry) {
+		if (!entry.isSymbolicLink()) return toFileType(entry);
+		try {
+			return toFileType(await fs.promises.stat(joinPath(dirPath, entry.name))) | FileType.SymbolicLink;
+		} catch {
+			return FileType.SymbolicLink;
+		}
+	}
+	async function ensureTargetNotExists(path) {
+		try {
+			await fs.promises.access(path, fs.constants.F_OK);
+			throw createFileSystemError(`File exists: ${path}`, FileSystemProviderErrorCode.FileExists);
+		} catch (err) {
+			if (isErrnoException(err) && err.code !== "ENOENT") throw err;
+		}
+	}
+	async function copyRecursive(sourcePath, targetPath, overwrite) {
+		const stats = await fs.promises.stat(sourcePath);
+		if (stats.isFile()) {
+			const mode = overwrite ? void 0 : fs.constants.COPYFILE_EXCL;
+			await fs.promises.copyFile(sourcePath, targetPath, mode);
+			return;
+		}
+		if (stats.isDirectory()) {
+			if (!overwrite) await ensureTargetNotExists(targetPath);
+			await fs.promises.mkdir(targetPath, { recursive: true });
+			const entries = await fs.promises.readdir(sourcePath, { withFileTypes: true });
+			for (const entry of entries) await copyRecursive(joinPath(sourcePath, entry.name), joinPath(targetPath, entry.name), overwrite);
+			return;
+		}
+		throw createFileSystemError(`Unsupported file type: ${sourcePath}`, FileSystemProviderErrorCode.Unknown);
+	}
+	return {
+		stat: (uri) => wrap(async () => {
+			const { type, stats } = await resolveFileType(uri.fsPath);
+			return {
+				type,
+				ctime: stats.birthtime.getTime(),
+				mtime: stats.mtime.getTime(),
+				size: stats.size
+			};
+		}),
+		readDirectory: (uri) => wrap(async () => {
+			const entries = await fs.promises.readdir(uri.fsPath, { withFileTypes: true });
+			return Promise.all(entries.map(async (entry) => [entry.name, await getEntryType(uri.fsPath, entry)]));
+		}),
+		createDirectory: (uri) => wrap(async () => {
+			await fs.promises.mkdir(uri.fsPath, { recursive: true });
+		}),
+		readFile: (uri) => wrap(() => fs.promises.readFile(uri.fsPath)),
+		writeFile: (uri, content) => wrap(() => fs.promises.writeFile(uri.fsPath, content)),
+		delete: (uri, options) => wrap(async () => {
+			if (options?.useTrash) await trash(uri.fsPath);
+			else await fs.promises.rm(uri.fsPath, { recursive: options?.recursive });
+		}),
+		rename: (source, target, options) => wrap(async () => {
+			if (options?.overwrite === false) await ensureTargetNotExists(target.fsPath);
+			await fs.promises.rename(source.fsPath, target.fsPath);
+		}),
+		copy: (source, target, options) => wrap(async () => {
+			const overwrite = options?.overwrite !== false;
+			await copyRecursive(source.fsPath, target.fsPath, overwrite);
+		})
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'FileSystemError', {
+  enumerable: true,
+  get: function () {
+    return FileSystemError;
+  }
+});
+exports.FileSystemProviderErrorCode = FileSystemProviderErrorCode;
+exports.FileType = FileType;
+exports.createFileSystemError = createFileSystemError;
+exports.createNodeFileSystem = createNodeFileSystem;
+exports.toFileSystemError = toFileSystemError;

package/dist/index.d.cts

@@ -0,0 +1,188 @@
+import { URI } from "vscode-uri";
+
+//#region src/types.d.ts
+/**
+ * Enumeration of file types. The types `File` and `Directory` can also be
+ * a symbolic links, in that case use `FileType.File | FileType.SymbolicLink` and
+ * `FileType.Directory | FileType.SymbolicLink`.
+ */
+declare enum FileType {
+  /**
+   * The file type is unknown.
+   */
+  Unknown = 0,
+  /**
+   * A regular file.
+   */
+  File = 1,
+  /**
+   * A directory.
+   */
+  Directory = 2,
+  /**
+   * A symbolic link to a file.
+   */
+  SymbolicLink = 64
+}
+/**
+ * The file system interface exposes the editor's built-in and contributed
+ * {@link FileSystemProvider file system providers}. It allows extensions to work
+ * with files from the local disk as well as files from remote places, like the
+ * remote extension host or ftp-servers.
+ */
+interface FileSystem {
+  /**
+   * Retrieve metadata about a file.
+   *
+   * @param uri The uri of the file to retrieve metadata about.
+   * @returns The file metadata about the file.
+   */
+  stat(uri: URI): Promise<FileStat>;
+  /**
+   * Retrieve all entries of a {@link FileType.Directory directory}.
+   *
+   * @param uri The uri of the folder.
+   * @returns An array of name/type-tuples or a thenable that resolves to such.
+   */
+  readDirectory(uri: URI): Promise<[string, FileType][]>;
+  /**
+   * Create a new directory (Note, that new files are created via `write`-calls).
+   *
+   * Note* that missing directories are created automatically, e.g this call has
+   * `mkdirp` semantics.
+   *
+   * @param uri The uri of the new folder.
+   */
+  createDirectory(uri: URI): Promise<void>;
+  /**
+   * Read the entire contents of a file.
+   *
+   * @param uri The uri of the file.
+   * @returns An array of bytes or a thenable that resolves to such.
+   */
+  readFile(uri: URI): Promise<Uint8Array>;
+  /**
+   * Write data to a file, replacing its entire contents.
+   *
+   * @param uri The uri of the file.
+   * @param content The new content of the file.
+   */
+  writeFile(uri: URI, content: Uint8Array): Promise<void>;
+  /**
+   * Delete a file.
+   *
+   * @param uri The resource that is to be deleted.
+   * @param options Defines if trash can should be used and if deletion of folders is recursive
+   * @param options.recursive Delete the content recursively if a folder is denoted.
+   * @param options.useTrash Use the os's trashcan instead of permanently deleting files whenever possible.
+   */
+  delete(uri: URI, options?: {
+    /**
+     * Delete the content recursively if a folder is denoted.
+     */
+    recursive?: boolean;
+    /**
+     * Use the os's trashcan instead of permanently deleting files whenever possible.
+     */
+    useTrash?: boolean;
+  }): Promise<void>;
+  /**
+   * Rename a file or folder.
+   *
+   * @param source The existing file.
+   * @param target The new location.
+   * @param options Defines if existing files should be overwritten.
+   * @param options.overwrite Overwrite the file if it does exist.
+   */
+  rename(source: URI, target: URI, options?: {
+    /**
+     * Overwrite the file if it does exist.
+     */
+    overwrite?: boolean;
+  }): Promise<void>;
+  /**
+   * Copy files or folders.
+   *
+   * @param source The existing file.
+   * @param target The destination location.
+   * @param options Defines if existing files should be overwritten.
+   * @param options.overwrite Overwrite the file if it does exist.
+   */
+  copy(source: URI, target: URI, options?: {
+    /**
+     * Overwrite the file if it does exist.
+     */
+    overwrite?: boolean;
+  }): Promise<void>;
+}
+/**
+ * The `FileStat`-type represents metadata about a file
+ */
+interface FileStat {
+  /**
+   * The type of the file, e.g. is a regular file, a directory, or symbolic link
+   * to a file.
+   *
+   * Note:* This value might be a bitmask, e.g. `FileType.File | FileType.SymbolicLink`.
+   */
+  type: FileType;
+  /**
+   * The creation timestamp in milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+   */
+  ctime: number;
+  /**
+   * The modification timestamp in milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+   *
+   * Note:* If the file changed, it is important to provide an updated `mtime` that advanced
+   * from the previous value. Otherwise there may be optimizations in place that will not show
+   * the updated file contents in an editor for example.
+   */
+  mtime: number;
+  /**
+   * The size in bytes.
+   *
+   * Note:* If the file changed, it is important to provide an updated `size`. Otherwise there
+   * may be optimizations in place that will not show the updated file contents in an editor for
+   * example.
+   */
+  size: number;
+}
+/**
+ * A type that filesystem providers should use to signal errors.
+ *
+ * This class has factory methods for common error-cases, like `FileNotFound` when
+ * a file or folder doesn't exist, use them like so: `throw vscode.FileSystemError.FileNotFound(someUri);`
+ */
+interface FileSystemError extends Error {
+  /**
+   * A code that identifies this error.
+   *
+   * Possible values are names of errors, like {@linkcode FileSystemError.FileNotFound FileNotFound},
+   * or `Unknown` for unspecified errors.
+   */
+  readonly code: string;
+}
+declare namespace FileSystemError {
+  function isFileSystemError(error: unknown): error is FileSystemError;
+}
+declare enum FileSystemProviderErrorCode {
+  FileExists = "EntryExists",
+  FileNotFound = "EntryNotFound",
+  FileNotADirectory = "EntryNotADirectory",
+  FileIsADirectory = "EntryIsADirectory",
+  FileExceedsStorageQuota = "EntryExceedsStorageQuota",
+  FileTooLarge = "EntryTooLarge",
+  FileWriteLocked = "EntryWriteLocked",
+  NoPermissions = "NoPermissions",
+  Unavailable = "Unavailable",
+  Unknown = "Unknown"
+}
+//#endregion
+//#region src/error.d.ts
+declare function createFileSystemError(error: Error | string, code: FileSystemProviderErrorCode): FileSystemError;
+declare function toFileSystemError(error: NodeJS.ErrnoException): FileSystemError;
+//#endregion
+//#region src/node.d.ts
+declare function createNodeFileSystem(): Promise<FileSystem>;
+//#endregion
+export { FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileType, createFileSystemError, createNodeFileSystem, toFileSystemError };

package/dist/index.d.mts

@@ -0,0 +1,188 @@
+import { URI } from "vscode-uri";
+
+//#region src/types.d.ts
+/**
+ * Enumeration of file types. The types `File` and `Directory` can also be
+ * a symbolic links, in that case use `FileType.File | FileType.SymbolicLink` and
+ * `FileType.Directory | FileType.SymbolicLink`.
+ */
+declare enum FileType {
+  /**
+   * The file type is unknown.
+   */
+  Unknown = 0,
+  /**
+   * A regular file.
+   */
+  File = 1,
+  /**
+   * A directory.
+   */
+  Directory = 2,
+  /**
+   * A symbolic link to a file.
+   */
+  SymbolicLink = 64
+}
+/**
+ * The file system interface exposes the editor's built-in and contributed
+ * {@link FileSystemProvider file system providers}. It allows extensions to work
+ * with files from the local disk as well as files from remote places, like the
+ * remote extension host or ftp-servers.
+ */
+interface FileSystem {
+  /**
+   * Retrieve metadata about a file.
+   *
+   * @param uri The uri of the file to retrieve metadata about.
+   * @returns The file metadata about the file.
+   */
+  stat(uri: URI): Promise<FileStat>;
+  /**
+   * Retrieve all entries of a {@link FileType.Directory directory}.
+   *
+   * @param uri The uri of the folder.
+   * @returns An array of name/type-tuples or a thenable that resolves to such.
+   */
+  readDirectory(uri: URI): Promise<[string, FileType][]>;
+  /**
+   * Create a new directory (Note, that new files are created via `write`-calls).
+   *
+   * Note* that missing directories are created automatically, e.g this call has
+   * `mkdirp` semantics.
+   *
+   * @param uri The uri of the new folder.
+   */
+  createDirectory(uri: URI): Promise<void>;
+  /**
+   * Read the entire contents of a file.
+   *
+   * @param uri The uri of the file.
+   * @returns An array of bytes or a thenable that resolves to such.
+   */
+  readFile(uri: URI): Promise<Uint8Array>;
+  /**
+   * Write data to a file, replacing its entire contents.
+   *
+   * @param uri The uri of the file.
+   * @param content The new content of the file.
+   */
+  writeFile(uri: URI, content: Uint8Array): Promise<void>;
+  /**
+   * Delete a file.
+   *
+   * @param uri The resource that is to be deleted.
+   * @param options Defines if trash can should be used and if deletion of folders is recursive
+   * @param options.recursive Delete the content recursively if a folder is denoted.
+   * @param options.useTrash Use the os's trashcan instead of permanently deleting files whenever possible.
+   */
+  delete(uri: URI, options?: {
+    /**
+     * Delete the content recursively if a folder is denoted.
+     */
+    recursive?: boolean;
+    /**
+     * Use the os's trashcan instead of permanently deleting files whenever possible.
+     */
+    useTrash?: boolean;
+  }): Promise<void>;
+  /**
+   * Rename a file or folder.
+   *
+   * @param source The existing file.
+   * @param target The new location.
+   * @param options Defines if existing files should be overwritten.
+   * @param options.overwrite Overwrite the file if it does exist.
+   */
+  rename(source: URI, target: URI, options?: {
+    /**
+     * Overwrite the file if it does exist.
+     */
+    overwrite?: boolean;
+  }): Promise<void>;
+  /**
+   * Copy files or folders.
+   *
+   * @param source The existing file.
+   * @param target The destination location.
+   * @param options Defines if existing files should be overwritten.
+   * @param options.overwrite Overwrite the file if it does exist.
+   */
+  copy(source: URI, target: URI, options?: {
+    /**
+     * Overwrite the file if it does exist.
+     */
+    overwrite?: boolean;
+  }): Promise<void>;
+}
+/**
+ * The `FileStat`-type represents metadata about a file
+ */
+interface FileStat {
+  /**
+   * The type of the file, e.g. is a regular file, a directory, or symbolic link
+   * to a file.
+   *
+   * Note:* This value might be a bitmask, e.g. `FileType.File | FileType.SymbolicLink`.
+   */
+  type: FileType;
+  /**
+   * The creation timestamp in milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+   */
+  ctime: number;
+  /**
+   * The modification timestamp in milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+   *
+   * Note:* If the file changed, it is important to provide an updated `mtime` that advanced
+   * from the previous value. Otherwise there may be optimizations in place that will not show
+   * the updated file contents in an editor for example.
+   */
+  mtime: number;
+  /**
+   * The size in bytes.
+   *
+   * Note:* If the file changed, it is important to provide an updated `size`. Otherwise there
+   * may be optimizations in place that will not show the updated file contents in an editor for
+   * example.
+   */
+  size: number;
+}
+/**
+ * A type that filesystem providers should use to signal errors.
+ *
+ * This class has factory methods for common error-cases, like `FileNotFound` when
+ * a file or folder doesn't exist, use them like so: `throw vscode.FileSystemError.FileNotFound(someUri);`
+ */
+interface FileSystemError extends Error {
+  /**
+   * A code that identifies this error.
+   *
+   * Possible values are names of errors, like {@linkcode FileSystemError.FileNotFound FileNotFound},
+   * or `Unknown` for unspecified errors.
+   */
+  readonly code: string;
+}
+declare namespace FileSystemError {
+  function isFileSystemError(error: unknown): error is FileSystemError;
+}
+declare enum FileSystemProviderErrorCode {
+  FileExists = "EntryExists",
+  FileNotFound = "EntryNotFound",
+  FileNotADirectory = "EntryNotADirectory",
+  FileIsADirectory = "EntryIsADirectory",
+  FileExceedsStorageQuota = "EntryExceedsStorageQuota",
+  FileTooLarge = "EntryTooLarge",
+  FileWriteLocked = "EntryWriteLocked",
+  NoPermissions = "NoPermissions",
+  Unavailable = "Unavailable",
+  Unknown = "Unknown"
+}
+//#endregion
+//#region src/error.d.ts
+declare function createFileSystemError(error: Error | string, code: FileSystemProviderErrorCode): FileSystemError;
+declare function toFileSystemError(error: NodeJS.ErrnoException): FileSystemError;
+//#endregion
+//#region src/node.d.ts
+declare function createNodeFileSystem(): Promise<FileSystem>;
+//#endregion
+export { FileStat, FileSystem, FileSystemError, FileSystemProviderErrorCode, FileType, createFileSystemError, createNodeFileSystem, toFileSystemError };

package/dist/index.mjs

@@ -0,0 +1,206 @@
+import { URI, Utils } from "vscode-uri";
+
+//#region src/types.ts
+/**
+* Enumeration of file types. The types `File` and `Directory` can also be
+* a symbolic links, in that case use `FileType.File | FileType.SymbolicLink` and
+* `FileType.Directory | FileType.SymbolicLink`.
+*/
+let FileType = /* @__PURE__ */ function(FileType) {
+	/**
+	* The file type is unknown.
+	*/
+	FileType[FileType["Unknown"] = 0] = "Unknown";
+	/**
+	* A regular file.
+	*/
+	FileType[FileType["File"] = 1] = "File";
+	/**
+	* A directory.
+	*/
+	FileType[FileType["Directory"] = 2] = "Directory";
+	/**
+	* A symbolic link to a file.
+	*/
+	FileType[FileType["SymbolicLink"] = 64] = "SymbolicLink";
+	return FileType;
+}({});
+let FileSystemError;
+(function(_FileSystemError) {
+	function isFileSystemError(error) {
+		return error instanceof FileSystemErrorImpl;
+	}
+	_FileSystemError.isFileSystemError = isFileSystemError;
+})(FileSystemError || (FileSystemError = {}));
+let FileSystemProviderErrorCode = /* @__PURE__ */ function(FileSystemProviderErrorCode) {
+	FileSystemProviderErrorCode["FileExists"] = "EntryExists";
+	FileSystemProviderErrorCode["FileNotFound"] = "EntryNotFound";
+	FileSystemProviderErrorCode["FileNotADirectory"] = "EntryNotADirectory";
+	FileSystemProviderErrorCode["FileIsADirectory"] = "EntryIsADirectory";
+	FileSystemProviderErrorCode["FileExceedsStorageQuota"] = "EntryExceedsStorageQuota";
+	FileSystemProviderErrorCode["FileTooLarge"] = "EntryTooLarge";
+	FileSystemProviderErrorCode["FileWriteLocked"] = "EntryWriteLocked";
+	FileSystemProviderErrorCode["NoPermissions"] = "NoPermissions";
+	FileSystemProviderErrorCode["Unavailable"] = "Unavailable";
+	FileSystemProviderErrorCode["Unknown"] = "Unknown";
+	return FileSystemProviderErrorCode;
+}({});
+
+//#endregion
+//#region src/error.ts
+var FileSystemErrorImpl = class FileSystemErrorImpl extends Error {
+	static create(error, code) {
+		const providerError = new FileSystemErrorImpl(error.toString(), code);
+		this.markAsFileSystemProviderError(providerError, code);
+		return providerError;
+	}
+	static markAsFileSystemProviderError(error, code) {
+		error.name = code ? `${code} (FileSystemError)` : `FileSystemError`;
+		return error;
+	}
+	constructor(message, code) {
+		super(message);
+		this.code = code;
+	}
+};
+function createFileSystemError(error, code) {
+	return FileSystemErrorImpl.create(error, code);
+}
+function toFileSystemError(error) {
+	let resultError = error;
+	let code;
+	switch (error.code) {
+		case "ENOENT":
+			code = FileSystemProviderErrorCode.FileNotFound;
+			break;
+		case "EISDIR":
+			code = FileSystemProviderErrorCode.FileIsADirectory;
+			break;
+		case "ENOTDIR":
+			code = FileSystemProviderErrorCode.FileNotADirectory;
+			break;
+		case "EEXIST":
+			code = FileSystemProviderErrorCode.FileExists;
+			break;
+		case "EPERM":
+		case "EACCES":
+			code = FileSystemProviderErrorCode.NoPermissions;
+			break;
+		case "ERR_UNC_HOST_NOT_ALLOWED":
+			resultError = `${error.message}. Please update the 'security.allowedUNCHosts' setting if you want to allow this host.`;
+			code = FileSystemProviderErrorCode.Unknown;
+			break;
+		default: code = FileSystemProviderErrorCode.Unknown;
+	}
+	return createFileSystemError(resultError, code);
+}
+
+//#endregion
+//#region src/node.ts
+function isErrnoException(err) {
+	return err !== null && typeof err === "object" && "code" in err;
+}
+function toFileType(stats) {
+	if (stats.isFile()) return FileType.File;
+	if (stats.isDirectory()) return FileType.Directory;
+	if (stats.isSymbolicLink()) return FileType.SymbolicLink;
+	return FileType.Unknown;
+}
+async function wrap(fn) {
+	try {
+		return await fn();
+	} catch (error) {
+		if (FileSystemError.isFileSystemError(error)) throw error;
+		throw toFileSystemError(error);
+	}
+}
+function joinPath(basePath, ...segments) {
+	return Utils.joinPath(URI.file(basePath), ...segments).fsPath;
+}
+async function createNodeFileSystem() {
+	const [fs, trash] = await Promise.all([import("node:fs"), import("trash").then((m) => m.default)]);
+	async function resolveFileType(path) {
+		const lstats = await fs.promises.lstat(path);
+		if (!lstats.isSymbolicLink()) return {
+			type: toFileType(lstats),
+			stats: lstats
+		};
+		let targetStats = null;
+		try {
+			targetStats = await fs.promises.stat(path);
+		} catch {}
+		const baseType = targetStats ? toFileType(targetStats) : FileType.Unknown;
+		const stats = targetStats ?? lstats;
+		return {
+			type: baseType | FileType.SymbolicLink,
+			stats
+		};
+	}
+	async function getEntryType(dirPath, entry) {
+		if (!entry.isSymbolicLink()) return toFileType(entry);
+		try {
+			return toFileType(await fs.promises.stat(joinPath(dirPath, entry.name))) | FileType.SymbolicLink;
+		} catch {
+			return FileType.SymbolicLink;
+		}
+	}
+	async function ensureTargetNotExists(path) {
+		try {
+			await fs.promises.access(path, fs.constants.F_OK);
+			throw createFileSystemError(`File exists: ${path}`, FileSystemProviderErrorCode.FileExists);
+		} catch (err) {
+			if (isErrnoException(err) && err.code !== "ENOENT") throw err;
+		}
+	}
+	async function copyRecursive(sourcePath, targetPath, overwrite) {
+		const stats = await fs.promises.stat(sourcePath);
+		if (stats.isFile()) {
+			const mode = overwrite ? void 0 : fs.constants.COPYFILE_EXCL;
+			await fs.promises.copyFile(sourcePath, targetPath, mode);
+			return;
+		}
+		if (stats.isDirectory()) {
+			if (!overwrite) await ensureTargetNotExists(targetPath);
+			await fs.promises.mkdir(targetPath, { recursive: true });
+			const entries = await fs.promises.readdir(sourcePath, { withFileTypes: true });
+			for (const entry of entries) await copyRecursive(joinPath(sourcePath, entry.name), joinPath(targetPath, entry.name), overwrite);
+			return;
+		}
+		throw createFileSystemError(`Unsupported file type: ${sourcePath}`, FileSystemProviderErrorCode.Unknown);
+	}
+	return {
+		stat: (uri) => wrap(async () => {
+			const { type, stats } = await resolveFileType(uri.fsPath);
+			return {
+				type,
+				ctime: stats.birthtime.getTime(),
+				mtime: stats.mtime.getTime(),
+				size: stats.size
+			};
+		}),
+		readDirectory: (uri) => wrap(async () => {
+			const entries = await fs.promises.readdir(uri.fsPath, { withFileTypes: true });
+			return Promise.all(entries.map(async (entry) => [entry.name, await getEntryType(uri.fsPath, entry)]));
+		}),
+		createDirectory: (uri) => wrap(async () => {
+			await fs.promises.mkdir(uri.fsPath, { recursive: true });
+		}),
+		readFile: (uri) => wrap(() => fs.promises.readFile(uri.fsPath)),
+		writeFile: (uri, content) => wrap(() => fs.promises.writeFile(uri.fsPath, content)),
+		delete: (uri, options) => wrap(async () => {
+			if (options?.useTrash) await trash(uri.fsPath);
+			else await fs.promises.rm(uri.fsPath, { recursive: options?.recursive });
+		}),
+		rename: (source, target, options) => wrap(async () => {
+			if (options?.overwrite === false) await ensureTargetNotExists(target.fsPath);
+			await fs.promises.rename(source.fsPath, target.fsPath);
+		}),
+		copy: (source, target, options) => wrap(async () => {
+			const overwrite = options?.overwrite !== false;
+			await copyRecursive(source.fsPath, target.fsPath, overwrite);
+		})
+	};
+}
+
+//#endregion
+export { FileSystemError, FileSystemProviderErrorCode, FileType, createFileSystemError, createNodeFileSystem, toFileSystemError };

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "vscode-fs",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "VSCode like simple、serializable and cross-platform file system utilities.",
+  "author": "Naily Zero <zero@naily.cc> (https://naily.cc)",
+  "license": "MIT",
+  "homepage": "https://github.com/groupguanfang/vscode-fs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/groupguanfang/vscode-fs"
+  },
+  "bugs": {
+    "url": "https://github.com/groupguanfang/vscode-fs/issues",
+    "email": "zero@naily.cc"
+  },
+  "keywords": [
+    "vscode",
+    "file system",
+    "serializable",
+    "cross-platform"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json",
+    "./dist/*": "./dist/*"
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.cts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vscode-uri": "^3.1.0"
+  },
+  "dependencies": {
+    "trash": "^10.1.1"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^25.3.2",
+    "naily-eslint-config": "^0.0.1",
+    "tsdown": "0.21.0-beta.2"
+  },
+  "scripts": {
+    "build": "tsdown --dts --format esm,cjs src/index.ts",
+    "test": "vitest --coverage --ui",
+    "lint": "eslint ."
+  }
+}