blob: 77d9a3b172115d89af7cb51cbc8b2a923e495c71 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
#pragma once
#include <unbox/kernel/extension.hpp>
#include <cstddef>
#include <memory>
// Test-only probe surface (PRIVATE — src/, never part of the contract). The
// headless glue test needs to drive the c2 minimize/restore PIPELINE and read
// the dock MODEL without a synthetic keyboard device (the Super+M keystroke
// decode is trivial; the pipeline it triggers is what matters). The public
// create() hides the concrete extension behind kernel::Extension; this factory
// hands back the same Extension plus a borrowed probe the test polls/drives.
//
// On a no-GL backend (headless pixman) the ui substrate is null, so the dock
// UiSurface is null and previews are null — the probe still exercises the model
// + hide()/show() (exactly what the brief says to test there). Glue/shell test
// convenience only; never a contract claim.
namespace unbox::ext_stage_dock {
// A non-owning view onto the live extension for tests. Valid as long as the
// returned unique_ptr (and thus the extension) is alive. All calls are on the
// single event-loop thread, like the extension itself.
class TestProbe {
public:
virtual ~TestProbe() = default;
// True once activate() completed (Service fetched, hooks wired, dock surface
// creation attempted).
[[nodiscard]] virtual auto activated() const -> bool = 0;
// Drive the minimize pipeline on the currently focused window exactly as the
// Super+M key path does (snapshot -> hide -> slot -> reveal dock + re-focus).
// No-op if nothing is focused.
virtual void minimize_focused() = 0;
// Drive the restore pipeline for slot `i` (show + focus the window, drop the
// slot). Guards the index.
virtual void restore(std::size_t i) = 0;
// The current number of dock slots (minimized windows).
[[nodiscard]] virtual auto slot_count() const -> std::size_t = 0;
// Whether the dock currently has a focused window (focused_ != nullptr) — the
// exact guard do_minimize_focused()/the Super+M filter check before acting.
// After a restore the dock MUST report a focused window (restore re-focuses
// the shown window), or the next minimize would be a no-op. Glue-test only.
[[nodiscard]] virtual auto has_focused() const -> bool = 0;
};
struct ExtensionWithProbe {
std::unique_ptr<unbox::kernel::Extension> extension; // install() this
TestProbe* probe = nullptr; // borrow into the above
};
// Same extension as create(), but also yields a probe borrow.
[[nodiscard]] auto make_extension_with_probe() -> ExtensionWithProbe;
} // namespace unbox::ext_stage_dock
|
