filedist 0.21.2

package/dist/package/resolve-files.js

@@ -0,0 +1,225 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFiles = resolveFiles;
+exports.resolveFilesDetailed = resolveFilesDetailed;
+/* eslint-disable no-console */
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("../utils");
+const package_files_1 = require("../fileset/package-files");
+const config_1 = require("./config");
+const config_merge_1 = require("./config-merge");
+const source_1 = require("./source");
+function addRelevantPackage(relevantPackagesByOutputDir, outputDir, packageName) {
+    const relevantPackages = relevantPackagesByOutputDir.get(outputDir) ?? new Set();
+    relevantPackages.add(packageName);
+    relevantPackagesByOutputDir.set(outputDir, relevantPackages);
+}
+function markNoSyncOutput(noSyncOutputDirs, outputDir, noSync) {
+    if (noSync) {
+        noSyncOutputDirs.add(outputDir);
+    }
+}
+/** Unique key for an entry used for recursion-cycle detection. */
+function entryKey(entry, output, selector, currentPkgPath) {
+    const packageScope = entry.package ?? `__self__:${currentPkgPath ?? ''}`;
+    return `${packageScope}|${JSON.stringify(selector)}|${JSON.stringify(output)}`;
+}
+/**
+ * Recursively resolve all entries into a flat list of desired files.
+ *
+ * Two entry types are handled:
+ *  - Self-package entry (no `package` field): enumerates files directly from the
+ *    package context provided by the parent recursion level.
+ *  - External-package entry (`package` field set): installs the package, reads its
+ *    filedist.sets, and recurses; when the package has no sets, files are enumerated
+ *    directly (leaf behaviour).
+ *
+ * Duplicate (outputDir, relPath) pairs are deduplicated; conflicting managed/gitignore
+ * settings for the same destination path throw an error.
+ */
+async function resolveFiles(entries, options) {
+    const result = await resolveFilesDetailed(entries, options);
+    return result.files;
+}
+async function resolveFilesDetailed(entries, options) {
+    const visited = new Set();
+    const relevantPackagesByOutputDir = new Map();
+    const noSyncOutputDirs = new Set();
+    const sourceRuntime = options.sourceRuntime ?? (0, source_1.createSourceRuntime)(options.cwd, options.verbose);
+    const raw = await resolveFilesInternal(entries, { path: '.' }, {}, 
+    // eslint-disable-next-line no-undefined
+    undefined, 
+    // eslint-disable-next-line no-undefined
+    undefined, 
+    // eslint-disable-next-line no-undefined
+    undefined, { ...options, sourceRuntime }, relevantPackagesByOutputDir, noSyncOutputDirs, visited);
+    return {
+        files: deduplicateAndCheckConflicts(raw),
+        relevantPackagesByOutputDir,
+        noSyncOutputDirs,
+    };
+}
+// eslint-disable-next-line complexity
+async function resolveFilesInternal(entries, inheritedOutput, inheritedSelector, currentPkgPath, currentPkgName, currentPkgVersion, options, relevantPackagesByOutputDir, noSyncOutputDirs, visited) {
+    const { cwd, verbose, onProgress, sourceRuntime } = options;
+    const resolvedEntries = entries.map((entry) => {
+        const mergedOutput = (0, config_merge_1.mergeOutputConfig)(inheritedOutput, entry.output ?? {});
+        const entrySelector = entry.selector ?? {};
+        const mergedSelector = (0, config_merge_1.mergeSelectorConfig)(inheritedSelector, entrySelector);
+        return {
+            entry,
+            mergedOutput,
+            mergedSelector,
+            key: entryKey(entry, mergedOutput, mergedSelector, currentPkgPath),
+        };
+    });
+    const entriesToProcess = resolvedEntries.filter(({ key }) => !visited.has(key));
+    for (const { key } of entriesToProcess)
+        visited.add(key);
+    if (verbose && entriesToProcess.length > 0) {
+        console.log(`[verbose] resolveFiles: processing ${entriesToProcess.length} entr${entriesToProcess.length === 1 ? 'y' : 'ies'}`);
+    }
+    const results = [];
+    for (const { entry, mergedOutput, mergedSelector } of entriesToProcess) {
+        if (!entry.package) {
+            // ── Self-package entry (no package field) ────────────────────────────
+            // Enumerates files directly from the current package context.
+            if (!currentPkgPath || !currentPkgName) {
+                throw new Error('A self-package entry (no "package" field) can only appear inside a ' +
+                    "package's own filedist.sets.");
+            }
+            const outputDir = node_path_1.default.resolve(cwd, mergedOutput.path ?? '.');
+            addRelevantPackage(relevantPackagesByOutputDir, outputDir, currentPkgName);
+            markNoSyncOutput(noSyncOutputDirs, outputDir, mergedOutput.noSync === true);
+            const files = await (0, package_files_1.enumeratePackageFiles)(currentPkgPath, mergedSelector);
+            if (verbose) {
+                console.log(`[verbose] resolveFiles: self-package "${currentPkgName}" → ${files.length} file(s) to ${(0, utils_1.formatDisplayPath)(outputDir, cwd)}`);
+            }
+            for (const relPath of files) {
+                results.push(buildResolvedFile(relPath, currentPkgPath, currentPkgName, currentPkgVersion ?? '0.0.0', outputDir, mergedOutput));
+            }
+        }
+        else {
+            // ── External-package entry ────────────────────────────────────────────
+            const pkg = (0, source_1.parsePackageTarget)(entry.package, entry.source);
+            const upgrade = mergedSelector.upgrade ?? false;
+            onProgress?.({
+                type: 'package-start',
+                packageName: pkg.packageName,
+                packageVersion: pkg.requestedVersion ?? 'latest',
+            });
+            const resolvedPackage = await sourceRuntime.resolvePackage(entry, upgrade);
+            const pkgPath = resolvedPackage.packagePath;
+            const installedVersion = resolvedPackage.packageVersion;
+            if (verbose) {
+                console.log(`[verbose] resolveFiles: resolved "${resolvedPackage.packageName}@${installedVersion}" at ${(0, utils_1.formatDisplayPath)(pkgPath, cwd)}`);
+            }
+            // Check whether this package declares its own filedist.sets
+            const depConfig = await (0, config_1.loadFiledistConfigFromDirectory)(pkgPath);
+            const pkgFiledistSets = depConfig?.sets;
+            const outputDir = node_path_1.default.resolve(cwd, mergedOutput.path ?? '.');
+            addRelevantPackage(relevantPackagesByOutputDir, outputDir, resolvedPackage.packageName);
+            markNoSyncOutput(noSyncOutputDirs, outputDir, mergedOutput.noSync === true);
+            const hasSelfSet = (pkgFiledistSets ?? []).some((setEntry) => !setEntry.package);
+            // When a package declares self sets, those sets define how its own files are split
+            // across outputs and managed flags. In that case, skip the blanket own-file pass.
+            const ownFiles = hasSelfSet ? [] : await (0, package_files_1.enumeratePackageFiles)(pkgPath, mergedSelector);
+            if (verbose) {
+                console.log(`[verbose] resolveFiles: "${resolvedPackage.packageName}" own files → ${ownFiles.length} file(s) to ${(0, utils_1.formatDisplayPath)(outputDir, cwd)}`);
+            }
+            for (const relPath of ownFiles) {
+                results.push(buildResolvedFile(relPath, pkgPath, resolvedPackage.packageName, installedVersion, outputDir, mergedOutput));
+            }
+            if (pkgFiledistSets && pkgFiledistSets.length > 0) {
+                for (const pkgSet of pkgFiledistSets) {
+                    const setOutput = (0, config_merge_1.mergeOutputConfig)(mergedOutput, pkgSet.output ?? {});
+                    const setOutputDir = node_path_1.default.resolve(cwd, setOutput.path ?? '.');
+                    markNoSyncOutput(noSyncOutputDirs, setOutputDir, setOutput.noSync === true);
+                    if (pkgSet.package) {
+                        addRelevantPackage(relevantPackagesByOutputDir, setOutputDir, (0, source_1.parsePackageTarget)(pkgSet.package, pkgSet.source).packageName);
+                    }
+                    else {
+                        addRelevantPackage(relevantPackagesByOutputDir, setOutputDir, resolvedPackage.packageName);
+                    }
+                }
+                // Apply preset filter
+                const presetFilteredSets = (0, utils_1.filterEntriesByPresets)(pkgFiledistSets, mergedSelector.presets);
+                if (mergedSelector.presets &&
+                    mergedSelector.presets.length > 0 &&
+                    pkgFiledistSets.length > 0 &&
+                    presetFilteredSets.length === 0) {
+                    throw new Error(`Presets (${mergedSelector.presets.join(', ')}) not found in any set of package "${resolvedPackage.packageName}"`);
+                }
+                // Preemptively mark preset-excluded sets as visited
+                for (const e of pkgFiledistSets) {
+                    if (!presetFilteredSets.includes(e)) {
+                        const presetMergedOutput = (0, config_merge_1.mergeOutputConfig)(mergedOutput, e.output ?? {});
+                        const presetMergedSelector = (0, config_merge_1.mergeSelectorConfig)(mergedSelector, e.selector ?? {});
+                        visited.add(entryKey(e, presetMergedOutput, presetMergedSelector, pkgPath));
+                    }
+                }
+                // Self-package sets are followed whenever the package declares them,
+                // because they define the package's own extraction semantics. When a
+                // caller filters by selector.presets, those self sets are filtered by
+                // the preset selection above.
+                const setsToFollow = presetFilteredSets.filter((e) => typeof e.package === 'string' || hasSelfSet);
+                if (verbose && setsToFollow.length > 0) {
+                    console.log(`[verbose] resolveFiles: "${resolvedPackage.packageName}" has ${pkgFiledistSets.length} set(s)` +
+                        `, ${setsToFollow.length} to follow after preset/self-ref filter`);
+                }
+                if (setsToFollow.length > 0) {
+                    const subResults = await resolveFilesInternal(setsToFollow, mergedOutput, mergedSelector, pkgPath, resolvedPackage.packageName, installedVersion, options, relevantPackagesByOutputDir, noSyncOutputDirs, visited);
+                    results.push(...subResults);
+                }
+            }
+            onProgress?.({
+                type: 'package-end',
+                packageName: resolvedPackage.packageName,
+                packageVersion: installedVersion,
+            });
+        }
+    }
+    return results;
+}
+function buildResolvedFile(relPath, pkgPath, packageName, packageVersion, outputDir, output) {
+    return {
+        relPath,
+        sourcePath: node_path_1.default.join(pkgPath, relPath),
+        packageName,
+        packageVersion,
+        outputDir,
+        managed: output.managed !== false,
+        gitignore: output.gitignore !== false,
+        force: output.force ?? false,
+        ignoreIfExisting: output.keepExisting ?? false,
+        noSync: output.noSync === true,
+        contentReplacements: output.contentReplacements ?? [],
+        symlinks: output.symlinks ?? [],
+    };
+}
+/**
+ * Remove duplicate (outputDir, relPath) pairs, checking that duplicates have
+ * compatible managed and gitignore settings. Throws on conflict.
+ */
+function deduplicateAndCheckConflicts(files) {
+    const byKey = new Map();
+    for (const file of files) {
+        const key = `${file.outputDir}|${file.relPath}`;
+        const existing = byKey.get(key);
+        if (!existing) {
+            byKey.set(key, file);
+        }
+        else if (existing.managed !== file.managed || existing.gitignore !== file.gitignore) {
+            throw new Error(`Conflict in resolve: file "${file.relPath}" in "${file.outputDir}" is resolved by ` +
+                `"${existing.packageName}" (managed=${existing.managed}, gitignore=${existing.gitignore}) ` +
+                `and "${file.packageName}" (managed=${file.managed}, gitignore=${file.gitignore}) ` +
+                `with different settings.`);
+        }
+        // Same settings — keep first occurrence (idempotent)
+    }
+    return [...byKey.values()];
+}
+//# sourceMappingURL=resolve-files.js.map

package/dist/package/resolve-files.js.map

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

package/dist/package/source.d.ts

@@ -0,0 +1,20 @@
+import { FiledistExtractEntry, SourceKind } from '../types';
+export type PackageTarget = {
+    source: 'npm' | 'git';
+    packageName: string;
+    requestedVersion?: string;
+    repository?: string;
+};
+export type ResolvedPackageSource = {
+    source: 'npm' | 'git';
+    packageName: string;
+    packageVersion: string;
+    packagePath: string;
+};
+export type SourceRuntime = {
+    resolvePackage: (entry: FiledistExtractEntry, upgrade: boolean) => Promise<ResolvedPackageSource>;
+    cleanup: () => void;
+};
+export declare function parsePackageTarget(spec: string, requestedSource?: SourceKind): PackageTarget;
+export declare function createSourceRuntime(cwd: string, verbose?: boolean): SourceRuntime;
+//# sourceMappingURL=source.d.ts.map

package/dist/package/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/package/source.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG5D,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClG,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAIF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,UAAmB,GACnC,aAAa,CAsBf;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,aAAa,CAiE/E"}

package/dist/package/source.js

@@ -0,0 +1,193 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePackageTarget = parsePackageTarget;
+exports.createSourceRuntime = createSourceRuntime;
+/* eslint-disable no-console */
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("../utils");
+const GIT_SOURCE_REGEX = /^(?:https?|ssh|git|file):\/\/|^git@/i;
+function parsePackageTarget(spec, requestedSource = 'auto') {
+    const source = resolveSourceKind(spec, requestedSource);
+    if (source === 'npm') {
+        const atIdx = spec.lastIndexOf('@');
+        if (atIdx > 0) {
+            const requestedVersion = spec.slice(atIdx + 1);
+            return {
+                source,
+                packageName: spec.slice(0, atIdx),
+                ...(requestedVersion ? { requestedVersion } : {}),
+            };
+        }
+        return { source, packageName: spec };
+    }
+    const { repository, ref } = splitGitSpec(spec);
+    return {
+        source,
+        packageName: normalizeGitRepository(repository),
+        ...(ref ? { requestedVersion: ref } : {}),
+        repository,
+    };
+}
+function createSourceRuntime(cwd, verbose = false) {
+    const packageCache = new Map();
+    const cloneDirs = new Set();
+    const tempRoot = node_path_1.default.join(cwd, '.filedist-tmp');
+    const ensureTempRoot = () => {
+        if (!node_fs_1.default.existsSync(tempRoot)) {
+            node_fs_1.default.mkdirSync(tempRoot, { recursive: true });
+            if (verbose) {
+                console.log(`[verbose] source: created temp git directory ${(0, utils_1.formatDisplayPath)(tempRoot, cwd)}`);
+            }
+        }
+        ensureGitignoreContains(cwd, '.filedist-tmp');
+    };
+    return {
+        async resolvePackage(entry, upgrade) {
+            if (!entry.package) {
+                throw new Error('resolvePackage requires an entry with a package spec');
+            }
+            const target = parsePackageTarget(entry.package, entry.source);
+            const cacheKey = `${target.source}|${target.packageName}|${target.requestedVersion ?? ''}`;
+            if (!upgrade) {
+                const cached = packageCache.get(cacheKey);
+                if (cached)
+                    return cached;
+            }
+            const resolved = target.source === 'git'
+                ? resolveGitPackage(target, cwd, tempRoot, ensureTempRoot, verbose)
+                : resolveNpmPackage(target, upgrade, cwd, verbose);
+            const packageSource = await resolved;
+            packageCache.set(cacheKey, packageSource);
+            if (packageSource.source === 'git') {
+                cloneDirs.add(packageSource.packagePath);
+            }
+            return packageSource;
+        },
+        cleanup() {
+            for (const cloneDir of cloneDirs) {
+                if (node_fs_1.default.existsSync(cloneDir)) {
+                    node_fs_1.default.rmSync(cloneDir, { recursive: true, force: true });
+                }
+            }
+            cloneDirs.clear();
+            if (node_fs_1.default.existsSync(tempRoot)) {
+                try {
+                    if (node_fs_1.default.readdirSync(tempRoot).length === 0) {
+                        node_fs_1.default.rmdirSync(tempRoot);
+                    }
+                }
+                catch {
+                    // ignore cleanup failures
+                }
+            }
+        },
+    };
+}
+function resolveSourceKind(spec, requestedSource) {
+    if (requestedSource === 'npm' || requestedSource === 'git')
+        return requestedSource;
+    return GIT_SOURCE_REGEX.test(spec) ? 'git' : 'npm';
+}
+function splitGitSpec(spec) {
+    if (spec.startsWith('git@')) {
+        const firstAt = spec.indexOf('@');
+        const lastAt = spec.lastIndexOf('@');
+        if (lastAt > firstAt) {
+            const ref = spec.slice(lastAt + 1);
+            return { repository: spec.slice(0, lastAt), ...(ref ? { ref } : {}) };
+        }
+        return { repository: spec };
+    }
+    const schemeEnd = spec.indexOf('://');
+    if (schemeEnd !== -1) {
+        const authStart = schemeEnd + 3;
+        const pathStart = spec.indexOf('/', authStart);
+        const authEnd = pathStart === -1 ? spec.length : pathStart;
+        const lastAt = spec.lastIndexOf('@');
+        if (lastAt >= authEnd) {
+            const ref = spec.slice(lastAt + 1);
+            return { repository: spec.slice(0, lastAt), ...(ref ? { ref } : {}) };
+        }
+        return { repository: spec };
+    }
+    throw new Error(`Git source requires a URL-like package spec. Received "${spec}". ` +
+        'Use source="git" with a full repository URL such as https://host/org/repo@ref.');
+}
+function normalizeGitRepository(repository) {
+    return repository.replace(/\/+$/, '');
+}
+async function resolveNpmPackage(target, upgrade, cwd, verbose) {
+    const packagePath = await (0, utils_1.installOrUpgradePackage)(target.packageName, target.requestedVersion, upgrade, cwd, verbose);
+    let installedVersion = '0.0.0';
+    try {
+        const pkgJsonContent = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(packagePath, 'package.json')).toString());
+        installedVersion = pkgJsonContent.version;
+    }
+    catch {
+        // fallback
+    }
+    return {
+        source: 'npm',
+        packageName: target.packageName,
+        packageVersion: installedVersion,
+        packagePath,
+    };
+}
+async function resolveGitPackage(target, cwd, tempRoot, ensureTempRoot, verbose) {
+    ensureTempRoot();
+    const cloneDir = node_path_1.default.join(tempRoot, buildCloneDirName(target));
+    if (node_fs_1.default.existsSync(cloneDir)) {
+        node_fs_1.default.rmSync(cloneDir, { recursive: true, force: true });
+    }
+    if (verbose) {
+        console.log(`[verbose] source: cloning ${target.repository} into ${(0, utils_1.formatDisplayPath)(cloneDir, cwd)}`);
+    }
+    (0, utils_1.spawnWithLog)('git', ['clone', target.repository, cloneDir], cwd, verbose, true);
+    if (target.requestedVersion) {
+        (0, utils_1.spawnWithLog)('git', ['-C', cloneDir, 'checkout', target.requestedVersion], cwd, verbose, true);
+    }
+    const revision = (0, utils_1.spawnWithLog)('git', ['-C', cloneDir, 'rev-parse', 'HEAD'], cwd, verbose, true)
+        .stdout.toString()
+        .trim();
+    const gitDir = node_path_1.default.join(cloneDir, '.git');
+    if (node_fs_1.default.existsSync(gitDir)) {
+        node_fs_1.default.rmSync(gitDir, { recursive: true, force: true });
+    }
+    return {
+        source: 'git',
+        packageName: target.packageName,
+        packageVersion: revision || target.requestedVersion || 'HEAD',
+        packagePath: cloneDir,
+    };
+}
+function buildCloneDirName(target) {
+    const pathSegments = target.packageName.split(/[/:]/).filter(Boolean);
+    const lastPathSegment = pathSegments.at(-1);
+    const baseName = lastPathSegment?.replace(/\.git$/, '')?.replace(/[^\w.-]+/g, '-') ?? 'repo';
+    const digest = node_crypto_1.default
+        .createHash('sha1')
+        .update(`${target.packageName}@${target.requestedVersion ?? ''}`)
+        .digest('hex')
+        .slice(0, 12);
+    return `${baseName}-${digest}`;
+}
+function ensureGitignoreContains(cwd, entry) {
+    const gitignorePath = node_path_1.default.join(cwd, '.gitignore');
+    if (!node_fs_1.default.existsSync(gitignorePath)) {
+        node_fs_1.default.writeFileSync(gitignorePath, `${entry}\n`);
+        return;
+    }
+    const lines = node_fs_1.default
+        .readFileSync(gitignorePath, 'utf8')
+        .split(/\r?\n/)
+        .map((line) => line.trim());
+    if (!lines.includes(entry)) {
+        node_fs_1.default.appendFileSync(gitignorePath, `\n${entry}\n`);
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/package/source.js.map

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

package/dist/package/symlinks.d.ts

@@ -0,0 +1,25 @@
+import { ManagedFileMetadata, ResolvedFile, SymlinkConfig } from '../types';
+/**
+ * Create symlinks for all files/dirs in outputDir matching source globs.
+ * Each matching source is symlinked into the target directory.
+ * Symlinks are created as relative paths.
+ */
+export declare function createSymlinks(outputDir: string, configs: SymlinkConfig[]): Promise<void>;
+/**
+ * Collect marker entries for managed symlinks created in an output directory.
+ *
+ * Symlink ownership is attributed to the package/config combination that declared
+ * the symlink operation. Duplicate output paths keep the first discovered owner.
+ */
+export declare function collectManagedSymlinkEntries(outputDir: string, files: ResolvedFile[]): ManagedFileMetadata[];
+/** Remove only marker-managed symlinks that are no longer desired for this run. */
+export declare function removeStaleSymlinks(outputDir: string, managedEntries: ManagedFileMetadata[], desiredPaths: Set<string>): Promise<string[]>;
+export declare function isManagedSymlinkEntry(entry: ManagedFileMetadata): boolean;
+export declare function isManagedFileEntry(entry: ManagedFileMetadata): boolean;
+export declare function findManagedSymlinkEntries(entries: ManagedFileMetadata[], relevantPackages?: Set<string>): ManagedFileMetadata[];
+export declare function uniqueSymlinkConfigs(files: ResolvedFile[]): SymlinkConfig[];
+/**
+ * Remove ALL symlinks pointing into outputDir (used during purge).
+ */
+export declare function removeAllSymlinks(outputDir: string): Promise<number>;
+//# sourceMappingURL=symlinks.d.ts.map

package/dist/package/symlinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlinks.d.ts","sourceRoot":"","sources":["../../src/package/symlinks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG5E;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC/F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,EAAE,GACpB,mBAAmB,EAAE,CAuCvB;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,mBAAmB,EAAE,EACrC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEtE;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,mBAAmB,EAAE,CAMvB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAc3E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E"}