Class AssetPathResolver

packages/asset-system/src/core/AssetPathResolver.ts:34–235

 * 资产路径解析器
 */
export class AssetPathResolver {
    private config: IAssetPathConfig;

    constructor(config: IAssetPathConfig = {}) {
        this.config = {
            baseUrl: '',
            assetDir: 'assets',
            platform: AssetPlatform.H5,
            ...config
        };
    }

    /**
     * Update configuration
     * 更新配置
     */
    updateConfig(config: Partial<IAssetPathConfig>): void {
        this.config = { ...this.config, ...config };
    }

    /**
     * Resolve asset path to full URL
     * 解析资产路径为完整URL
     */
    resolve(path: string): string {
        // Validate input path
        const validation = PathValidator.validate(path);
        if (!validation.valid) {
            console.warn(`Invalid asset path: ${path} - ${validation.reason}`);
            // Sanitize the path instead of throwing
            path = PathValidator.sanitize(path);
            if (!path) {
                throw new Error(`Cannot resolve invalid path: ${validation.reason}`);
            }
        }

        // Already a full URL
        // 已经是完整URL
        if (this.isAbsoluteUrl(path)) {
            return path;
        }

        // Data URL
        // 数据URL
        if (path.startsWith('data:')) {
            return path;
        }

        // Normalize the path
        path = PathValidator.normalize(path);

        // Apply custom transformer if provided
        // 应用自定义转换器（如果提供）
        if (this.config.pathTransformer) {
            path = this.config.pathTransformer(path);
            // Transformer output is trusted (may be absolute path or asset:// URL)
            // 转换器输出是可信的（可能是绝对路径或 asset:// URL）
            return path;