rotor-framework 0.4.2 → 0.4.4

package/README.md

@@ -96,7 +96,7 @@ You can find [🌱](./docs/ai/readme.opt.yaml) symbols in all documentation page
 
 ## 📚 Learn More
 
-![Version](https://img.shields.io/badge/version-v0.4.2-blue?label=Documents%20TAG)
+![Version](https://img.shields.io/badge/version-v0.4.4-blue?label=Documents%20TAG)
 
 ### Framework Core
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rotor-framework",
-	"version": "0.4.2",
+	"version": "0.4.4",
 	"description": "Roku toolkit library providing a ViewBuilder, full UI lifecycle with focus handling and many core features, plus MVI-based state management.",
 	"author": "Balázs Molnár",
 	"license": "MIT",

package/src/source/RotorFramework.bs

@@ -4,7 +4,7 @@
 ' ▐▛▀▚▖▐▌ ▐▌ █ ▐▌ ▐▌▐▛▀▚▖    ▐▛▀▀▘▐▛▀▚▖▐▛▀▜▌▐▌  ▐▌▐▛▀▀▘▐▌ ▐▌▐▌ ▐▌▐▛▀▚▖▐▛▚▖
 ' ▐▌ ▐▌▝▚▄▞▘ █ ▝▚▄▞▘▐▌ ▐▌    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  ▐▌▐▙▄▄▖▐▙█▟▌▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌
 ' Rotor Framework™
-' Version 0.4.2
+' Version 0.4.4
 ' © 2025 Balázs Molnár — MIT License
 ' =========================================================================
 
@@ -85,7 +85,7 @@ namespace Rotor
     class Framework
 
         name = "Rotor Framework"
-        version = "0.4.2"
+        version = "0.4.4"
 
         config = {
             tasks: invalid, ' @array    (optional)

package/src/source/RotorFrameworkTask.bs

@@ -4,7 +4,7 @@
 ' ▐▛▀▚▖▐▌ ▐▌ █ ▐▌ ▐▌▐▛▀▚▖    ▐▛▀▀▘▐▛▀▚▖▐▛▀▜▌▐▌  ▐▌▐▛▀▀▘▐▌ ▐▌▐▌ ▐▌▐▛▀▚▖▐▛▚▖
 ' ▐▌ ▐▌▝▚▄▞▘ █ ▝▚▄▞▘▐▌ ▐▌    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  ▐▌▐▙▄▄▖▐▙█▟▌▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌
 ' Rotor Framework™
-' Version 0.4.2
+' Version 0.4.4
 ' © 2025 Balázs Molnár — MIT License
 ' =========================================================================
 
@@ -70,7 +70,7 @@ namespace Rotor
     class FrameworkTask
 
         name = "Rotor Framework"
-        version = "0.4.2"
+        version = "0.4.4"
 
         config = {
             tasks: invalid, ' optional
@@ -86,6 +86,7 @@ namespace Rotor
         taskNode as object
         dispatcherProvider as object
         port as object
+        asyncTransferRegistry = {} ' transferId -> { dispatcherId, context }
 
         ' ---------------------------------------------------------------------
         ' new - Initializes the FrameworkTask instance
@@ -128,6 +129,24 @@ namespace Rotor
             return m.dispatcherProvider.getFacade(dispatcherId, GetGlobalAA())
         end function
 
+        ' ---------------------------------------------------------------------
+        ' registerAsyncTransfer - Registers an async transfer with dispatcher context
+        '
+        ' This method associates a roUrlTransfer identity with a dispatcher ID and
+        ' optional context data. When the transfer completes and sends a roUrlEvent,
+        ' the framework will route it to the correct dispatcher's asyncReducerCallback.
+        '
+        ' @param {string} transferId - The transfer.GetIdentity().ToStr() value
+        ' @param {string} dispatcherId - Dispatcher ID that initiated the transfer
+        ' @param {object} context - Optional user data to pass back in callback
+        '
+        public sub registerAsyncTransfer(transferId as string, dispatcherId as string, context = invalid as dynamic)
+            m.asyncTransferRegistry[transferId] = {
+                dispatcherId: dispatcherId,
+                context: context
+            }
+        end sub
+
         ' ---------------------------------------------------------------------
         ' sync - Starts the message loop for cross-thread communication
         '
@@ -194,6 +213,27 @@ namespace Rotor
                             end if
 
                         end if
+                    else if msgType = "roUrlEvent"
+                        ' Handle async transfer responses
+                        transferId = msg.GetSourceIdentity().ToStr()
+
+                        if m.asyncTransferRegistry.DoesExist(transferId)
+                            transferData = m.asyncTransferRegistry[transferId]
+                            dispatcherId = transferData.dispatcherId
+
+                            dispatcherInstance = m.dispatcherProvider.get(dispatcherId)
+                            if dispatcherInstance <> invalid
+                                ' Route to dispatcher with wrapped message
+                                dispatcherInstance.asyncReducerCallback({
+                                    type: "roUrlEvent",
+                                    event: msg,
+                                    context: transferData.context
+                                })
+                            end if
+
+                            ' Cleanup registry entry
+                            m.asyncTransferRegistry.delete(transferId)
+                        end if
                     end if
                 end if
             end while
@@ -259,6 +299,7 @@ namespace Rotor
         ' Destroys dispatcher provider and clears global framework helper.
         '
         public sub destroy()
+            m.asyncTransferRegistry.clear()
             m.dispatcherProvider.destroy()
 
             globalScope = GetGlobalAA()

package/src/source/base/BaseReducer.bs

@@ -23,12 +23,12 @@ namespace Rotor
         ' MEMBER VARIABLES
         ' =============================================================
 
-        model as object                 ' Reference to Model holding state
         middlewares = [] as function[]  ' Middleware function array
         port as object                  ' Framework port for async operations
 
         ' Dispatcher integration
         getDispatcher as function       ' Get dispatcher facade by ID
+        getState as function            ' Get dispatcher's model state
         dispatch as function            ' Dispatch intent to owner dispatcher
         ownerDispatcher as object       ' Owning dispatcher instance
         ownerDispatcherId as string     ' Owning dispatcher ID
@@ -52,10 +52,15 @@ namespace Rotor
                 return GetGlobalAA().rotor_framework_helper.frameworkInstance.dispatcherProvider.getFacade(dispatcherId, m)
             end function
 
-            ' Inject dispatch method for self-dispatching
+            ' Inject dispatch method for dispatching intents
             m.dispatch = sub(intent as object)
                 m.ownerDispatcher.dispatch(intent)
             end sub
+
+            ' Inject getState method for accessing current state
+            m.getState = function() as Rotor.Model
+                return m.ownerDispatcher.getState()
+            end function
         end sub
 
         ' =============================================================
@@ -154,6 +159,37 @@ namespace Rotor
             return newState
         end function
 
+        ' =============================================================
+        ' ASYNC TRANSFER SUPPORT
+        ' =============================================================
+
+        ' ---------------------------------------------------------------------
+        ' registerAsyncTransfer - Registers a roUrlTransfer with the framework
+        '
+        ' Helper method to simplify async HTTP request tracking. Call this after
+        ' creating a roUrlTransfer but BEFORE calling AsyncGetToString() or other
+        ' async methods.
+        '
+        ' @param {object} transfer - The roUrlTransfer object
+        ' @param {object} context - Optional data to receive in asyncReducerCallback
+        '
+        ' Example:
+        '   transfer = CreateObject("roUrlTransfer")
+        '   transfer.SetUrl("https://api.example.com/data")
+        '   transfer.SetMessagePort(m.port)
+        '   m.registerAsyncTransfer(transfer, { userId: 123 })
+        '   transfer.AsyncGetToString()
+        '
+        sub registerAsyncTransfer(transfer as object, context = invalid as dynamic)
+            frameworkInstance = GetGlobalAA().rotor_framework_helper.frameworkInstance
+            transferId = transfer.GetIdentity().ToStr()
+
+            ' Only call if the method exists (task thread only)
+            if Rotor.Utils.isFunction(frameworkInstance?.registerAsyncTransfer)
+                frameworkInstance.registerAsyncTransfer(transferId, m.ownerDispatcherId, context)
+            end if
+        end sub
+
         ' =============================================================
         ' ASYNC CALLBACK
         ' =============================================================

package/src/source/base/BaseWidget.bs

@@ -44,9 +44,9 @@ namespace Rotor
         ' LIFECYCLE CALLBACKS
         ' =============================================================
 
-        onMountWidget as Function       ' Called after widget is mounted
-        onUpdateWidget as Function      ' Called before widget updates
-        onDestroyWidget as Function     ' Called before widget is destroyed
+        onMountWidget as function       ' Called after widget is mounted
+        onUpdateWidget as function      ' Called before widget updates
+        onDestroyWidget as function     ' Called before widget is destroyed
 
         ' =============================================================
         ' DECORATED METHODS
@@ -54,31 +54,32 @@ namespace Rotor
         ' These methods are injected by WidgetCreate.bs
 
         ' Tree Navigation
-        getWidget as Function           ' Find widget by ID or path (any depth)
-        findWidgets as Function         ' Find widgets by glob pattern
-        getChildrenWidgets as Function  ' Get direct children (optionally filtered)
-        getSiblingWidget as Function    ' Get sibling widget by ID
-        getSubtreeClone as Function     ' Clone widget subtree
+        getWidget as function           ' Find widget by ID or path (any depth)
+        findWidgets as function         ' Find widgets by glob pattern
+        getChildrenWidgets as function  ' Get direct children (optionally filtered)
+        getSiblingWidget as function    ' Get sibling widget by ID
+        getSubtreeClone as function     ' Clone widget subtree
 
         ' ViewModel Access
-        getParentViewModel as Function  ' Get parent ViewModel
-        getViewModel as Function        ' Get owning ViewModel
-        getRootWidget as Function       ' Get root widget (HID "0")
+        getParentViewModel as function  ' Get parent ViewModel
+        getViewModel as function        ' Get owning ViewModel
+        getRootWidget as function       ' Get root widget (HID "0")
 
         ' Rendering
-        render as Function              ' Render widget updates
-        refresh as Function             ' Refresh specific properties by key paths
-        erase as Function               ' Remove widget(s) from tree
+        render as function              ' Render widget updates
+        refresh as function             ' Refresh specific properties by key paths
+        erase as function               ' Remove widget(s) from tree
 
         ' Framework Integration
-        getFrameworkInstance as Function ' Get framework instance
-        getDispatcher as Function        ' Get dispatcher facade by ID
-        createDispatcher as Function     ' Create dispatcher
-        animator as Function             ' Get animator factory
+        getFrameworkInstance as function ' Get framework instance
+        getDispatcher as function        ' Get dispatcher facade by ID
+        dispatchTo as function           ' Dispatch intent to dispatcher by ID
+        getStateFrom as function         ' Get state from dispatcher by ID
+        animator as function             ' Get animator factory
 
         ' i18n Integration
-        getLocale as String              ' Get locale e.g: "en_US"
-        isRTL as Boolean                 ' Indicates whether the current locale uses right-to-left text
+        getLocale as function            ' Get locale e.g: "en_US"
+        isRTL as function                ' Indicates whether the current locale uses right-to-left text
 
         ' =============================================================
         ' PLUGIN METHODS

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

@@ -152,9 +152,9 @@ namespace Rotor.ViewBuilder
         end sub
 
         ' Listen shortcut - Listen to specific dispatcher'
-        widget.getStateFrom = function(dispatcherId as string)
+        widget.getStateFrom = function(dispatcherId as string, mapStateToProps = invalid as dynamic)
             dispatcherFaced = m.getDispatcher(dispatcherId)
-            return dispatcherFaced.getState()
+            return dispatcherFaced.getState(mapStateToProps)
         end function
 
         ' animator - Gets animator factory by ID *'