@bolt-foundry/gambit 0.8.3 → 0.8.5-rc.5

package/esm/deps/jsr.io/@std/fs/1.0.22/copy.js

@@ -0,0 +1,313 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { basename } from "../../path/1.1.4/basename.js";
+import { join } from "../../path/1.1.4/join.js";
+import { resolve } from "../../path/1.1.4/resolve.js";
+import { ensureDir, ensureDirSync } from "./ensure_dir.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+import { toPathString } from "./_to_path_string.js";
+import { isSubdir } from "./_is_subdir.js";
+import { isWindows } from "../../internal/1.0.12/os.js";
+function assertIsDate(date, name) {
+    if (date === null) {
+        throw new Error(`${name} is unavailable`);
+    }
+}
+async function ensureValidCopy(src, dest, options) {
+    let destStat;
+    try {
+        destStat = await dntShim.Deno.lstat(dest);
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound) {
+            return;
+        }
+        throw err;
+    }
+    if (options.isFolder && !destStat.isDirectory) {
+        throw new Error(`Cannot overwrite non-directory '${dest}' with directory '${src}'`);
+    }
+    if (!options.overwrite) {
+        throw new dntShim.Deno.errors.AlreadyExists(`'${dest}' already exists.`);
+    }
+    return destStat;
+}
+function ensureValidCopySync(src, dest, options) {
+    let destStat;
+    try {
+        destStat = dntShim.Deno.lstatSync(dest);
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound) {
+            return;
+        }
+        throw err;
+    }
+    if (options.isFolder && !destStat.isDirectory) {
+        throw new Error(`Cannot overwrite non-directory '${dest}' with directory '${src}'`);
+    }
+    if (!options.overwrite) {
+        throw new dntShim.Deno.errors.AlreadyExists(`'${dest}' already exists`);
+    }
+    return destStat;
+}
+/* copy file to dest */
+async function copyFile(src, dest, options) {
+    await ensureValidCopy(src, dest, options);
+    await dntShim.Deno.copyFile(src, dest);
+    if (options.preserveTimestamps) {
+        const statInfo = await dntShim.Deno.stat(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        await dntShim.Deno.utime(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy file to dest synchronously */
+function copyFileSync(src, dest, options) {
+    ensureValidCopySync(src, dest, options);
+    dntShim.Deno.copyFileSync(src, dest);
+    if (options.preserveTimestamps) {
+        const statInfo = dntShim.Deno.statSync(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        dntShim.Deno.utimeSync(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy symlink to dest */
+async function copySymLink(src, dest, options) {
+    await ensureValidCopy(src, dest, options);
+    const originSrcFilePath = await dntShim.Deno.readLink(src);
+    const type = getFileInfoType(await dntShim.Deno.lstat(src));
+    if (isWindows) {
+        await dntShim.Deno.symlink(originSrcFilePath, dest, {
+            type: type === "dir" ? "dir" : "file",
+        });
+    }
+    else {
+        await dntShim.Deno.symlink(originSrcFilePath, dest);
+    }
+    if (options.preserveTimestamps) {
+        const statInfo = await dntShim.Deno.lstat(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        await dntShim.Deno.utime(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy symlink to dest synchronously */
+function copySymlinkSync(src, dest, options) {
+    ensureValidCopySync(src, dest, options);
+    const originSrcFilePath = dntShim.Deno.readLinkSync(src);
+    const type = getFileInfoType(dntShim.Deno.lstatSync(src));
+    if (isWindows) {
+        dntShim.Deno.symlinkSync(originSrcFilePath, dest, {
+            type: type === "dir" ? "dir" : "file",
+        });
+    }
+    else {
+        dntShim.Deno.symlinkSync(originSrcFilePath, dest);
+    }
+    if (options.preserveTimestamps) {
+        const statInfo = dntShim.Deno.lstatSync(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        dntShim.Deno.utimeSync(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy folder from src to dest. */
+async function copyDir(src, dest, options) {
+    const destStat = await ensureValidCopy(src, dest, {
+        ...options,
+        isFolder: true,
+    });
+    if (!destStat) {
+        await ensureDir(dest);
+    }
+    if (options.preserveTimestamps) {
+        const srcStatInfo = await dntShim.Deno.stat(src);
+        assertIsDate(srcStatInfo.atime, "statInfo.atime");
+        assertIsDate(srcStatInfo.mtime, "statInfo.mtime");
+        await dntShim.Deno.utime(dest, srcStatInfo.atime, srcStatInfo.mtime);
+    }
+    src = toPathString(src);
+    dest = toPathString(dest);
+    const promises = [];
+    for await (const entry of dntShim.Deno.readDir(src)) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, basename(srcPath));
+        if (entry.isSymlink) {
+            promises.push(copySymLink(srcPath, destPath, options));
+        }
+        else if (entry.isDirectory) {
+            promises.push(copyDir(srcPath, destPath, options));
+        }
+        else if (entry.isFile) {
+            promises.push(copyFile(srcPath, destPath, options));
+        }
+    }
+    await Promise.all(promises);
+}
+/* copy folder from src to dest synchronously */
+function copyDirSync(src, dest, options) {
+    const destStat = ensureValidCopySync(src, dest, {
+        ...options,
+        isFolder: true,
+    });
+    if (!destStat) {
+        ensureDirSync(dest);
+    }
+    if (options.preserveTimestamps) {
+        const srcStatInfo = dntShim.Deno.statSync(src);
+        assertIsDate(srcStatInfo.atime, "statInfo.atime");
+        assertIsDate(srcStatInfo.mtime, "statInfo.mtime");
+        dntShim.Deno.utimeSync(dest, srcStatInfo.atime, srcStatInfo.mtime);
+    }
+    src = toPathString(src);
+    dest = toPathString(dest);
+    for (const entry of dntShim.Deno.readDirSync(src)) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, basename(srcPath));
+        if (entry.isSymlink) {
+            copySymlinkSync(srcPath, destPath, options);
+        }
+        else if (entry.isDirectory) {
+            copyDirSync(srcPath, destPath, options);
+        }
+        else if (entry.isFile) {
+            copyFileSync(srcPath, destPath, options);
+        }
+    }
+}
+/**
+ * Asynchronously copy a file or directory (along with its contents), like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=c-cp-command#cp__cp_flagr | cp -r}.
+ *
+ * Both `src` and `dest` must both be a file or directory.
+ *
+ * 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/directory path as a string or URL.
+ * @param dest The destination file/directory path as a string or URL.
+ * @param options Options for copying.
+ *
+ * @returns A promise that resolves once the copy operation completes.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { copy } from "@std/fs/copy";
+ *
+ * await copy("./foo", "./bar");
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` without
+ * overwriting.
+ *
+ * @example Overwriting files/directories
+ * ```ts ignore
+ * import { copy } from "@std/fs/copy";
+ *
+ * await copy("./foo", "./bar", { overwrite: true });
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` and overwrite
+ * any existing files or directories.
+ *
+ * @example Preserving timestamps
+ * ```ts ignore
+ * import { copy } from "@std/fs/copy";
+ *
+ * await copy("./foo", "./bar", { preserveTimestamps: true });
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` and set the
+ * last modification and access times to the ones of the original source files.
+ */
+export async function copy(src, dest, options = {}) {
+    src = resolve(toPathString(src));
+    dest = resolve(toPathString(dest));
+    if (src === dest) {
+        throw new Error("Source and destination cannot be the same");
+    }
+    const srcStat = await dntShim.Deno.lstat(src);
+    if (srcStat.isDirectory && isSubdir(src, dest)) {
+        throw new Error(`Cannot copy '${src}' to a subdirectory of itself: '${dest}'`);
+    }
+    if (srcStat.isSymlink) {
+        await copySymLink(src, dest, options);
+    }
+    else if (srcStat.isDirectory) {
+        await copyDir(src, dest, options);
+    }
+    else if (srcStat.isFile) {
+        await copyFile(src, dest, options);
+    }
+}
+/**
+ * Synchronously copy a file or directory (along with its contents), like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=c-cp-command#cp__cp_flagr | cp -r}.
+ *
+ * Both `src` and `dest` must both be a file or directory.
+ *
+ * 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/directory path as a string or URL.
+ * @param dest The destination file/directory path as a string or URL.
+ * @param options Options for copying.
+ *
+ * @returns A void value that returns once the copy operation completes.
+ *
+ * @example Basic usage
+ * ```ts ignore
+ * import { copySync } from "@std/fs/copy";
+ *
+ * copySync("./foo", "./bar");
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` without
+ * overwriting.
+ *
+ * @example Overwriting files/directories
+ * ```ts ignore
+ * import { copySync } from "@std/fs/copy";
+ *
+ * copySync("./foo", "./bar", { overwrite: true });
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` and overwrite
+ * any existing files or directories.
+ *
+ * @example Preserving timestamps
+ * ```ts ignore
+ * import { copySync } from "@std/fs/copy";
+ *
+ * copySync("./foo", "./bar", { preserveTimestamps: true });
+ * ```
+ *
+ * This will copy the file or directory at `./foo` to `./bar` and set the
+ * last modification and access times to the ones of the original source files.
+ */
+export function copySync(src, dest, options = {}) {
+    src = resolve(toPathString(src));
+    dest = resolve(toPathString(dest));
+    if (src === dest) {
+        throw new Error("Source and destination cannot be the same");
+    }
+    const srcStat = dntShim.Deno.lstatSync(src);
+    if (srcStat.isDirectory && isSubdir(src, dest)) {
+        throw new Error(`Cannot copy '${src}' to a subdirectory of itself: '${dest}'`);
+    }
+    if (srcStat.isSymlink) {
+        copySymlinkSync(src, dest, options);
+    }
+    else if (srcStat.isDirectory) {
+        copyDirSync(src, dest, options);
+    }
+    else if (srcStat.isFile) {
+        copyFileSync(src, dest, options);
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.22/empty_dir.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Asynchronously ensures that a directory is empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void promise that resolves once the directory is empty.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { emptyDir } from "@std/fs/empty-dir";
+ *
+ * await emptyDir("./foo");
+ * ```
+ */
+export declare function emptyDir(dir: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that a directory is empty deletes the directory
+ * contents it is not empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void value that returns once the directory is empty.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { emptyDirSync } from "@std/fs/empty-dir";
+ *
+ * emptyDirSync("./foo");
+ * ```
+ */
+export declare function emptyDirSync(dir: string | URL): void;
+//# sourceMappingURL=empty_dir.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.22/empty_dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty_dir.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.22/empty_dir.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,iBAkB/C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,QAmB7C"}

package/esm/deps/jsr.io/@std/fs/1.0.22/empty_dir.js

@@ -0,0 +1,87 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { join } from "../../path/1.1.4/join.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Asynchronously ensures that a directory is empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void promise that resolves once the directory is empty.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { emptyDir } from "@std/fs/empty-dir";
+ *
+ * await emptyDir("./foo");
+ * ```
+ */
+export async function emptyDir(dir) {
+    try {
+        const items = await Array.fromAsync(dntShim.Deno.readDir(dir));
+        await Promise.all(items.map((item) => {
+            if (item && item.name) {
+                const filepath = join(toPathString(dir), item.name);
+                return dntShim.Deno.remove(filepath, { recursive: true });
+            }
+        }));
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+        // if not exist. then create it
+        await dntShim.Deno.mkdir(dir, { recursive: true });
+    }
+}
+/**
+ * Synchronously ensures that a directory is empty deletes the directory
+ * contents it is not empty.
+ *
+ * If the directory does not exist, it is created. The directory itself is not
+ * deleted.
+ *
+ * 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 dir The path of the directory to empty, as a string or URL.
+ *
+ * @returns A void value that returns once the directory is empty.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { emptyDirSync } from "@std/fs/empty-dir";
+ *
+ * emptyDirSync("./foo");
+ * ```
+ */
+export function emptyDirSync(dir) {
+    try {
+        const items = [...dntShim.Deno.readDirSync(dir)];
+        // If the directory exists, remove all entries inside it.
+        while (items.length) {
+            const item = items.shift();
+            if (item && item.name) {
+                const filepath = join(toPathString(dir), item.name);
+                dntShim.Deno.removeSync(filepath, { recursive: true });
+            }
+        }
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+        // if not exist. then create it
+        dntShim.Deno.mkdirSync(dir, { recursive: true });
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.22/ensure_dir.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Asynchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A promise that resolves once the directory exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureDir } from "@std/fs/ensure-dir";
+ *
+ * await ensureDir("./bar");
+ * ```
+ */
+export declare function ensureDir(dir: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the directory exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureDirSync } from "@std/fs/ensure-dir";
+ *
+ * ensureDirSync("./bar");
+ * ```
+ */
+export declare function ensureDirSync(dir: string | URL): void;
+//# sourceMappingURL=ensure_dir.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.22/ensure_dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_dir.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.22/ensure_dir.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,iBAuBhD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,QAuB9C"}

package/esm/deps/jsr.io/@std/fs/1.0.22/ensure_dir.js

@@ -0,0 +1,102 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+import * as dntShim from "../../../../../_dnt.shims.js";
+import { getFileInfoType } from "./_get_file_info_type.js";
+/**
+ * Asynchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A promise that resolves once the directory exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureDir } from "@std/fs/ensure-dir";
+ *
+ * await ensureDir("./bar");
+ * ```
+ */
+export async function ensureDir(dir) {
+    try {
+        const fileInfo = await dntShim.Deno.stat(dir);
+        throwIfNotDirectory(fileInfo);
+        return;
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+    }
+    // The dir doesn't exist. Create it.
+    // This can be racy. So we catch AlreadyExists and check stat again.
+    try {
+        await dntShim.Deno.mkdir(dir, { recursive: true });
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw err;
+        }
+        const fileInfo = await dntShim.Deno.stat(dir);
+        throwIfNotDirectory(fileInfo);
+    }
+}
+/**
+ * Synchronously ensures that the directory exists, like
+ * {@linkcode https://www.ibm.com/docs/en/aix/7.3?topic=m-mkdir-command#mkdir__row-d3e133766 | mkdir -p}.
+ *
+ * If the directory already exists, this function does nothing. If the directory
+ * does not exist, it is 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 dir The path of the directory to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the directory exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureDirSync } from "@std/fs/ensure-dir";
+ *
+ * ensureDirSync("./bar");
+ * ```
+ */
+export function ensureDirSync(dir) {
+    try {
+        const fileInfo = dntShim.Deno.statSync(dir);
+        throwIfNotDirectory(fileInfo);
+        return;
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            throw err;
+        }
+    }
+    // The dir doesn't exist. Create it.
+    // This can be racy. So we catch AlreadyExists and check stat again.
+    try {
+        dntShim.Deno.mkdirSync(dir, { recursive: true });
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.AlreadyExists)) {
+            throw err;
+        }
+        const fileInfo = dntShim.Deno.statSync(dir);
+        throwIfNotDirectory(fileInfo);
+    }
+}
+function throwIfNotDirectory(fileInfo) {
+    if (!fileInfo.isDirectory) {
+        throw new Error(`Failed to ensure directory exists: expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+    }
+}

package/esm/deps/jsr.io/@std/fs/1.0.22/ensure_file.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Asynchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void promise that resolves once the file exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureFile } from "@std/fs/ensure-file";
+ *
+ * await ensureFile("./folder/targetFile.dat");
+ * ```
+ */
+export declare function ensureFile(filePath: string | URL): Promise<void>;
+/**
+ * Synchronously ensures that the file exists.
+ *
+ * If the file already exists, this function does nothing. If the parent
+ * directories for the file 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 filePath The path of the file to ensure, as a string or URL.
+ *
+ * @returns A void value that returns once the file exists.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { ensureFileSync } from "@std/fs/ensure-file";
+ *
+ * ensureFileSync("./folder/targetFile.dat");
+ * ```
+ */
+export declare function ensureFileSync(filePath: string | URL): void;
+//# sourceMappingURL=ensure_file.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.22/ensure_file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_file.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.22/ensure_file.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAsB3D"}