rotor-framework 0.7.0 → 0.7.2

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.7.0-blue?label=Documents%20TAG)
+![Version](https://img.shields.io/badge/version-v0.7.2-blue?label=Documents%20TAG)
 
 ### Framework Core
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rotor-framework",
-	"version": "0.7.0",
+	"version": "0.7.2",
 	"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": "Apache-2.0",

package/src/source/RotorFramework.bs

@@ -4,7 +4,7 @@
 ' ▐▛▀▚▖▐▌ ▐▌ █ ▐▌ ▐▌▐▛▀▚▖    ▐▛▀▀▘▐▛▀▚▖▐▛▀▜▌▐▌  ▐▌▐▛▀▀▘▐▌ ▐▌▐▌ ▐▌▐▛▀▚▖▐▛▚▖
 ' ▐▌ ▐▌▝▚▄▞▘ █ ▝▚▄▞▘▐▌ ▐▌    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  ▐▌▐▙▄▄▖▐▙█▟▌▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌
 ' Rotor Framework™
-' Version 0.7.0
+' Version 0.7.2
 ' © 2025 Balázs Molnár — Apache License 2.0
 ' =========================================================================
 
@@ -86,7 +86,7 @@ namespace Rotor
     class Framework
 
         name = "Rotor Framework"
-        version = "0.7.0"
+        version = "0.7.2"
 
         config = {
             tasks: invalid, ' @array    (optional)
@@ -118,10 +118,6 @@ namespace Rotor
         ttsService as object
         dispatcherProvider as object
         animatorProvider as object
-        info = {
-            device: {}
-        }
-
         ' plugin adapter workspace
         plugins = {}
 
@@ -132,9 +128,6 @@ namespace Rotor
 
         enableRendering = true
 
-        ' helper vars
-        deviceInfo as object
-
         '----------------------------------------------------------------------
         ' new - Initializes the Rotor Framework instance
         '
@@ -161,8 +154,6 @@ namespace Rotor
 
             m.builder.init(m)
 
-            m.initInfo()
-
             ' set root node
             if m.config.rootNode = invalid
                 rootNode = globalScope.top
@@ -325,15 +316,6 @@ namespace Rotor
             return m.animatorProvider.getFactory(animatorId, m)
         end function
 
-        ' ---------------------------------------------------------------------
-        ' getInfo - Gets framework and device information
-        '
-        ' @returns {object} Info object containing device details
-        '
-        public function getInfo() as object
-            return m.info
-        end function
-
         ' ---------------------------------------------------------------------
         ' getNodePoolInfo - Gets node pool statistics
         '
@@ -366,32 +348,6 @@ namespace Rotor
             m.builder.pluginAdapter.registerPlugins(plugins)
         end sub
 
-        ' ---------------------------------------------------------------------
-        ' initInfo - Initializes device and framework information
-        '
-        ' Collects device information (graphics platform, model, OS version, locale)
-        ' and stores it in m.info for later access.
-        '
-        sub initInfo()
-            ' Device info
-            di = CreateObject("roDeviceInfo")
-            ' Make it available on framework instance
-            m.deviceInfo = di
-            ' Generate app info
-            m.info.device.append({
-                graphicsPlatform: di.GetGraphicsPlatform(), ' ["opengl"|"directfb"]
-                modelDisplayName: di.GetModelDisplayName(),
-                OSVersion: di.GetOSVersion(),
-                currentLocale: di.GetCurrentLocale(), ' Example: "en_US"
-                countryCode: di.GetCountryCode() ' A value that indicates the Streaming Store associated with a user's Roku account.
-            })
-            #if debug
-                print `[DEVICEINFO] Graphics Platform: ${m.info.device.graphicsPlatform}`
-                print `[DEVICEINFO] modelDisplayName: ${m.info.device.modelDisplayName}`
-                print `[DEVICEINFO] OSVersion: ${m.info.device.OSVersion.major}.${m.info.device.OSVersion.minor}.${m.info.device.OSVersion.revision}.${m.info.device.OSVersion.build}`
-            #end if
-        end sub
-
         ' ---------------------------------------------------------------------
         ' setupTaskForSyncing - Prepares a task node for cross-thread syncing
         '
@@ -619,9 +575,6 @@ namespace Rotor
             }
             m.config.rootNode = invalid
 
-            m.info.Clear()
-            m.deviceInfo = invalid
-
         end sub
 
     end class
@@ -646,7 +599,15 @@ namespace Rotor
 
         taskNode = sync.taskNode
 
-        if sync.type = Rotor.Const.ThreadSyncType.TASK_SYNCING
+        if sync.type = Rotor.Const.ThreadSyncType.DISPATCH
+            ' Cross-thread dispatch from task thread to render thread
+            dispatcherId = sync.payload.dispatcherId
+            intent = sync.payload.intent
+            dispatcherInstance = framework.dispatcherProvider.stack.LookupCI(dispatcherId)
+            if dispatcherInstance <> invalid
+                dispatcherInstance.dispatch(intent)
+            end if
+        else if sync.type = Rotor.Const.ThreadSyncType.TASK_SYNCING
             framework.handleTaskSyncing(sync)
         else if sync.type = Rotor.Const.ThreadSyncType.TASK_SYNCED
             framework.handleTaskSynced(taskNode.taskId)

package/src/source/RotorFrameworkTask.bs

@@ -4,7 +4,7 @@
 ' ▐▛▀▚▖▐▌ ▐▌ █ ▐▌ ▐▌▐▛▀▚▖    ▐▛▀▀▘▐▛▀▚▖▐▛▀▜▌▐▌  ▐▌▐▛▀▀▘▐▌ ▐▌▐▌ ▐▌▐▛▀▚▖▐▛▚▖
 ' ▐▌ ▐▌▝▚▄▞▘ █ ▝▚▄▞▘▐▌ ▐▌    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  ▐▌▐▙▄▄▖▐▙█▟▌▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌
 ' Rotor Framework™
-' Version 0.7.0
+' Version 0.7.2
 ' © 2025 Balázs Molnár — Apache License 2.0
 ' =========================================================================
 
@@ -70,7 +70,7 @@ namespace Rotor
     class FrameworkTask
 
         name = "Rotor Framework"
-        version = "0.7.0"
+        version = "0.7.2"
 
         config = {
             tasks: invalid, ' optional

package/src/source/engine/animator/Animator.bs

@@ -120,7 +120,9 @@ namespace Rotor
                         m.scope.animators.delete(m.animatorId)
                     end if
 
-                    m.scope.animators = {}
+                    if m.scope.animators = invalid
+                        m.scope.animators = {}
+                    end if
                     m.scope.animators[m.animatorId] = {}
 
                     parsedParams = Rotor.animatorParamsIntegrationHelper(params)
@@ -171,7 +173,9 @@ namespace Rotor
                         m.scope.animators.delete(m.animatorId)
                     end if
 
-                    m.scope.animators = {}
+                    if m.scope.animators = invalid
+                        m.scope.animators = {}
+                    end if
                     m.scope.animators[m.animatorId] = {}
 
                     return {

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

@@ -36,11 +36,6 @@ namespace Rotor.ViewBuilder
             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)
@@ -195,7 +190,7 @@ namespace Rotor.ViewBuilder
             if template <> invalid and template.Count() > 0
                 templateChildren = template.children
                 template.delete("children")
-                config = Rotor.Utils.deepExtendAA(config, template)
+                config = Rotor.Utils.deepExtendAA(template, config)
                 config.children = templateChildren
             end if
 

package/src/source/engine/services/I18n.bs

@@ -31,8 +31,9 @@ namespace Rotor.ViewBuilder
         ' @param {Rotor.Framework} frameworkInstance - Framework instance reference
         '
         sub init(frameworkInstance as Rotor.Framework)
-            ' Set current locale from framework device info
-            currentLocale = frameworkInstance.getInfo().device.currentLocale
+            ' Set current locale from device info
+            deviceInfo = CreateObject("roDeviceInfo")
+            currentLocale = deviceInfo.GetCurrentLocale()
             ' Store current locale
             m.setLocale(currentLocale)
         end sub

package/src/source/plugins/FieldsPlugin.bs

@@ -12,6 +12,7 @@ namespace Rotor
     '   - Interpolates @-prefixed expressions (e.g., @viewModelState.value)
     '   - Supports dynamic field resolution from widget context
     '   - Automatically updates fields on widget lifecycle changes
+    '   - Converts \n to Chr(10) for multi-line text support
     '
     ' Expression Syntax:
     '   @key.path - Resolves from widget.viewModelState
@@ -27,8 +28,11 @@ namespace Rotor
 
         ' Regex pattern for matching @ and $ prefixed expressions
         ' @ = viewModelState, $ = widget properties
-        ' Matches: @ or $ followed by any characters except space, @, $, or comma
-        configRegex = /([\@\$])([^\s\@\$\,]*)/i
+        ' Matches: @ or $ followed by valid key path characters (letters, numbers, underscore, dot)
+        configRegex = /([\@\$])([a-zA-Z0-9_\.]*)/i
+
+        ' Regex pattern for matching \n (literal backslash-n) to convert to Chr(10)
+        newlineRegex = /\\n/
 
         ' =============================================================
         ' LIFECYCLE HOOKS
@@ -160,6 +164,11 @@ namespace Rotor
                         end for
                     end if
 
+                    ' Step 3: Convert \n to Chr(10) for multi-line text
+                    if Rotor.Utils.isString(value)
+                        value = m.newlineRegex.ReplaceAll(value, Chr(10))
+                    end if
+
                     parsedFields[fieldId] = value
                 else
                     ' Step 3: Direct value assignment

package/src/source/plugins/FocusPlugin.bs

@@ -321,7 +321,58 @@ namespace Rotor
             '
             triggerKeyPress: function(key) as object
                 return m.getFrameworkInstance().plugins[PRIMARY_FOCUS_PLUGIN_KEY].onKeyEventHandler(key, true)
-            end function
+            end function,
+
+            ' ---------------------------------------------------------------------
+            ' setGroupLastFocusedHID - Updates the lastFocusedHID of this widget's focus group
+            '
+            ' If called on a focusGroup widget, updates its own lastFocusedHID.
+            ' If called on a focusItem widget, finds and updates the parent group's lastFocusedHID.
+            '
+            ' @param {string} id - The widget id to set as lastFocusedHID
+            '
+            setGroupLastFocusedHID: sub(id as string)
+                plugin = m.getFrameworkInstance().plugins[PRIMARY_FOCUS_PLUGIN_KEY]
+
+                ' Determine ancestorHID for search context
+                ' If this is a focus item, use parent group's HID to find siblings
+                ancestorGroups = plugin.findAncestorGroups(m.HID)
+                if ancestorGroups.count() > 0
+                    ancestorHID = ancestorGroups[0]
+                else
+                    ancestorHID = m.HID
+                end if
+
+                ' Resolve id to HID - check focusItemStack first, then groupStack
+                focusItem = plugin.focusItemStack.getByNodeId(id, ancestorHID)
+                if focusItem <> invalid
+                    resolvedHID = focusItem.HID
+                else
+                    group = plugin.groupStack.getByNodeId(id, ancestorHID)
+                    if group <> invalid
+                        resolvedHID = group.HID
+                    else
+                        return
+                    end if
+                end if
+
+                ' Check if this widget is a group
+                group = plugin.groupStack.get(m.HID)
+                if group <> invalid
+                    group.setLastFocusedHID(resolvedHID)
+                    return
+                end if
+
+                ' This is a focus item - find parent group
+                ancestorGroups = plugin.findAncestorGroups(m.HID)
+                if ancestorGroups.count() > 0
+                    parentGroupHID = ancestorGroups[0]
+                    parentGroup = plugin.groupStack.get(parentGroupHID)
+                    if parentGroup <> invalid
+                        parentGroup.setLastFocusedHID(resolvedHID)
+                    end if
+                end if
+            end sub
 
         }
 
@@ -1130,7 +1181,7 @@ namespace Rotor
 
         class BaseFocusConfig
 
-            autoSetIsFocusedOnContext as boolean
+            autoSetIsFocusedState as boolean
             staticDirection as object
 
             sub new (config as object)
@@ -1142,7 +1193,7 @@ namespace Rotor
                 m.node = m.widget.node
                 m.isFocused = config.isFocused ?? false
 
-                m.autoSetIsFocusedOnContext = config.autoSetIsFocusedOnContext ?? true
+                m.autoSetIsFocusedState = config.autoSetIsFocusedState ?? true
 
                 m.isEnabled = config.isEnabled ?? true
                 m.staticDirection = {}
@@ -1160,7 +1211,7 @@ namespace Rotor
                 Rotor.Utils.setCustomFields(m.node, { "isFocused": false }, true, true)
 
                 ' convenience (usually this is used on viewModelState)
-                if false = m.widget.viewModelState.DoesExist("isFocused") and true = m.autoSetIsFocusedOnContext
+                if false = m.widget.viewModelState.DoesExist("isFocused") and true = m.autoSetIsFocusedState
                     m.widget.viewModelState.isFocused = false ' as default
                 end if
 
@@ -1346,7 +1397,7 @@ namespace Rotor
 
                 m.isFocused = isFocused
 
-                if m.autoSetIsFocusedOnContext
+                if m.autoSetIsFocusedState
                     m.widget.viewModelState.isInFocusChain = isFocused
                 end if
                 m.node.setField("isFocused", isFocused)
@@ -1470,7 +1521,7 @@ namespace Rotor
 
                 m.isFocused = isFocused
 
-                if m.autoSetIsFocusedOnContext
+                if m.autoSetIsFocusedState
                     m.widget.viewModelState.isFocused = isFocused
                 end if