### Installing the Hymission Library

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Installs the 'hymission' shared library to the appropriate system directory.

```cmake
install(TARGETS hymission LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})
```

--------------------------------

### Install hymission with hyprpm

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Use hyprpm to update, add, enable, and reload the hymission plugin.

```bash
hyprpm update
hyprpm add https://github.com/gfhdhytghd/hymission
hyprpm enable hymission
hyprpm reload
```

--------------------------------

### Build hymission with CMake

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Build the hymission plugin locally using CMake for development purposes. Ensure Hyprland development headers and a C++23 compiler are installed.

```bash
cmake -DCMAKE_BUILD_TYPE=Release -B build-cmake
cmake --build build-cmake -j"$(nproc)"
ctest --test-dir build-cmake --output-on-failure
```

--------------------------------

### Run Hymission Layout Demo

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Executes the geometry solver without loading the Hyprland plugin. Use this to test layout algorithms and generate SVG visualizations.

```sh
./build-cmake/hymission-layout-demo
```

--------------------------------

### Creating Hymission Layout Demo Executable

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Defines an executable for demonstrating layout functionality, linking it with the 'hymission' library's include paths.

```cmake
add_executable(hymission-layout-demo
  tools/layout_demo.cpp
  src/mission_layout.cpp
)

target_include_directories(hymission-layout-demo PRIVATE src)
```

--------------------------------

### Configuring and Adding Overview Logic Tests

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Conditionally adds a test executable for overview logic if testing is enabled. It includes source files and sets up the test command.

```cmake
  add_executable(hymission-overview-logic-test
    tools/overview_logic_test.cpp
    src/overview_logic.cpp
  )

  target_include_directories(hymission-overview-logic-test PRIVATE src)
  add_test(NAME hymission-overview-logic-test COMMAND hymission-overview-logic-test)
endif()
```

--------------------------------

### Live Plugin Reload and Validation Sequence

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-click-input-fallback.md

This sequence demonstrates how to unload and reload the plugin, then perform live reproduction of the issue with synthetic input to validate the fix. It confirms that the workspace transition now occurs successfully.

```bash
hyprctl plugin unload "hymission"
hyprctl plugin load "/path/to/hymission/plugin"

# Then, reproduce the issue:
hyprctl dispatch hymission:open onlycurrentworkspace
hyprctl dispatch movecursor 2250 2128
ydotool click 0xC0

# Verify the result:
hyprctl activeworkspace
```

--------------------------------

### HyMission Plugin Configuration (Lua)

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

This snippet demonstrates how to configure the HyMission plugin using Lua. It shows a subset of common settings, including padding, layout engine, and keybindings.

```lua
hl.config({
    plugin = {
        hymission = {
            outer_padding_top = 92,
            layout_engine = "grid",
            niri_mode = 0,
            switch_release_key = "Super_L",
            workspace_strip_anchor = "left",
        },
    },
})
```

--------------------------------

### Dependency Management with PkgConfig

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Finds and checks for required packages (Hyprland and Lua) using PkgConfig.

```cmake
find_package(PkgConfig REQUIRED)
pkg_check_modules(HYPR_DEPS REQUIRED hyprland)
pkg_check_modules(LUA REQUIRED lua)
```

--------------------------------

### List Scenes for Layout Demo

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Lists available built-in scenes for the `hymission-layout-demo` command. This helps in selecting specific scenarios for testing.

```sh
./build-cmake/hymission-layout-demo --list-scenes
```

--------------------------------

### Build Project with CMake

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-refresh-and-input-regression.md

Builds the project using CMake, specifying the build directory and utilizing parallel processing with nproc.

```bash
cmake --build build-cmake -j"$(nproc)"
```

--------------------------------

### Run Hymission Overview Logic Test

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Executes the overview logic test utility for Hymission.

```sh
./build-cmake/hymission-overview-logic-test
```

--------------------------------

### Allow hyprpm in Hyprland config

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Configure Hyprland permissions to allow hyprpm execution if using Hyprland's permission system.

```conf
permission = /usr/(bin|local/bin)/hyprpm, plugin, allow
```

--------------------------------

### Configuring and Adding Mission Layout Tests

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Conditionally adds a test executable for mission layout if testing is enabled. It includes source files and sets up the test command.

```cmake
if(BUILD_TESTING)
  add_executable(hymission-mission-layout-test
    tools/mission_layout_test.cpp
    src/mission_layout.cpp
  )

  target_include_directories(hymission-mission-layout-test PRIVATE src)
  add_test(NAME hymission-mission-layout-test COMMAND hymission-mission-layout-test)
```

--------------------------------

### Project and C++ Standard Configuration

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Sets the minimum CMake version, project name and version, and the C++ standard to C++23, ensuring it's required.

```cmake
cmake_minimum_required(VERSION 3.19)
project(hymission VERSION "0.3.3")

set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
```

--------------------------------

### Run Overview Logic Test

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-refresh-and-input-regression.md

Executes the overview logic test for the hymission project.

```bash
build-cmake/hymission-overview-logic-test
```

--------------------------------

### HyMission Plugin Configuration (conf)

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

This snippet shows the full configuration for the HyMission plugin using the conf format. It includes all available settings for padding, spacing, layout engines, and workspace strip behavior.

```conf
plugin {
    hymission {
        outer_padding_top = 92
        outer_padding_right = 32
        outer_padding_bottom = 32
        outer_padding_left = 32
        row_spacing = 32
        column_spacing = 32
        min_window_length = 120
        min_preview_short_edge = 32
        small_window_boost = 1.35
        max_preview_scale = 0.95
        workspace_overview_max_preview_scale = 0.95
        min_slot_scale = 0.10
        natural_scale_flex = 0.22
        layout_engine = grid
        layout_scale_weight = 1.0
        layout_space_weight = 0.10

        expand_selected_window = 1
        overview_focus_follows_mouse = 1
        multi_workspace_sort_recent_first = 1
        niri_mode = 0
        niri_scroll_pixels_per_delta = 1.0
        niri_workspace_scale = 1.0
        toggle_switch_mode = 1
        switch_toggle_auto_next = 1
        switch_release_key = Super_L
        gesture_invert_vertical = 0
        one_workspace_per_row = 0
        only_active_workspace = 0
        only_active_monitor = 0
        show_special = 0
        workspace_change_keeps_overview = 1

        workspace_strip_anchor = left
        workspace_strip_empty_mode = existing
        workspace_strip_thickness = 160
        workspace_strip_gap = 24
        hide_bar_when_strip = 1
        hide_bar_animation = 1
        hide_bar_animation_blur = 1
        hide_bar_animation_move_multiplier = 0.8
        hide_bar_animation_scale_divisor = 1.1
        hide_bar_animation_alpha_end = 0
        bar_single_mission_control = 0
        show_focus_indicator = 0

        debug_logs = 0
        debug_surface_logs = 0
    }
}
```

--------------------------------

### Compiler Options and Definitions

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Configures compiler options for debugging and warnings, and adds a specific preprocessor definition.

```cmake
include(CTest)

add_compile_definitions(WLR_USE_UNSTABLE)
add_compile_options(
  -g
  -Wall
  -Wextra
  -Wno-unused-parameter
  -Wno-unused-value
  -Wno-missing-field-initializers
  -Wno-narrowing
  -Wno-pointer-arith
  --no-gnu-unique
)
```

--------------------------------

### Configure hymission dispatchers

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Bind keyboard shortcuts to hymission dispatchers for toggling, opening, and closing the overview, with optional scope arguments like 'onlycurrentworkspace' and 'forceall'.

```conf
bind = SUPER, TAB, hymission:toggle
bind = SUPER SHIFT, TAB, hymission:open
bind = SUPER CTRL, TAB, hymission:close
bind = SUPER, C, hymission:toggle,onlycurrentworkspace
bind = SUPER, A, hymission:toggle,forceall
bind = SUPER, M, hymission:debug_current_layout
```

--------------------------------

### Reproduce Strip Click Failure with Synthetic Input

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-click-input-fallback.md

This sequence establishes a concrete failure scenario by using `hyprctl` and `ydotool` to simulate user interactions and log the resulting input states. It's used to verify the bug before applying a fix.

```bash
hyprctl dispatch movecursor 2250 2128
ydotool click 0xC0
```

--------------------------------

### Run Hymission Mission Layout Test

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Executes the mission layout test utility for Hymission.

```sh
./build-cmake/hymission-mission-layout-test
```

--------------------------------

### Waybar Configuration for Single-Entry Mission Control

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

This configuration snippet is used with Niri's `bar_single_mission_control = 1` setting. It collapses the hyprland/workspaces module to a single 'Mission Control' button when the multi-workspace overview is active, by ignoring dynamically renamed hidden workspaces.

```jsonc
"hyprland/workspaces": {
  "all-outputs": true,
  "disable-scroll": true,
  "on-click": "activate",
  "persistent_workspaces": {},
  "ignore-workspaces": ["^__hymission_hidden__:"]
}
```

--------------------------------

### Creating the Hymission Shared Library

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Defines the main shared library 'hymission' and lists its source files.

```cmake
add_library(hymission SHARED
  src/main.cpp
  src/mission_layout.cpp
  src/overview_logic.cpp
  src/overview_controller.cpp
)
```

--------------------------------

### Safe reload sequence for hymission

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Unload previous versions and load the newly built hymission plugin using hyprctl. 'plugin not loaded' messages are expected for unloaded paths.

```bash
hyprctl plugin unload "$(pwd)/build/libhymission.so"
hyprctl plugin unload "$(pwd)/build-cmake/libhymission.so"
hyprctl plugin unload "$(pwd)/build-meson/libhymission.so"
hyprctl plugin load "$(pwd)/build-cmake/libhymission.so"
hyprctl plugin list
```

--------------------------------

### Setting Include and Link Directories for Hymission Library

Source: https://github.com/gfhdhytghd/hymission/blob/master/CMakeLists.txt

Configures private include directories and link directories/libraries for the 'hymission' shared library, including dependencies.

```cmake
target_include_directories(hymission PRIVATE ${HYPR_DEPS_INCLUDE_DIRS} ${LUA_INCLUDE_DIRS})

foreach(inc ${HYPR_DEPS_INCLUDE_DIRS})
  if(EXISTS "${inc}/hyprland/src")
    target_include_directories(hymission PRIVATE "${inc}/hyprland/src")
  endif()
endforeach()

target_link_directories(hymission PRIVATE ${HYPR_DEPS_LIBRARY_DIRS} ${LUA_LIBRARY_DIRS})
target_link_libraries(hymission PRIVATE ${HYPR_DEPS_LIBRARIES} ${LUA_LIBRARIES})
```

--------------------------------

### Debug Current Layout with Hyprctl

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Uses `hyprctl` to dispatch a debug command for the current layout in Hymission. This is useful for inspecting the state of the layout solver.

```sh
hyprctl dispatch hymission:debug_current_layout
```

--------------------------------

### Gesture-only 'recommand' mode for hymission:toggle

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-recommand-gesture-and-strip-slide.md

Enables a toggle-only gesture mode for 'hymission:toggle' to provide distinct 'forceall' and 'onlycurrentworkspace' behaviors based on gesture direction.

```text
gesture = ..., dispatcher, hymission:toggle,recommand
```

--------------------------------

### Configure Hymission Gestures in Hyprland Config

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Define gestures in your Hyprland configuration file to trigger Hymission actions like toggling, opening, or scrolling layouts.

```conf
gesture = 4, vertical, dispatcher, hymission:toggle,forceall
gesture = 4, vertical, dispatcher, hymission:toggle,recommand
gesture = 4, vertical, dispatcher, hymission:open,onlycurrentworkspace
gesture = 3, horizontal, dispatcher, hymission:scroll,layout
# or: gesture = 3, horizontal, scrollMove
gesture = 3, vertical, workspace
```

--------------------------------

### Register Hymission Gestures in Lua

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Register continuous overview progress gestures using `hl.plugin.hymission.gesture` in your Lua configuration. This method is preferred over `hl.gesture` for such cases.

```lua
hl.plugin.hymission.gesture({
    fingers = 4,
    direction = "vertical",
    action = "toggle",
    args = "forceall",
})

hl.plugin.hymission.gesture({
    fingers = 4,
    direction = "vertical",
    action = "toggle",
    recommand = true,
})

hl.plugin.hymission.gesture({
    fingers = 4,
    direction = "vertical",
    action = "open",
    scope = "onlycurrentworkspace",
})

hl.plugin.hymission.gesture({
    fingers = 3,
    direction = "horizontal",
    action = "scroll",
    mode = "layout",
})

-- Native alternative:
-- hl.gesture({ fingers = 3, direction = "horizontal", action = "scroll_move" })

hl.plugin.hymission.gesture({
    fingers = 3,
    direction = "vertical",
    action = "workspace",
})
```

--------------------------------

### Bind Hymission Functions in Lua

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Use `hl.plugin.hymission` to bind functions like toggle, open, and close to keyboard shortcuts in your Hyprland Lua configuration.

```lua
hl.bind("SUPER + TAB", hl.plugin.hymission.toggle)
hl.bind("SUPER + A", function()
    hl.plugin.hymission.toggle("forceall")
end)
hl.bind("SUPER + S", function()
    hl.plugin.hymission.open("onlycurrentworkspace")
end)
hl.bind("SUPER + Escape", hl.plugin.hymission.close)
```

--------------------------------

### Configure toggle switch mode for hymission

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Enable and configure toggle switch mode for the `hymission:toggle` dispatcher, allowing repeated key presses to cycle targets while a modifier is held. This mode is intended for bindings like ALT+TAB or SUPER+TAB.

```conf
toggle_switch_mode = 1
switch_toggle_auto_next = 1
switch_release_key = Super_L
```

--------------------------------

### Add Primary-Button Fallback in handleMouseButton

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-click-input-fallback.md

This code implements a fallback mechanism within the `handleMouseButton` function. It normalizes corrupted button codes to the primary button and synthesizes press/release events to ensure usability for left-click interactions.

```cpp
void OverviewController::handleMouseButton(const IPointer::SButtonEvent &raw_event) {
  // ... existing code ...

  // Normalize corrupted button codes to primary button.
  auto effective_button = raw_event.button;
  if (effective_button != 1) {
    // Log the raw and effective values for debugging.
    Debug::log(LOG_INFO, "Raw button: %d, Effective button: %d", raw_event.button, 1);
    effective_button = 1; // Normalize to primary button
  }

  // Synthesize press/release edge from a local state machine.
  bool primary_button_pressed = m_primaryButtonPressed;
  if (effective_button == 1) {
    if (!m_primaryButtonPressed) {
      primary_button_pressed = true;
      m_primaryButtonPressed = true;
    }
  } else {
    if (m_primaryButtonPressed) {
      primary_button_pressed = false;
      m_primaryButtonPressed = false;
    }
  }

  // Use effective_button and synthesized press/release for logic.
  // ... rest of the handler logic ...
}

```

--------------------------------

### Log Output of Corrupted Mouse Button Payload

Source: https://github.com/gfhdhytghd/hymission/blob/master/devlog/2026-03-07-strip-click-input-fallback.md

This log snippet shows the raw input state received by the `handleMouseButton` callback, highlighting a corrupted button code (`32767`) which prevents the expected workspace transition.

```text
state=1 button=32767
```

--------------------------------

### Generate SVG Output with Specific Scene and Engine

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Generates an SVG output for a specified scene and engine. Useful for visualizing layout results with different configurations.

```sh
./build-cmake/hymission-layout-demo --scene forceall --engine natural --output /tmp/hymission-forceall-natural.svg
```

```sh
./build-cmake/hymission-layout-demo --scene forceall --engine grid --output /tmp/hymission-forceall-grid.svg
```

--------------------------------

### Generate Stress Test SVG Output

Source: https://github.com/gfhdhytghd/hymission/blob/master/README.md

Generates an SVG output from a stress test with a specified number of iterations and seed. Useful for tuning the solver with pathological scenes.

```sh
./build-cmake/hymission-layout-demo --stress 5000 --seed 1 --output /tmp/hymission-stress-worst.svg
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.