@bolt-foundry/gambit 0.8.1 → 0.8.5-rc.10

package/esm/deps/jsr.io/@std/fs/1.0.23/expand_glob.d.ts

@@ -0,0 +1,267 @@
+import { type GlobOptions } from "../../path/1.1.4/glob_to_regexp.js";
+import { type WalkEntry } from "./_create_walk_entry.js";
+export type { GlobOptions, WalkEntry };
+/** Options for {@linkcode expandGlob} and {@linkcode expandGlobSync}. */
+export interface ExpandGlobOptions extends Omit<GlobOptions, "os"> {
+    /**
+     * File path where to expand from.
+     *
+     * @default {Deno.cwd()}
+     */
+    root?: string;
+    /**
+     * List of glob patterns to be excluded from the expansion.
+     *
+     * @default {[]}
+     */
+    exclude?: string[];
+    /**
+     * Whether to include directories in entries.
+     *
+     * @default {true}
+     */
+    includeDirs?: boolean;
+    /**
+     * Whether to follow symbolic links.
+     *
+     * @default {false}
+     */
+    followSymlinks?: boolean;
+    /**
+     * Indicates whether the followed symlink's path should be canonicalized.
+     * This option works only if `followSymlinks` is not `false`.
+     *
+     * @default {true}
+     */
+    canonicalize?: boolean;
+}
+/**
+ * Returns an async iterator that yields each file path matching the given glob
+ * pattern.
+ *
+ * The file paths are absolute paths. If `root` is not provided, the current
+ * working directory is used. The `root` directory is not included in the
+ * yielded file paths.
+ *
+ * Requires `--allow-read` permission.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param glob The glob pattern to expand.
+ * @param options Additional options for the expansion.
+ *
+ * @returns An async iterator that yields each walk entry matching the glob
+ * pattern.
+ *
+ * @example Basic usage
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts"));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/foo.ts",
+ * //     name: "foo.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Define root directory
+ *
+ * Setting the `root` option to `/folder` will expand the glob pattern from the
+ * `/folder` directory.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── subdir
+ * │   └── bar.ts
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { root: "./subdir" }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/subdir/bar.ts",
+ * //     name: "bar.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Exclude files
+ *
+ * Setting the `exclude` option to `["foo.ts"]` will exclude the `foo.ts` file
+ * from the expansion.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { exclude: ["foo.ts"] }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "true.ts",
+ * //     isFile: false,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Exclude directories
+ *
+ * Setting the `includeDirs` option to `false` will exclude directories from the
+ * expansion.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── subdir
+ * │   └── bar.ts
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*", { includeDirs: false }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/foo.ts",
+ * //     name: "foo.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Follow symbolic links
+ *
+ * Setting the `followSymlinks` option to `true` will follow symbolic links.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── link.ts -> script.ts (symbolic link)
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { followSymlinks: true }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/symlink",
+ * //     name: "symlink",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: true,
+ * //   },
+ * // ]
+ * ```
+ */
+export declare function expandGlob(glob: string | URL, options?: ExpandGlobOptions): AsyncIterableIterator<WalkEntry>;
+/**
+ * Returns an iterator that yields each file path matching the given glob
+ * pattern. The file paths are relative to the provided `root` directory.
+ * If `root` is not provided, the current working directory is used.
+ * The `root` directory is not included in the yielded file paths.
+ *
+ * Requires the `--allow-read` flag.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param glob The glob pattern to expand.
+ * @param options Additional options for the expansion.
+ *
+ * @returns An iterator that yields each walk entry matching the glob pattern.
+ *
+ * @example Usage
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlobSync } from "@std/fs/expand-glob";
+ *
+ * const entries = [];
+ * for (const entry of expandGlobSync("*.ts")) {
+ *   entries.push(entry);
+ * }
+ *
+ * entries[0]!.path; // "/Users/user/folder/script.ts"
+ * entries[0]!.name; // "script.ts"
+ * entries[0]!.isFile; // false
+ * entries[0]!.isDirectory; // true
+ * entries[0]!.isSymlink; // false
+ *
+ * entries[1]!.path; // "/Users/user/folder/foo.ts"
+ * entries[1]!.name; // "foo.ts"
+ * entries[1]!.isFile; // true
+ * entries[1]!.isDirectory; // false
+ * entries[1]!.isSymlink; // false
+ * ```
+ */
+export declare function expandGlobSync(glob: string | URL, options?: ExpandGlobOptions): IterableIterator<WalkEntry>;
+//# sourceMappingURL=expand_glob.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.23/expand_glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand_glob.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.23/expand_glob.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,oCAAoC,CAAC;AAQpF,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAEvC,yEAAyE;AACzE,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;IAChE;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmLG;AACH,wBAAuB,UAAU,CAC/B,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,qBAAqB,CAAC,SAAS,CAAC,CAyGlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAiB,cAAc,CAC7B,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAAC,SAAS,CAAC,CAuG7B"}

package/esm/deps/jsr.io/@std/fs/1.0.23/expand_glob.js

@@ -0,0 +1,442 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { globToRegExp } from "../../path/1.1.4/glob_to_regexp.js";
+import { joinGlobs } from "../../path/1.1.4/join_globs.js";
+import { isGlob } from "../../path/1.1.4/is_glob.js";
+import { isAbsolute } from "../../path/1.1.4/is_absolute.js";
+import { resolve } from "../../path/1.1.4/resolve.js";
+import { SEPARATOR_PATTERN } from "../../path/1.1.4/constants.js";
+import { walk, walkSync } from "./walk.js";
+import { toPathString } from "./_to_path_string.js";
+import { createWalkEntry, createWalkEntrySync, } from "./_create_walk_entry.js";
+import { isWindows } from "../../internal/1.0.12/os.js";
+function split(path) {
+    const s = SEPARATOR_PATTERN.source;
+    const segments = path
+        .replace(new RegExp(`^${s}|${s}$`, "g"), "")
+        .split(SEPARATOR_PATTERN);
+    const isAbsolute_ = isAbsolute(path);
+    const split = {
+        segments,
+        isAbsolute: isAbsolute_,
+        hasTrailingSep: path.match(new RegExp(`${s}$`)) !== null,
+    };
+    if (isWindows && isAbsolute_) {
+        split.winRoot = segments.shift();
+    }
+    return split;
+}
+function throwUnlessNotFound(error) {
+    if (!(error instanceof dntShim.Deno.errors.NotFound)) {
+        throw error;
+    }
+}
+function comparePath(a, b) {
+    if (a.path < b.path)
+        return -1;
+    if (a.path > b.path)
+        return 1;
+    return 0;
+}
+/**
+ * Returns an async iterator that yields each file path matching the given glob
+ * pattern.
+ *
+ * The file paths are absolute paths. If `root` is not provided, the current
+ * working directory is used. The `root` directory is not included in the
+ * yielded file paths.
+ *
+ * Requires `--allow-read` permission.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param glob The glob pattern to expand.
+ * @param options Additional options for the expansion.
+ *
+ * @returns An async iterator that yields each walk entry matching the glob
+ * pattern.
+ *
+ * @example Basic usage
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts"));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/foo.ts",
+ * //     name: "foo.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Define root directory
+ *
+ * Setting the `root` option to `/folder` will expand the glob pattern from the
+ * `/folder` directory.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── subdir
+ * │   └── bar.ts
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { root: "./subdir" }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/subdir/bar.ts",
+ * //     name: "bar.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Exclude files
+ *
+ * Setting the `exclude` option to `["foo.ts"]` will exclude the `foo.ts` file
+ * from the expansion.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { exclude: ["foo.ts"] }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "true.ts",
+ * //     isFile: false,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Exclude directories
+ *
+ * Setting the `includeDirs` option to `false` will exclude directories from the
+ * expansion.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── subdir
+ * │   └── bar.ts
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*", { includeDirs: false }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/foo.ts",
+ * //     name: "foo.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * // ]
+ * ```
+ *
+ * @example Follow symbolic links
+ *
+ * Setting the `followSymlinks` option to `true` will follow symbolic links.
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── link.ts -> script.ts (symbolic link)
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlob } from "@std/fs/expand-glob";
+ *
+ * await Array.fromAsync(expandGlob("*.ts", { followSymlinks: true }));
+ * // [
+ * //   {
+ * //     path: "/Users/user/folder/script.ts",
+ * //     name: "script.ts",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: false,
+ * //   },
+ * //   {
+ * //     path: "/Users/user/folder/symlink",
+ * //     name: "symlink",
+ * //     isFile: true,
+ * //     isDirectory: false,
+ * //     isSymlink: true,
+ * //   },
+ * // ]
+ * ```
+ */
+export async function* expandGlob(glob, options) {
+    let { root, exclude = [], includeDirs = true, extended = true, globstar = true, caseInsensitive = false, followSymlinks = false, canonicalize = true, } = options ?? {};
+    const { segments, isAbsolute: isGlobAbsolute, hasTrailingSep, winRoot, } = split(toPathString(glob));
+    root ??= isGlobAbsolute ? winRoot ?? "/" : dntShim.Deno.cwd();
+    const globOptions = { extended, globstar, caseInsensitive };
+    const absRoot = isGlobAbsolute ? root : resolve(root); // root is always string here
+    const resolveFromRoot = (path) => resolve(absRoot, path);
+    const excludePatterns = exclude
+        .map(resolveFromRoot)
+        .map((s) => globToRegExp(s, globOptions));
+    const shouldInclude = (path) => !excludePatterns.some((p) => p.test(path));
+    let fixedRoot = isGlobAbsolute ? winRoot ?? "/" : absRoot;
+    while (segments.length > 0 && !isGlob(segments[0])) {
+        const seg = segments.shift();
+        fixedRoot = joinGlobs([fixedRoot, unescapeGlobSegment(seg)], globOptions);
+    }
+    let fixedRootInfo;
+    try {
+        fixedRootInfo = await createWalkEntry(fixedRoot);
+    }
+    catch (error) {
+        return throwUnlessNotFound(error);
+    }
+    async function* advanceMatch(walkInfo, globSegment) {
+        if (!walkInfo.isDirectory) {
+            return;
+        }
+        else if (globSegment === "..") {
+            const parentPath = joinGlobs([walkInfo.path, ".."], globOptions);
+            if (shouldInclude(parentPath)) {
+                return yield await createWalkEntry(parentPath);
+            }
+            return;
+        }
+        else if (globSegment === "**") {
+            return yield* walk(walkInfo.path, {
+                skip: excludePatterns,
+                maxDepth: globstar ? Infinity : 1,
+                followSymlinks,
+                canonicalize,
+            });
+        }
+        const globPattern = globToRegExp(globSegment, globOptions);
+        for await (const walkEntry of walk(walkInfo.path, {
+            maxDepth: 1,
+            skip: excludePatterns,
+            followSymlinks,
+        })) {
+            if (walkEntry.path !== walkInfo.path &&
+                walkEntry.name.match(globPattern)) {
+                yield walkEntry;
+            }
+        }
+    }
+    let currentMatches = [fixedRootInfo];
+    for (const segment of segments) {
+        // Advancing the list of current matches may introduce duplicates, so we
+        // pass everything through this Map.
+        const nextMatchMap = new Map();
+        await Promise.all(currentMatches.map(async (currentMatch) => {
+            for await (const nextMatch of advanceMatch(currentMatch, segment)) {
+                nextMatchMap.set(nextMatch.path, nextMatch);
+            }
+        }));
+        currentMatches = [...nextMatchMap.values()].sort(comparePath);
+    }
+    if (hasTrailingSep) {
+        currentMatches = currentMatches.filter((entry) => entry.isDirectory);
+    }
+    if (!includeDirs) {
+        currentMatches = currentMatches.filter((entry) => !entry.isDirectory);
+    }
+    yield* currentMatches;
+}
+/**
+ * Returns an iterator that yields each file path matching the given glob
+ * pattern. The file paths are relative to the provided `root` directory.
+ * If `root` is not provided, the current working directory is used.
+ * The `root` directory is not included in the yielded file paths.
+ *
+ * Requires the `--allow-read` flag.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param glob The glob pattern to expand.
+ * @param options Additional options for the expansion.
+ *
+ * @returns An iterator that yields each walk entry matching the glob pattern.
+ *
+ * @example Usage
+ *
+ * File structure:
+ * ```
+ * folder
+ * ├── script.ts
+ * └── foo.ts
+ * ```
+ *
+ * ```ts ignore
+ * // script.ts
+ * import { expandGlobSync } from "@std/fs/expand-glob";
+ *
+ * const entries = [];
+ * for (const entry of expandGlobSync("*.ts")) {
+ *   entries.push(entry);
+ * }
+ *
+ * entries[0]!.path; // "/Users/user/folder/script.ts"
+ * entries[0]!.name; // "script.ts"
+ * entries[0]!.isFile; // false
+ * entries[0]!.isDirectory; // true
+ * entries[0]!.isSymlink; // false
+ *
+ * entries[1]!.path; // "/Users/user/folder/foo.ts"
+ * entries[1]!.name; // "foo.ts"
+ * entries[1]!.isFile; // true
+ * entries[1]!.isDirectory; // false
+ * entries[1]!.isSymlink; // false
+ * ```
+ */
+export function* expandGlobSync(glob, options) {
+    let { root, exclude = [], includeDirs = true, extended = true, globstar = true, caseInsensitive = false, followSymlinks = false, canonicalize = true, } = options ?? {};
+    const { segments, isAbsolute: isGlobAbsolute, hasTrailingSep, winRoot, } = split(toPathString(glob));
+    root ??= isGlobAbsolute ? winRoot ?? "/" : dntShim.Deno.cwd();
+    const globOptions = { extended, globstar, caseInsensitive };
+    const absRoot = isGlobAbsolute ? root : resolve(root); // root is always string here
+    const resolveFromRoot = (path) => resolve(absRoot, path);
+    const excludePatterns = exclude
+        .map(resolveFromRoot)
+        .map((s) => globToRegExp(s, globOptions));
+    const shouldInclude = (path) => !excludePatterns.some((p) => p.test(path));
+    let fixedRoot = isGlobAbsolute ? winRoot ?? "/" : absRoot;
+    while (segments.length > 0 && !isGlob(segments[0])) {
+        const seg = segments.shift();
+        fixedRoot = joinGlobs([fixedRoot, unescapeGlobSegment(seg)], globOptions);
+    }
+    let fixedRootInfo;
+    try {
+        fixedRootInfo = createWalkEntrySync(fixedRoot);
+    }
+    catch (error) {
+        return throwUnlessNotFound(error);
+    }
+    function* advanceMatch(walkInfo, globSegment) {
+        if (!walkInfo.isDirectory) {
+            return;
+        }
+        else if (globSegment === "..") {
+            const parentPath = joinGlobs([walkInfo.path, ".."], globOptions);
+            if (shouldInclude(parentPath)) {
+                return yield createWalkEntrySync(parentPath);
+            }
+            return;
+        }
+        else if (globSegment === "**") {
+            return yield* walkSync(walkInfo.path, {
+                skip: excludePatterns,
+                maxDepth: globstar ? Infinity : 1,
+                followSymlinks,
+                canonicalize,
+            });
+        }
+        const globPattern = globToRegExp(globSegment, globOptions);
+        for (const walkEntry of walkSync(walkInfo.path, {
+            maxDepth: 1,
+            skip: excludePatterns,
+            followSymlinks,
+        })) {
+            if (walkEntry.path !== walkInfo.path &&
+                walkEntry.name.match(globPattern)) {
+                yield walkEntry;
+            }
+        }
+    }
+    let currentMatches = [fixedRootInfo];
+    for (const segment of segments) {
+        // Advancing the list of current matches may introduce duplicates, so we
+        // pass everything through this Map.
+        const nextMatchMap = new Map();
+        for (const currentMatch of currentMatches) {
+            for (const nextMatch of advanceMatch(currentMatch, segment)) {
+                nextMatchMap.set(nextMatch.path, nextMatch);
+            }
+        }
+        currentMatches = [...nextMatchMap.values()].sort(comparePath);
+    }
+    if (hasTrailingSep) {
+        currentMatches = currentMatches.filter((entry) => entry.isDirectory);
+    }
+    if (!includeDirs) {
+        currentMatches = currentMatches.filter((entry) => !entry.isDirectory);
+    }
+    yield* currentMatches;
+}
+const globEscapeChar = 
+// deno-lint-ignore no-explicit-any
+dntShim.dntGlobalThis.Deno?.build.os === "windows" ? "`" : `\\`;
+const globMetachars = "*?{}[]()|+@!";
+function unescapeGlobSegment(segment) {
+    let result = "";
+    let lastIndex = 0;
+    for (let i = 0; i < segment.length; i++) {
+        const char = segment[i];
+        if (char === globEscapeChar) {
+            const nextChar = segment[i + 1];
+            if (nextChar && globMetachars.includes(nextChar)) {
+                // append the slice before the escape char, then the metachar
+                result += segment.slice(lastIndex, i) + nextChar;
+                i++; // skip next char since we already processed it
+                lastIndex = i + 1;
+            }
+        }
+    }
+    // no escaped, return the original segment
+    if (lastIndex === 0) {
+        return segment;
+    }
+    // append any remaining characters
+    result += segment.slice(lastIndex);
+    return result;
+}