@roku-sdk/components 0.0.0-stage → 2.19.0

package/src/xml-components/modal/StandardProgressDialogExt.xml.d.ts

@@ -0,0 +1,37 @@
+// Auto-generated TypeScript declarations for XML component import.
+// DO NOT EDIT — this file is regenerated during build.
+//
+// Source component: StandardProgressDialogExt
+// Extends: StandardProgressDialog
+
+import type { IStandardProgressDialogProps } from "@roku-sdk/components";
+import type { TypedXmlComponent } from "@roku-sdk/interfaces";
+
+export interface IStandardProgressDialogExtProps extends IStandardProgressDialogProps {}
+
+declare const _default: TypedXmlComponent<"StandardProgressDialogExt", Record<string, never>>;
+export default _default;
+
+declare module "@roku-sdk/solid" {
+    namespace JSX {
+        interface IntrinsicElements {
+            standardProgressDialogExt: IStandardProgressDialogExtProps;
+        }
+    }
+}
+
+declare module "@roku-sdk/solid/jsx-runtime" {
+    namespace JSX {
+        interface IntrinsicElements {
+            standardProgressDialogExt: IStandardProgressDialogExtProps;
+        }
+    }
+}
+
+declare module "solid-js" {
+    namespace JSX {
+        interface IntrinsicElements {
+            standardProgressDialogExt: IStandardProgressDialogExtProps;
+        }
+    }
+}

package/src/xml-components/modal/tests/Modal.test.brs

@@ -0,0 +1,195 @@
+' Copyright (c) 2026 Roku, Inc.
+' SPDX-License-Identifier: MIT
+' Run with Modal.brs in the same interpreter scope. Scene/node effects are controlled.
+sub main()
+    m.failures = 0
+    m.assertions = 0
+    for each id in ["", "shared-id"]
+        setupModal()
+        first = fakeDialog(1, id)
+        second = fakeDialog(2, id)
+        m.top.dialog = first
+        onDialogChange()
+        check(m.scene.dialog = invalid, "no presentation before mount")
+        m.top.mounted = true
+        updateDialog()
+        check(sameDialog(m.scene.dialog, first), "initial presentation")
+        check(m.top.opened, "native opening notification")
+        check(first.observed, "observe native close")
+
+        m.scene.dialog = second
+        m.top.mounted = false
+        updateDialog()
+        check(sameDialog(m.scene.dialog, second), "unmount does not close same-id replacement")
+        check(not first.close and not second.close, "stale owner does not request native close")
+        check(not first.observed, "unmount removes original observer")
+
+        setupModal()
+        m.top.mounted = true
+        m.top.dialog = first
+        m.scene.dialog = second
+        onDialogChange()
+        check(sameDialog(m.scene.dialog, first), "default admission replaces distinct same-id node")
+        m.top.open = false
+        onOpenChange()
+        check(first.close, "explicit close requests the native close field")
+        check(sameDialog(m.scene.dialog, first), "close request does not clear the scene field")
+        check(first.observed and not m.top.wasClosed, "close notification waits for native completion")
+        finishNativeClose(first)
+        check(m.scene.dialog = invalid and m.top.wasClosed, "native completion releases the session")
+        m.top.open = true
+        onOpenChange()
+        check(sameDialog(m.scene.dialog, first), "same wrapper reopens")
+
+        onNativeClosed(fakeEvent(second))
+        check(sameDialog(m.dialog, first), "foreign close ignored")
+        m.scene.dialog = invalid
+        onNativeClosed(fakeEvent(first))
+        check(m.top.wasClosed, "native close reported without Boolean payload")
+        m.top.wasClosed = false
+        onNativeClosed(fakeEvent(first))
+        updateDialog()
+        check(not m.top.wasClosed, "duplicate close is not reported")
+        check(m.scene.dialog = invalid, "dismissed dialog does not reopen")
+
+        setupModal()
+        m.top.mounted = true
+        m.top.dialog = first
+        m.top.replaceExisting = false
+        m.scene.dialog = second
+        onDialogChange()
+        check(m.top.blocked, "occupied scene reports blocked")
+        check(sameDialog(m.scene.dialog, second), "non-preempting admission preserves modal")
+        m.scene.dialog = invalid
+        m.top.blocked = false
+        updateDialog()
+        check(m.scene.dialog = invalid and not m.top.blocked, "blocked admission does not retry itself")
+        m.top.open = false
+        onOpenChange()
+        m.top.open = true
+        onOpenChange()
+        check(sameDialog(m.scene.dialog, first), "explicit retry after rejection")
+    end for
+    setupModal()
+    m.top.dialog = fakeDialog(1, "content")
+    m.top.fallback = fakeDialog(2, "loading")
+    m.top.ready = false
+    m.top.mounted = true
+    m.top.replaceExisting = false
+    updateDialog()
+    check(sameDialog(m.scene.dialog, m.top.fallback), "loading is presented by the same owner")
+    check(not m.top.opened, "loading is not content presentation")
+    m.top.ready = true
+    updateDialog()
+    check(sameDialog(m.scene.dialog, m.top.dialog), "ready replaces own loading without preemption")
+    check(not m.top.wasClosed, "loading handoff is not a terminal close")
+    check(not m.top.fallback.observed, "loading observer removed at handoff")
+    check(m.top.opened, "content presentation notified")
+    content = m.top.dialog
+    m.top.dialog = invalid
+    onDialogChange()
+    check(content.close and not m.top.wasClosed, "clearing content requests native close")
+    finishNativeClose(content)
+    check(m.scene.dialog = invalid and m.top.wasClosed, "clearing content waits for native close")
+
+    setupModal()
+    m.top.dialog = fakeDialog(1, "content")
+    m.top.fallback = fakeDialog(2, "loading")
+    m.top.ready = false
+    m.top.mounted = true
+    updateDialog()
+    m.scene.dialog = invalid
+    onNativeClosed(fakeEvent(m.top.fallback))
+    m.top.ready = true
+    updateDialog()
+    check(m.scene.dialog = invalid, "late assets cannot reopen cancelled loading")
+    setupModal()
+    m.top.dialog = fakeDialog(1, "content")
+    m.top.fallback = fakeDialog(2, "loading")
+    m.top.ready = false
+    m.top.mounted = true
+    updateDialog()
+    m.top.open = false
+    onOpenChange()
+    check(m.top.fallback.close and not m.top.wasClosed, "controlled close requests fallback dismissal")
+    finishNativeClose(m.top.fallback)
+    check(m.scene.dialog = invalid and m.top.wasClosed, "native close completes fallback dismissal")
+    m.top.ready = true
+    updateDialog()
+    check(m.scene.dialog = invalid, "close fences subsequent readiness")
+    setupModal()
+    m.top.dialog = fakeDialog(1, "content")
+    m.top.mounted = true
+    updateDialog()
+    m.top.scene = invalid
+    m.top.mounted = false
+    updateDialog()
+    check(m.top.dialog.close, "unmount closes through the dialog's scene after host detachment")
+    check(not m.top.dialog.observed, "unmount retires the native observer without awaiting callbacks")
+    GetGlobalAA().Delete("modalTestScene")
+    print "Modal bridge assertions="; m.assertions; " failures="; m.failures
+end sub
+
+sub finishNativeClose(dialog as Object)
+    if dialog.observed then onNativeClosed(fakeEvent(dialog))
+    if sameDialog(m.scene.dialog, dialog) then m.scene.dialog = invalid
+end sub
+
+sub setupModal()
+    m.scene = { dialog: invalid }
+    GetGlobalAA().modalTestScene = m.scene
+    m.top = {
+        scene: m.scene, mounted: false, ready: true, open: true, replaceExisting: true, fallback: invalid
+        identity: 0
+        initialFocusId: "", dialog: invalid, opened: false, wasClosed: false, blocked: false
+        getScene: function() as Object
+            return m.scene
+        end function
+        appendChild: sub(node as Object)
+            m.prepared = node
+        end sub
+        isSameNode: function(other as Object) as Boolean
+            return m.identity = other.identity
+        end function
+        removeChild: sub(node as Object)
+        end sub
+    }
+    init()
+end sub
+
+function fakeDialog(identity as Integer, id as String) as Object
+    return {
+        identity: identity, id: id, observed: false, close: false
+        getScene: function() as Object
+            return GetGlobalAA().modalTestScene
+        end function
+        getParent: function() as Dynamic
+            return invalid
+        end function
+        isSameNode: function(other as Object) as Boolean
+            return m.identity = other.identity
+        end function
+        observeFieldScopedEx: sub(field as String, callback as String)
+            m.observed = field = "wasClosed" and callback = "onNativeClosed"
+        end sub
+        unobserveFieldScoped: sub(field as String)
+            if field = "wasClosed" then m.observed = false
+        end sub
+    }
+end function
+
+function fakeEvent(node as Object) as Object
+    return {
+        node: node
+        getRoSGNode: function() as Object
+            return m.node
+        end function
+    }
+end function
+
+sub check(condition as Boolean, message as String)
+    m.assertions++
+    if condition then return
+    m.failures++
+    print "FAIL "; message
+end sub

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+    "extends": "@roku-sdk/dev-tools/typescript-config/tsconfig.base.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "rootDir": "./src"
+    },
+    "include": ["src/**/*", "jsx.d.ts", "core-jsx.d.ts"],
+    "exclude": ["dist", "node_modules"],
+    "files": ["xml.d.ts", "src/kdfs.d.ts"]
+}