942e05ba3e
Parses manifest.launcher.md leading JSON-frontmatter (delimited by standalone '---' lines), returns (meta, body). Reuses lib-management.dep-fetcher._json_decode so we do not add a second JSON decoder to the codebase. Lazy require so test-lib contexts can swap a stub decoder via _G.LAUNCHER_FRONTMATTER_DECODER.
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