@tinyrack/dotweave 0.39.4

package/dist/lib/filesystem.d.ts

@@ -0,0 +1,60 @@
+import { lstat } from "node:fs/promises";
+/**
+ * @description
+ * Checks whether a filesystem path currently exists.
+ */
+export declare const pathExists: (path: string) => Promise<boolean>;
+/**
+ * @description
+ * Reads path metadata while treating missing paths as an absent result.
+ */
+export declare const getPathStats: (path: string) => Promise<import("fs").Stats | undefined>;
+/**
+ * @description
+ * Reads path metadata while following symlinks and treating missing paths as an absent result.
+ */
+export declare const getFollowedPathStats: (path: string) => Promise<import("fs").Stats | undefined>;
+/**
+ * @description
+ * Lists directory entries in a stable name-sorted order.
+ */
+export declare const listDirectoryEntries: (path: string) => Promise<import("fs").Dirent<string>[]>;
+/**
+ * @description
+ * Writes a regular file node with the permissions dotweave should preserve.
+ */
+export declare const writeFileNode: (path: string, node: Readonly<{
+    contents: string | Uint8Array;
+    executable: boolean;
+}>, fileMode?: number) => Promise<void>;
+/**
+ * @description
+ * Creates a symlink while correctly handling Windows symlink types.
+ */
+export declare const createSymlink: (target: string, path: string, type?: "file" | "dir" | "junction") => Promise<void>;
+/**
+ * @description
+ * Replaces a path with a symlink node and its target.
+ */
+export declare const writeSymlinkNode: (path: string, linkTarget: string) => Promise<void>;
+/**
+ * @description
+ * Copies a filesystem node into the sync layout while preserving supported node types.
+ */
+export declare const copyFilesystemNode: (sourcePath: string, targetPath: string, stats?: Awaited<ReturnType<typeof lstat>>) => Promise<void>;
+/**
+ * @description
+ * Swaps a staged path into place with rollback protection for the previous target.
+ */
+export declare const replacePathAtomically: (targetPath: string, nextPath: string) => Promise<void>;
+/**
+ * @description
+ * Removes a path through a temporary rename so deletion is completed atomically.
+ */
+export declare const removePathAtomically: (targetPath: string) => Promise<void>;
+/**
+ * @description
+ * Writes text content through a staging directory before replacing the target file.
+ */
+export declare const writeTextFileAtomically: (targetPath: string, contents: string) => Promise<void>;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/lib/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/lib/filesystem.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,EAWN,MAAM,kBAAkB,CAAC;AAK1B;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,qBAU5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAU,MAAM,MAAM,4CAa9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,MAAM,MAAM,4CAatD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,MAAM,MAAM,2CAKtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,MAAM,QAAQ,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,EACF,WAAW,MAAM,kBAKlB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,OAAO,MAAM,GAAG,KAAK,GAAG,UAAU,kBAqBnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAU,MAAM,MAAM,EAAE,YAAY,MAAM,kBAItE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,YAAY,MAAM,EAClB,QAAQ,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,kBAkC1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,EAClB,UAAU,MAAM,kBA6BjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM,kBAc5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,UAAU,MAAM,kBAcjB,CAAC"}

package/dist/lib/filesystem.js

@@ -0,0 +1,190 @@
+import { randomUUID } from "node:crypto";
+import { access, chmod, lstat, mkdir, mkdtemp, readdir, readFile, readlink, rename, rm, stat, symlink, writeFile, } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join } from "node:path";
+import { DotweaveError } from "#app/lib/error.ts";
+import { buildExecutableMode, isExecutableMode } from "#app/lib/file-mode.ts";
+/**
+ * @description
+ * Checks whether a filesystem path currently exists.
+ */
+export const pathExists = async (path) => {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+};
+/**
+ * @description
+ * Reads path metadata while treating missing paths as an absent result.
+ */
+export const getPathStats = async (path) => {
+    try {
+        return await lstat(path);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            (error.code === "ENOENT" || error.code === "ENOTDIR")) {
+            return undefined;
+        }
+        throw error;
+    }
+};
+/**
+ * @description
+ * Reads path metadata while following symlinks and treating missing paths as an absent result.
+ */
+export const getFollowedPathStats = async (path) => {
+    try {
+        return await stat(path);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            (error.code === "ENOENT" || error.code === "ENOTDIR")) {
+            return undefined;
+        }
+        throw error;
+    }
+};
+/**
+ * @description
+ * Lists directory entries in a stable name-sorted order.
+ */
+export const listDirectoryEntries = async (path) => {
+    const entries = await readdir(path, { withFileTypes: true });
+    return entries.sort((left, right) => {
+        return left.name.localeCompare(right.name);
+    });
+};
+/**
+ * @description
+ * Writes a regular file node with the permissions dotweave should preserve.
+ */
+export const writeFileNode = async (path, node, fileMode) => {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, node.contents);
+    await chmod(path, fileMode ?? buildExecutableMode(node.executable));
+};
+/**
+ * @description
+ * Creates a symlink while correctly handling Windows symlink types.
+ */
+export const createSymlink = async (target, path, type) => {
+    if (process.platform !== "win32") {
+        await symlink(target, path);
+        return;
+    }
+    // On Windows, the symlink type (file, dir, junction) must be specified.
+    // Junctions are preferred for directories as they don't require admin privileges.
+    if (type !== undefined) {
+        await symlink(target, path, type);
+        return;
+    }
+    const absoluteTarget = isAbsolute(target)
+        ? target
+        : join(dirname(path), target);
+    const stats = await getFollowedPathStats(absoluteTarget);
+    const resolvedType = stats?.isDirectory() ? "junction" : "file";
+    await symlink(target, path, resolvedType);
+};
+/**
+ * @description
+ * Replaces a path with a symlink node and its target.
+ */
+export const writeSymlinkNode = async (path, linkTarget) => {
+    await mkdir(dirname(path), { recursive: true });
+    await rm(path, { force: true, recursive: true });
+    await createSymlink(linkTarget, path);
+};
+/**
+ * @description
+ * Copies a filesystem node into the sync layout while preserving supported node types.
+ */
+export const copyFilesystemNode = async (sourcePath, targetPath, stats) => {
+    const sourceStats = stats ?? (await lstat(sourcePath));
+    if (sourceStats.isDirectory()) {
+        await mkdir(targetPath, { recursive: true });
+        const entries = await listDirectoryEntries(sourcePath);
+        for (const entry of entries) {
+            await copyFilesystemNode(join(sourcePath, entry.name), join(targetPath, entry.name));
+        }
+        return;
+    }
+    if (sourceStats.isSymbolicLink()) {
+        const linkTarget = await readlink(sourcePath);
+        await writeSymlinkNode(targetPath, linkTarget);
+        return;
+    }
+    if (!sourceStats.isFile()) {
+        throw new DotweaveError(`Unsupported filesystem entry: ${sourcePath}`);
+    }
+    await writeFileNode(targetPath, {
+        contents: await readFile(sourcePath),
+        executable: isExecutableMode(sourceStats.mode),
+    });
+};
+/**
+ * @description
+ * Swaps a staged path into place with rollback protection for the previous target.
+ */
+export const replacePathAtomically = async (targetPath, nextPath) => {
+    const backupPath = join(dirname(targetPath), `.${basename(targetPath)}.dotweave-sync-backup-${randomUUID()}`);
+    const existingStats = await getPathStats(targetPath);
+    let targetMoved = false;
+    try {
+        if (existingStats !== undefined) {
+            await rename(targetPath, backupPath);
+            targetMoved = true;
+        }
+        await rename(nextPath, targetPath);
+        if (targetMoved) {
+            await rm(backupPath, { force: true, recursive: true });
+        }
+    }
+    catch (error) {
+        if (targetMoved && !(await pathExists(targetPath))) {
+            await rename(backupPath, targetPath).catch(() => { });
+        }
+        throw error;
+    }
+    finally {
+        await rm(backupPath, { force: true, recursive: true }).catch(() => { });
+    }
+};
+/**
+ * @description
+ * Removes a path through a temporary rename so deletion is completed atomically.
+ */
+export const removePathAtomically = async (targetPath) => {
+    const stats = await getPathStats(targetPath);
+    if (stats === undefined) {
+        return;
+    }
+    const backupPath = join(dirname(targetPath), `.${basename(targetPath)}.dotweave-sync-remove-${randomUUID()}`);
+    await rename(targetPath, backupPath);
+    await rm(backupPath, { force: true, recursive: true });
+};
+/**
+ * @description
+ * Writes text content through a staging directory before replacing the target file.
+ */
+export const writeTextFileAtomically = async (targetPath, contents) => {
+    await mkdir(dirname(targetPath), { recursive: true });
+    const stagingDirectory = await mkdtemp(join(dirname(targetPath), `.${basename(targetPath)}.dotweave-sync-`));
+    const stagedPath = join(stagingDirectory, basename(targetPath));
+    try {
+        await writeFile(stagedPath, contents, "utf8");
+        await replacePathAtomically(targetPath, stagedPath);
+    }
+    finally {
+        await rm(stagingDirectory, { force: true, recursive: true });
+    }
+};
+//# sourceMappingURL=filesystem.js.map

package/dist/lib/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../src/lib/filesystem.ts"],"names":[],"mappings":"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"}

package/dist/lib/git.d.ts

@@ -0,0 +1,23 @@
+import type { ConsolaInstance } from "consola";
+/**
+ * @description
+ * Verifies that a directory is already a git working tree.
+ */
+export declare const ensureRepository: (directory: string) => Promise<void>;
+/**
+ * @description
+ * Creates a sync directory locally or clones it from a remote source.
+ */
+export declare const initializeRepository: (directory: string, source?: string, reporter?: ConsolaInstance) => Promise<{
+    action: "initialized";
+    source?: undefined;
+} | {
+    action: "cloned";
+    source: string;
+}>;
+/**
+ * @description
+ * Ensures the sync directory is a usable git repository for dotweave commands.
+ */
+export declare const ensureGitRepository: (syncDirectory: string) => Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/lib/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmK/C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAU,WAAW,MAAM,kBAEvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,WAAW,eAAe;;;;;;EAoB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,eAAe,MAAM,kBAU9D,CAAC"}

package/dist/lib/git.js

@@ -0,0 +1,162 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import { wrapUnknownError } from "#app/lib/error.ts";
+const execFileAsync = promisify(execFile);
+/**
+ * @description
+ * Runs a git command and normalizes failures into concise errors.
+ */
+const runGitCommand = async (args, options) => {
+    try {
+        const result = await execFileAsync("git", [...args], {
+            cwd: options?.cwd,
+            encoding: "utf8",
+            maxBuffer: 10_000_000,
+        });
+        return {
+            stderr: result.stderr,
+            stdout: result.stdout,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && "stderr" in error) {
+            const stderr = typeof error.stderr === "string" ? error.stderr.trim() : undefined;
+            const stdout = "stdout" in error && typeof error.stdout === "string"
+                ? error.stdout.trim()
+                : undefined;
+            const message = stderr || stdout || error.message;
+            throw new Error(message);
+        }
+        throw new Error(error instanceof Error ? error.message : "git failed.");
+    }
+};
+/**
+ * @description
+ * Streams git progress lines to the reporter as complete messages arrive.
+ */
+const forwardGitProgressChunk = (reporter, state, chunk) => {
+    if (!((reporter?.level ?? 0) >= 4)) {
+        return;
+    }
+    state.remainder += chunk.replaceAll("\r", "\n");
+    const lines = state.remainder.split("\n");
+    state.remainder = lines.pop() ?? "";
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.length > 0) {
+            reporter?.verbose(`git: ${trimmed}`);
+        }
+    }
+};
+/**
+ * @description
+ * Flushes any final buffered git progress line to the reporter.
+ */
+const flushGitProgressChunk = (reporter, state) => {
+    if (!((reporter?.level ?? 0) >= 4)) {
+        return;
+    }
+    const trimmed = state.remainder.trim();
+    if (trimmed.length > 0) {
+        reporter?.verbose(`git: ${trimmed}`);
+    }
+};
+/**
+ * @description
+ * Runs a git command while collecting output and forwarding verbose progress.
+ */
+const runStreamingGitCommand = async (args, options) => {
+    return await new Promise((resolve, reject) => {
+        const child = spawn("git", [...args], {
+            cwd: options?.cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let settled = false;
+        let stdout = "";
+        let stderr = "";
+        const stdoutState = { remainder: "" };
+        const stderrState = { remainder: "" };
+        const finish = (handler) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            handler();
+        };
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+            forwardGitProgressChunk(options?.reporter, stdoutState, chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+            forwardGitProgressChunk(options?.reporter, stderrState, chunk);
+        });
+        child.on("error", (error) => {
+            finish(() => {
+                reject(new Error(error instanceof Error ? error.message : "git failed."));
+            });
+        });
+        child.on("close", (code) => {
+            flushGitProgressChunk(options?.reporter, stdoutState);
+            flushGitProgressChunk(options?.reporter, stderrState);
+            if (code === 0) {
+                finish(() => {
+                    resolve({ stderr, stdout });
+                });
+                return;
+            }
+            finish(() => {
+                reject(new Error(stderr.trim() ||
+                    stdout.trim() ||
+                    `git exited with code ${code ?? "unknown"}.`));
+            });
+        });
+    });
+};
+/**
+ * @description
+ * Verifies that a directory is already a git working tree.
+ */
+export const ensureRepository = async (directory) => {
+    await runGitCommand(["-C", directory, "rev-parse", "--is-inside-work-tree"]);
+};
+/**
+ * @description
+ * Creates a sync directory locally or clones it from a remote source.
+ */
+export const initializeRepository = async (directory, source, reporter) => {
+    if (source === undefined) {
+        await runStreamingGitCommand(["init", "-b", "main", directory], {
+            reporter,
+        });
+        return {
+            action: "initialized",
+        };
+    }
+    await runStreamingGitCommand(["clone", source, directory], {
+        reporter,
+    });
+    return {
+        action: "cloned",
+        source,
+    };
+};
+/**
+ * @description
+ * Ensures the sync directory is a usable git repository for dotweave commands.
+ */
+export const ensureGitRepository = async (syncDirectory) => {
+    try {
+        await ensureRepository(syncDirectory);
+    }
+    catch (error) {
+        throw wrapUnknownError("Sync repository is not initialized.", error, {
+            code: "SYNC_REPO_INVALID",
+            details: [`Sync directory: ${syncDirectory}`],
+            hint: "Run 'dotweave init' to create or clone the sync directory.",
+        });
+    }
+};
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"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"}

package/dist/lib/jsonc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Strips single-line (//) and block (/* *\/) comments from a JSONC string.
+ * Uses a state machine to avoid stripping comment-like sequences inside string literals.
+ */
+export declare const stripJsoncComments: (input: string) => string;
+export declare const parseJsonc: (input: string) => unknown;
+export declare const resolveJsoncConfigPath: (preferredPath: string) => Promise<string>;
+//# sourceMappingURL=jsonc.d.ts.map

package/dist/lib/jsonc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../src/lib/jsonc.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAyDlD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,OAE1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,eAAe,MAAM,KACpB,OAAO,CAAC,MAAM,CAehB,CAAC"}

package/dist/lib/jsonc.js

@@ -0,0 +1,78 @@
+import { DotweaveError } from "#app/lib/error.ts";
+import { pathExists } from "#app/lib/filesystem.ts";
+/**
+ * Strips single-line (//) and block (/* *\/) comments from a JSONC string.
+ * Uses a state machine to avoid stripping comment-like sequences inside string literals.
+ */
+export const stripJsoncComments = (input) => {
+    let result = "";
+    let i = 0;
+    while (i < input.length) {
+        const char = input[i] ?? "";
+        // String literal — pass through verbatim, handling escape sequences
+        if (char === '"') {
+            result += char;
+            i++;
+            while (i < input.length) {
+                const c = input[i] ?? "";
+                result += c;
+                if (c === "\\") {
+                    i++;
+                    if (i < input.length) {
+                        result += input[i];
+                        i++;
+                    }
+                    continue;
+                }
+                i++;
+                if (c === '"')
+                    break;
+            }
+            continue;
+        }
+        // Single-line comment: skip until end of line
+        if (char === "/" && input[i + 1] === "/") {
+            while (i < input.length && input[i] !== "\n") {
+                i++;
+            }
+            continue;
+        }
+        // Block comment: skip until */, preserving newlines for line numbers
+        if (char === "/" && input[i + 1] === "*") {
+            i += 2;
+            while (i < input.length) {
+                if (input[i] === "*" && input[i + 1] === "/") {
+                    i += 2;
+                    break;
+                }
+                if (input[i] === "\n") {
+                    result += "\n";
+                }
+                i++;
+            }
+            continue;
+        }
+        result += char;
+        i++;
+    }
+    return result;
+};
+export const parseJsonc = (input) => {
+    return JSON.parse(stripJsoncComments(input));
+};
+export const resolveJsoncConfigPath = async (preferredPath) => {
+    if (preferredPath.endsWith(".jsonc")) {
+        const jsonPath = preferredPath.slice(0, -1); // .jsonc → .json
+        if (await pathExists(jsonPath)) {
+            throw new DotweaveError("Unsupported dotweave config file.", {
+                code: "CONFIG_JSON_UNSUPPORTED",
+                details: [
+                    `Unsupported config file: ${jsonPath}`,
+                    `Supported config file: ${preferredPath}`,
+                ],
+            });
+        }
+    }
+    return preferredPath;
+};
+//# sourceMappingURL=jsonc.js.map

package/dist/lib/jsonc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.js","sourceRoot":"","sources":["../../src/lib/jsonc.ts"],"names":[],"mappings":"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"}

package/dist/lib/path.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @description
+ * Normalizes repository directory paths into a stable keyed form.
+ */
+export declare const buildDirectoryKey: (repoPath: string) => string;
+/**
+ * @description
+ * Checks whether a path is the same as or contained within a root path.
+ */
+export declare const isPathEqualOrNested: (path: string, rootPath: string) => boolean;
+/**
+ * @description
+ * Detects whether two paths cover any shared directory scope.
+ */
+export declare const doPathsOverlap: (leftPath: string, rightPath: string) => boolean;
+/**
+ * @description
+ * Identifies path inputs that should be treated as explicit local filesystem targets.
+ */
+export declare const isExplicitLocalPath: (target: string) => boolean;
+//# sourceMappingURL=path.d.ts.map

package/dist/lib/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/lib/path.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,WAEjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,YASjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,YAKjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,YAYjD,CAAC"}

package/dist/lib/path.js

@@ -0,0 +1,44 @@
+import { isAbsolute, relative } from "node:path";
+const homePrefix = "~";
+const shellPathSeparator = "/";
+/**
+ * @description
+ * Normalizes repository directory paths into a stable keyed form.
+ */
+export const buildDirectoryKey = (repoPath) => {
+    return `${repoPath}/`;
+};
+/**
+ * @description
+ * Checks whether a path is the same as or contained within a root path.
+ */
+export const isPathEqualOrNested = (path, rootPath) => {
+    const rootToPath = relative(rootPath, path);
+    return (rootToPath === "" ||
+        (!isAbsolute(rootToPath) &&
+            !rootToPath.startsWith("..") &&
+            rootToPath !== ".."));
+};
+/**
+ * @description
+ * Detects whether two paths cover any shared directory scope.
+ */
+export const doPathsOverlap = (leftPath, rightPath) => {
+    return (isPathEqualOrNested(leftPath, rightPath) ||
+        isPathEqualOrNested(rightPath, leftPath));
+};
+/**
+ * @description
+ * Identifies path inputs that should be treated as explicit local filesystem targets.
+ */
+export const isExplicitLocalPath = (target) => {
+    const homePathPrefix = `${homePrefix}${shellPathSeparator}`;
+    return (target === "." ||
+        target === ".." ||
+        target === homePrefix ||
+        target.startsWith("./") ||
+        target.startsWith("../") ||
+        target.startsWith(homePathPrefix) ||
+        isAbsolute(target));
+};
+//# sourceMappingURL=path.js.map

package/dist/lib/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/lib/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAE,EAAE;IACpD,OAAO,GAAG,QAAQ,GAAG,CAAC;AACxB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,EAAE;IACpE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE5C,OAAO,CACL,UAAU,KAAK,EAAE;QACjB,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YACtB,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YAC5B,UAAU,KAAK,IAAI,CAAC,CACvB,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAE,EAAE;IACpE,OAAO,CACL,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;QACxC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CACzC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,EAAE;IACpD,MAAM,cAAc,GAAG,GAAG,UAAU,GAAG,kBAAkB,EAAE,CAAC;IAE5D,OAAO,CACL,MAAM,KAAK,GAAG;QACd,MAAM,KAAK,IAAI;QACf,MAAM,KAAK,UAAU;QACrB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACvB,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QACxB,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC;QACjC,UAAU,CAAC,MAAM,CAAC,CACnB,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/promise.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Limits the number of concurrent asynchronous operations.
+ *
+ * @param concurrency - The maximum number of concurrent operations.
+ * @param items - The items to process.
+ * @param mapper - The mapping function that returns a promise.
+ * @returns A promise that resolves to an array of the results.
+ */
+export declare const limitConcurrency: <T, R>(concurrency: number, items: readonly T[], mapper: (item: T, index: number) => Promise<R>) => Promise<R[]>;
+//# sourceMappingURL=promise.d.ts.map

package/dist/lib/promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../src/lib/promise.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAU,CAAC,EAAE,CAAC,EACzC,aAAa,MAAM,EACnB,OAAO,SAAS,CAAC,EAAE,EACnB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,CAAC,EAAE,CAsBb,CAAC"}