/**
 * Path Scope Utils — 核心基础层模块。
 *
 * 职责边界：
 * - 负责：PathComparisonOptions 等 核心基础层职责
 * - 不负责：不属于本模块的职责由对应模块承担
 *
 * 被谁调用：引擎各子模块、管线层
 * 调用谁：node:path
 *
 * 数据流：底层能力请求 → 处理 → 返回结果
 * 持久化：无持久化（纯计算/内存态）
 */
export interface PathComparisonOptions {
    caseSensitive?: boolean;
}
/**
 * Canonical path string used for comparison only.
 *
 * This intentionally detects the path grammar from the string itself instead
 * of assuming the current OS. That lets tests and adapters reason about
 * Windows paths on macOS/Linux and vice versa.
 */
export declare function normalizePathForComparison(rawPath: string, options?: PathComparisonOptions): string;
export declare function isSameOrDescendantPath(candidatePath: string, boundaryPath: string, options?: PathComparisonOptions): boolean;
export declare function matchesScopePattern(candidatePath: string, scopePattern: string, options?: PathComparisonOptions): boolean;
export declare function normalizeScopePattern(rawPath: string, _options?: PathComparisonOptions): string;
export declare function isPathInScope(candidatePath: string, scopePattern: string, options?: PathComparisonOptions): boolean;
export declare function isPathInAnyScope(candidatePath: string, scopePatterns: string[], options?: PathComparisonOptions): boolean;
export declare function ensureTrailingSlash(rawPath: string): string;