structured-outputs 0.1.0-beta.1 → 0.1.0-beta.10

package/esm/deps/jsr.io/@std/fs/1.0.5/ensure_link.js

@@ -0,0 +1,62 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { dirname } from "../../path/1.0.8/dirname.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Asynchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the hard link exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureLink } from "@std/fs/ensure-link";
+ *
+ * await ensureLink("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export async function ensureLink(src, dest) {
+    dest = toPathString(dest);
+    await ensureDir(dirname(dest));
+    await dntShim.Deno.link(toPathString(src), dest);
+}
+/**
+ * Synchronously ensures that the hard link exists.
+ *
+ * If the parent directories for the hard link do not exist, they are created.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param src The source file path as a string or URL. Directory hard links are
+ * not allowed.
+ * @param dest The destination link path as a string or URL.
+ *
+ * @returns A void value that returns once the hard link exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureLinkSync } from "@std/fs/ensure-link";
+ *
+ * ensureLinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export function ensureLinkSync(src, dest) {
+    dest = toPathString(dest);
+    ensureDirSync(dirname(dest));
+    dntShim.Deno.linkSync(toPathString(src), dest);
+}
+//# sourceMappingURL=ensure_link.js.map

package/esm/deps/jsr.io/@std/fs/1.0.5/ensure_link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_link.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.5/ensure_link.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAiB,EAAE,IAAkB;IACpE,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/B,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAiB,EAAE,IAAkB;IAClE,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1B,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/esm/deps/jsr.io/@std/fs/1.0.5/ensure_symlink.js

@@ -0,0 +1,122 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { dirname } from "../../path/1.0.8/dirname.js";
+import { resolve } from "../../path/1.0.8/resolve.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+import { toPathString } from "./_to_path_string.js";
+// deno-lint-ignore no-explicit-any
+const isWindows = dntShim.dntGlobalThis.Deno?.build.os === "windows";
+function resolveSymlinkTarget(target, linkName) {
+    if (typeof target !== "string")
+        return target; // URL is always absolute path
+    if (typeof linkName === "string") {
+        return resolve(dirname(linkName), target);
+    }
+    else {
+        return new URL(target, linkName);
+    }
+}
+function getSymlinkOption(type) {
+    return isWindows ? { type: type === "dir" ? "dir" : "file" } : undefined;
+}
+/**
+ * Asynchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL.
+ * @param linkName The destination link path as a string or URL.
+ *
+ * @returns A void promise that resolves once the link exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureSymlink } from "@std/fs/ensure-symlink";
+ *
+ * await ensureSymlink("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export async function ensureSymlink(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    const srcStatInfo = await dntShim.Deno.lstat(targetRealPath);
+    const srcFilePathType = getFileInfoType(srcStatInfo);
+    await ensureDir(dirname(toPathString(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        await dntShim.Deno.symlink(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = await dntShim.Deno.lstat(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = getFileInfoType(linkStatInfo);
+            throw new dntShim.Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = await dntShim.Deno.readLink(linkName);
+        const linkRealPath = resolve(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new dntShim.Deno.errors.AlreadyExists(`A symlink targeting to an undesired path already exists: ${linkName} -> ${linkRealPath}`);
+        }
+    }
+}
+/**
+ * Synchronously ensures that the link exists, and points to a valid file.
+ *
+ * If the parent directories for the link do not exist, they are created. If the
+ * link already exists, and it is not modified, this function does nothing. If
+ * the link already exists, and it does not point to the given target, an error
+ * is thrown.
+ *
+ * Requires `--allow-read` and `--allow-write` permissions.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param target The source file path as a string or URL.
+ * @param linkName The destination link path as a string or URL.
+ * @returns A void value that returns once the link exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureSymlinkSync } from "@std/fs/ensure-symlink";
+ *
+ * ensureSymlinkSync("./folder/targetFile.dat", "./folder/targetFile.link.dat");
+ * ```
+ */
+export function ensureSymlinkSync(target, linkName) {
+    const targetRealPath = resolveSymlinkTarget(target, linkName);
+    const srcStatInfo = dntShim.Deno.lstatSync(targetRealPath);
+    const srcFilePathType = getFileInfoType(srcStatInfo);
+    ensureDirSync(dirname(toPathString(linkName)));
+    const options = getSymlinkOption(srcFilePathType);
+    try {
+        dntShim.Deno.symlinkSync(target, linkName, options);
+    }
+    catch (error) {
+        if (!(error instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw error;
+        }
+        const linkStatInfo = dntShim.Deno.lstatSync(linkName);
+        if (!linkStatInfo.isSymlink) {
+            const type = getFileInfoType(linkStatInfo);
+            throw new dntShim.Deno.errors.AlreadyExists(`A '${type}' already exists at the path: ${linkName}`);
+        }
+        const linkPath = dntShim.Deno.readLinkSync(linkName);
+        const linkRealPath = resolve(linkPath);
+        if (linkRealPath !== targetRealPath) {
+            throw new dntShim.Deno.errors.AlreadyExists(`A symlink targeting to an undesired path already exists: ${linkName} -> ${linkRealPath}`);
+        }
+    }
+}
+//# sourceMappingURL=ensure_symlink.js.map

package/esm/deps/jsr.io/@std/fs/1.0.5/ensure_symlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_symlink.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.5/ensure_symlink.ts"],"names":[],"mappings":"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"}

package/esm/deps/jsr.io/@std/fs/1.0.5/eol.js

@@ -0,0 +1,67 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+/** End-of-line character for POSIX platforms such as macOS and Linux. */
+import * as dntShim from "../../../../../_dnt.shims.js";
+export const LF = "\n";
+/** End-of-line character for Windows platforms. */
+export const CRLF = "\r\n";
+/**
+ * End-of-line character evaluated for the current platform.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { EOL } from "@std/fs/eol";
+ *
+ * EOL; // "\n" on POSIX platforms and "\r\n" on Windows
+ * ```
+ */
+export const EOL = 
+// deno-lint-ignore no-explicit-any
+dntShim.dntGlobalThis.Deno?.build.os === "windows" ? CRLF : LF;
+const regDetect = /(?:\r?\n)/g;
+/**
+ * Returns the detected EOL character(s) detected in the input string. If no EOL
+ * character is detected, `null` is returned.
+ *
+ * @param content The input string to detect EOL characters.
+ *
+ * @returns The detected EOL character(s) or `null` if no EOL character is detected.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { detect } from "@std/fs/eol";
+ *
+ * detect("deno\r\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\r\nnode"); // "\r\n"
+ * detect("deno\nis not\nnode"); // "\n"
+ * detect("deno is not node"); // null
+ * ```
+ */
+export function detect(content) {
+    const d = content.match(regDetect);
+    if (!d || d.length === 0) {
+        return null;
+    }
+    const hasCRLF = d.some((x) => x === CRLF);
+    return hasCRLF ? CRLF : LF;
+}
+/**
+ * Normalize the input string to the targeted EOL.
+ *
+ * @param content The input string to normalize.
+ * @param eol The EOL character(s) to normalize the input string to.
+ *
+ * @returns The input string normalized to the targeted EOL.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { LF, format } from "@std/fs/eol";
+ *
+ * const CRLFinput = "deno\r\nis not\r\nnode";
+ *
+ * format(CRLFinput, LF); // "deno\nis not\nnode"
+ * ```
+ */
+export function format(content, eol) {
+    return content.replace(regDetect, eol);
+}
+//# sourceMappingURL=eol.js.map

package/esm/deps/jsr.io/@std/fs/1.0.5/eol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eol.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.5/eol.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,yEAAyE;AACzE,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD,MAAM,CAAC,MAAM,EAAE,GAAG,IAAa,CAAC;AAEhC,mDAAmD;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAe,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,GAAG;AACd,mCAAmC;AAClC,OAAO,CAAC,aAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAE1E,MAAM,SAAS,GAAG,YAAY,CAAC;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAE3D,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,GAAe;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/esm/deps/jsr.io/@std/fs/1.0.5/exists.js

@@ -0,0 +1,272 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+/** Options for {@linkcode exists} and {@linkcode existsSync.} */
+import * as dntShim from "../../../../../_dnt.shims.js";
+/**
+ * Asynchronously test whether or not the given path exists by checking with
+ * the file system.
+ *
+ * Note: Do not use this function if performing a check before another operation
+ * on that file. Doing so creates a race condition. Instead, perform the actual
+ * file operation directly. This function is not recommended for this use case.
+ * See the recommended method below.
+ *
+ * @see {@link https://en.wikipedia.org/wiki/Time-of-check_to_time-of-use} for
+ * more information on the time-of-check to time-of-use bug.
+ *
+ * Requires `--allow-read` permissions, and in some cases, `--allow-sys`
+ * permissions if `options.isReadable` is `true`.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param path The path to the file or directory, as a string or URL.
+ * @param options Additional options for the check.
+ *
+ * @returns A promise that resolves with `true` if the path exists, `false`
+ * otherwise.
+ *
+ * @example Recommended method
+ * ```ts ignore
+ * // Notice no use of exists
+ * try {
+ *   await Deno.remove("./foo", { recursive: true });
+ * } catch (error) {
+ *   if (!(error instanceof Deno.errors.NotFound)) {
+ *     throw error;
+ *   }
+ *   // Do nothing...
+ * }
+ * ```
+ *
+ * Notice that `exists()` is not used in the above example. Doing so avoids a
+ * possible race condition. See the above note for details.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./exists"); // true
+ * await exists("./does_not_exist"); // false
+ * ```
+ *
+ * @example Check if a path is readable
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable", { isReadable: true }); // true
+ * await exists("./not_readable", { isReadable: true }); // false
+ * ```
+ *
+ * @example Check if a path is a directory
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./directory", { isDirectory: true }); // true
+ * await exists("./file", { isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a file
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./file", { isFile: true }); // true
+ * await exists("./directory", { isFile: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable directory
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable_directory", { isReadable: true, isDirectory: true }); // true
+ * await exists("./not_readable_directory", { isReadable: true, isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable file
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { exists } from "@std/fs/exists";
+ *
+ * await exists("./readable_file", { isReadable: true, isFile: true }); // true
+ * await exists("./not_readable_file", { isReadable: true, isFile: true }); // false
+ * ```
+ */
+export async function exists(path, options) {
+    try {
+        const stat = await dntShim.Deno.stat(path);
+        if (options &&
+            (options.isReadable || options.isDirectory || options.isFile)) {
+            if (options.isDirectory && options.isFile) {
+                throw new TypeError("ExistsOptions.options.isDirectory and ExistsOptions.options.isFile must not be true together");
+            }
+            if ((options.isDirectory && !stat.isDirectory) ||
+                (options.isFile && !stat.isFile)) {
+                return false;
+            }
+            if (options.isReadable) {
+                return fileIsReadable(stat);
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            return false;
+        }
+        if (error instanceof dntShim.Deno.errors.PermissionDenied) {
+            if ((await dntShim.Deno.permissions.query({ name: "read", path })).state ===
+                "granted") {
+                // --allow-read not missing
+                return !options?.isReadable; // PermissionDenied was raised by file system, so the item exists, but can't be read
+            }
+        }
+        throw error;
+    }
+}
+/**
+ * Synchronously test whether or not the given path exists by checking with
+ * the file system.
+ *
+ * Note: Do not use this function if performing a check before another operation
+ * on that file. Doing so creates a race condition. Instead, perform the actual
+ * file operation directly. This function is not recommended for this use case.
+ * See the recommended method below.
+ *
+ * @see {@link https://en.wikipedia.org/wiki/Time-of-check_to_time-of-use} for
+ * more information on the time-of-check to time-of-use bug.
+ *
+ * Requires `--allow-read` permissions, and in some cases, `--allow-sys`
+ * permissions if `options.isReadable` is `true`.
+ *
+ * @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
+ * for more information on Deno's permissions system.
+ *
+ * @param path The path to the file or directory, as a string or URL.
+ * @param options Additional options for the check.
+ *
+ * @returns `true` if the path exists, `false` otherwise.
+ *
+ * @example Recommended method
+ * ```ts ignore
+ * // Notice no use of exists
+ * try {
+ *   Deno.removeSync("./foo", { recursive: true });
+ * } catch (error) {
+ *   if (!(error instanceof Deno.errors.NotFound)) {
+ *     throw error;
+ *   }
+ *   // Do nothing...
+ * }
+ * ```
+ *
+ * Notice that `existsSync()` is not used in the above example. Doing so avoids
+ * a possible race condition. See the above note for details.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./exists"); // true
+ * existsSync("./does_not_exist"); // false
+ * ```
+ *
+ * @example Check if a path is readable
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable", { isReadable: true }); // true
+ * existsSync("./not_readable", { isReadable: true }); // false
+ * ```
+ *
+ * @example Check if a path is a directory
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./directory", { isDirectory: true }); // true
+ * existsSync("./file", { isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a file
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./file", { isFile: true }); // true
+ * existsSync("./directory", { isFile: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable directory
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable_directory", { isReadable: true, isDirectory: true }); // true
+ * existsSync("./not_readable_directory", { isReadable: true, isDirectory: true }); // false
+ * ```
+ *
+ * @example Check if a path is a readable file
+ *
+ * Requires `--allow-sys` permissions in some cases.
+ *
+ * ```ts ignore
+ * import { existsSync } from "@std/fs/exists";
+ *
+ * existsSync("./readable_file", { isReadable: true, isFile: true }); // true
+ * existsSync("./not_readable_file", { isReadable: true, isFile: true }); // false
+ * ```
+ */
+export function existsSync(path, options) {
+    try {
+        const stat = dntShim.Deno.statSync(path);
+        if (options &&
+            (options.isReadable || options.isDirectory || options.isFile)) {
+            if (options.isDirectory && options.isFile) {
+                throw new TypeError("ExistsOptions.options.isDirectory and ExistsOptions.options.isFile must not be true together");
+            }
+            if ((options.isDirectory && !stat.isDirectory) ||
+                (options.isFile && !stat.isFile)) {
+                return false;
+            }
+            if (options.isReadable) {
+                return fileIsReadable(stat);
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            return false;
+        }
+        if (error instanceof dntShim.Deno.errors.PermissionDenied) {
+            if (dntShim.Deno.permissions.querySync({ name: "read", path }).state === "granted") {
+                // --allow-read not missing
+                return !options?.isReadable; // PermissionDenied was raised by file system, so the item exists, but can't be read
+            }
+        }
+        throw error;
+    }
+}
+function fileIsReadable(stat) {
+    if (stat.mode === null) {
+        return true; // Exclusive on Non-POSIX systems
+    }
+    else if (dntShim.Deno.uid() === stat.uid) {
+        return (stat.mode & 0o400) === 0o400; // User is owner and can read?
+    }
+    else if (dntShim.Deno.gid() === stat.gid) {
+        return (stat.mode & 0o040) === 0o040; // User group is owner and can read?
+    }
+    return (stat.mode & 0o004) === 0o004; // Others can read?
+}
+//# sourceMappingURL=exists.js.map

package/esm/deps/jsr.io/@std/fs/1.0.5/exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.5/exists.ts"],"names":[],"mappings":"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"}