rotor-framework 0.3.2

package/src/source/engine/builder/WidgetCreate.bs

@@ -0,0 +1,322 @@
+namespace Rotor.ViewBuilder
+
+    ' =====================================================================
+    ' createWidget - Creates and initializes a widget instance. Core widget factory function that handles the complete widget creation lifecycle: 1. Widget tree registration 2. Decorator method injection 3. ViewModel initialization (if applicable) 4. SceneGraph node creation 5. Plugin registration and lifecycle hooks
+    '
+    ' @param {object} postProcessBuffer - Buffer for deferred plugin/lifecycle operations
+    ' @param {object} config - Widget configuration object
+    ' @param {string} parentHID - Parent's Hierarchical ID (default: "0" for root)
+    ' @returns {object} Widget metadata { HID, children, parentHID, id }
+    ' =====================================================================
+    function createWidget(postProcessBuffer as object, config as object, parentHID = "0" as string) as object
+
+        ' Extract and remove ViewModel class from config
+        ViewModelClass = config.viewModel
+        config.delete("viewModel")
+
+        ' =============================================================
+        ' WIDGET TREE REGISTRATION
+        ' =============================================================
+
+        ' Register widget in tree and get HID
+        widget = m.frameworkInstance.builder.widgetTree.add({
+            id: config.id,
+            parentHID: parentHID
+        }, ViewModelClass)
+        HID = widget.HID
+
+        ' =============================================================
+        ' WIDGET DECORATOR METHODS
+        ' =============================================================
+        ' These methods provide widget API for tree navigation,
+        ' rendering, state management, and framework integration
+
+        ' getFrameworkInstance - Returns framework instance *'
+        widget.getFrameworkInstance = function() as object
+            return GetGlobalAA().rotor_framework_helper.frameworkInstance
+        end function
+
+        ' getInfo - Returns framework info *'
+        widget.getInfo = function() as object
+            return m.getFrameworkInstance().getInfo()
+        end function
+
+        ' refresh - Refreshes specific widget properties by key paths *'
+        widget.refresh = sub(featureKeyPaths as object)
+            iterateKeyPaths = Rotor.Utils.ensureArray(featureKeyPaths)
+            refreshObject = {}
+            for each keyPath in iterateKeyPaths
+                refreshObject.append(Rotor.Utils.getCloneByKeyPath(m, keyPath))
+            end for
+            m.render(refreshObject)
+        end sub
+
+        ' getWidget - Finds widget by search pattern from this widget's context *'
+        widget.getWidget = function(searchPattern as string) as object
+            return m.getFrameworkInstance().builder.widgetTree.get(searchPattern, m.HID)
+        end function
+
+        ' getSiblingWidget - Gets sibling widget by ID *'
+        widget.getSiblingWidget = function(id as string) as object
+            return m.parent.children[id]
+        end function
+
+        ' getViewModel - Returns owning ViewModel (self if ViewModel, or parent VM) *'
+        widget.getViewModel = function() as object
+            if m.isViewModel = true
+                return m
+            else
+                return m.getFrameworkInstance().builder.widgetTree.getByHID(m.vmHID)
+            end if
+        end function
+
+        ' getParentViewModel - Returns parent's ViewModel *'
+        widget.getParentViewModel = function() as object
+            return m.getViewModel().parent.getViewModel()
+        end function
+
+        ' getRootWidget - Returns root widget (HID "0") *'
+        widget.getRootWidget = function() as object
+            return m.getFrameworkInstance().builder.widgetTree.getByHID("0")
+        end function
+
+        ' findWidgets - Finds multiple widgets by search pattern *'
+        widget.findWidgets = function(searchPattern as string) as object
+            return m.getFrameworkInstance().builder.widgetTree.find(searchPattern, m.HID)
+        end function
+
+        ' getChildrenWidgets - Gets child widgets with optional pattern matching *'
+        widget.getChildrenWidgets = function(matchingPattern = "" as string) as object
+            return m.getFrameworkInstance().builder.widgetTree.getChildrenWidgets(m, matchingPattern)
+        end function
+
+        ' getSubtreeClone - Creates a clone of widget subtree *'
+        widget.getSubtreeClone = function(searchPattern = "" as string, keyPathList = [] as object) as object
+            if searchPattern = "" then searchPattern = m.HID
+            return m.getFrameworkInstance().builder.widgetTree.getSubtreeClone(searchPattern, keyPathList, m.parentHID)
+        end function
+
+        ' render - Renders widget updates (self, descendants, or children) *'
+        widget.render = sub(payloads as dynamic, params = {} as object)
+            for each payload in Rotor.Utils.ensureArray(payloads)
+                if payload.DoesExist("id") = false
+                    ' Self update
+                    payload.id = m.id
+                    payload.HID = m.HID
+                else if payload.id <> m.id
+                    ' Update descendants starting from this widget
+                    payload.parentHID = m.HID
+                else
+                    ' Update descendants starting from parent widget
+                    payload.parentHID = m.parentHID
+                end if
+            end for
+            if Rotor.Utils.isValid(params.callback) then params.callbackScope = m
+            m.getFrameworkInstance().builder.render(payloads, params)
+        end sub
+
+        ' erase - Removes widget(s) from tree *'
+        widget.erase = sub(payloads = invalid as dynamic, shouldSkipNodePool = false as boolean)
+            if payloads = invalid
+                ' Self destroy
+                payloads = m.HID
+                parentHID = m.parentHID
+            else
+                ' Children destroy
+                parentHID = m.HID
+            end if
+            m.getFrameworkInstance().builder.erase(payloads, shouldSkipNodePool, parentHID)
+        end sub
+
+        ' getDispatcher - Gets dispatcher facade by ID *'
+        widget.getDispatcher = function(dispatcherId as string) as object
+            return m.getFrameworkInstance().dispatcherProvider.getFacade(dispatcherId, m)
+        end function
+
+        ' animator - Gets animator factory by ID *'
+        widget.animator = function(animatorId) as object
+            return m.getFrameworkInstance().animatorProvider.getFactory(animatorId, m)
+        end function
+
+        ' =============================================================
+        ' VIEWMODEL INITIALIZATION
+        ' =============================================================
+
+        if widget.isViewModel = true
+
+            ' Merge props from config
+            if Rotor.Utils.isAssociativeArray(config.props)
+                Rotor.Utils.deepExtendAA(widget.props, config.props)
+            end if
+
+            ' Merge viewModelState from config
+            if Rotor.Utils.isAssociativeArray(config.viewModelState)
+                Rotor.Utils.deepExtendAA(widget.viewModelState, config.viewModelState)
+            end if
+
+            ' Setup i18n (l10n)
+            i18nService = widget.getFrameworkInstance().i18nService
+            keysPaths = Rotor.Utils.isString(config.i18n?.path) ? config.i18n.path : Rotor.Utils.isArray(config.i18n?.paths) ? config.i18n.paths : invalid
+            widget.viewModelState.l10n = i18nService.getL10n(keysPaths)
+
+            ' Include isRTL flag if requested
+            if config?.i18n?.includeIsRtl = true
+                widget.viewModelState.isRTL = i18nService.getIsRtl()
+            end if
+
+            ' Include locale string if requested
+            if config?.i18n?.includeLocale = true
+                widget.viewModelState.locale = i18nService.getLocale()
+            end if
+
+            ' Call lifecycle hook before template compilation
+            widget.onCreateView()
+
+            ' Generate template
+            template = widget.template()
+
+            ' Optional template post-processing hook
+            if Rotor.Utils.isFunction(widget.onTemplateCreated)
+                widget.onTemplateCreated(template)
+            end if
+
+            ' Merge template into config
+            if template <> invalid and template.Count() > 0
+                templateChildren = template.children
+                template.delete("children")
+                config = Rotor.Utils.deepExtendAA(config, template)
+                config.children = templateChildren
+            end if
+
+        end if
+
+        ' =============================================================
+        ' LIFECYCLE HOOK REGISTRATION
+        ' =============================================================
+
+        ' Register custom lifecycle hooks from config
+        if Rotor.Utils.isFunction(config.onMountWidget)
+            widget.onMountWidget = config.onMountWidget
+        end if
+
+        if Rotor.Utils.isFunction(config.onUpdateWidget)
+            widget.onUpdateWidget = config.onUpdateWidget
+        end if
+
+        if Rotor.Utils.isFunction(config.onDestroyWidget)
+            widget.onDestroyWidget = config.onDestroyWidget
+        end if
+
+        ' Queue onRenderSettled callback
+        if Rotor.Utils.isFunction(config.onRenderSettled) = true
+            m.frameworkInstance.builder.callbackQueue.push({
+                callback: config.onRenderSettled,
+                callbackScope: widget
+            })
+            config.delete("onRenderSettled")
+        end if
+
+        ' =============================================================
+        ' SCENEGRAPH NODE CREATION
+        ' =============================================================
+
+        ' Get children for processing
+        if config.children = invalid then config.children = {}
+        children = config.children
+
+        ' Create SceneGraph node from node pool
+        nodeType = Rotor.Utils.isString(config.nodeType) ? config.nodeType : "Group"
+        widget.node = m.frameworkInstance.builder.nodePool.acquireNode(nodeType)
+        widget.nodeType = nodeType
+        widget.markedToAppend = true
+
+        ' Debug: Set node ID for scene graph inspector
+        #if debug
+            Rotor.Utils.setCustomFields(widget.node, {
+                id: `${widget.id}-${widget.HID}`
+            }, true, false)
+        #end if
+
+        ' =============================================================
+        ' PLUGIN INTEGRATION
+        ' =============================================================
+
+        ' Process plugins and inject addon methods
+        widgetAddon = {}
+        pluginKeyList = m.frameworkInstance.builder.pluginAdapter.pluginKeyList
+        pluginKeyList.ResetIndex()
+        pluginKey = pluginKeyList.GetIndex()
+
+        while pluginKey <> invalid
+
+            if config.doesExist(pluginKey)
+
+                ' Register plugin lifecycle hooks (beforeMount, afterMounted)
+                for each LifeCycleHookType in [Rotor.Const.LifeCycleHookType.BEFORE_MOUNT, Rotor.Const.LifeCycleHookType.AFTER_MOUNTED]
+                    if m.frameworkInstance.builder.pluginAdapter.pluginHooks[LifeCycleHookType].DoesExist(pluginKey)
+                        widget[pluginKey] = config[pluginKey]
+                        postProcessBuffer.add({
+                            isPlugin: true,
+                            widget: widget,
+                            hookType: LifeCycleHookType,
+                            pluginKey: pluginKey
+                        })
+                    end if
+                end for
+
+                ' Inject plugin widget methods
+                plugin = m.frameworkInstance.plugins[pluginKey]
+                if Rotor.Utils.isValid(plugin["widgetMethods"])
+                    if widgetAddon.plugins = invalid then widgetAddon.plugins = {}
+                    if widgetAddon.plugins[pluginKey] = invalid then widgetAddon.plugins[pluginKey] = {
+                        pluginKey: pluginKey,
+                        id: widget.id,
+                        HID: widget.HID,
+                        parentHID: widget.parentHID
+                    }
+                    widgetAddon.plugins[pluginKey].append(plugin["widgetMethods"])
+                end if
+
+            end if
+
+            pluginKey = pluginKeyList.GetIndex()
+        end while
+
+        ' Append all plugin addon methods to widget
+        if widgetAddon.Count() > 0
+            widget.append(widgetAddon)
+        end if
+
+        ' =============================================================
+        ' POST-PROCESS QUEUE
+        ' =============================================================
+
+        ' Queue child append operation
+        appendChildProcess = {
+            hookType: Rotor.Const.LifeCycleHookType.APPEND_CHILD,
+            widget: widget
+        }
+        if config.zIndex <> invalid
+            appendChildProcess.zIndex = config.zIndex
+        end if
+        postProcessBuffer.add(appendChildProcess)
+
+        ' Queue mounted lifecycle hook
+        if Rotor.Utils.isFunction(widget.onMountWidget) or widget?.isViewModel = true
+            postProcessBuffer.add({
+                hookType: Rotor.Const.LifeCycleHookType.MOUNTED,
+                widget: widget
+            })
+        end if
+
+        ' Return widget metadata for tree processing
+        return {
+            HID: HID,
+            children: children,
+            parentHID: parentHID,
+            id: widget.id
+        }
+
+    end function
+
+end namespace

package/src/source/engine/builder/WidgetRemove.bs

@@ -0,0 +1,72 @@
+namespace Rotor.ViewBuilder
+
+    ' =====================================================================
+    ' removeWidget - Removes a widget and its children from the widget tree. Handles plugin beforeDestroy hooks, widget destruction, and SceneGraph node removal. Recursively marks children for removal.
+    '
+    ' @param {object} postProcessBuffer - Buffer for deferred plugin/lifecycle operations
+    ' @param {object} widget - Widget instance to remove
+    ' @param {object} config - Removal configuration with markedToRemove and shouldSkipNodePool flags
+    ' @returns {object} Object with children array and HID for recursive processing
+    ' =====================================================================
+    function removeWidget(postProcessBuffer as object, widget as object, config as object) as object
+        HID = widget.HID
+
+        widget.markedToRemove = config.markedToRemove
+
+        ' plugin :: beforeDestroy
+        pluginKeyList = m.frameworkInstance.builder.pluginAdapter.pluginKeyList
+        pluginKeyList.ResetIndex()
+        pluginKey = pluginKeyList.GetIndex()
+        while pluginKey <> invalid
+
+            if widget.doesExist(pluginKey)
+                LifeCycleHookType = Rotor.Const.LifeCycleHookType.BEFORE_DESTROY
+                if m.frameworkInstance.builder.pluginAdapter.pluginHooks[LifeCycleHookType].DoesExist(pluginKey)
+                    postProcessBuffer.add({
+                        isPlugin: true,
+                        ' isView: widget?.isView ?? false,
+                        widget: widget,
+                        hookType: LifeCycleHookType,
+                        pluginKey: pluginKey
+                    })
+                end if
+            end if
+
+            pluginKey = pluginKeyList.GetIndex()
+        end while
+
+        postProcessBuffer.add({
+            hookType: Rotor.Const.LifeCycleHookType.DELETE_WIDGET,
+            widget: widget
+        })
+
+        isBranchOfRemove = m.frameworkInstance.builder.widgetTree.isBranchOfRemove(widget)
+        if isBranchOfRemove
+            postProcessBuffer.add({
+                hookType: Rotor.Const.LifeCycleHookType.REMOVE_CHILD,
+                shouldSkipNodePool: config.shouldSkipNodePool,
+                widget: widget
+
+            })
+        end if
+
+        childrenToRemove = []
+        for each id in widget.children
+            if not widget.children[id].doesExist("markedToRemove")
+                childrenToRemove.push({
+                    markedToRemove: true,
+                    id: id,
+                    HID: widget.children[id].HID,
+                    parentHID: widget.children[id].parentHID
+                })
+            end if
+        end for
+
+        return {
+            children: childrenToRemove,
+            HID: HID
+        }
+
+    end function
+
+end namespace

package/src/source/engine/builder/WidgetUpdate.bs

@@ -0,0 +1,113 @@
+namespace Rotor.ViewBuilder
+
+    ' =====================================================================
+    ' updateWidget - Updates an existing widget with new configuration. Handles props updates, viewModelState changes, plugin lifecycle hooks, z-index changes, and custom lifecycle callbacks.
+    '
+    ' @param {object} postProcessBuffer - Buffer for deferred plugin/lifecycle operations
+    ' @param {object} widget - Existing widget instance to update
+    ' @param {object} newConfig - New configuration to apply
+    ' @returns {object} Object with children and HID for further processing
+    ' =====================================================================
+    function updateWidget(postProcessBuffer as object, widget as object, newConfig as object) as object
+        HID = widget.HID
+
+        isWidgetChanged = false
+
+        if widget?.isViewModel = true and newConfig.DoesExist("props")
+            newConfig.delete("viewModel") ' In case app update with the same template.
+            postProcessBuffer.add({
+                hookType: Rotor.Const.LifeCycleHookType.VIEWMODEL_STATE_UPDATE,
+                widget: widget,
+                props: newConfig.props
+            })
+        end if
+
+        if newConfig.DoesExist("viewModelState")
+            Rotor.Utils.deepExtendAA(widget.viewModelState, newConfig.viewModelState)
+            isWidgetChanged = true
+        end if
+
+        ' Method decorators during update
+
+        pluginKeyList = m.frameworkInstance.builder.pluginAdapter.pluginKeyList
+        pluginKeyList.ResetIndex()
+        pluginKey = pluginKeyList.GetIndex()
+        while pluginKey <> invalid
+
+            if newConfig.doesExist(pluginKey)
+                for each LifeCycleHookType in [Rotor.Const.LifeCycleHookType.BEFORE_UPDATE, Rotor.Const.LifeCycleHookType.AFTER_UPDATED]
+                    if m.frameworkInstance.builder.pluginAdapter.pluginHooks[LifeCycleHookType].DoesExist(pluginKey)
+
+                        isWidgetChanged = true
+
+                        process = {
+                            isPlugin: true,
+                            widget: widget,
+                            hookType: LifeCycleHookType,
+                            ' isView: widget?.isView ?? false,
+                            pluginKey: pluginKey
+                        }
+
+                        if LifeCycleHookType = Rotor.Const.LifeCycleHookType.BEFORE_UPDATE or LifeCycleHookType = Rotor.Const.LifeCycleHookType.AFTER_UPDATED
+                            newValue = newConfig[pluginKey]
+                            oldValue = widget[pluginKey]
+                            ' Change is depend on plugin ;)
+                            process.append({
+                                oldValue: oldValue,
+                                newValue: newValue
+                            })
+                        end if
+
+                        postProcessBuffer.add(process)
+
+                    end if
+                end for
+            end if
+
+            pluginKey = pluginKeyList.GetIndex()
+        end while
+
+
+        if Rotor.Utils.isInteger(newConfig.zIndex)
+            postProcessBuffer.add({
+                hookType: Rotor.Const.LifeCycleHookType.REINDEX_CHILD,
+                widget: widget,
+                zIndex: newConfig.zIndex
+            })
+        end if
+
+
+        if Rotor.Utils.isFunction(newConfig.onUpdateWidget)
+            isWidgetChanged = true
+            widget.onUpdateWidget = newConfig.onUpdateWidget
+        end if
+
+        if Rotor.Utils.isFunction(newConfig.onDestroyWidget)
+            widget.onDestroyWidget = newConfig.onDestroyWidget
+        end if
+
+        if Rotor.Utils.isFunction(newConfig.onRenderSettled) = true
+            m.frameworkInstance.builder.callbackQueue.push({
+                callback: newConfig.onRenderSettled,
+                callbackScope: widget
+            })
+            newConfig.delete("onRenderSettled")
+        end if
+
+
+        if isWidgetChanged = true and Rotor.Utils.isFunction(widget.onUpdateWidget)
+            postProcessBuffer.add({
+                hookType: Rotor.Const.LifeCycleHookType.UPDATED,
+                widget: widget
+            })
+        end if
+
+        return {
+            children: newConfig.children,
+            HID: HID
+        }
+
+    end function
+
+
+end namespace

package/src/source/engine/providers/Dispatcher.bs

@@ -0,0 +1,72 @@
+
+namespace Rotor
+
+    ' =====================================================================
+    ' Dispatcher - Dispatcher Facade that provides a simplified interface for state management
+    '
+    ' Acts as a proxy to the underlying dispatcher instance, managing intents,
+    ' listeners, and state access. The facade pattern allows for clean separation
+    ' between the dispatcher implementation and its consumers, enabling multiple
+    ' listeners to subscribe to the same dispatcher with different scopes.
+    ' =====================================================================
+    class Dispatcher
+
+        dispatcherId as string
+        listenerId as string
+        listenerScope as object
+        dispatcherInstance as object
+
+        sub new(dispatcherInstance as dynamic, dispatcherId as string, listenerId = "" as string, listenerScope = invalid as object)
+            m.dispatcherId = dispatcherId
+            m.listenerScope = listenerScope
+            m.listenerId = listenerId
+            m.dispatcherInstance = dispatcherInstance
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' dispatch - Dispatches an intent to trigger state changes through the reducer
+        '
+        ' @param {Intent} intent - The intent object containing action type and payload
+        '
+        sub dispatch(intent)
+            m.dispatcherInstance.dispatch(intent)
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' addListener - Adds a listener to subscribe to state changes from this dispatcher
+        '
+        ' @param {Dynamic} listenerConfig - Configuration object for the listener (can be a function or object with mapStateToProps)
+        '
+        sub addListener(listenerConfig as dynamic)
+            m.dispatcherInstance.addListener(listenerConfig, m.listenerId, m.listenerScope)
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' removeAllListenersByListenerId - Removes all listeners associated with this dispatcher's listener ID
+        '
+        sub removeAllListenersByListenerId()
+            m.dispatcherInstance.removeAllListenersByListenerId(m.listenerId)
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' getState - Retrieves the current state from the dispatcher, optionally mapped through a selector function
+        '
+        ' @param {Dynamic} mapStateToProps - Optional function to map/select specific parts of the state
+        ' @returns {Object} The current state object (mapped if selector provided)
+        '
+        function getState(mapStateToProps = invalid as Dynamic) as object
+            return m.dispatcherInstance.getState(mapStateToProps, m.listenerScope)
+        end function
+
+        ' ---------------------------------------------------------------------
+        ' destroy - Cleans up the dispatcher facade by removing all listeners and clearing references
+        '
+        sub destroy()
+            m.removeAllListenersByListenerId()
+            m.listenerScope = invalid
+            m.dispatcherInstance = invalid
+        end sub
+
+    end class
+
+end namespace

package/src/source/engine/providers/DispatcherProvider.bs

@@ -0,0 +1,95 @@
+
+namespace Rotor
+
+    ' =====================================================================
+    ' DispatcherProvider - Manages a collection of dispatcher instances and provides facade access
+    '
+    ' Manages a collection of dispatcher instances and provides facade access
+    ' to dispatchers. Extends BaseStack to store and organize dispatchers by ID.
+    ' Handles both internal and external dispatcher registration/deregistration.
+    ' =====================================================================
+    class DispatcherProvider extends Rotor.BaseStack
+
+        threadType as string
+
+        ' ---------------------------------------------------------------------
+        ' new - Initializes the dispatcher provider with thread type
+        '
+        ' @param {string} threadType - Type of thread this provider operates on (render/task)
+        '
+        sub new(threadType as string)
+            super()
+            m.threadType = threadType
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' getFacade - Returns a dispatcher facade for the requested dispatcher ID
+        '
+        ' @param {string} dispatcherId - The unique identifier for the dispatcher
+        ' @param {object} listenerScope - Optional scope for the listener (default: invalid)
+        ' @returns {object} Dispatcher facade instance
+        ' @throws {object} Error if dispatcher ID is not registered (debug mode only)
+        '
+        function getFacade(dispatcherId as string, listenerScope = invalid as object) as object
+            listenerId = Rotor.Utils.getUUIDHex(32)
+
+            dispatcherTaskNode = m.stack.LookupCI(dispatcherId)
+
+            #if debug
+                if dispatcherTaskNode = invalid
+                    throw { message: `[DISPATCHER_PROVIDER][ERROR] Dispatcher id:${dispatcherId} is not registered.` }
+                end if
+            #end if
+
+            dispatcherFacadeInstance = new Rotor.Dispatcher(dispatcherTaskNode, dispatcherId, listenerId, listenerScope)
+
+            return dispatcherFacadeInstance
+        end function
+
+        ' ---------------------------------------------------------------------
+        ' registerDispatcher - Registers a dispatcher instance with the provider
+        '
+        ' @param {object} dispatcherInstance - The dispatcher instance to register
+        ' @param {string} id - The unique identifier for the dispatcher
+        '
+        override sub registerDispatcher(dispatcherInstance, id as string)
+
+            m.set(id, dispatcherInstance)
+
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' registerExternalDispatchers - Registers external dispatchers from another thread
+        '
+        ' @param {dynamic} dispatcherIds - Single ID string or array of dispatcher IDs
+        ' @param {object} taskNode - The task node for cross-thread communication
+        '
+        sub registerExternalDispatchers(dispatcherIds as dynamic, taskNode as object)
+            dispatcherIds = Rotor.Utils.ensureArray(dispatcherIds)
+            for each dispatcherId in dispatcherIds
+                dispatcherInstance = new Rotor.DispatcherExternal(dispatcherId, taskNode, m.threadType)
+                m.set(dispatcherId, dispatcherInstance)
+            end for
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' deregisterDispatcher - Removes a dispatcher from the provider
+        '
+        ' @param {dynamic} dispatcherId - The ID of the dispatcher to remove
+        '
+        sub deregisterDispatcher(dispatcherId as dynamic)
+            m.remove(dispatcherId)
+        end sub
+
+        ' ---------------------------------------------------------------------
+        ' destroy - Destroys all registered dispatchers and cleans up resources
+        '
+        sub destroy()
+            dispatchers = m.getAll()
+            for each dispatcherId in dispatchers
+                dispatchers[dispatcherId].destroy() ' Note that destroy will deregister dispatcher automatically
+            end for
+        end sub
+
+    end class
+end namespace