Skip to content

feat(deck): bind host game preview selection #80

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
papi-ux merged 1 commit into from
Jun 14, 2026
Merged

feat(deck): bind host game preview selection #80

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
130 changes: 106 additions & 24 deletions clients/deck/qml/Main.qml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,21 +25,80 @@ ApplicationWindow {
readonly property int sampleTextWidth: sampleCardWidth - 48
readonly property int detailTextWidth: detailColumnWidth - 48
property int previewCopyActivationCount: 0
property var selectedHostForPreview: novaSelectedHostDetail
property var selectedGameForPreview: novaSelectedGameCard
property string selectedLaunchPreviewText: novaSelectedLaunchPreviewText
property var launchPreviewCopyAction: novaLaunchPreviewCopyAction

function selectedHostSubtitle() {
return "Demo host detail only — not discovered from the network."
}

function previewComponent(value) {
return encodeURIComponent(value === undefined || value === null ? "" : String(value))
}

function refreshLaunchPreviewBinding() {
const hostId = selectedHostForPreview && selectedHostForPreview.id
? selectedHostForPreview.id
: "host-empty-state"
const gameTitle = selectedGameForPreview && selectedGameForPreview.title
? selectedGameForPreview.title
: "No game selected"
selectedLaunchPreviewText = "preview://nova-deck/launch?host="
+ previewComponent(hostId)
+ "&game="
+ previewComponent(gameTitle)
+ "&state=copy-preview-only"
launchPreviewCopyAction = {
"id": novaLaunchPreviewCopyAction.id,
"label": novaLaunchPreviewCopyAction.label,
"previewText": selectedLaunchPreviewText,
"idleStatusLabel": novaLaunchPreviewCopyAction.idleStatusLabel,
"successToast": novaLaunchPreviewCopyAction.successToast,
"inertToast": novaLaunchPreviewCopyAction.inertToast,
"enabled": selectedLaunchPreviewText.length > 0,
"copyOnly": true,
"uiLocalClipboardOnly": true,
"executable": false
}
}

function selectHostForPreview(hostModel) {
selectedHostForPreview = {
"id": hostModel.id,
"displayName": hostModel.displayName,
"statusLabel": hostModel.statusLabel,
"subtitle": selectedHostSubtitle()
}
refreshLaunchPreviewBinding()
}

function selectGameForPreview(gameModel) {
selectedGameForPreview = {
"id": gameModel.id,
"title": gameModel.title,
"sourceRuntimeLabel": gameModel.sourceRuntimeLabel,
"launchModeLabel": gameModel.launchModeLabel,
"installedLabel": gameModel.installedLabel
}
refreshLaunchPreviewBinding()
}

function activateLaunchPreviewCopyFromController() {
const canCopyPreview = novaLaunchPreviewCopyAction.enabled
&& novaLaunchPreviewCopyAction.previewText.length > 0
&& novaLaunchPreviewCopyAction.copyOnly
&& novaLaunchPreviewCopyAction.uiLocalClipboardOnly
&& !novaLaunchPreviewCopyAction.executable
const canCopyPreview = launchPreviewCopyAction.enabled
&& launchPreviewCopyAction.previewText.length > 0
&& launchPreviewCopyAction.copyOnly
&& launchPreviewCopyAction.uiLocalClipboardOnly
&& !launchPreviewCopyAction.executable
const didCopyPreview = canCopyPreview
&& novaLocalClipboard.copyPreviewText(novaLaunchPreviewCopyAction.previewText)
&& novaLocalClipboard.copyPreviewText(launchPreviewCopyAction.previewText)
if (didCopyPreview) {
previewCopyActivationCount += 1
}
copyStatusLabel.text = didCopyPreview
? novaLaunchPreviewCopyAction.successToast + " · A pressed #" + previewCopyActivationCount
: novaLaunchPreviewCopyAction.inertToast + " · A press stayed preview-only"
? launchPreviewCopyAction.successToast + " · A pressed #" + previewCopyActivationCount
: launchPreviewCopyAction.inertToast + " · A press stayed preview-only"
copyStatusLabel.color = didCopyPreview ? "#8AFFC1" : "#FFDDA8"
}

Expand All @@ -63,6 +122,7 @@ ApplicationWindow {
anchors.fill: parent
focus: true
Component.onCompleted: Qt.callLater(function() {
refreshLaunchPreviewBinding()
if (novaDemoHosts.length > 0 && hostRepeater.itemAt(0) !== null) {
hostRepeater.itemAt(0).forceActiveFocus()
} else {
Expand Down Expand Up @@ -157,13 +217,20 @@ ApplicationWindow {
Layout.preferredWidth: hostColumnWidth
Layout.preferredHeight: hostCardHeight
radius: 20
color: activeFocus ? "#202B55" : "#151D39"
border.color: activeFocus ? "#B8C2FF" : "#7C73FF"
border.width: activeFocus ? 5 : 3
color: selectedHostForPreview.id === modelData.id ? "#202B55" : "#151D39"
border.color: activeFocus ? "#B8C2FF" : selectedHostForPreview.id === modelData.id ? "#8AFFC1" : "#7C73FF"
border.width: activeFocus ? 5 : selectedHostForPreview.id === modelData.id ? 4 : 3
focus: modelData.initialFocus
activeFocusOnTab: true
KeyNavigation.right: hostDetailPanel
Keys.onRightPressed: hostDetailPanel.forceActiveFocus()
onActiveFocusChanged: if (activeFocus) selectHostForPreview(modelData)
Keys.onRightPressed: {
selectHostForPreview(modelData)
hostDetailPanel.forceActiveFocus()
}
Keys.onReturnPressed: selectHostForPreview(modelData)
Keys.onEnterPressed: selectHostForPreview(modelData)
Keys.onSpacePressed: selectHostForPreview(modelData)
Keys.onDownPressed: {
const next = hostRepeater.itemAt(index + 1)
if (next !== null) {
Expand Down Expand Up @@ -232,13 +299,20 @@ ApplicationWindow {
Layout.preferredWidth: sampleCardWidth
Layout.preferredHeight: 88
radius: 18
color: activeFocus ? "#202B55" : "#151D39"
border.color: activeFocus ? "#B8C2FF" : "#7C73FF"
border.width: activeFocus ? 5 : 2
color: selectedGameForPreview.id === modelData.id ? "#202B55" : "#151D39"
border.color: activeFocus ? "#B8C2FF" : selectedGameForPreview.id === modelData.id ? "#8AFFC1" : "#7C73FF"
border.width: activeFocus ? 5 : selectedGameForPreview.id === modelData.id ? 4 : 2
focus: modelData.initialFocus
activeFocusOnTab: true
KeyNavigation.right: hostDetailPanel
Keys.onRightPressed: hostDetailPanel.forceActiveFocus()
onActiveFocusChanged: if (activeFocus) selectGameForPreview(modelData)
Keys.onRightPressed: {
selectGameForPreview(modelData)
hostDetailPanel.forceActiveFocus()
}
Keys.onReturnPressed: selectGameForPreview(modelData)
Keys.onEnterPressed: selectGameForPreview(modelData)
Keys.onSpacePressed: selectGameForPreview(modelData)
Keys.onDownPressed: {
const next = libraryGameRepeater.itemAt(index + 1)
if (next !== null) {
Expand Down Expand Up @@ -325,25 +399,33 @@ ApplicationWindow {
}

Label {
text: novaSelectedHostDetail.displayName
text: selectedHostForPreview.displayName
color: "#E9ECFF"
font.pixelSize: 30
font.bold: true
}

Label {
text: novaSelectedHostDetail.statusLabel
text: selectedHostForPreview.statusLabel
color: "#B8C2F0"
font.pixelSize: 19
}

Label {
Layout.preferredWidth: detailTextWidth
text: novaSelectedHostDetail.subtitle
text: selectedHostForPreview.subtitle
color: "#A8B0D8"
font.pixelSize: 16
wrapMode: Text.WordWrap
}

Label {
Layout.preferredWidth: detailTextWidth
text: "Selected game: " + selectedGameForPreview.title
color: "#8AFFC1"
font.pixelSize: 14
wrapMode: Text.WordWrap
}
}
}

Expand Down Expand Up @@ -421,7 +503,7 @@ ApplicationWindow {

Label {
Layout.preferredWidth: detailTextWidth
text: novaHostLaunchCta.previewText
text: selectedLaunchPreviewText
color: "#A8B0D8"
font.pixelSize: 12
font.family: "monospace"
Expand All @@ -430,9 +512,9 @@ ApplicationWindow {

Button {
id: copyPreviewButton
objectName: novaLaunchPreviewCopyAction.id
text: activeFocus ? "A · " + novaLaunchPreviewCopyAction.label : novaLaunchPreviewCopyAction.label
enabled: novaLaunchPreviewCopyAction.enabled
objectName: launchPreviewCopyAction.id
text: activeFocus ? "A · " + launchPreviewCopyAction.label : launchPreviewCopyAction.label
enabled: launchPreviewCopyAction.enabled
focusPolicy: Qt.StrongFocus
activeFocusOnTab: true
KeyNavigation.up: launchCtaPlaceholder
Expand All @@ -453,7 +535,7 @@ ApplicationWindow {
Label {
id: copyStatusLabel
Layout.preferredWidth: detailTextWidth
text: novaLaunchPreviewCopyAction.idleStatusLabel + " Press A on Copy to verify."
text: launchPreviewCopyAction.idleStatusLabel + " Press A on Copy to verify."
color: "#FFDDA8"
font.pixelSize: 12
wrapMode: Text.WordWrap
Expand Down
82 changes: 73 additions & 9 deletions clients/deck/src/deck_layout.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,46 @@ std::string launchModeLabelFor(const PolarisGameFixture& game) {
return "Stream: " + streamMode + " · Steam: " + steamMode;
}

DeckLibraryGameCard libraryGameCardFor(const PolarisGameFixture& game, const int row) {
return DeckLibraryGameCard{
.id = game.id.empty() ? "library-game-" + std::to_string(row) : game.id,
.title = game.name.empty() ? "Untitled game" : game.name,
.sourceRuntimeLabel = joinedSourceRuntimeLabelFor(game),
.launchModeLabel = launchModeLabelFor(game),
.installedLabel = game.installed ? "Installed" : "Not installed",
.row = row,
.initialFocus = row == 0,
};
}

std::size_t selectedGameIndexFor(const PolarisGameLibraryFixture& library, const std::string_view selectedGameId) {
if (library.games.empty()) {
return 0;
}

const auto selected = std::ranges::find_if(library.games, [selectedGameId](const PolarisGameFixture& game) {
return game.id == selectedGameId;
});

if (selected == library.games.end()) {
return 0;
}

return static_cast<std::size_t>(std::distance(library.games.begin(), selected));
}

PolarisGameFixture emptySelectedGameFixture() {
return PolarisGameFixture{
.id = "game-empty-state",
.name = "No game selected",
.source = "manual",
.launcherSource = "manual",
.platformLabel = "Preview",
.runtimeLabel = "No runtime",
.installed = false,
};
}

} // namespace


Expand Down Expand Up @@ -174,15 +214,7 @@ std::vector<DeckLibraryGameCard> libraryGameCardsFor(const PolarisGameLibraryFix
cards.reserve(library.games.size());
int row = 0;
for (const auto& game : library.games) {
cards.push_back(DeckLibraryGameCard{
.id = game.id.empty() ? "library-game-" + std::to_string(row) : game.id,
.title = game.name.empty() ? "Untitled game" : game.name,
.sourceRuntimeLabel = joinedSourceRuntimeLabelFor(game),
.launchModeLabel = launchModeLabelFor(game),
.installedLabel = game.installed ? "Installed" : "Not installed",
.row = row,
.initialFocus = row == 0,
});
cards.push_back(libraryGameCardFor(game, row));
++row;
}
return cards;
Expand Down Expand Up @@ -286,6 +318,38 @@ DeckLaunchIntent resolveLaunchIntent(const DeckHostDetail& detail, const Polaris
};
}

DeckLaunchPreviewBinding resolveLaunchPreviewBinding(
const std::vector<DeckHostListItem>& hosts,
const PolarisGameLibraryFixture& library,
const std::string_view selectedHostId,
const std::string_view selectedGameId) {
const std::string_view resolvedHostId = resolveHostDetail(hosts, selectedHostId).id == std::string_view("host-detail-empty")
? initialHostFocusTarget(hosts)
: selectedHostId;
const auto hostDetail = resolveHostDetail(hosts, resolvedHostId);

const auto gameIndex = selectedGameIndexFor(library, selectedGameId);
const auto selectedGame = library.games.empty() ? emptySelectedGameFixture() : library.games.at(gameIndex);
const auto gameCard = libraryGameCardFor(selectedGame, static_cast<int>(gameIndex));
const auto intent = resolveLaunchIntent(hostDetail, selectedGame);
const auto preview = fakeLaunchCommandPreviewFor(intent);
const auto launchCta = inertLaunchCtaFor(hostDetail, selectedGame);
const auto copyAction = copyLaunchPreviewActionFor(preview);

return DeckLaunchPreviewBinding{
.selectedHostId = std::string(hostDetail.id),
.selectedHostName = std::string(hostDetail.displayName),
.selectedGameId = selectedGame.id,
.selectedGameTitle = selectedGame.name,
.hostDetail = hostDetail,
.gameCard = gameCard,
.intent = intent,
.preview = preview,
.launchCta = launchCta,
.copyAction = copyAction,
};
}

bool canExecuteLaunchIntent(const DeckLaunchIntent& intent) {
return intent.executable
&& !intent.boundary.previewOnly
Expand Down
19 changes: 19 additions & 0 deletions clients/deck/src/deck_layout.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,19 @@ struct DeckLaunchPreviewCopyResult {
bool copied = false;
};

struct DeckLaunchPreviewBinding {
std::string selectedHostId;
std::string selectedHostName;
std::string selectedGameId;
std::string selectedGameTitle;
DeckHostDetail hostDetail;
DeckLibraryGameCard gameCard;
DeckLaunchIntent intent;
DeckLaunchPreview preview;
DeckLaunchCta launchCta;
DeckLaunchPreviewCopyAction copyAction;
};

class DeckLocalClipboard {
public:
virtual ~DeckLocalClipboard() = default;
Expand Down Expand Up @@ -162,6 +175,12 @@ DeckLaunchIntentBoundary previewOnlyLaunchIntentBoundary();

DeckLaunchIntent resolveLaunchIntent(const DeckHostDetail& detail, const PolarisGameFixture& game);

DeckLaunchPreviewBinding resolveLaunchPreviewBinding(
const std::vector<DeckHostListItem>& hosts,
const PolarisGameLibraryFixture& library,
std::string_view selectedHostId,
std::string_view selectedGameId);

bool canExecuteLaunchIntent(const DeckLaunchIntent& intent);

DeckLaunchPreview fakeLaunchCommandPreviewFor(const DeckLaunchIntent& intent);
Expand Down
Loading
Loading