resource-preloader 1.0.0

package/dist/resource-loader.amd.js

@@ -0,0 +1,309 @@
+define(['exports'], (function (exports) { 'use strict';
+
+    // 默认公共配置
+    const defaultConfig = {
+        timeout: 1000, // 默认超时时间1s
+        retry: 0, // 默认不重试
+    };
+
+    let globalConfig = { ...defaultConfig };
+
+    /**
+     * 配置公共配置的方法（导出）
+     * @param {Object} config - 需覆盖的公共配置
+     * @returns {Object} 合并后的最终全局配置
+     */
+    function setGlobalConfig(config) {
+        if (typeof config !== 'object' || config === null) {
+            throw new Error('配置参数必须是一个非空对象');
+        }
+        globalConfig = { ...globalConfig, ...config };
+        return { ...globalConfig };
+    }
+
+    /**
+     * 获取当前全局配置
+     * @returns {Object} 全局配置
+     */
+    function getGlobalConfig() {
+        return { ...globalConfig };
+    }
+
+    // 加载器映射表（存储内置+自定义加载器）
+    const loaderMap = new Map();
+
+    /**
+     * 通用资源加载Promise封装
+     * @param {string} url - 资源地址
+     * @param {Function} loadHandler - 具体的资源加载处理函数
+     * @param {number} timeout - 超时时间
+     * @returns {Promise<Object>} 加载结果Promise
+     */
+    function wrapLoadPromise(url, loadHandler, timeout) {
+        return new Promise((resolve, reject) => {
+            // 超时处理
+            const timeoutTimer = setTimeout(() => {
+                reject(new Error(`Resource ${url} load timeout (${timeout}ms)`));
+            }, timeout);
+
+            // 执行具体加载逻辑
+            loadHandler(url)
+                .then((result) => {
+                    clearTimeout(timeoutTimer);
+                    resolve({
+                        url,
+                        success: true,
+                        data: result,
+                        error: null,
+                    });
+                })
+                .catch((error) => {
+                    clearTimeout(timeoutTimer);
+                    reject({
+                        url,
+                        success: false,
+                        data: null,
+                        error,
+                    });
+                });
+        });
+    }
+
+    // --------------- 内置JS加载器 ---------------
+    function jsLoaderHandler(url) {
+        return new Promise((resolve, reject) => {
+            const script = document.createElement('script');
+            script.type = 'text/javascript';
+            script.src = url;
+            script.async = false; // 保持加载顺序（不开启异步）
+
+            script.onload = () => {
+                resolve(script);
+                document.head.removeChild(script); // 可选：加载完成后移除标签，避免污染DOM
+            };
+
+            script.onerror = () => {
+                reject(new Error(`JS resource ${url} load failed`));
+                document.head.removeChild(script);
+            };
+
+            document.head.appendChild(script);
+        });
+    }
+
+    // --------------- 内置CSS加载器 ---------------
+    function cssLoaderHandler(url) {
+        return new Promise((resolve, reject) => {
+            const link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.href = url;
+
+            link.onload = () => {
+                resolve(link);
+            };
+
+            link.onerror = () => {
+                reject(new Error(`CSS resource ${url} load failed`));
+            };
+
+            document.head.appendChild(link);
+        });
+    }
+
+    // 初始化内置加载器
+    loaderMap.set('js', jsLoaderHandler);
+    loaderMap.set('css', cssLoaderHandler);
+
+    /**
+     * 注册自定义加载器的方法（导出）
+     * @param {string} type - 资源类型（唯一标识）
+     * @param {Function} handler - 加载处理函数，接收url参数，返回Promise
+     */
+    function registerLoader(type, handler) {
+        if (typeof type !== 'string' || type.trim() === '') {
+            throw new Error('资源类型必须是非空字符串');
+        }
+        if (typeof handler !== 'function' || handler.constructor.name !== 'Function') {
+            throw new Error('加载器必须是一个函数，且返回Promise对象');
+        }
+        if (loaderMap.has(type)) {
+            console.warn(`类型为${type}的加载器已存在，将被覆盖`);
+        }
+        loaderMap.set(type, handler);
+    }
+
+    /**
+     * 获取对应类型的加载器
+     * @param {string} type - 资源类型
+     * @returns {Function} 加载器处理函数
+     */
+    function getLoader(type) {
+        if (!loaderMap.has(type)) {
+            throw new Error(`未找到${type}类型的加载器，请先注册自定义加载器`);
+        }
+        return loaderMap.get(type);
+    }
+     // 导出wrapLoadPromise，避免冗余
+
+    /**
+     * 检测循环依赖（深度优先遍历，配置字段改为dependencies）
+     * @param {Array} configList - 完整配置数组
+     * @param {number} currentId - 当前资源ID
+     * @param {Set} visited - 已访问的资源ID集合
+     * @param {Set} visiting - 正在访问的资源ID集合（用于检测环）
+     */
+    function detectCycle(configList, currentId, visited, visiting) {
+        const currentConfig = configList.find(item => item.name === currentId);
+        if (!currentConfig) {
+            throw new Error(`未找到ID为${currentId}的资源配置`);
+        }
+
+        // 若正在访问中，说明存在循环依赖
+        if (visiting.has(currentId)) {
+            throw new Error(`检测到循环依赖：${Array.from(visiting).join(' -> ')} -> ${currentId}`);
+        }
+
+        // 若已访问过，直接返回（无需重复检测）
+        if (visited.has(currentId)) {
+            return;
+        }
+
+        // 标记为正在访问
+        visiting.add(currentId);
+        // 递归检测依赖项（改为dependencies）
+        const dependencies = currentConfig.dependencies || [];
+        for (const depId of dependencies) {
+            detectCycle(configList, depId, visited, visiting);
+        }
+        // 标记为已访问，移出正在访问集合
+        visiting.delete(currentId);
+        visited.add(currentId);
+    }
+
+    /**
+     * 预检测所有资源的循环依赖（配置字段改为dependencies）
+     * @param {Array} configList - 完整配置数组
+     */
+    function checkAllCycles(configList) {
+        const visited = new Set();
+        for (const config of configList) {
+            detectCycle(configList, config.name, visited, new Set());
+        }
+    }
+
+    /**
+     * 递归加载单个资源及其所有依赖（保证依赖先加载，配置字段改为dependencies）
+     * @param {number} resourceId - 资源ID
+     * @param {Array} configList - 完整配置数组
+     * @param {number} timeout - 超时时间
+     * @param {Map} loadedMap - 已加载资源的结果缓存
+     */
+    async function loadResourceWithDeps(resourceId, configList, timeout, loadedMap) {
+        // 若已加载，直接返回缓存结果
+        if (loadedMap.has(resourceId)) {
+            return loadedMap.get(resourceId);
+        }
+
+        const currentConfig = configList.find(item => item.name === resourceId);
+        if (!currentConfig) {
+            throw new Error(`未找到ID为${resourceId}的资源配置`);
+        }
+
+        // 1. 先加载所有依赖（改为dependencies）
+        const dependencies = currentConfig.dependencies || [];
+        for (const depId of dependencies) {
+            await loadResourceWithDeps(depId, configList, timeout, loadedMap);
+        }
+
+        // 2. 再加载当前资源的urls（顺序加载，一个成功即可）
+        const { urls, type } = currentConfig;
+        let loadResult = null;
+        let status = 'success';
+        let error = null;
+
+        try {
+            loadResult = await loadUrlsInOrder(urls, type, timeout);
+        } catch (err) {
+            status = 'failed';
+            error = err;
+        }
+
+        // 3. 缓存加载结果
+        const result = {
+            resourceId,
+            config: currentConfig,
+            loadResult,
+            status,
+            error,
+        };
+        loadedMap.set(resourceId, result);
+        return result;
+    }
+
+    /**
+     * 按顺序加载urls，只需要一个成功即可
+     * @param {Array} urls - 资源地址数组
+     * @param {string} type - 资源类型
+     * @param {number} timeout - 超时时间
+     * @returns {Promise<Object>} 第一个成功的加载结果
+     */
+    async function loadUrlsInOrder(urls, type, timeout) {
+        if (!Array.isArray(urls) || urls.length === 0) {
+            throw new Error('urls必须是非空数组');
+        }
+
+        const loader = getLoader(type);
+        let lastError;
+
+        // 按顺序遍历urls，直到有一个加载成功
+        for (const url of urls) {
+            try {
+                return await wrapLoadPromise(url, loader, timeout);
+            } catch (error) {
+                lastError = error;
+                continue; // 加载失败，继续下一个url
+            }
+        }
+
+        // 所有url都加载失败，抛出最后一个错误
+        throw new Error(`所有${type}类型资源加载失败，最后一个错误：${lastError?.message || '未知错误'}`);
+    }
+
+    /**
+     * 核心加载调度方法（最终结果保持配置定义顺序）
+     * @param {Array} configList - 输入配置数组
+     * @returns {Promise<Array>} 按配置定义顺序的加载结果数组
+     */
+    async function preloadResources(configList) {
+        if (!Array.isArray(configList) || configList.length === 0) {
+            throw new Error('配置数组必须是非空数组');
+        }
+
+        // 1. 获取全局配置
+        const { timeout: globalTimeout } = getGlobalConfig();
+
+        // 2. 预检测所有循环依赖（防止无限递归）
+        checkAllCycles(configList);
+
+        // 3. 初始化缓存（存储已加载资源结果，避免重复加载）
+        const loadedMap = new Map();
+
+        // 4. 按配置定义的顺序，并行加载同层级无依赖资源（保证依赖先加载，结果保留原始顺序）
+        const rawOrderPromises = configList.map(async (config) => {
+            return await loadResourceWithDeps(config.name, configList, globalTimeout, loadedMap);
+        });
+
+        // 5. 等待所有资源加载完成，返回原始配置顺序的结果
+        const finalResult = await Promise.all(rawOrderPromises);
+        return finalResult;
+    }
+
+    exports.default = preloadResources;
+    exports.preloadResources = preloadResources;
+    exports.registerLoader = registerLoader;
+    exports.setGlobalConfig = setGlobalConfig;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=resource-loader.amd.js.map

package/dist/resource-loader.amd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader.amd.js","sources":["../src/config.js","../src/loader.js","../src/scheduler.js"],"sourcesContent":["// 默认公共配置\nconst defaultConfig = {\n    timeout: 1000, // 默认超时时间1s\n    retry: 0, // 默认不重试\n};\n\nlet globalConfig = { ...defaultConfig };\n\n/**\n * 配置公共配置的方法（导出）\n * @param {Object} config - 需覆盖的公共配置\n * @returns {Object} 合并后的最终全局配置\n */\nfunction setGlobalConfig(config) {\n    if (typeof config !== 'object' || config === null) {\n        throw new Error('配置参数必须是一个非空对象');\n    }\n    globalConfig = { ...globalConfig, ...config };\n    return { ...globalConfig };\n}\n\n/**\n * 获取当前全局配置\n * @returns {Object} 全局配置\n */\nfunction getGlobalConfig() {\n    return { ...globalConfig };\n}\n\nexport { setGlobalConfig, getGlobalConfig };","// 加载器映射表（存储内置+自定义加载器）\nconst loaderMap = new Map();\n\n/**\n * 通用资源加载Promise封装\n * @param {string} url - 资源地址\n * @param {Function} loadHandler - 具体的资源加载处理函数\n * @param {number} timeout - 超时时间\n * @returns {Promise<Object>} 加载结果Promise\n */\nfunction wrapLoadPromise(url, loadHandler, timeout) {\n    return new Promise((resolve, reject) => {\n        // 超时处理\n        const timeoutTimer = setTimeout(() => {\n            reject(new Error(`Resource ${url} load timeout (${timeout}ms)`));\n        }, timeout);\n\n        // 执行具体加载逻辑\n        loadHandler(url)\n            .then((result) => {\n                clearTimeout(timeoutTimer);\n                resolve({\n                    url,\n                    success: true,\n                    data: result,\n                    error: null,\n                });\n            })\n            .catch((error) => {\n                clearTimeout(timeoutTimer);\n                reject({\n                    url,\n                    success: false,\n                    data: null,\n                    error,\n                });\n            });\n    });\n}\n\n// --------------- 内置JS加载器 ---------------\nfunction jsLoaderHandler(url) {\n    return new Promise((resolve, reject) => {\n        const script = document.createElement('script');\n        script.type = 'text/javascript';\n        script.src = url;\n        script.async = false; // 保持加载顺序（不开启异步）\n\n        script.onload = () => {\n            resolve(script);\n            document.head.removeChild(script); // 可选：加载完成后移除标签，避免污染DOM\n        };\n\n        script.onerror = () => {\n            reject(new Error(`JS resource ${url} load failed`));\n            document.head.removeChild(script);\n        };\n\n        document.head.appendChild(script);\n    });\n}\n\n// --------------- 内置CSS加载器 ---------------\nfunction cssLoaderHandler(url) {\n    return new Promise((resolve, reject) => {\n        const link = document.createElement('link');\n        link.rel = 'stylesheet';\n        link.href = url;\n\n        link.onload = () => {\n            resolve(link);\n        };\n\n        link.onerror = () => {\n            reject(new Error(`CSS resource ${url} load failed`));\n        };\n\n        document.head.appendChild(link);\n    });\n}\n\n// 初始化内置加载器\nloaderMap.set('js', jsLoaderHandler);\nloaderMap.set('css', cssLoaderHandler);\n\n/**\n * 注册自定义加载器的方法（导出）\n * @param {string} type - 资源类型（唯一标识）\n * @param {Function} handler - 加载处理函数，接收url参数，返回Promise\n */\nfunction registerLoader(type, handler) {\n    if (typeof type !== 'string' || type.trim() === '') {\n        throw new Error('资源类型必须是非空字符串');\n    }\n    if (typeof handler !== 'function' || handler.constructor.name !== 'Function') {\n        throw new Error('加载器必须是一个函数，且返回Promise对象');\n    }\n    if (loaderMap.has(type)) {\n        console.warn(`类型为${type}的加载器已存在，将被覆盖`);\n    }\n    loaderMap.set(type, handler);\n}\n\n/**\n * 获取对应类型的加载器\n * @param {string} type - 资源类型\n * @returns {Function} 加载器处理函数\n */\nfunction getLoader(type) {\n    if (!loaderMap.has(type)) {\n        throw new Error(`未找到${type}类型的加载器，请先注册自定义加载器`);\n    }\n    return loaderMap.get(type);\n}\n\nexport { registerLoader, getLoader, wrapLoadPromise }; // 导出wrapLoadPromise，避免冗余","import { getGlobalConfig } from './config.js';\nimport { getLoader } from './loader.js';\nimport { wrapLoadPromise } from './loader.js';\n\n/**\n * 检测循环依赖（深度优先遍历，配置字段改为dependencies）\n * @param {Array} configList - 完整配置数组\n * @param {number} currentId - 当前资源ID\n * @param {Set} visited - 已访问的资源ID集合\n * @param {Set} visiting - 正在访问的资源ID集合（用于检测环）\n */\nfunction detectCycle(configList, currentId, visited, visiting) {\n    const currentConfig = configList.find(item => item.name === currentId);\n    if (!currentConfig) {\n        throw new Error(`未找到ID为${currentId}的资源配置`);\n    }\n\n    // 若正在访问中，说明存在循环依赖\n    if (visiting.has(currentId)) {\n        throw new Error(`检测到循环依赖：${Array.from(visiting).join(' -> ')} -> ${currentId}`);\n    }\n\n    // 若已访问过，直接返回（无需重复检测）\n    if (visited.has(currentId)) {\n        return;\n    }\n\n    // 标记为正在访问\n    visiting.add(currentId);\n    // 递归检测依赖项（改为dependencies）\n    const dependencies = currentConfig.dependencies || [];\n    for (const depId of dependencies) {\n        detectCycle(configList, depId, visited, visiting);\n    }\n    // 标记为已访问，移出正在访问集合\n    visiting.delete(currentId);\n    visited.add(currentId);\n}\n\n/**\n * 预检测所有资源的循环依赖（配置字段改为dependencies）\n * @param {Array} configList - 完整配置数组\n */\nfunction checkAllCycles(configList) {\n    const visited = new Set();\n    for (const config of configList) {\n        detectCycle(configList, config.name, visited, new Set());\n    }\n}\n\n/**\n * 递归加载单个资源及其所有依赖（保证依赖先加载，配置字段改为dependencies）\n * @param {number} resourceId - 资源ID\n * @param {Array} configList - 完整配置数组\n * @param {number} timeout - 超时时间\n * @param {Map} loadedMap - 已加载资源的结果缓存\n */\nasync function loadResourceWithDeps(resourceId, configList, timeout, loadedMap) {\n    // 若已加载，直接返回缓存结果\n    if (loadedMap.has(resourceId)) {\n        return loadedMap.get(resourceId);\n    }\n\n    const currentConfig = configList.find(item => item.name === resourceId);\n    if (!currentConfig) {\n        throw new Error(`未找到ID为${resourceId}的资源配置`);\n    }\n\n    // 1. 先加载所有依赖（改为dependencies）\n    const dependencies = currentConfig.dependencies || [];\n    for (const depId of dependencies) {\n        await loadResourceWithDeps(depId, configList, timeout, loadedMap);\n    }\n\n    // 2. 再加载当前资源的urls（顺序加载，一个成功即可）\n    const { urls, type } = currentConfig;\n    let loadResult = null;\n    let status = 'success';\n    let error = null;\n\n    try {\n        loadResult = await loadUrlsInOrder(urls, type, timeout);\n    } catch (err) {\n        status = 'failed';\n        error = err;\n    }\n\n    // 3. 缓存加载结果\n    const result = {\n        resourceId,\n        config: currentConfig,\n        loadResult,\n        status,\n        error,\n    };\n    loadedMap.set(resourceId, result);\n    return result;\n}\n\n/**\n * 按顺序加载urls，只需要一个成功即可\n * @param {Array} urls - 资源地址数组\n * @param {string} type - 资源类型\n * @param {number} timeout - 超时时间\n * @returns {Promise<Object>} 第一个成功的加载结果\n */\nasync function loadUrlsInOrder(urls, type, timeout) {\n    if (!Array.isArray(urls) || urls.length === 0) {\n        throw new Error('urls必须是非空数组');\n    }\n\n    const loader = getLoader(type);\n    let lastError;\n\n    // 按顺序遍历urls，直到有一个加载成功\n    for (const url of urls) {\n        try {\n            return await wrapLoadPromise(url, loader, timeout);\n        } catch (error) {\n            lastError = error;\n            continue; // 加载失败，继续下一个url\n        }\n    }\n\n    // 所有url都加载失败，抛出最后一个错误\n    throw new Error(`所有${type}类型资源加载失败，最后一个错误：${lastError?.message || '未知错误'}`);\n}\n\n/**\n * 核心加载调度方法（最终结果保持配置定义顺序）\n * @param {Array} configList - 输入配置数组\n * @returns {Promise<Array>} 按配置定义顺序的加载结果数组\n */\nasync function preloadResources(configList) {\n    if (!Array.isArray(configList) || configList.length === 0) {\n        throw new Error('配置数组必须是非空数组');\n    }\n\n    // 1. 获取全局配置\n    const { timeout: globalTimeout } = getGlobalConfig();\n\n    // 2. 预检测所有循环依赖（防止无限递归）\n    checkAllCycles(configList);\n\n    // 3. 初始化缓存（存储已加载资源结果，避免重复加载）\n    const loadedMap = new Map();\n\n    // 4. 按配置定义的顺序，并行加载同层级无依赖资源（保证依赖先加载，结果保留原始顺序）\n    const rawOrderPromises = configList.map(async (config) => {\n        return await loadResourceWithDeps(config.name, configList, globalTimeout, loadedMap);\n    });\n\n    // 5. 等待所有资源加载完成，返回原始配置顺序的结果\n    const finalResult = await Promise.all(rawOrderPromises);\n    return finalResult;\n}\n\nexport { preloadResources };"],"names":[],"mappings":"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"}

package/dist/resource-loader.amd.min.js

@@ -0,0 +1,309 @@
+define(['exports'], (function (exports) { 'use strict';
+
+    // 默认公共配置
+    const defaultConfig = {
+        timeout: 1000, // 默认超时时间1s
+        retry: 0, // 默认不重试
+    };
+
+    let globalConfig = { ...defaultConfig };
+
+    /**
+     * 配置公共配置的方法（导出）
+     * @param {Object} config - 需覆盖的公共配置
+     * @returns {Object} 合并后的最终全局配置
+     */
+    function setGlobalConfig(config) {
+        if (typeof config !== 'object' || config === null) {
+            throw new Error('配置参数必须是一个非空对象');
+        }
+        globalConfig = { ...globalConfig, ...config };
+        return { ...globalConfig };
+    }
+
+    /**
+     * 获取当前全局配置
+     * @returns {Object} 全局配置
+     */
+    function getGlobalConfig() {
+        return { ...globalConfig };
+    }
+
+    // 加载器映射表（存储内置+自定义加载器）
+    const loaderMap = new Map();
+
+    /**
+     * 通用资源加载Promise封装
+     * @param {string} url - 资源地址
+     * @param {Function} loadHandler - 具体的资源加载处理函数
+     * @param {number} timeout - 超时时间
+     * @returns {Promise<Object>} 加载结果Promise
+     */
+    function wrapLoadPromise(url, loadHandler, timeout) {
+        return new Promise((resolve, reject) => {
+            // 超时处理
+            const timeoutTimer = setTimeout(() => {
+                reject(new Error(`Resource ${url} load timeout (${timeout}ms)`));
+            }, timeout);
+
+            // 执行具体加载逻辑
+            loadHandler(url)
+                .then((result) => {
+                    clearTimeout(timeoutTimer);
+                    resolve({
+                        url,
+                        success: true,
+                        data: result,
+                        error: null,
+                    });
+                })
+                .catch((error) => {
+                    clearTimeout(timeoutTimer);
+                    reject({
+                        url,
+                        success: false,
+                        data: null,
+                        error,
+                    });
+                });
+        });
+    }
+
+    // --------------- 内置JS加载器 ---------------
+    function jsLoaderHandler(url) {
+        return new Promise((resolve, reject) => {
+            const script = document.createElement('script');
+            script.type = 'text/javascript';
+            script.src = url;
+            script.async = false; // 保持加载顺序（不开启异步）
+
+            script.onload = () => {
+                resolve(script);
+                document.head.removeChild(script); // 可选：加载完成后移除标签，避免污染DOM
+            };
+
+            script.onerror = () => {
+                reject(new Error(`JS resource ${url} load failed`));
+                document.head.removeChild(script);
+            };
+
+            document.head.appendChild(script);
+        });
+    }
+
+    // --------------- 内置CSS加载器 ---------------
+    function cssLoaderHandler(url) {
+        return new Promise((resolve, reject) => {
+            const link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.href = url;
+
+            link.onload = () => {
+                resolve(link);
+            };
+
+            link.onerror = () => {
+                reject(new Error(`CSS resource ${url} load failed`));
+            };
+
+            document.head.appendChild(link);
+        });
+    }
+
+    // 初始化内置加载器
+    loaderMap.set('js', jsLoaderHandler);
+    loaderMap.set('css', cssLoaderHandler);
+
+    /**
+     * 注册自定义加载器的方法（导出）
+     * @param {string} type - 资源类型（唯一标识）
+     * @param {Function} handler - 加载处理函数，接收url参数，返回Promise
+     */
+    function registerLoader(type, handler) {
+        if (typeof type !== 'string' || type.trim() === '') {
+            throw new Error('资源类型必须是非空字符串');
+        }
+        if (typeof handler !== 'function' || handler.constructor.name !== 'Function') {
+            throw new Error('加载器必须是一个函数，且返回Promise对象');
+        }
+        if (loaderMap.has(type)) {
+            console.warn(`类型为${type}的加载器已存在，将被覆盖`);
+        }
+        loaderMap.set(type, handler);
+    }
+
+    /**
+     * 获取对应类型的加载器
+     * @param {string} type - 资源类型
+     * @returns {Function} 加载器处理函数
+     */
+    function getLoader(type) {
+        if (!loaderMap.has(type)) {
+            throw new Error(`未找到${type}类型的加载器，请先注册自定义加载器`);
+        }
+        return loaderMap.get(type);
+    }
+     // 导出wrapLoadPromise，避免冗余
+
+    /**
+     * 检测循环依赖（深度优先遍历，配置字段改为dependencies）
+     * @param {Array} configList - 完整配置数组
+     * @param {number} currentId - 当前资源ID
+     * @param {Set} visited - 已访问的资源ID集合
+     * @param {Set} visiting - 正在访问的资源ID集合（用于检测环）
+     */
+    function detectCycle(configList, currentId, visited, visiting) {
+        const currentConfig = configList.find(item => item.name === currentId);
+        if (!currentConfig) {
+            throw new Error(`未找到ID为${currentId}的资源配置`);
+        }
+
+        // 若正在访问中，说明存在循环依赖
+        if (visiting.has(currentId)) {
+            throw new Error(`检测到循环依赖：${Array.from(visiting).join(' -> ')} -> ${currentId}`);
+        }
+
+        // 若已访问过，直接返回（无需重复检测）
+        if (visited.has(currentId)) {
+            return;
+        }
+
+        // 标记为正在访问
+        visiting.add(currentId);
+        // 递归检测依赖项（改为dependencies）
+        const dependencies = currentConfig.dependencies || [];
+        for (const depId of dependencies) {
+            detectCycle(configList, depId, visited, visiting);
+        }
+        // 标记为已访问，移出正在访问集合
+        visiting.delete(currentId);
+        visited.add(currentId);
+    }
+
+    /**
+     * 预检测所有资源的循环依赖（配置字段改为dependencies）
+     * @param {Array} configList - 完整配置数组
+     */
+    function checkAllCycles(configList) {
+        const visited = new Set();
+        for (const config of configList) {
+            detectCycle(configList, config.name, visited, new Set());
+        }
+    }
+
+    /**
+     * 递归加载单个资源及其所有依赖（保证依赖先加载，配置字段改为dependencies）
+     * @param {number} resourceId - 资源ID
+     * @param {Array} configList - 完整配置数组
+     * @param {number} timeout - 超时时间
+     * @param {Map} loadedMap - 已加载资源的结果缓存
+     */
+    async function loadResourceWithDeps(resourceId, configList, timeout, loadedMap) {
+        // 若已加载，直接返回缓存结果
+        if (loadedMap.has(resourceId)) {
+            return loadedMap.get(resourceId);
+        }
+
+        const currentConfig = configList.find(item => item.name === resourceId);
+        if (!currentConfig) {
+            throw new Error(`未找到ID为${resourceId}的资源配置`);
+        }
+
+        // 1. 先加载所有依赖（改为dependencies）
+        const dependencies = currentConfig.dependencies || [];
+        for (const depId of dependencies) {
+            await loadResourceWithDeps(depId, configList, timeout, loadedMap);
+        }
+
+        // 2. 再加载当前资源的urls（顺序加载，一个成功即可）
+        const { urls, type } = currentConfig;
+        let loadResult = null;
+        let status = 'success';
+        let error = null;
+
+        try {
+            loadResult = await loadUrlsInOrder(urls, type, timeout);
+        } catch (err) {
+            status = 'failed';
+            error = err;
+        }
+
+        // 3. 缓存加载结果
+        const result = {
+            resourceId,
+            config: currentConfig,
+            loadResult,
+            status,
+            error,
+        };
+        loadedMap.set(resourceId, result);
+        return result;
+    }
+
+    /**
+     * 按顺序加载urls，只需要一个成功即可
+     * @param {Array} urls - 资源地址数组
+     * @param {string} type - 资源类型
+     * @param {number} timeout - 超时时间
+     * @returns {Promise<Object>} 第一个成功的加载结果
+     */
+    async function loadUrlsInOrder(urls, type, timeout) {
+        if (!Array.isArray(urls) || urls.length === 0) {
+            throw new Error('urls必须是非空数组');
+        }
+
+        const loader = getLoader(type);
+        let lastError;
+
+        // 按顺序遍历urls，直到有一个加载成功
+        for (const url of urls) {
+            try {
+                return await wrapLoadPromise(url, loader, timeout);
+            } catch (error) {
+                lastError = error;
+                continue; // 加载失败，继续下一个url
+            }
+        }
+
+        // 所有url都加载失败，抛出最后一个错误
+        throw new Error(`所有${type}类型资源加载失败，最后一个错误：${lastError?.message || '未知错误'}`);
+    }
+
+    /**
+     * 核心加载调度方法（最终结果保持配置定义顺序）
+     * @param {Array} configList - 输入配置数组
+     * @returns {Promise<Array>} 按配置定义顺序的加载结果数组
+     */
+    async function preloadResources(configList) {
+        if (!Array.isArray(configList) || configList.length === 0) {
+            throw new Error('配置数组必须是非空数组');
+        }
+
+        // 1. 获取全局配置
+        const { timeout: globalTimeout } = getGlobalConfig();
+
+        // 2. 预检测所有循环依赖（防止无限递归）
+        checkAllCycles(configList);
+
+        // 3. 初始化缓存（存储已加载资源结果，避免重复加载）
+        const loadedMap = new Map();
+
+        // 4. 按配置定义的顺序，并行加载同层级无依赖资源（保证依赖先加载，结果保留原始顺序）
+        const rawOrderPromises = configList.map(async (config) => {
+            return await loadResourceWithDeps(config.name, configList, globalTimeout, loadedMap);
+        });
+
+        // 5. 等待所有资源加载完成，返回原始配置顺序的结果
+        const finalResult = await Promise.all(rawOrderPromises);
+        return finalResult;
+    }
+
+    exports.default = preloadResources;
+    exports.preloadResources = preloadResources;
+    exports.registerLoader = registerLoader;
+    exports.setGlobalConfig = setGlobalConfig;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=resource-loader.amd.min.js.map