Alpha Picker (#540)

DEVGUIDE.md

@@ -121,6 +121,16 @@ telnet ${ROKU_DEV_TARGET} 8085
 
 To exit telnet: `CTRL + ]` and then type `quit + ENTER`
 
+### Committing
+
+Before commiting your code, please run:
+
+```bash
+make prep_commit
+```
+
+This will format your code and run the CI checks locally to ensure you will pass the CI tests.
+
 ### (Optional) Update Images
 
 This repo already contains all necessary images for the app. This script only needs to be run when the [official Jellyfin images](https://github.com/jellyfin/jellyfin-ux) are changed to allow us to update the repo images.

app.mk

@@ -169,6 +169,12 @@ prep_tests:
 	cp -r $(SOURCEREL)/tests/source/* $(STAGINGREL)/source/tests/;\
 	./node_modules/.bin/rooibos-cli i tests/.rooibosrc.json
 
+prep_commit:
+	npm run format
+	npm ci
+	npm run validate
+	npm run check-formatting
+
 install: prep_staging package home
 	@echo "Installing $(APPNAME)-$(BUILD) to host $(ROKU_DEV_TARGET)"
 	@$(CURLCMD) --user $(USERPASS) --digest -F "mysubmit=Install" -F "archive=@$(ZIPREL)/$(APPNAME)-$(BUILD).zip" -F "passwd=" http://$(ROKU_DEV_TARGET)/plugin_install | grep "<font color" | sed "s/<font color=\"red\">//" | sed "s[</font>[["

components/ItemGrid/Alpha.brs

@@ -0,0 +1,28 @@
+sub init()
+    m.top.visible = true
+    m.Alphamenu = m.top.findNode("Alphamenu")
+    m.Alphamenu.focusable = true
+    m.Alphatext = m.top.findNode("alphatext")
+    m.focusedChild = m.top.findNode("focusedChild")
+    m.Alphamenu.focusedFont.size = 25
+    m.Alphamenu.font.size = 25
+end sub
+
+function onKeyEvent(key as string, press as boolean) as boolean
+
+    if not press then return false
+
+    if key = "OK"
+        child = m.Alphatext.getChild(m.Alphamenu.itemFocused)
+
+        if child.title = m.top.itemAlphaSelected
+            m.top.itemAlphaSelected = ""
+            m.Alphamenu.focusFootprintBitmapUri = ""
+        else
+            m.Alphamenu.focusFootprintBitmapUri = "pkg:/images/white.png"
+            m.top.itemAlphaSelected = child.title
+        end if
+        return true
+    end if
+    return false
+end function

components/ItemGrid/Alpha.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<component name="Alpha" extends = "Group">
+  <children>
+    <LabelList 
+        translation="[1872, 185]"
+        vertFocusAnimationStyle="floatingFocus" 
+        drawFocusFeedback="true"
+        id = "Alphamenu"
+        font="font:SmallestSystemFont"
+        itemSpacing="[0,2]"
+        itemSize="[28,28]"
+        numRows="27"
+        textHorizAlign="center"
+        focusBitmapUri = "pkg:/images/white.png"
+        focusBitmapBlendColor = "#FFFFFF"
+        focusFootprintBlendColor = "#666666"
+    >
+    <ContentNode id="alphatext" role = "content" >
+      <ContentNode title = "#" />
+      <ContentNode title = "A" />
+      <ContentNode title = "B" />
+      <ContentNode title = "C" />
+      <ContentNode title = "D" />
+      <ContentNode title = "E" />
+      <ContentNode title = "F" />
+      <ContentNode title = "G" />
+      <ContentNode title = "H" />
+      <ContentNode title = "I" />
+      <ContentNode title = "J" />
+      <ContentNode title = "K" />
+      <ContentNode title = "L" />
+      <ContentNode title = "M" />
+      <ContentNode title = "N" />
+      <ContentNode title = "O" />
+      <ContentNode title = "P" />
+      <ContentNode title = "Q" />
+      <ContentNode title = "R" />
+      <ContentNode title = "S" />
+      <ContentNode title = "T" />
+      <ContentNode title = "U" />
+      <ContentNode title = "V" />
+      <ContentNode title = "W" />
+      <ContentNode title = "X" />
+      <ContentNode title = "Y" />
+      <ContentNode title = "Z" />
+    </ContentNode>
+  </LabelList>
+  </children>
+  <interface>
+    <field id="selectedItem" type="node" alwaysNotify="true" />
+    <field id="focusedChild" type="node" onChange="focusChanged" />
+    <field id="itemAlphaSelected" type="string" />
+  </interface>
+<script type="text/brightscript" uri="Alpha.brs" />
+</component>

components/ItemGrid/ItemGrid.brs

@@ -21,6 +21,7 @@ sub init()
 
     m.itemGrid.observeField("itemFocused", "onItemFocused")
     m.itemGrid.observeField("itemSelected", "onItemSelected")
+    m.itemGrid.observeField("AlphaSelected", "onItemAlphaSelected")
     m.newBackdrop.observeField("loadStatus", "newBGLoaded")
 
     'Background Image Queued for loading
@@ -34,6 +35,8 @@ sub init()
 
     m.loadItemsTask = createObject("roSGNode", "LoadItemsTask2")
 
+    m.Alpha = m.top.findNode("AlphaMenu")
+    m.AlphaSelected = m.top.findNode("AlphaSelected")
 end sub
 
 '
@@ -72,6 +75,9 @@ sub loadInitialItems()
         m.sortAscending = false
     end if
 
+    m.loadItemsTask.nameStartsWith = m.top.AlphaSelected
+    m.emptyText.visible = false
+
     updateTitle()
 
     m.loadItemsTask.itemId = m.top.parentItem.Id
@@ -339,6 +345,14 @@ sub onItemSelected()
     m.top.selectedItem = m.itemGrid.content.getChild(m.itemGrid.itemSelected)
 end sub
 
+sub onItemAlphaSelected()
+    m.loadedRows = 0
+    m.loadedItems = 0
+    m.data = CreateObject("roSGNode", "ContentNode")
+    m.itemGrid.content = m.data
+    loadInitialItems()
+end sub
+
 
 '
 'Check if options updated and any reloading required
@@ -440,9 +454,8 @@ sub onChannelSelected(msg)
 end sub
 
 function onKeyEvent(key as string, press as boolean) as boolean
-
     if not press then return false
-
+    topGrp = m.top.findNode("itemGrid")
     if key = "options"
         if m.options.visible = true
             m.options.visible = false
@@ -463,6 +476,7 @@ function onKeyEvent(key as string, press as boolean) as boolean
     else if key = "play" or key = "OK"
         markupGrid = m.top.getChild(2)
         itemToPlay = markupGrid.content.getChild(markupGrid.itemFocused)
+
         if itemToPlay <> invalid and (itemToPlay.type = "Movie" or itemToPlay.type = "Episode")
             m.top.quickPlayNode = itemToPlay
             return true
@@ -473,6 +487,16 @@ function onKeyEvent(key as string, press as boolean) as boolean
             photoPlayer.control = "RUN"
             return true
         end if
+    else if key = "right" and topGrp.isinFocusChain()
+        topGrp.setFocus(false)
+        alpha = m.Alpha.getChild(0).findNode("Alphamenu")
+        alpha.setFocus(true)
+        return true
+    else if key = "left" and m.Alpha.isinFocusChain()
+        m.Alpha.setFocus(false)
+        m.Alpha.visible = true
+        topGrp.setFocus(true)
+        return true
     end if
     return false
 end function
@@ -481,8 +505,11 @@ sub updateTitle()
     if m.filter = "All"
         m.top.overhangTitle = m.top.parentItem.title
     else if m.filter = "Favorites"
-        m.top.overhangTitle = m.top.parentItem.title + " (Favorites)"
+        m.top.overhangTitle = m.top.parentItem.title + tr(" (Favorites)")
     else
-        m.top.overhangTitle = m.top.parentItem.title + " (Filtered)"
+        m.top.overhangTitle = m.top.parentItem.title + tr(" (Filtered)")
+    end if
+    if m.top.AlphaSelected <> ""
+        m.top.overhangTitle = m.top.parentItem.title + tr(" (Filtered)")
     end if
 end sub

components/ItemGrid/ItemGrid.xml

@@ -29,12 +29,14 @@
         <FloatFieldInterpolator id = "fadeinLoading" key="[0.0, 1.0]" keyValue="[ 0.00, 0.25 ]" fieldToInterp="backdropTransition.opacity" />
         <FloatFieldInterpolator id = "fadeoutLoaded" key="[0.0, 1.0]" keyValue="[ 0.25, 0.00 ]" fieldToInterp="backdrop.opacity" />
     </Animation>
+    <Alpha id="AlphaMenu" />
   </children>
   <interface>
     <field id="parentItem" type="node" onChange="loadInitialItems" />
     <field id="selectedItem" type="node" alwaysNotify="true" />
     <field id="quickPlayNode" type="node" alwaysNotify="true" />
     <field id="imageDisplayMode" type="string" value="scaleToZoom" />
+    <field id="AlphaSelected" type="string" alias="AlphaMenu.itemAlphaSelected" alwaysNotify="true" onChange="onItemAlphaSelected" />
   </interface>
   <script type="text/brightscript" uri="pkg:/source/utils/misc.brs" />
   <script type="text/brightscript" uri="pkg:/source/utils/config.brs" />

components/ItemGrid/LoadItemsTask2.brs

@@ -25,6 +25,15 @@ sub loadItems()
         Fields: "Overview"
     }
 
+    ' Handle special case when getting names starting with numeral
+    if m.top.NameStartsWith <> ""
+        if m.top.NameStartsWith = "#"
+            params.NameLessThan = "A"
+        else
+            params.NameStartsWith = m.top.nameStartsWith
+        end if
+    end if
+
     filter = m.top.filter
     if filter = "All" or filter = "all"
         ' do nothing

components/ItemGrid/LoadItemsTask2.xml

@@ -9,6 +9,7 @@
     <field id="metadata" type="assocarray" />
     <field id="sortField" type="string" value="SortName" />
     <field id="sortAscending" type="boolean" value="true" />
+    <field id="nameStartsWith" type="string" value="" />
     <field id="recursive" type="boolean" value="true" />
     <field id="filter" type="string" value="All" />