/**
 * @deprecated [DC-2] 无运行时消费方。保留供未来跨平台兼容实现。
 *
 * 问题四十: Platform Compatibility — 跨平台路径安全、规范化与兼容性。
 *
 * 强制执行:
 * - symlink / case sensitivity / path separator / shell 差异不得绕过 scope
 * - 跨平台兼容不得以降低安全边界为代价
 * - 路径判定必须使用 path.resolve + path.relative，禁止 startsWith 字符串边界判断
 */
import type { PlatformContext, NormalizedPathRef, PlatformCompatibilityReport, PathSafetyCheck } from "./extension_platform_contracts.js";
/**
 * 路径解析器 — 可注入以支持测试环境和 CI。
 * 默认使用 Node.js path.resolve + fs.realpathSync.native。
 */
export interface PathResolver {
    resolve: (...pathSegments: string[]) => string;
    realpath: (p: string) => string;
}
/**
 * 检测当前平台上下文。
 */
export declare function detectPlatformContext(workspacePath: string): PlatformContext;
/**
 * 规范化路径引用。
 *
 * 安全策略:
 * - 使用 path.resolve 解析 .. / ~ / 相对路径
 * - 使用 path.relative + startsWith('..') 判断是否逃逸 scope
 * - 禁止 startsWith 字符串边界判断作为 scope 判定方式
 * - realpath 解析 symlink，文件不存在时回退到 resolved 路径
 */
export declare function normalizePathRef(rawPath: string, platform: PlatformContext, scopeBoundary: string, resolver?: PathResolver): NormalizedPathRef;
/**
 * 执行路径安全检查。
 */
export declare function checkPathSafety(pathRef: NormalizedPathRef, scopeBoundary: string): PathSafetyCheck;
/**
 * 生成平台兼容性报告。
 */
export declare function generatePlatformReport(platform: PlatformContext, pathsToCheck: string[], scopeBoundary: string): PlatformCompatibilityReport;
/**
 * 创建测试用的平台上下文。
 */
export declare function createTestPlatformContext(overrides?: Partial<PlatformContext>): PlatformContext;
//# sourceMappingURL=platform_context.d.ts.map