adamant-ModpackLib

Shared runtime and immediate-mode UI toolkit for adamant modpack modules.

Lib now owns:

• managed module storage and explicit session
• storage typing and normalization
• hash/profile encoding helpers
• mutation lifecycle helpers for affectsRunData modules
• standalone hosting helpers
• immediate-mode widgets and navigation helpers

Lib does not own a declarative UI tree/runtime anymore. New module UI should be written directly in module draw functions such as internal.DrawTab(ui, session) and optional internal.DrawQuickContent(ui, session), then exposed through public.host = lib.createModuleHost(...).

Docs

• GETTING_STARTED.md First-time author guide: core concepts, file roles, and your first module.
• API.md Reference for the current public namespaces and functions.
• MODULE_AUTHORING.md How to author a module against the current immediate-mode contract.
• WIDGETS.md Widgets, nav, and storage notes for the live surface.
• UI_PERFORMANCE.md Render-path guidance for immediate-mode module UIs.
• IMGUI_LUA_REFERENCE.md Notes on the Dear ImGui Lua binding used by the stack.
• RELOAD_MODUTIL_CHALK_REFERENCE.md Stack reference for ReLoad, ModUtil, and Chalk behavior.
• CONTRIBUTING.md Contributor expectations for changing the public Lib contract.

Current Public Namespaces

• lib.config
• lib.logging
• lib.lifecycle
• lib.mutation
• lib.hashing
• lib.widgets
• lib.nav

Common top-level helpers:

• lib.createStore(...)
• lib.createModuleHost(...)
• lib.standaloneHost(...)
• lib.isModuleEnabled(...)
• lib.isModuleCoordinated(...)
• lib.resetStorageToDefaults(...)

Validation

cd adamant-ModpackLib
lua5.2 tests/all.lua