Updated jsDoc

Author: Achal1607

vscode/src/utils.ts

@@ -349,24 +349,25 @@ export namespace FileUtils {
 	/**
 	 * Converts a given file system path or URI-like string into a {@link vscode.Uri} instance.
 	 *
-	 * This utility attempts to correctly handle both raw file paths and strings that may
-	 * already represent a valid file URI.
+	 * This utility attempts to handle both raw file paths and strings that may already
+	 * represent a valid file URI.
 	 *
 	 * ### Behavior
-	 * - If `treatAsUriIfPossible` is **true** and the path starts with the file scheme
-	 *   (`"file:"`), it assumes the input is already a valid URI and parses it
-	 *   using `vscode.Uri.parse(path, true)`.
-	 * - Otherwise, it treats the input as a regular file system path and wraps it using
+	 * - If `treatAsUriIfPossible` is **true** and the input starts with the `"file:"` scheme,
+	 *   it first attempts to parse the string using `vscode.Uri.parse(path, true)`.
+	 *   - If parsing succeeds, the parsed URI is returned.
+	 *   - If parsing fails, the error is logged (at debug level) and the method falls back
+	 *     to treating the input as a regular file path.
+	 * - In all other cases or when fallback occurs, the input is wrapped using
 	 *   `vscode.Uri.file(path)`.
 	 *
-	 * Any parsing errors are logged through the `LOGGER` and rethrown as a generic error.
+	 * Any unexpected errors during URI creation are logged and rethrown as a generic error.
 	 *
 	 * @param {string} path - The input file system path or URI-like string.
 	 * @param {boolean} [treatAsUriIfPossible=false] - If true, and the input starts with the
-	 * `file:` scheme, the path will be parsed directly as a URI instead of being wrapped
-	 * as a file URI.
+	 * `file:` scheme, the method attempts to parse it directly as a URI before falling back.
 	 * @returns {vscode.Uri} The resulting {@link vscode.Uri} object.
-	 * @throws {Error} When the input cannot be parsed into a valid URI.
+	 * @throws {Error} When both URI parsing and file wrapping fail.
 	 */
 	export const toUri = (path: string, treatAsUriIfPossible: boolean = false): vscode.Uri => {
 		try {