Skip to content

Propose a versioned host interface for retained Drawer widgets - #11

Draft
tcballard wants to merge 1 commit into
review/core-baseline-5ead870from
feat/stock-bar-drawer-api
Draft

tcballard wants to merge 1 commit into
review/core-baseline-5ead870from
feat/stock-bar-drawer-api

Conversation

@tcballard

@tcballard tcballard commented Sep 9, 2026 •

Copy link
Copy Markdown
Owner

Fork review draft. Intended upstream target: omacom/omarchy:quattro. Opening the upstream PR was blocked by GitHub integration permissions (403). The base branch is an exact snapshot of upstream 5ead870, so this review contains only the intended contribution.

Drawer needs the stock bar to retain widget instances while moving their presentation between the bar and a drawer, including popup placement and drag/drop handling.

This brings Spencer Bull's existing four-file Drawer host extension into a separately reviewable core proposal and adds drawerApiVersion 1. Original extension source: https://github.com/spencerbull/omarchy-drawer/blob/c051f5789b97aec0c08b81d60d100d12ca5dc3f5/integration/stock-bar-drawer.patch (MIT). No authentication or foreign-service access is added. Hiding is not disabling: retained services/polling continue.

Independent of Workbench and the core lifecycle/update changes. The revised Drawer contribution needs either this host API or its equivalent bundled patch; merging this PR is not required to test Drawer locally. Do not apply the same patch twice.

Host contracts and patch application/reversal tests pass. Native keyboard, popup, service-backed widget, multi-monitor, orientation and scaling acceptance remain outstanding; this is a draft API proposal, not release-ready desktop code.

Related presentation proposals include omacom/omarchy#7975, omacom/omarchy#6961 and omacom/omarchy#7163; controller ownership and retained-instance semantics should be reconciled during review.

Companion changes and merge order

Change Dependency
Workbench #20 Helper and QML must both support protocol 1. Drawer remains optional.
Drawer #1 Requires API 1 from the revised bundled host patch OR the core host proposal; no core merge is mandatory for local testing. Existing patch users must upgrade their patch.
Core lifecycle proposal, fork PR #10 Independent fix. Needed for reliable external live-link watching and generic-updater preservation of Workbench ownership. Overlaps upstream staged-validation/watcher proposals and should be reconciled with them.
Core host proposal, fork PR #11 Independent of Workbench and lifecycle fixes. Provides an alternative to manually applying Drawer's patch. Most host code originates with Spencer Bull.
Helper package #287 Pins Workbench source 9dce628d7e597a25f7abffa8498575f924761d97 from omacom#20; requires full supported-host tests and Arch builds. Publish before shipping the refreshed native panel.
Native Workbench #10027 Hard runtime dependency on the protocol-1 helper from omacom#287. Drawer integration is optional.

Recommended order: validate and review Workbench omacom#20, publish its reviewed helper through omacom#287, then ship the refreshed omacom#10027 panel. Drawer and its host support form a separate track. Lifecycle fixes can merge independently. None of these PRs automatically enables, installs or requires Drawer for Workbench users.

The two core PRs currently live in tcballard/omarchy because GitHub returned 403 when creating upstream PRs. Intended upstream comparisons:

Native desktop acceptance remains outstanding. Hiding is presentation only; it does not promise polling suspension or resource savings.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant