client/src/ts/utils/pathUtils.ts

/**
 * 路径规范化工具函数
 */

/**
 * 规范化完整路径（用于demo管理器的路径导航）
 * - 确保以 / 开头
 * - 去除多余的连续斜杠
 * - 去除尾部斜杠（除非是根路径 /）
 * 
 * @param path 原始路径
 * @returns 规范化后的路径，如果输入无效则返回 null
 * 
 * @example
 * normalizeFullPath('/folder1//folder2/') => '/folder1/folder2'
 * normalizeFullPath('folder1/folder2') => '/folder1/folder2'
 * normalizeFullPath('/') => '/'
 */
export const normalizeFullPath = (path?: string | null): string | null => {
    if (!path) {
        return null;
    }
    const trimmed = path.trim();
    if (!trimmed) {
        return null;
    }
    const withLeadingSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
    const normalized = withLeadingSlash.replace(/\/{2,}/g, '/');
    return normalized.length > 1 && normalized.endsWith('/') ? normalized.slice(0, -1) : normalized;
};

/**
 * 规范化demo文件路径（用于文件系统访问）
 * - 去除前导 /
 * - 确保以 .json 结尾
 * 
 * @param path 原始路径
 * @returns 规范化后的相对路径
 * 
 * @example
 * normalizeDemoPath('/demo1.json') => 'demo1.json'
 * normalizeDemoPath('/folder/demo1') => 'folder/demo1.json'
 * normalizeDemoPath('demo1') => 'demo1.json'
 */
export const normalizeDemoPath = (path: string): string => {
    let normalized = path.trim();
    // 去除前导 /
    if (normalized.startsWith('/')) {
        normalized = normalized.substring(1);
    }
    // 确保以 .json 结尾
    if (!normalized.endsWith('.json')) {
        normalized += '.json';
    }
    return normalized;
};

/**
 * 从路径提取demo名称（文件名，不含扩展名和路径）
 * 
 * @param path demo路径
 * @returns demo名称
 * 
 * @example
 * getDemoName('/folder/demo1.json') => 'demo1'
 * getDemoName('demo1.json') => 'demo1'
 */
export const getDemoName = (path: string): string => {
    const normalized = normalizeDemoPath(path);
    // 去除 .json 后缀，提取文件名
    const fileName = normalized.replace(/\.json$/, '');
    // 如果包含路径分隔符，取最后一部分
    const parts = fileName.split('/');
    return parts[parts.length - 1];
};