rotor-framework 0.3.7 → 0.4.1

package/README.md

@@ -22,6 +22,12 @@
 
 ---
 
+## 🎯 Quick Start with Starter Template
+
+Want to get started quickly? Check out **[rotor-starter](https://github.com/mobalazs/rotor-starter)** - a ready-to-use project template with Rotor Framework pre-configured, sample components, and best practices built in.
+
+---
+
 ## 📦 Installation
 
 ### Prerequisites
@@ -90,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.3.7-blue?label=Documents%20TAG)
+![Version](https://img.shields.io/badge/version-v0.4.1-blue?label=Documents%20TAG)
 
 ### Framework Core
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rotor-framework",
-	"version": "0.3.7",
+	"version": "0.4.1",
 	"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.3.7
+' Version 0.4.1
 ' © 2025 Balázs Molnár — MIT License
 ' =========================================================================
 
@@ -85,7 +85,7 @@ namespace Rotor
     class Framework
 
         name = "Rotor Framework"
-        version = "0.3.7"
+        version = "0.4.1"
 
         config = {
             tasks: invalid, ' @array    (optional)

package/src/source/RotorFrameworkTask.bs

@@ -4,7 +4,7 @@
 ' ▐▛▀▚▖▐▌ ▐▌ █ ▐▌ ▐▌▐▛▀▚▖    ▐▛▀▀▘▐▛▀▚▖▐▛▀▜▌▐▌  ▐▌▐▛▀▀▘▐▌ ▐▌▐▌ ▐▌▐▛▀▚▖▐▛▚▖
 ' ▐▌ ▐▌▝▚▄▞▘ █ ▝▚▄▞▘▐▌ ▐▌    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  ▐▌▐▙▄▄▖▐▙█▟▌▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌
 ' Rotor Framework™
-' Version 0.3.7
+' Version 0.4.1
 ' © 2025 Balázs Molnár — MIT License
 ' =========================================================================
 
@@ -70,7 +70,7 @@ namespace Rotor
     class FrameworkTask
 
         name = "Rotor Framework"
-        version = "0.3.7"
+        version = "0.4.1"
 
         config = {
             tasks: invalid, ' optional
@@ -184,9 +184,9 @@ namespace Rotor
                             data = msg.getData()
                             extraInfo = msg.GetInfo() ' Info AA passed during observeFieldScoped
 
-                            if extraInfo?.asyncReducerCallbackId <> invalid and m.dispatcherProvider.get(extraInfo?.asyncReducerCallbackId) <> invalid
+                            if extraInfo?.dispatcherId <> invalid and m.dispatcherProvider.get(extraInfo?.dispatcherId) <> invalid
                                 ' Catch by dispatcherId
-                                m.dispatcherProvider.get(extraInfo?.asyncReducerCallbackId).asyncReducerCallback(msg)
+                                m.dispatcherProvider.get(extraInfo?.dispatcherId).asyncReducerCallback(msg)
                             else
                                 dispatcherId = fieldId
                                 dispatcherInstance = m.dispatcherProvider.get(dispatcherId)

package/src/source/base/BaseWidget.bs

@@ -72,9 +72,13 @@ namespace Rotor
 
         ' 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
+        getDispatcher as Function        ' Get dispatcher facade by ID
+        createDispatcher as Function     ' Create dispatcher
+        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
 
         ' =============================================================
         ' PLUGIN METHODS

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

@@ -96,6 +96,18 @@ namespace Rotor.ViewBuilder
             return m.getFrameworkInstance().builder.widgetTree.getSubtreeClone(searchPattern, keyPathList, m.parentHID)
         end function
 
+       ' Get isRTL flag
+        widget.isRtl = function() as boolean
+            i18nService = m.getFrameworkInstance().i18nService
+            return i18nService.getIsRtl()
+        end function
+
+        ' Get locale string
+        widget.getLocale = function() as string
+            i18nService = m.getFrameworkInstance().i18nService
+            return i18nService.getLocale()
+        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)
@@ -133,6 +145,18 @@ namespace Rotor.ViewBuilder
             return m.getFrameworkInstance().dispatcherProvider.getFacade(dispatcherId, m)
         end function
 
+        ' Dispatch shortcut - Dispatches an event via specific dispatcher'
+        widget.dispatchTo = sub(dispatcherId as string, dispatchObject as object)
+            dispatcherFaced = m.getDispatcher(dispatcherId)
+            dispatcherFaced.dispatch(dispatchObject)
+        end sub
+
+        ' Listen shortcut - Listen to specific dispatcher'
+        widget.getStateFrom = function(dispatcherId as string)
+            dispatcherFaced = m.getDispatcher(dispatcherId)
+            return dispatcherFaced.getState()
+        end function
+
         ' animator - Gets animator factory by ID *'
         widget.animator = function(animatorId) as object
             return m.getFrameworkInstance().animatorProvider.getFactory(animatorId, m)
@@ -159,16 +183,6 @@ namespace Rotor.ViewBuilder
             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()
 

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

@@ -32,8 +32,6 @@ namespace Rotor.ViewBuilder
         sub init(frameworkInstance as Rotor.Framework)
             ' Set current locale from framework device info
             currentLocale = frameworkInstance.getInfo().device.currentLocale
-            ' Store rootWidget reference
-            m.rootWidget = frameworkInstance.getRootWidget()
             ' Store current locale
             m.setLocale(currentLocale)
         end sub
@@ -46,9 +44,6 @@ namespace Rotor.ViewBuilder
         sub setLocale(locale as string)
             m.locale = locale
             m.isRTL = m.detectRTL(locale)
-            ' update root widget's locale and isRTL
-            m.rootWidget.viewModelState.locale = m.locale
-            m.rootWidget.viewModelState.isRTL = m.isRTL
         end sub
 
         ' ---------------------------------------------------------------------
@@ -88,10 +83,6 @@ namespace Rotor.ViewBuilder
         '
         sub setL10n(l10n as object)
             m.l10n = l10n
-
-            ' Update root widget's l10n reference
-            m.rootWidget.viewModelState.l10n = m.l10n
-
             m.refreshCache()
         end sub
 
@@ -102,7 +93,6 @@ namespace Rotor.ViewBuilder
         '
         sub extendL10n(l10n as object)
             Rotor.Utils.deepExtendAA(m.l10n, l10n)
-            m.rootWidget.viewModelState.l10n = m.l10n
             m.refreshCache()
         end sub
 
@@ -110,7 +100,6 @@ namespace Rotor.ViewBuilder
         ' destroy - Cleans up cache and l10n data
         '
         sub destroy()
-            m.rootWidget = invalid
             m.cache.Clear()
             m.l10n.Clear()
         end sub

package/src/source/plugins/FocusPlugin.bs

@@ -972,32 +972,34 @@ namespace Rotor
 
             refSegmentTop = focused.metrics.segments[Rotor.Const.Segment.TOP]
             refSegmentRight = focused.metrics.segments[Rotor.Const.Segment.RIGHT]
+            refSegmentLeft = focused.metrics.segments[Rotor.Const.Segment.LEFT]
+            refSegmentBottom = focused.metrics.segments[Rotor.Const.Segment.BOTTOM]
             referencePoint = { x: (refSegmentTop.x1 + refSegmentRight.x2) / 2, y: (refSegmentTop.y1 + refSegmentRight.y2) / 2 }
 
             validators = {
 
-                "left": function(referencePoint as object, segments as object) as object
+                "left": function(referencePoint as object, segments as object, refSegmentLeft as object, refSegmentRight as object) as object
                     right = segments[Rotor.Const.Segment.RIGHT]
-                    ' stop
-                    return right.x1 <= referencePoint.x ? { isValid: true, segment: right } : { isValid: false }
+                    ' Candidate's right edge must be strictly left of focused element's left edge
+                    return right.x2 <= refSegmentLeft.x1 ? { isValid: true, segment: right } : { isValid: false }
                 end function,
 
-                "up": function(referencePoint as object, segments as object) as object
+                "up": function(referencePoint as object, segments as object, refSegmentTop as object, refSegmentBottom as object) as object
                     bottom = segments[Rotor.Const.Segment.BOTTOM]
-                    ' stop
-                    return bottom.y1 <= referencePoint.y ? { isValid: true, segment: bottom } : { isValid: false }
+                    ' Candidate's bottom edge must be strictly above focused element's top edge
+                    return bottom.y2 <= refSegmentTop.y1 ? { isValid: true, segment: bottom } : { isValid: false }
                 end function,
 
-                "right": function(referencePoint as object, segments as object) as object
+                "right": function(referencePoint as object, segments as object, refSegmentLeft as object, refSegmentRight as object) as object
                     left = segments[Rotor.Const.Segment.LEFT]
-                    ' stop
-                    return left.x1 >= referencePoint.x ? { isValid: true, segment: left } : { isValid: false }
+                    ' Candidate's left edge must be strictly right of focused element's right edge
+                    return left.x1 >= refSegmentRight.x2 ? { isValid: true, segment: left } : { isValid: false }
                 end function,
 
-                "down": function(referencePoint as object, segments as object) as object
+                "down": function(referencePoint as object, segments as object, refSegmentTop as object, refSegmentBottom as object) as object
                     top = segments[Rotor.Const.Segment.TOP]
-                    ' stop
-                    return top.y1 >= referencePoint.y ? { isValid: true, segment: top } : { isValid: false }
+                    ' Candidate's top edge must be strictly below focused element's bottom edge
+                    return top.y1 >= refSegmentBottom.y2 ? { isValid: true, segment: top } : { isValid: false }
                 end function
             }
             segments = {}
@@ -1006,7 +1008,12 @@ namespace Rotor
                 if HID <> focused.HID
                     focusItem = m.focusItemStack.get(HID)
                     focusItem.refreshBounding()
-                    result = validator(referencePoint, focusItem.metrics.segments)
+                    ' Pass appropriate reference segments based on direction
+                    if direction = "left" or direction = "right"
+                        result = validator(referencePoint, focusItem.metrics.segments, refSegmentLeft, refSegmentRight)
+                    else ' up or down
+                        result = validator(referencePoint, focusItem.metrics.segments, refSegmentTop, refSegmentBottom)
+                    end if
                     if result.isValid
                         segments[HID] = result.segment
                     end if