feat(path): Align globToRegExp() with bash glob expansion (denoland/d…

…eno#7209)

- feat: Support escaping glob characters
- feat: Support more character classes
- feat: Match characters literally on segment parse failure
- fix: Match nothing for empty globs
- fix: Contain any glob syntax to its path segment
- perf: Remove extraneous separators from generated regex
- doc: Add detailed JSDoc
- chore: Remove old copyright headers

fs/expand_glob.ts

@@ -60,15 +60,17 @@ function comparePath(a: WalkEntry, b: WalkEntry): number {
   return 0;
 }
 
-/**
- * Expand the glob string from the specified `root` directory and yield each
+/** Expand the glob string from the specified `root` directory and yield each
  * result as a `WalkEntry` object.
  *
- * Examples:
+ * See [`globToRegExp()`](../path/glob.ts#globToRegExp) for details on supported
+ * syntax.
  *
- *     for await (const file of expandGlob("**\/*.ts")) {
- *       console.log(file);
- *     }
+ * Example:
+ *
+ *      for await (const file of expandGlob("**\/*.ts")) {
+ *        console.log(file);
+ *      }
  */
 export async function* expandGlob(
   glob: string,
@@ -168,14 +170,13 @@ export async function* expandGlob(
   yield* currentMatches;
 }
 
-/**
- * Synchronous version of `expandGlob()`.
+/** Synchronous version of `expandGlob()`.
  *
- * Examples:
+ * Example:
  *
- *     for (const file of expandGlobSync("**\/*.ts")) {
- *       console.log(file);
- *     }
+ *      for (const file of expandGlobSync("**\/*.ts")) {
+ *        console.log(file);
+ *      }
  */
 export function* expandGlobSync(
   glob: string,