@lzehrung/codegraph 2.1.0

package/dist/util/partialResults.js

@@ -0,0 +1,290 @@
+/**
+ * Partial results handling for more reliable operations
+ *
+ * Instead of failing completely, operations return what was successfully
+ * analyzed along with detailed error information. This is especially useful
+ * for agents that can work with incomplete data.
+ */
+import { errorMessage } from "./errors.js";
+function messageFromReason(reason) {
+    if (reason instanceof Error)
+        return reason.message;
+    if (typeof reason === "string")
+        return reason;
+    if (typeof reason === "object" &&
+        reason !== null &&
+        "message" in reason &&
+        typeof reason.message === "string") {
+        return reason.message;
+    }
+    return "Unknown error";
+}
+/**
+ * Create a successful partial result
+ */
+export function success(data, metadata) {
+    const result = {
+        status: "complete",
+        data,
+        errors: [],
+        coverage: 1.0,
+    };
+    if (metadata) {
+        result.metadata = metadata;
+    }
+    return result;
+}
+/**
+ * Create a partial result with some failures
+ */
+export function partial(data, errors, metadata) {
+    const attempted = metadata?.attempted ?? 1;
+    const failed = metadata?.failed ?? errors.length;
+    const succeeded = attempted - failed;
+    const coverage = attempted > 0 ? succeeded / attempted : 0;
+    return {
+        status: coverage > 0 ? "partial" : "failed",
+        data,
+        errors,
+        coverage,
+        metadata: metadata ?? {
+            attempted,
+            succeeded,
+            failed,
+        },
+    };
+}
+/**
+ * Create a failed result
+ */
+export function failed(emptyData, error, target = "operation") {
+    const message = error instanceof Error ? error.message : error;
+    const stack = error instanceof Error ? error.stack : undefined;
+    const partialError = {
+        target,
+        message,
+        severity: "error",
+        retryable: false,
+    };
+    if (stack) {
+        partialError.stack = stack;
+    }
+    return {
+        status: "failed",
+        data: emptyData,
+        errors: [partialError],
+        coverage: 0,
+        metadata: {
+            attempted: 1,
+            succeeded: 0,
+            failed: 1,
+        },
+    };
+}
+/**
+ * Wrapper for async operations that may partially fail
+ */
+export async function withPartialResults(items, operation, options) {
+    const itemName = options?.itemName ?? "item";
+    const continueOnError = options?.continueOnError ?? true;
+    const concurrency = options?.concurrency ?? 8;
+    const startTime = Date.now();
+    const results = [];
+    const errors = [];
+    let succeeded = 0;
+    let failed = 0;
+    if (!continueOnError) {
+        for (const [index, item] of items.entries()) {
+            try {
+                const result = await operation(item);
+                results.push(result);
+                succeeded++;
+            }
+            catch (error) {
+                failed++;
+                const partialError = {
+                    target: `${itemName}[${index}]`,
+                    message: errorMessage(error),
+                    severity: "error",
+                    retryable: true,
+                };
+                if (error instanceof Error && error.stack) {
+                    partialError.stack = error.stack;
+                }
+                errors.push(partialError);
+                const duration = Date.now() - startTime;
+                return partial(results, errors, {
+                    attempted: succeeded + failed,
+                    succeeded,
+                    failed,
+                    duration,
+                });
+            }
+        }
+        const duration = Date.now() - startTime;
+        return success(results, {
+            attempted: items.length,
+            succeeded,
+            failed: 0,
+            duration,
+        });
+    }
+    // Process in batches with concurrency control
+    for (let i = 0; i < items.length; i += concurrency) {
+        const batch = items.slice(i, i + concurrency);
+        const batchResults = await Promise.allSettled(batch.map(async (item, idx) => {
+            try {
+                const result = await operation(item);
+                return { success: true, result, item, index: i + idx };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error,
+                    item,
+                    index: i + idx,
+                };
+            }
+        }));
+        for (const settled of batchResults) {
+            if (settled.status === "fulfilled") {
+                const value = settled.value;
+                if (value.success) {
+                    results.push(value.result);
+                    succeeded++;
+                }
+                else {
+                    failed++;
+                    const error = {
+                        target: `${itemName}[${value.index}]`,
+                        message: messageFromReason(value.error),
+                        severity: "error",
+                        retryable: true,
+                    };
+                    if (value.error instanceof Error && value.error.stack) {
+                        error.stack = value.error.stack;
+                    }
+                    errors.push(error);
+                }
+            }
+            else {
+                // Promise was rejected (shouldn't happen with allSettled, but handle anyway)
+                failed++;
+                errors.push({
+                    target: `${itemName}[${i + batchResults.indexOf(settled)}]`,
+                    message: messageFromReason(settled.reason),
+                    severity: "error",
+                    retryable: false,
+                });
+            }
+        }
+    }
+    const duration = Date.now() - startTime;
+    if (!errors.length) {
+        return success(results, {
+            attempted: items.length,
+            succeeded,
+            failed: 0,
+            duration,
+        });
+    }
+    return partial(results, errors, {
+        attempted: items.length,
+        succeeded,
+        failed,
+        duration,
+    });
+}
+/**
+ * Combine multiple partial results
+ */
+export function combinePartialResults(results, combine) {
+    const allErrors = [];
+    const allData = [];
+    let totalAttempted = 0;
+    let totalSucceeded = 0;
+    let totalFailed = 0;
+    for (const result of results) {
+        allErrors.push(...result.errors);
+        allData.push(result.data);
+        const counts = getResultCounts(result);
+        totalAttempted += counts.attempted;
+        totalSucceeded += counts.succeeded;
+        totalFailed += counts.failed;
+    }
+    const combined = combine(allData);
+    const coverage = totalAttempted > 0 ? totalSucceeded / totalAttempted : 0;
+    let status = "failed";
+    if (coverage === 1) {
+        status = "complete";
+    }
+    else if (coverage > 0) {
+        status = "partial";
+    }
+    return {
+        status,
+        data: combined,
+        errors: allErrors,
+        coverage,
+        metadata: {
+            attempted: totalAttempted,
+            succeeded: totalSucceeded,
+            failed: totalFailed,
+        },
+    };
+}
+/**
+ * Map a partial result to a new type
+ */
+export function mapPartialResult(result, mapper) {
+    return {
+        ...result,
+        data: mapper(result.data),
+    };
+}
+/**
+ * Filter errors by severity
+ */
+export function filterErrorsBySeverity(result, severity) {
+    return result.errors.filter((e) => e.severity === severity);
+}
+/**
+ * Get a summary of a partial result
+ */
+export function summarizePartialResult(result) {
+    const { status, coverage, errors, metadata } = result;
+    if (status === "complete") {
+        return `✓ Complete (${metadata?.succeeded ?? 0} items processed)`;
+    }
+    if (status === "failed") {
+        const errorCount = errors.length;
+        const firstError = errors[0]?.message ?? "Unknown error";
+        return `✗ Failed (${errorCount} errors): ${firstError}`;
+    }
+    // Partial
+    const pct = (coverage * 100).toFixed(1);
+    const succeeded = metadata?.succeeded ?? 0;
+    const failed = metadata?.failed ?? 0;
+    return `⚠ Partial (${pct}% complete: ${succeeded} succeeded, ${failed} failed)`;
+}
+function getResultCounts(result) {
+    if (result.metadata) {
+        return {
+            attempted: result.metadata.attempted,
+            succeeded: result.metadata.succeeded,
+            failed: result.metadata.failed,
+        };
+    }
+    const attempted = 1;
+    const coverage = Math.max(0, Math.min(1, result.coverage));
+    let succeeded = coverage;
+    if (result.status === "complete") {
+        succeeded = 1;
+    }
+    else if (result.status === "failed") {
+        succeeded = 0;
+    }
+    const failed = attempted - succeeded;
+    return { attempted, succeeded, failed };
+}
+//# sourceMappingURL=partialResults.js.map

package/dist/util/partialResults.js.map

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

package/dist/util/paths.d.ts

@@ -0,0 +1,51 @@
+export declare function normalizePath(p: string): string;
+/**
+ * Configures the assumed filesystem case sensitivity used by {@link fileIdentityKey}.
+ * The first generated key or completed probe freezes the effective value; later
+ * calls are ignored so one index cannot contain keys from mixed case modes.
+ */
+export declare function setFileIdentityCaseInsensitive(caseInsensitive: boolean): void;
+export declare function isFileIdentityCaseInsensitive(): boolean;
+/**
+ * Probes each indexed root and configures {@link fileIdentityKey} from the first
+ * observed filesystem mode. A conflicting later root emits a process warning because
+ * identity keys are process-global. Probe failures retain the platform default.
+ */
+export declare function initializeFileIdentityCaseSensitivity(projectRoot: string): Promise<void>;
+/**
+ * Resets the process-global identity probe for tests that need to exercise both
+ * filesystem case modes. Production code must configure identity once and never reset it.
+ *
+ * Passing an explicit mode pins it: the probe will not overwrite it with the host
+ * filesystem's real behavior, so a test can exercise the case-sensitive branch on a
+ * case-insensitive host. Calling with no argument restores probe-driven detection.
+ */
+export declare function resetFileIdentityCaseSensitivityForTests(caseInsensitive?: boolean): void;
+/**
+ * Canonical comparison key for a file path.
+ *
+ * Use this for every map key, set membership test, dedup check, and path equality
+ * comparison so one physical file can never be keyed two different ways (for example
+ * `./Util` resolving beside a discovered `util.ts` on a case-insensitive volume).
+ *
+ * Never persist or display this value. Keep {@link normalizePath} output for storage,
+ * serialized artifacts, and user-facing output.
+ */
+export declare function fileIdentityKey(filePath: string): string;
+export declare function isAbsoluteFilePath(filePath: string): boolean;
+export declare function resolveFilePathFromRoot(projectRoot: string, filePath: string): string;
+export declare function isFilePathWithinRoot(projectRoot: string, filePath: string): boolean;
+export declare function assertFilePathWithinRoot(projectRoot: string, filePath: string, label?: string): string;
+export type FilePathWithinRootResult = {
+    status: "ok";
+    file: string;
+} | {
+    status: "error";
+    reason: "outside_project_root";
+    error: string;
+};
+export declare function resolveFilePathWithinRoot(projectRoot: string, filePath: string, label?: string): FilePathWithinRootResult;
+export declare function toProjectRelativePath(projectRoot: string, filePath: string): string | null;
+export declare function toProjectDisplayPath(projectRoot: string | undefined, filePath: string): string;
+export declare function normalizeResolutionHints(hints?: string[]): string[];
+//# sourceMappingURL=paths.d.ts.map

package/dist/util/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAaD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,OAAO,GAAG,IAAI,CAG7E;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASxF;AAED;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAOxF;AAoDD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxD;AAYD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWrF;AAgDD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAe,GAAG,MAAM,CAO9G;AAED,MAAM,MAAM,wBAAwB,GAClC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtG,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,wBAAwB,CAU1B;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe1F;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAUnE"}

package/dist/util/paths.js

@@ -0,0 +1,245 @@
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { errorMessage } from "./errors.js";
+export function normalizePath(p) {
+    return typeof p === "string" ? p.replace(/\\/g, "/") : "";
+}
+function normalizeWindowsComparablePath(filePath) {
+    return normalizePath(filePath).replace(/^([A-Za-z]):/, (_, driveLetter) => `${driveLetter.toUpperCase()}:`);
+}
+const defaultCaseInsensitiveFileIdentity = process.platform === "win32" || process.platform === "darwin";
+let caseInsensitiveFileIdentity = defaultCaseInsensitiveFileIdentity;
+let fileIdentityCaseSensitivityFrozen = false;
+let fileIdentityCaseSensitivityPinned = false;
+let fileIdentityCaseSensitivityRoot;
+const fileIdentityCaseSensitivityProbes = new Map();
+let fileIdentityCaseSensitivityProbeGeneration = 0;
+/**
+ * Configures the assumed filesystem case sensitivity used by {@link fileIdentityKey}.
+ * The first generated key or completed probe freezes the effective value; later
+ * calls are ignored so one index cannot contain keys from mixed case modes.
+ */
+export function setFileIdentityCaseInsensitive(caseInsensitive) {
+    if (fileIdentityCaseSensitivityFrozen)
+        return;
+    caseInsensitiveFileIdentity = caseInsensitive;
+}
+export function isFileIdentityCaseInsensitive() {
+    return caseInsensitiveFileIdentity;
+}
+/**
+ * Probes each indexed root and configures {@link fileIdentityKey} from the first
+ * observed filesystem mode. A conflicting later root emits a process warning because
+ * identity keys are process-global. Probe failures retain the platform default.
+ */
+export function initializeFileIdentityCaseSensitivity(projectRoot) {
+    const resolvedRoot = path.resolve(projectRoot);
+    const generation = fileIdentityCaseSensitivityProbeGeneration;
+    let probe = fileIdentityCaseSensitivityProbes.get(resolvedRoot);
+    if (!probe) {
+        probe = probeFileIdentityCaseSensitivity(resolvedRoot, generation);
+        fileIdentityCaseSensitivityProbes.set(resolvedRoot, probe);
+    }
+    return probe;
+}
+/**
+ * Resets the process-global identity probe for tests that need to exercise both
+ * filesystem case modes. Production code must configure identity once and never reset it.
+ *
+ * Passing an explicit mode pins it: the probe will not overwrite it with the host
+ * filesystem's real behavior, so a test can exercise the case-sensitive branch on a
+ * case-insensitive host. Calling with no argument restores probe-driven detection.
+ */
+export function resetFileIdentityCaseSensitivityForTests(caseInsensitive) {
+    fileIdentityCaseSensitivityProbeGeneration += 1;
+    fileIdentityCaseSensitivityProbes.clear();
+    caseInsensitiveFileIdentity = caseInsensitive ?? defaultCaseInsensitiveFileIdentity;
+    fileIdentityCaseSensitivityFrozen = false;
+    fileIdentityCaseSensitivityPinned = caseInsensitive !== undefined;
+    fileIdentityCaseSensitivityRoot = undefined;
+}
+async function probeFileIdentityCaseSensitivity(resolvedRoot, generation) {
+    let caseInsensitive = defaultCaseInsensitiveFileIdentity;
+    try {
+        const caseFlippedRoot = flipPathCharacterCase(resolvedRoot);
+        if (caseFlippedRoot) {
+            const rootStat = await fsp.stat(resolvedRoot);
+            try {
+                const caseFlippedStat = await fsp.stat(caseFlippedRoot);
+                caseInsensitive = rootStat.dev === caseFlippedStat.dev && rootStat.ino === caseFlippedStat.ino;
+            }
+            catch (error) {
+                if (isMissingPathError(error))
+                    caseInsensitive = false;
+            }
+        }
+    }
+    catch {
+        // Some filesystems cannot be probed. Keep the platform default.
+    }
+    if (generation !== fileIdentityCaseSensitivityProbeGeneration || fileIdentityCaseSensitivityPinned)
+        return;
+    if (fileIdentityCaseSensitivityFrozen) {
+        if (caseInsensitive !== caseInsensitiveFileIdentity && fileIdentityCaseSensitivityRoot) {
+            process.emitWarning(`Codegraph file identity uses ${fileIdentityCaseSensitivityRoot} as ${caseInsensitiveFileIdentity ? "case-insensitive" : "case-sensitive"}, but ${resolvedRoot} is ${caseInsensitive ? "case-insensitive" : "case-sensitive"}. Multiple filesystem case modes are not supported in one process.`, { code: "CODEGRAPH_FILE_IDENTITY_CASE_MODE_CONFLICT" });
+        }
+        return;
+    }
+    caseInsensitiveFileIdentity = caseInsensitive;
+    fileIdentityCaseSensitivityFrozen = true;
+    fileIdentityCaseSensitivityRoot = resolvedRoot;
+}
+function isMissingPathError(error) {
+    return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
+}
+function flipPathCharacterCase(filePath) {
+    const rootLength = path.parse(filePath).root.length;
+    for (let index = filePath.length - 1; index >= rootLength; index -= 1) {
+        const character = filePath[index];
+        if (!character)
+            continue;
+        if (character >= "a" && character <= "z") {
+            return `${filePath.slice(0, index)}${character.toUpperCase()}${filePath.slice(index + 1)}`;
+        }
+        if (character >= "A" && character <= "Z") {
+            return `${filePath.slice(0, index)}${character.toLowerCase()}${filePath.slice(index + 1)}`;
+        }
+    }
+    return null;
+}
+/**
+ * Canonical comparison key for a file path.
+ *
+ * Use this for every map key, set membership test, dedup check, and path equality
+ * comparison so one physical file can never be keyed two different ways (for example
+ * `./Util` resolving beside a discovered `util.ts` on a case-insensitive volume).
+ *
+ * Never persist or display this value. Keep {@link normalizePath} output for storage,
+ * serialized artifacts, and user-facing output.
+ */
+export function fileIdentityKey(filePath) {
+    fileIdentityCaseSensitivityFrozen = true;
+    const normalized = normalizeWindowsComparablePath(filePath);
+    return caseInsensitiveFileIdentity ? normalized.toLowerCase() : normalized;
+}
+function isWindowsQualifiedAbsolutePath(filePath) {
+    const normalizedPath = normalizePath(filePath);
+    return /^[A-Za-z]:\//.test(normalizedPath) || normalizedPath.startsWith("//");
+}
+function isPosixQualifiedAbsolutePath(filePath) {
+    const normalizedPath = normalizePath(filePath);
+    return path.posix.isAbsolute(normalizedPath) && !isWindowsQualifiedAbsolutePath(normalizedPath);
+}
+export function isAbsoluteFilePath(filePath) {
+    return path.posix.isAbsolute(filePath) || path.win32.isAbsolute(filePath);
+}
+export function resolveFilePathFromRoot(projectRoot, filePath) {
+    if (isAbsoluteFilePath(filePath)) {
+        return filePath;
+    }
+    if (isWindowsQualifiedAbsolutePath(projectRoot)) {
+        return path.win32.resolve(projectRoot, filePath);
+    }
+    if (isPosixQualifiedAbsolutePath(projectRoot)) {
+        return path.posix.resolve(normalizePath(projectRoot), normalizePath(filePath));
+    }
+    return path.resolve(projectRoot, filePath);
+}
+function resolveComparableProjectRoot(projectRoot) {
+    if (isAbsoluteFilePath(projectRoot)) {
+        return projectRoot;
+    }
+    return path.resolve(projectRoot);
+}
+function isRelativeToRoot(normalizedRoot, normalizedFile) {
+    const rootIsWindowsPath = isWindowsQualifiedAbsolutePath(normalizedRoot);
+    const fileIsWindowsPath = isWindowsQualifiedAbsolutePath(normalizedFile);
+    const rootIsPosixPath = isPosixQualifiedAbsolutePath(normalizedRoot);
+    const fileIsPosixPath = isPosixQualifiedAbsolutePath(normalizedFile);
+    const comparableRoot = rootIsWindowsPath ? normalizeWindowsComparablePath(normalizedRoot) : normalizedRoot;
+    const comparableFile = fileIsWindowsPath ? normalizeWindowsComparablePath(normalizedFile) : normalizedFile;
+    if (rootIsWindowsPath && fileIsWindowsPath) {
+        if (comparableFile === comparableRoot) {
+            return true;
+        }
+        const relativePath = normalizePath(path.win32.relative(comparableRoot, comparableFile));
+        return !!relativePath.length && !relativePath.startsWith("..") && !path.win32.isAbsolute(relativePath);
+    }
+    if (rootIsWindowsPath || fileIsWindowsPath) {
+        return false;
+    }
+    if (rootIsPosixPath && fileIsPosixPath) {
+        if (comparableFile === comparableRoot) {
+            return true;
+        }
+        const relativePath = path.posix.relative(comparableRoot, comparableFile);
+        return !!relativePath.length && !relativePath.startsWith("..") && !path.posix.isAbsolute(relativePath);
+    }
+    if (rootIsPosixPath || fileIsPosixPath) {
+        return false;
+    }
+    if (comparableFile === comparableRoot) {
+        return true;
+    }
+    const relativePath = path.relative(comparableRoot, comparableFile);
+    return !!relativePath.length && !relativePath.startsWith("..") && !path.isAbsolute(relativePath);
+}
+export function isFilePathWithinRoot(projectRoot, filePath) {
+    const normalizedRoot = normalizePath(resolveComparableProjectRoot(projectRoot));
+    const normalizedFile = normalizePath(resolveFilePathFromRoot(normalizedRoot, filePath));
+    return isRelativeToRoot(normalizedRoot, normalizedFile);
+}
+export function assertFilePathWithinRoot(projectRoot, filePath, label = "File") {
+    const normalizedRoot = normalizePath(resolveComparableProjectRoot(projectRoot));
+    const normalizedFile = normalizePath(resolveFilePathFromRoot(normalizedRoot, filePath));
+    if (!isFilePathWithinRoot(normalizedRoot, normalizedFile)) {
+        throw new Error(`${label} is outside project root: ${normalizedFile} (root: ${normalizedRoot})`);
+    }
+    return normalizedFile;
+}
+export function resolveFilePathWithinRoot(projectRoot, filePath, label) {
+    try {
+        return { status: "ok", file: assertFilePathWithinRoot(projectRoot, filePath, label) };
+    }
+    catch (error) {
+        return {
+            status: "error",
+            reason: "outside_project_root",
+            error: errorMessage(error),
+        };
+    }
+}
+export function toProjectRelativePath(projectRoot, filePath) {
+    const normalizedRoot = normalizePath(resolveComparableProjectRoot(projectRoot));
+    const normalizedFile = normalizePath(resolveFilePathFromRoot(normalizedRoot, filePath));
+    if (!isFilePathWithinRoot(normalizedRoot, normalizedFile)) {
+        return null;
+    }
+    if (isWindowsQualifiedAbsolutePath(normalizedRoot) && isWindowsQualifiedAbsolutePath(normalizedFile)) {
+        const comparableRoot = normalizeWindowsComparablePath(normalizedRoot);
+        const comparableFile = normalizeWindowsComparablePath(normalizedFile);
+        return normalizePath(path.win32.relative(comparableRoot, comparableFile));
+    }
+    if (isPosixQualifiedAbsolutePath(normalizedRoot) && isPosixQualifiedAbsolutePath(normalizedFile)) {
+        return path.posix.relative(normalizedRoot, normalizedFile);
+    }
+    return normalizePath(path.relative(normalizedRoot, normalizedFile));
+}
+export function toProjectDisplayPath(projectRoot, filePath) {
+    if (!projectRoot)
+        return normalizePath(filePath);
+    return toProjectRelativePath(projectRoot, filePath) ?? normalizePath(filePath);
+}
+export function normalizeResolutionHints(hints) {
+    const out = [];
+    const seen = new Set();
+    for (const hint of hints ?? []) {
+        const normalized = hint.replace(/\\/g, "/").trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        out.push(normalized);
+    }
+    return out;
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

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

package/dist/util/projectFiles/definitions.d.ts

@@ -0,0 +1,21 @@
+export type ProjectFileKind = "file" | "dir";
+export type ProjectFileRole = "manifest" | "lockfile" | "config" | "solution" | "ide";
+export type ProjectFileType = "node" | "typescript" | "python" | "rust" | "go" | "maven" | "gradle" | "dotnet" | "ruby" | "php" | "swift" | "native" | "ide";
+export type ProjectFileInfo = {
+    path: string;
+    kind: ProjectFileKind;
+    type: ProjectFileType;
+    role: ProjectFileRole;
+    projectRoot: string;
+    name?: string;
+};
+export type ProjectFileDefinition = {
+    type: ProjectFileType;
+    role: ProjectFileRole;
+    kind: ProjectFileKind;
+    patterns: string[];
+    parseName?: (contents: string, filePath: string) => string | null;
+    nameFromPath?: "file" | "dir";
+};
+export declare const PROJECT_FILE_DEFINITIONS: ProjectFileDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/util/projectFiles/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/util/projectFiles/definitions.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAC7C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AACtF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAClE,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B,CAAC;AAqCF,eAAO,MAAM,wBAAwB,EAAE,qBAAqB,EA8F3D,CAAC"}