4d91a5ffde3056e557c16072f092411c8b18007a
Per ADR-0045 (three-tier library naming) the launcher migrates from
the retired lib-sporel.* prefix to the new lib-management.* tier for
host-infrastructure libs. Updates:
- manifest.module id: lib-sporel.launcher -> lib-management.launcher
- manifest.core id: lib-sporel.launcher.core -> lib-management.launcher.core
- init.lua engine.module.dir_of("lib-management.launcher")
- README + fsm.lua comment refs
Gitea repo renamed in lockstep:
sporel/sporel-module-lib-sporel.launcher ->
sporel/sporel-module-lib-management.launcher
lib-management.launcher
Module-discovery and module-switch entry. Lists available modules from the configured modules-dir and launches the selected one via engine.switch_module. Typical entry point: --module=lib-management.launcher boots into a chooser screen rather than directly into a game.
Version: 0.1.0
Module-ID: lib-management.launcher
Requires: lib-core.input v>=0.4.0
Tags: launcher, menu, system, navigation
Topology
graph LR
this["lib-management.launcher"]
lib_core_input["lib-core.input"]
this --> lib_core_input
engine["engine.*"]
this --> engine
Controls
- Mouse-Left: Click a module-button to launch it; click confirm/cancel in the quit-modal.
- Enter: Confirm quit when the modal is open.
- Escape: Open the quit-modal from the chooser; cancel the modal when open.
Demonstrates
engine.module.listdiscovery of installed modules from the modules-dir.engine.switch_moduleruntime swap from the launcher to the selected module.- Simple text + rect rendering via
engine.renderfor the chooser UI. - Input-action binding through
lib-core.input(ui_click,ui_back,ui_confirm). - Modal-state FSM (chooser <-> quit-modal) factored into a sibling
fsm.lualoaded viaengine.module.dir_of.
References
- meta/docs/architecture/module-lifecycle.md
- meta/docs/architecture/host-app.md
- meta/docs/superpowers/specs/2026-05-14-launcher-design.md
Description
Languages
Lua
99.2%
Shell
0.8%