class DemoURLNavigationEventDelegate: NSObject,GRVURLNavigationEventDelegate {
    
    func urlListOpenByContainer() -> [String] {
        // return the URL list that needs to open by SDK container
    }
    
    func urlListOpenByApplication() -> [String] {
        // return the URL list that needs to open by UIApplication
    }
    
    func willStartURLNavigation(_ context: GRVNavigationContext) -> Bool {
        // URL navigation intercept
    }
    
    func allowLoadURLWithoutPermissionCheck(_ url: URL?) -> Bool {
        // URL: wheher skip the permission check
    }
}

let extensionDelegate = GRVExtensionDelegate()
extensionDelegate.urlNavigationEventDelegate = DemoURLNavigationEventDelegate()

@protocol GRVURLNavigationEventDelegate <NSObject>

@optional
// URL list should be opened by Griver Container
- (NSArray<NSString *> * _Nonnull)URLListOpenByContainer;

// URL list should be opened by Application
- (NSArray<NSString *> * _Nonnull)URLListOpenByApplication;

/**
 Will start URL Navigation.

@param context GRVNavigationContext
@return YES - handle URL Navigation in this method ;  NO - Container will handle URL navigation event by default
*/
- (BOOL)willStartURLNavigation:(GRVNavigationContext * _Nonnull)context;


/// This method is called just before the permission check for url loading.
/// You may return YES to allow the url loading without permission check.
/// @param url the url being loaded
/// @return YES - allow the url loading without permission check;  NO - do permission check
- (BOOL)allowLoadURLWithoutPermissionCheck:(NSURL * _Nullable)url;

@end

/**
 * @brief Context object for managing navigation state in a web view.
 *
 * This class holds references to the current view controller, web view instance, and URL during navigation operations.
 */
@interface GRVNavigationContext : NSObject

/// The current view controller associated with the navigation context (can be nil).
@property(nonatomic, strong, nullable) UIViewController *currentViewController;

/// The WKWebView instance used for web content rendering (can be nil).
@property(nonatomic, strong, nullable) WKWebView *webView;

/// The URL currently being loaded or operated on (can be nil).
@property(nonatomic, strong, nullable) NSURL *URL;

@end