Add plugin dependency support for chart plugins

Introduces a pluginDependencies property to AAChartView and updates plugin loading logic to accept and merge external plugin dependencies. This allows users to specify custom plugin dependencies, improving flexibility and correctness when loading chart plugins. Demo updated to show usage with AACustom-Stage.js depending on AAXrange.js.

Author: AAChartModel

AAInfographics-Pro/AAChartCreator/AAChartView.swift

@@ -178,6 +178,7 @@ public class AAChartView: WKWebView {
     private var pluginLoader: AAChartViewPluginLoader = ProPluginLoader(provider: ProPluginProvider())
 
     public var userPluginPaths: Set<String> = []
+    public var pluginDependencies: [String: String] = [:]
 #if DEBUG
     public var shouldPrintOptionsJSON: Bool = true
 #endif
@@ -437,7 +438,11 @@ extension AAChartView: WKUIDelegate {
 extension AAChartView:  WKNavigationDelegate {
     internal func loadAllPluginsAndDrawChart() {
         // Load plugins via loader, then draw chart in completion
-        pluginLoader.loadPluginsIfNeeded(webView: self, userPlugins: userPluginPaths) { [weak self] in
+        pluginLoader.loadPluginsIfNeeded(
+            webView: self,
+            userPlugins: userPluginPaths,
+            dependencies: pluginDependencies
+        ) { [weak self] in
             // Ensure options are ready before drawing
             guard let self = self, self.optionsJson != nil else {
                 self?.debugLog("💀💀💀 AAChartView options not ready after plugin load or view deallocated.")

AAInfographics-Pro/AAChartCreator/AAChartViewPluginProvider.swift

@@ -169,7 +169,12 @@ public protocol AAChartViewPluginLoader {
     func configure(options: AAOptions)
 
     /// Loads necessary plugins if they haven't been loaded yet.
-    func loadPluginsIfNeeded(webView: WKWebView, userPlugins: Set<String>, completion: @escaping () -> Void)
+    func loadPluginsIfNeeded(
+        webView: WKWebView,
+        userPlugins: Set<String>,
+        dependencies: [String: String],
+        completion: @escaping () -> Void
+    )
 
     /// Executes the pre-draw JavaScript script.
     func executeBeforeDrawScript(webView: WKWebView)
@@ -187,7 +192,12 @@ public class DefaultPluginLoader: AAChartViewPluginLoader {
         // No configuration needed for default
     }
 
-    public func loadPluginsIfNeeded(webView: WKWebView, userPlugins: Set<String>, completion: @escaping () -> Void) {
+    public func loadPluginsIfNeeded(
+        webView: WKWebView,
+        userPlugins: Set<String>,
+        dependencies: [String: String],
+        completion: @escaping () -> Void
+    ) {
         #if DEBUG
         print("ℹ️ DefaultPluginLoader: No plugins to load.")
         #endif
@@ -239,7 +249,12 @@ public class ProPluginLoader: AAChartViewPluginLoader {
         }
     }
 
-    public func loadPluginsIfNeeded(webView: WKWebView, userPlugins: Set<String>, completion: @escaping () -> Void) {
+    public func loadPluginsIfNeeded(
+        webView: WKWebView,
+        userPlugins: Set<String>,
+        dependencies: [String: String],
+        completion: @escaping () -> Void
+    ) {
         let totalRequiredPluginsSet = requiredPluginPaths.union(userPlugins)
         let pluginsToLoad = totalRequiredPluginsSet.subtracting(loadedPluginPaths)
 
@@ -256,19 +271,23 @@ public class ProPluginLoader: AAChartViewPluginLoader {
         }
 
         debugLog("ℹ️ [ProPluginLoader] Preparing to load \(pluginsToLoad.count) new plugin scripts...")
-        loadAndEvaluateCombinedPluginScript(webView: webView, scriptsToLoad: pluginsToLoad) { [weak self] successfullyLoadedPlugins in
-             guard let self = self else { return }
-             self.loadedPluginPaths.formUnion(successfullyLoadedPlugins)
+        loadAndEvaluateCombinedPluginScript(
+            webView: webView,
+            scriptsToLoad: pluginsToLoad,
+            dependencies: dependencies
+        ) { [weak self] successfullyLoadedPlugins in
+            guard let self = self else { return }
+            self.loadedPluginPaths.formUnion(successfullyLoadedPlugins)
 
-             #if DEBUG
-             if successfullyLoadedPlugins.count < pluginsToLoad.count {
-                  print("⚠️ [ProPluginLoader] One or more plugin script files could not be read, or the combined script evaluation failed.")
-             } else if !successfullyLoadedPlugins.isEmpty {
-                  print("✅ [ProPluginLoader] \(successfullyLoadedPlugins.count) new plugin scripts loaded and evaluated successfully.")
-             }
-             print("ℹ️ [ProPluginLoader] Total loaded plugins count: \(self.loadedPluginPaths.count)")
-             #endif
-             completion()
+            #if DEBUG
+            if successfullyLoadedPlugins.count < pluginsToLoad.count {
+                print("⚠️ [ProPluginLoader] One or more plugin script files could not be read, or the combined script evaluation failed.")
+            } else if !successfullyLoadedPlugins.isEmpty {
+                print("✅ [ProPluginLoader] \(successfullyLoadedPlugins.count) new plugin scripts loaded and evaluated successfully.")
+            }
+            print("ℹ️ [ProPluginLoader] Total loaded plugins count: \(self.loadedPluginPaths.count)")
+            #endif
+            completion()
         }
     }
 
@@ -291,15 +310,23 @@ public class ProPluginLoader: AAChartViewPluginLoader {
     // --- Helper methods moved from AAChartView ---
 
     // Helper function to sort plugin paths based on known dependencies
-    private func sortPluginPaths(_ paths: Set<String>) -> [String] {
+    private func sortPluginPaths(
+        _ paths: Set<String>,
+        merging externalDependencies: [String: String]
+    ) -> [String] {
         var sortedPaths = Array(paths)
-        let dependencies: [String: String] = [
+        
+        // Base dependencies that are internal to the library
+        var dependencies: [String: String] = [
             "AADependency-Wheel.js": "AASankey.js",
             "AAOrganization.js": "AASankey.js",
             "AALollipop.js": "AADumbbell.js",
             "AATilemap.js": "AAHeatmap.js",
-            "AAArc-Diagram.js": "AASankey.js" // Added Arc Diagram dependency
+            "AAArc-Diagram.js": "AASankey.js"
         ]
+        
+        // Merge external dependencies, allowing them to override base dependencies if needed
+        dependencies.merge(externalDependencies) { (_, new) in new }
 
         sortedPaths.sort { path1, path2 in
             let file1 = (path1 as NSString).lastPathComponent
@@ -332,14 +359,15 @@ public class ProPluginLoader: AAChartViewPluginLoader {
     private func loadAndEvaluateCombinedPluginScript(
         webView: WKWebView,
         scriptsToLoad: Set<String>,
+        dependencies: [String: String],
         completion: @escaping (Set<String>) -> Void
     ) {
         guard !scriptsToLoad.isEmpty else {
             completion(Set())
             return
         }
 
-        let sortedScriptPaths = sortPluginPaths(scriptsToLoad)
+        let sortedScriptPaths = sortPluginPaths(scriptsToLoad, merging: dependencies)
         var combinedJSString = ""
         var successfullyReadPaths = Set<String>()
 

AAInfographics-ProDemo/Demo/AAPlugins/AAStageSeries/AACustomStageChartVC.swift

@@ -70,6 +70,12 @@ class AACustomStageChartVC: UIViewController {
             jsPathCustom_Stage,
         ]
 
+        // 配置它们的依赖关系
+        self.aaChartView?.pluginDependencies = [
+            "AACustom-Stage.js": "AAXrange.js"
+        ]
+
+        
         //输出查看 AAOption 的 computedProperties 内容
         //        AAOptions *aaOptions = [self chartConfigurationWithSelectedIndex:self.selectedIndex];
         self.aaOptions = AACustomStageChartComposer.defaultOptions()