@effectionx/jsonl-store 0.1.2 → 0.3.0

package/esm/deps/jsr.io/@std/fs/1.0.20/_create_walk_entry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Walk entry for {@linkcode walk}, {@linkcode walkSync},
+ * {@linkcode expandGlob} and {@linkcode expandGlobSync}.
+ */
+export interface WalkEntry extends Deno.DirEntry {
+    /** Full path of the entry. */
+    path: string;
+}
+/** Create {@linkcode WalkEntry} for the `path` synchronously. */
+export declare function createWalkEntrySync(path: string | URL): WalkEntry;
+/** Create {@linkcode WalkEntry} for the `path` asynchronously. */
+export declare function createWalkEntry(path: string | URL): Promise<WalkEntry>;
+//# sourceMappingURL=_create_walk_entry.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/_create_walk_entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_create_walk_entry.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/_create_walk_entry.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,QAAQ;IAC9C,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAYjE;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAY5E"}

package/esm/deps/jsr.io/@std/fs/1.0.20/_create_walk_entry.js

@@ -0,0 +1,33 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+import { basename } from "../../path/1.1.3/basename.js";
+import { normalize } from "../../path/1.1.3/normalize.js";
+import { toPathString } from "./_to_path_string.js";
+/** Create {@linkcode WalkEntry} for the `path` synchronously. */
+export function createWalkEntrySync(path) {
+    path = toPathString(path);
+    path = normalize(path);
+    const name = basename(path);
+    const info = Deno.statSync(path);
+    return {
+        path,
+        name,
+        isFile: info.isFile,
+        isDirectory: info.isDirectory,
+        isSymlink: info.isSymlink,
+    };
+}
+/** Create {@linkcode WalkEntry} for the `path` asynchronously. */
+export async function createWalkEntry(path) {
+    path = toPathString(path);
+    path = normalize(path);
+    const name = basename(path);
+    const info = await Deno.stat(path);
+    return {
+        path,
+        name,
+        isFile: info.isFile,
+        isDirectory: info.isDirectory,
+        isSymlink: info.isSymlink,
+    };
+}

package/esm/deps/jsr.io/@std/fs/1.0.20/_get_file_info_type.d.ts

@@ -0,0 +1,12 @@
+export type PathType = "file" | "dir" | "symlink";
+/**
+ * Get a human readable file type string.
+ *
+ * @param file File information, as returned by {@linkcode Deno.stat} or
+ * {@linkcode Deno.lstat}.
+ *
+ * @returns The file type as a string, or `undefined` if the file type is
+ * unknown.
+ */
+export declare function getFileInfoType(fileInfo: Deno.FileInfo): PathType | undefined;
+//# sourceMappingURL=_get_file_info_type.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/_get_file_info_type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_get_file_info_type.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/_get_file_info_type.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAQ7E"}

package/esm/deps/jsr.io/@std/fs/1.0.20/_get_file_info_type.js

@@ -0,0 +1,20 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+/**
+ * Get a human readable file type string.
+ *
+ * @param file File information, as returned by {@linkcode Deno.stat} or
+ * {@linkcode Deno.lstat}.
+ *
+ * @returns The file type as a string, or `undefined` if the file type is
+ * unknown.
+ */
+export function getFileInfoType(fileInfo) {
+    return fileInfo.isFile
+        ? "file"
+        : fileInfo.isDirectory
+            ? "dir"
+            : fileInfo.isSymlink
+                ? "symlink"
+                : undefined;
+}

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_same_path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Checks if two paths are the same.
+ *
+ * @param src Source file path as a string or URL.
+ * @param dest Destination file path as a string or URL.
+ *
+ * @returns `true` if the paths are the same, `false` otherwise.
+ */
+export declare function isSamePath(src: string | URL, dest: string | URL): boolean;
+//# sourceMappingURL=_is_same_path.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_same_path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_is_same_path.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/_is_same_path.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,MAAM,GAAG,GAAG,GACjB,OAAO,CAKT"}

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_same_path.js

@@ -0,0 +1,17 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+import { resolve } from "../../path/1.1.3/resolve.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Checks if two paths are the same.
+ *
+ * @param src Source file path as a string or URL.
+ * @param dest Destination file path as a string or URL.
+ *
+ * @returns `true` if the paths are the same, `false` otherwise.
+ */
+export function isSamePath(src, dest) {
+    src = toPathString(src);
+    dest = toPathString(dest);
+    return resolve(src) === resolve(dest);
+}

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_subdir.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Checks whether `src` is a sub-directory of `dest`.
+ *
+ * @param src Source file path as a string or URL.
+ * @param dest Destination file path as a string or URL.
+ * @param sep Path separator. Defaults to `\\` for Windows and `/` for other
+ * platforms.
+ *
+ * @returns `true` if `src` is a sub-directory of `dest`, `false` otherwise.
+ */
+export declare function isSubdir(src: string | URL, dest: string | URL, sep?: "/" | "\\"): boolean;
+//# sourceMappingURL=_is_subdir.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_subdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_is_subdir.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/_is_subdir.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,GAAG,aAAY,GACd,OAAO,CAYT"}

package/esm/deps/jsr.io/@std/fs/1.0.20/_is_subdir.js

@@ -0,0 +1,25 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+import { resolve } from "../../path/1.1.3/resolve.js";
+import { SEPARATOR } from "../../path/1.1.3/constants.js";
+import { toPathString } from "./_to_path_string.js";
+/**
+ * Checks whether `src` is a sub-directory of `dest`.
+ *
+ * @param src Source file path as a string or URL.
+ * @param dest Destination file path as a string or URL.
+ * @param sep Path separator. Defaults to `\\` for Windows and `/` for other
+ * platforms.
+ *
+ * @returns `true` if `src` is a sub-directory of `dest`, `false` otherwise.
+ */
+export function isSubdir(src, dest, sep = SEPARATOR) {
+    src = toPathString(src);
+    dest = toPathString(dest);
+    if (resolve(src) === resolve(dest)) {
+        return false;
+    }
+    const srcArray = src.split(sep);
+    const destArray = dest.split(sep);
+    return srcArray.every((current, i) => destArray[i] === current);
+}

package/esm/deps/jsr.io/@std/fs/1.0.20/_to_path_string.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert a URL or string to a path.
+ *
+ * @param pathUrl A URL or string to be converted.
+ *
+ * @returns The path as a string.
+ */
+export declare function toPathString(pathUrl: string | URL): string;
+//# sourceMappingURL=_to_path_string.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/_to_path_string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_to_path_string.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/_to_path_string.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,GAAG,GAAG,GACpB,MAAM,CAER"}

package/esm/deps/jsr.io/@std/fs/1.0.20/_to_path_string.js

@@ -0,0 +1,13 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+import { fromFileUrl } from "../../path/1.1.3/from_file_url.js";
+/**
+ * Convert a URL or string to a path.
+ *
+ * @param pathUrl A URL or string to be converted.
+ *
+ * @returns The path as a string.
+ */
+export function toPathString(pathUrl) {
+    return pathUrl instanceof URL ? fromFileUrl(pathUrl) : pathUrl;
+}

package/esm/deps/jsr.io/@std/fs/1.0.20/copy.d.ts

@@ -0,0 +1,117 @@
+/** Options for {@linkcode copy} and {@linkcode copySync}. */
+export interface CopyOptions {
+    /**
+     * Whether to overwrite existing file or directory.
+     *
+     * @default {false}
+     */
+    overwrite?: boolean;
+    /**
+     * When `true`, will set last modification and access times to the ones of
+     * the original source files. When `false`, timestamp behavior is
+     * OS-dependent.
+     *
+     * > [!NOTE]
+     * > This option is currently unsupported for symbolic links.
+     *
+     * @default {false}
+     */
+    preserveTimestamps?: boolean;
+}
+/**
+ * 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 declare function copy(src: string | URL, dest: string | URL, options?: CopyOptions): Promise<void>;
+/**
+ * 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 declare function copySync(src: string | URL, dest: string | URL, options?: CopyOptions): void;
+//# sourceMappingURL=copy.d.ts.map

package/esm/deps/jsr.io/@std/fs/1.0.20/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/fs/1.0.20/copy.ts"],"names":[],"mappings":"AAWA,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAoOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,GAAE,WAAgB,iBAwB1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,OAAO,GAAE,WAAgB,QAwB1B"}

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

@@ -0,0 +1,312 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+import { basename } from "../../path/1.1.3/basename.js";
+import { join } from "../../path/1.1.3/join.js";
+import { resolve } from "../../path/1.1.3/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 Deno.lstat(dest);
+    }
+    catch (err) {
+        if (err instanceof 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 Deno.errors.AlreadyExists(`'${dest}' already exists.`);
+    }
+    return destStat;
+}
+function ensureValidCopySync(src, dest, options) {
+    let destStat;
+    try {
+        destStat = Deno.lstatSync(dest);
+    }
+    catch (err) {
+        if (err instanceof 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 Deno.errors.AlreadyExists(`'${dest}' already exists`);
+    }
+    return destStat;
+}
+/* copy file to dest */
+async function copyFile(src, dest, options) {
+    await ensureValidCopy(src, dest, options);
+    await Deno.copyFile(src, dest);
+    if (options.preserveTimestamps) {
+        const statInfo = await Deno.stat(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        await Deno.utime(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy file to dest synchronously */
+function copyFileSync(src, dest, options) {
+    ensureValidCopySync(src, dest, options);
+    Deno.copyFileSync(src, dest);
+    if (options.preserveTimestamps) {
+        const statInfo = Deno.statSync(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        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 Deno.readLink(src);
+    const type = getFileInfoType(await Deno.lstat(src));
+    if (isWindows) {
+        await Deno.symlink(originSrcFilePath, dest, {
+            type: type === "dir" ? "dir" : "file",
+        });
+    }
+    else {
+        await Deno.symlink(originSrcFilePath, dest);
+    }
+    if (options.preserveTimestamps) {
+        const statInfo = await Deno.lstat(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        await Deno.utime(dest, statInfo.atime, statInfo.mtime);
+    }
+}
+/* copy symlink to dest synchronously */
+function copySymlinkSync(src, dest, options) {
+    ensureValidCopySync(src, dest, options);
+    const originSrcFilePath = Deno.readLinkSync(src);
+    const type = getFileInfoType(Deno.lstatSync(src));
+    if (isWindows) {
+        Deno.symlinkSync(originSrcFilePath, dest, {
+            type: type === "dir" ? "dir" : "file",
+        });
+    }
+    else {
+        Deno.symlinkSync(originSrcFilePath, dest);
+    }
+    if (options.preserveTimestamps) {
+        const statInfo = Deno.lstatSync(src);
+        assertIsDate(statInfo.atime, "statInfo.atime");
+        assertIsDate(statInfo.mtime, "statInfo.mtime");
+        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 Deno.stat(src);
+        assertIsDate(srcStatInfo.atime, "statInfo.atime");
+        assertIsDate(srcStatInfo.mtime, "statInfo.mtime");
+        await Deno.utime(dest, srcStatInfo.atime, srcStatInfo.mtime);
+    }
+    src = toPathString(src);
+    dest = toPathString(dest);
+    const promises = [];
+    for await (const entry of 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 = Deno.statSync(src);
+        assertIsDate(srcStatInfo.atime, "statInfo.atime");
+        assertIsDate(srcStatInfo.mtime, "statInfo.mtime");
+        Deno.utimeSync(dest, srcStatInfo.atime, srcStatInfo.mtime);
+    }
+    src = toPathString(src);
+    dest = toPathString(dest);
+    for (const entry of 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 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 = 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.20/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