Accessibility ModandClaude Opus 5
0477097e29
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>
65 lines
1.8 KiB
Lua
65 lines
1.8 KiB
Lua
-- Shared descriptor for the full-screen prose states: menu_text (manual,
|
|
-- credits), ingame_message and menu_message.
|
|
--
|
|
-- These have no focus cursor -- the whole screen is one block of text. Long ones
|
|
-- (the manual runs to thousands of words) are unusable as a single utterance, so
|
|
-- the text is ALSO pushed into the console history. That makes the existing
|
|
-- review keys ([ and ]) work on it: you can walk the manual paragraph by
|
|
-- paragraph, jump to the start with Shift+[, and re-read with \.
|
|
|
|
local history = require("accessibility.history")
|
|
|
|
-- Split on blank lines first, falling back to single newlines. Paragraph-sized
|
|
-- chunks read far better than either one huge utterance or line-by-line
|
|
-- fragments broken mid-sentence by the game's own wrapping.
|
|
local function paragraphs(text)
|
|
local chunks = {}
|
|
|
|
for chunk in (text .. "\n\n"):gmatch("(.-)\n%s*\n") do
|
|
chunk = chunk:gsub("^%s+", ""):gsub("%s+$", "")
|
|
if chunk ~= "" then
|
|
chunks[#chunks + 1] = chunk
|
|
end
|
|
end
|
|
|
|
if #chunks == 0 then
|
|
for line in text:gmatch("[^\n]+") do
|
|
line = line:gsub("^%s+", ""):gsub("%s+$", "")
|
|
if line ~= "" then
|
|
chunks[#chunks + 1] = line
|
|
end
|
|
end
|
|
end
|
|
|
|
return chunks
|
|
end
|
|
|
|
local lastText
|
|
|
|
return {
|
|
read = function(stateTable, menus)
|
|
local text = menus.getAnyUpvalue(stateTable, "messageText")
|
|
|
|
if type(text) ~= "string" or text == "" then
|
|
return nil, nil
|
|
end
|
|
|
|
if text == lastText then
|
|
return nil, nil
|
|
end
|
|
lastText = text
|
|
|
|
-- Feed the review buffer so [ and ] can walk it.
|
|
local chunks = paragraphs(text)
|
|
for _, chunk in ipairs(chunks) do
|
|
pcall(history.append, chunk, "text")
|
|
end
|
|
|
|
local summary = #chunks > 1
|
|
and string.format("%s. %d paragraphs, use review keys to read.", chunks[1], #chunks)
|
|
or chunks[1]
|
|
|
|
return summary, text
|
|
end,
|
|
}
|