Phase 4: menu descriptors for 16 states

Game-file footprint unchanged: still one line in main.lua.

Adds descriptors for actions_menu, worldmap, alchemy_table, journal, character,
inventory, and a shared one for the full-screen prose states (menu_text,
ingame_message, menu_message). The prose states also push their text into the
console history, so the existing review keys walk the manual paragraph by
paragraph rather than delivering it as one unusable utterance.

Two driver improvements, both prompted by real failures the self-test caught:

- menus.getAnyUpvalue finds a file-local across all of a state's functions and
  one level into inner closures. Safe because a Lua file-local is a single
  shared upvalue. Needed because actions_menu and worldmap build their lists in
  open() and never reference them in keypressed, so the named probe function
  found nothing. The generic probe path now falls back to this.

- menus.hasUpvalue checks that a local exists rather than that it holds a value.
  getUpvalue cannot distinguish 'no such local' from 'declared but currently
  nil', which made the self-test report PROBE BROKEN for worldmap, whose
  'local options' is nil until the screen is first opened.

patches/popups.lua now stands down for any state that has a descriptor.
inventoryCursorPopup.set only fires when an item is under the cursor, so empty
slots and empty tabs were silent and you could not tell the cursor had moved.
The inventory descriptor reports item-or-empty plus slot and tab instead.

21/21 testbed checks, history unit tests passing.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Accessibility Mod
2026-08-01 22:00:52 +02:00
co-authored by Claude Opus 5
parent bd338087ce
commit 0477097e29
15 changed files with 512 additions and 18 deletions
+50
View File
@@ -0,0 +1,50 @@
-- states/journal.lua — quests, lore, bestiary, knowledge, research, tutorials.
--
-- Two axes move independently: the tab (left/right) and the entry within it
-- (up/down). Both must be announced, and the tab header must lead when it
-- changes, since "Quests" and "Bestiary" list very different things.
--
-- Uses getAnyUpvalue because activeTabIndex, options and selectedOption are
-- touched by different functions here (gotoTab, refreshOptions, keypressed).
local lastTab
return {
read = function(stateTable, menus)
local tabIndex = menus.getAnyUpvalue(stateTable, "activeTabIndex")
local tabsList = menus.getAnyUpvalue(stateTable, "tabsList")
local options = menus.getAnyUpvalue(stateTable, "options")
local selected = menus.getAnyUpvalue(stateTable, "selectedOption")
if type(tabIndex) ~= "number" or type(tabsList) ~= "table" then
return nil, nil
end
local tab = tabsList[tabIndex]
local tabName = tab and tab.header or ("tab " .. tabIndex)
local parts = {}
-- Lead with the tab only when it just changed, so stepping through a long
-- quest list doesn't repeat "Quests" on every line.
if tabIndex ~= lastTab then
lastTab = tabIndex
parts[#parts + 1] = tabName
end
if type(options) == "table" and type(selected) == "number" and options[selected] then
local entry = options[selected]
parts[#parts + 1] = entry.title or entry.header or entry.name or "?"
parts[#parts + 1] = selected .. " of " .. #options
elseif type(options) == "table" and #options == 0 then
parts[#parts + 1] = "empty"
end
if #parts == 0 then
return nil, nil
end
return table.concat(parts, ", "),
tostring(tabIndex) .. ":" .. tostring(selected) .. ":" .. tostring(options and #options)
end,
}